設定 Ruby 開發環境

本教學課程說明如何準備本機電腦，用於 Ruby 開發作業，包括開發在 Google Cloud上執行的 Ruby 應用程式。按照這篇教學課程的指示安裝 Ruby 和相關工具。

請參閱「Ruby 快速入門導覽課程 Google Cloud」，瞭解 Ruby 簡介，以及在 Google Cloud上執行 Ruby 應用程式的方法。

目標

  • 安裝 Ruby。
  • 安裝 Bundler。
  • 安裝編輯器 (選用)。
  • 安裝 Google Cloud CLI。
  • 安裝 Ruby 適用的 Cloud 用戶端程式庫。
  • 設定驗證方法。

安裝 Ruby

Ruby 的安裝方式會因作業系統而異。請按照本機開發機器所用作業系統的指南操作。本教學課程適用於 Ruby-lang 上列出的穩定且未停產 (EOL) Ruby 版本。

macOS

建議使用 rbenv 管理 macOS 上的 Ruby 安裝作業。rbenv 可管理電腦上安裝的多個 Ruby 版本，而名為 ruby-build 的 rbenv 外掛程式則可為 rbenv 新增支援，以便安裝指定版本的 Ruby。

雖然 macOS 預設包含某個版本的 Ruby，但建議您另外安裝最新版本的 Ruby，以使用最新功能並避免作業系統使用預設版本所造成的衝突。

  1. 安裝 XCode。

  2. 在終端機中使用以下指令安裝 XCode 的指令列工具：

    xcode-select --install

  3. 按照 Homebrew 首頁上的操作說明安裝 homebrew。

  4. 使用 homebrew 安裝 rbenv，並按照 rbenv 讀我檔案中的指示操作。Homebrew 安裝作業包含 ruby-build 外掛程式。

進一步瞭解如何使用 rbenv 和 ruby-build 安裝不同版本的 Ruby。

Linux

建議使用 rbenv 管理 Linux 發行版本上的 Ruby 安裝作業。rbenv 可管理機器上安裝的多個 Ruby 版本，而名為 ruby-build 的 rbenv 外掛程式則可支援安裝特定 Ruby 版本。rbenv

  1. 使用 rbenv 讀我檔案，在 Linux 發行版上安裝 rbenv。

  2. 按照 ruby-build 讀我檔案中的說明，安裝 rbenv 的 ruby-build 外掛程式。

進一步瞭解如何使用 rbenv 和 ruby-build 安裝不同版本的 Ruby。

Windows

如果您使用 Windows，建議您使用下列其中一種方法進行安裝：

安裝 Bundler

Bundler 是 Ruby Gem，可管理 Gemfile 檔案中定義的專案 Gem 依附元件。 Google Cloud文件中的 Ruby 範例會使用 Gemfile 檔案指定必要 Gem 和版本。

  1. 安裝 Bundler。

    gem install bundler

  2. 安裝 Gemfile 中定義的 gem 依附元件。

    bundle install

  3. 只使用 Gemfile 中定義的 Gem 執行 Ruby 專案。

    bundle exec ruby app.rb

如要進一步瞭解如何建立 Gemfile，請參閱 Bundler 說明文件。

安裝編輯器

主流的 Ruby 應用程式開發編輯器包括但不限於 (排名不分先後)：

這些編輯器 (有些需安裝外掛程式) 提供如語法反白顯示、智慧感知、程式碼自動完成及全面整合的偵錯功能，可大幅提高您的 Ruby 開發效率。

安裝 gcloud CLI

gcloud CLI 是一套工具，可 Google Cloud。其中包含 gcloud 和 bq，方便您從指令列存取 Compute Engine、Cloud Storage、BigQuery 和其他產品與服務。您可以利用這些工具進行互動操作，或是在自動化指令碼中執行這些工具。

舉例來說，以下是將 Ruby 網頁應用程式部署至 App Engine 彈性環境的簡單指令。部署完成後，App Engine 會嘗試使用 bundle exec ruby app.rb -p 8080 啟動應用程式：

gcloud app deploy

瞭解如何將 Ruby on Rails 應用程式部署至 App Engine 彈性環境。

安裝 Ruby 適用的 Cloud 用戶端程式庫

Ruby 適用的 Cloud 用戶端程式庫 是 Ruby 開發人員整合 Google Cloud服務的慣用方式。您可以為個別 API (如 Cloud Storage) 安裝套件，例如：

gem install google-cloud-storage

您也可以使用 Bundler，將 Gem 新增至 Gemfile 依附元件，例如：

bundle add google-cloud-storage

設定驗證方法

如要在本機開發環境中使用 Cloud 用戶端程式庫，請設定應用程式預設憑證。

如果您使用的是本機殼層，請為使用者帳戶建立本機驗證憑證： 

gcloud auth application-default login

如果您使用的是 Cloud Shell，則不必執行這項操作。

如果系統傳回驗證錯誤，且您使用的是外部識別資訊提供者 (IdP)，請確認您已 使用聯合身分登入 gcloud CLI。

詳情請參閱「進行驗證以使用用戶端程式庫」一文。

後續步驟