Ruby 開発環境の設定

このチュートリアルでは、 Google Cloudで動作する Ruby アプリの開発など、Ruby 開発用にローカルマシンを準備する方法について説明します。このチュートリアルに従って、Ruby と関連ツールをインストールしてください。

Ruby の概要と Google Cloudで Ruby アプリを実行する方法については、Ruby と Google Cloudのクイックスタートをご覧ください。

目標

  • Ruby をインストールする。
  • Bundler をインストールする。
  • エディタのインストール（省略可）
  • Google Cloud CLI をインストールする
  • Ruby 用 Cloud クライアント ライブラリをインストールします。
  • 認証を設定する。

Ruby をインストールする

Ruby のインストール手順は、オペレーティング システムによって異なります。ローカル開発マシンで実行しているオペレーティング システム用のインストール ガイドに従ってください。このチュートリアルは、Ruby-lang に掲載されている Ruby の安定バージョンを対象としています（サポートが終了した EOL は除く）。

macOS

macOS で Ruby のインストールを管理するには、rbenv を使用することをおすすめします。rbenv は、マシンにインストールされている複数の Ruby バージョンを管理します。ruby-build という名前の rbenv プラグインは、指定されたバージョンの Ruby をインストールするためのサポートを rbenv に追加します。

macOS にはデフォルトで Ruby が含まれていますが、Ruby の最新バージョンを別途インストールし、最新の状態にすることをおすすめします。これにより、オペレーティング システムが使用するデフォルト バージョンとの競合を避けることができます。

  1. XCode をインストールします。

  2. ターミナルで次のコマンドを使用して、XCode のコマンドライン ツールをインストールします。

    xcode-select --install

  3. homebrewホームページの手順に沿ってhomebrewをインストールします。

  4. rbenv readme の手順に沿って、homebrew を使用して rbenv をインストールします。Homebrew のインストールには ruby-build プラグインが含まれています。

rbenv の使用と ruby-build を使用して、さまざまなバージョンの Ruby をインストールする方法について学習する。

Linux

Linux ディストリビューションでの Ruby のインストールを管理するには、rbenv を使用することをおすすめします。rbenv は、マシンにインストールされている複数の Ruby バージョンを管理します。ruby-build という rbenv プラグインは、指定されたバージョンの Ruby をインストールするためのサポートを rbenv に追加します。

  1. rbenv readme を使用して、Linux ディストリビューションに rbenv をインストールします。

  2. ruby-build readme の手順に沿って、rbenv の ruby-build プラグインをインストールします。

rbenv と ruby-build を使用してさまざまなバージョンの Ruby をインストールする方法の詳細を確認する。

Windows

Windows の場合は、次のいずれかをおすすめします。

Bundler をインストールする

Bundler は、Gemfile という名前のファイルで定義されたプロジェクトの gem 依存関係を管理する Ruby gem です。 Google Cloudのドキュメントの Ruby のサンプルでは、必要な gem とバージョンを指定するために Gemfile ファイルを使用しています。

  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

App Engine フレキシブル環境に Ruby on Rails アプリをデプロイする方法を学習します。

Ruby 用 Cloud クライアント ライブラリをインストールする

Ruby 用 Cloud クライアント ライブラリは、Ruby デベロッパーが Google Cloudサービスと統合するための慣用的な方法です。次のように、Cloud Storage などの API のパッケージを個別にインストールできます。

gem install google-cloud-storage

次のように、Bundler を使用して gem を Gemfile 依存関係に追加することもできます。

bundle add google-cloud-storage

認証を設定する

ローカル開発環境で Cloud クライアント ライブラリを使用するには、アプリケーションのデフォルト認証情報を設定します。

ユーザー アカウントのローカル認証情報を作成します。 

gcloud auth application-default login

認証エラーが返された場合は、 フェデレーション ID を使用して gcloud CLI にログインしていることを確認します。

詳細については、クライアント ライブラリを使用して認証するをご覧ください。

（省略可）オブザーバビリティ

Google Cloud Observability には、Ruby アプリケーションの動作、健全性、パフォーマンスの把握に役立つオブザーバビリティ サービスが含まれています。詳細については、Ruby 用 Google Cloud Observability をご覧ください。

次のステップ