本教學課程說明如何準備本機電腦以進行 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,以使用最新功能並避免作業系統使用預設版本所造成的衝突。
- 安裝 XCode。
在終端機中使用以下指令安裝 XCode 的指令列工具:
xcode-select --install按照 homebrew 首頁上的操作說明安裝
homebrew。按照 rbenv readme 中的操作說明,使用
homebrew安裝rbenv。homebrew 安裝項目包括ruby-build外掛程式。
進一步瞭解如何使用 rbenv 和 ruby-build 安裝不同版本的 Ruby。
Linux
建議使用 rbenv 管理 Linux 發行版本上的 Ruby 安裝作業。rbenv 可管理電腦上安裝的多個 Ruby 版本,而名為 ruby-build 的 rbenv 外掛程式則可支援 rbenv 安裝特定版本的 Ruby。
在 Linux 發行版上安裝
rbenv,請參閱rbenv讀我檔案。按照
ruby-buildreadme 中的操作說明,安裝rbenv的ruby-build外掛程式。
進一步瞭解如何使用 rbenv 和 ruby-build 安裝不同版本的 Ruby。
Windows
如果您使用 Windows,建議您使用下列其中一種方法進行安裝:
安裝 Bundler
Bundler 是 Ruby Gem,可管理 Gemfile 檔案中定義的專案 Gem 依附元件。 Google Cloud說明文件中的 Ruby 範例使用 Gemfile 檔案來指定所需的 Gem 和版本。
安裝 Bundler。
gem install bundler
安裝
Gemfile中定義的gem依附元件。bundle install
僅使用
Gemfile中定義的 Gem 來執行 Ruby 專案。bundle exec ruby app.rb
如要進一步瞭解如何建立 Gemfile,請參閱 Bundler 說明文件。
安裝編輯器
主流的 Ruby 應用程式開發編輯器包括但不限於 (排名不分先後):
- Jon Skinner 的 Sublime Text
- GitHub 的 Atom
- JetBrains 的 RubyMine
- Vim 編輯器
這些編輯器 (有些需安裝外掛程式) 提供如語法反白顯示、智慧感知、程式碼自動完成及全面整合的偵錯功能,可大幅提高您的 Ruby 開發效率。
安裝 gcloud CLI
gcloud CLI 是一組適用於 Google Cloud的工具,包括 gcloud 和 bq。您可以從指令列執行這些指令,以存取 Compute Engine、Cloud Storage、BigQuery 和其他產品與服務。您可以利用這些工具進行互動操作,也可以使用自動化指令碼執行這些工具。
bundle exec ruby app.rb -p 8080 啟動應用程式:
gcloud app deploy
瞭解如何將 Ruby on Rails 應用程式部署至 App Engine 彈性環境。
安裝 Ruby 適用的 Cloud 用戶端程式庫
Ruby 開發人員常用 Ruby 適用的 Cloud 用戶端程式庫來整合服務。 Google Cloud您可以為個別 API (如 Cloud Storage) 安裝套件,例如:
gem install google-cloud-storage
您也可以使用 Bundler,並將 Gem 新增至 Gemfile 依附元件中,例如:
bundle add google-cloud-storage
設定驗證方法
如要在本機開發環境中使用 Cloud 用戶端程式庫,請設定應用程式預設憑證。
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
詳情請參閱「進行驗證以使用用戶端程式庫」一文。