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 プラグインによって rbenv にサポートが追加され、Ruby の特定バージョンがインストールされます。

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

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

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

    xcode-select --install

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

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

複数のバージョンの Ruby をインストールするには、rbenv の使用と ruby-build についてさらに学習してください。

Linux

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

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

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

複数のバージョンの Ruby をインストールするには、rbenv の使用とruby-buildについてさらに学習してください。

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

Ruby on Rails アプリを App Engine フレキシブル環境にデプロイする方法については、こちらをご覧ください。

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

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

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.

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

次のステップ