Rails 5 での Cloud SQL for MySQL の使用

App Engine フレキシブル環境で動作する Ruby on Rails アプリの開発を始めます。作成したアプリはすべての Google プロダクトの基盤となる同じインフラストラクチャで動作するため、数人でも何百万人でも、すべてのユーザーに対応できるように確実にスケーリングできます。

このチュートリアルは、Rails ウェブ開発の知識があることを前提としています。ここでは、新しい Rails アプリを使用して Cloud SQL for MySQL を設定する方法について説明します。このチュートリアルは、Cloud SQL for MySQL を使用するように既存の Rails アプリでを構成するためのリファレンスとしても使用できます。

このチュートリアルには Ruby 2.3.4 以降が必要です。

始める前に

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

Google Cloud Console の [プロジェクトセレクタ] ページで、Google Cloud プロジェクトを選択または作成します。

プロジェクトセレクタに移動

Google Cloud プロジェクトで課金が有効になっていることを確認します。

Cloud SQL Admin API を有効にします。

API を有効にする

Google Cloud CLI をインストールします。

gcloud CLI を初期化するには:

gcloud init

Google Cloud Console の [プロジェクトセレクタ] ページで、Google Cloud プロジェクトを選択または作成します。

プロジェクトセレクタに移動

Google Cloud プロジェクトで課金が有効になっていることを確認します。

Cloud SQL Admin API を有効にします。

API を有効にする

Google Cloud CLI をインストールします。

gcloud CLI を初期化するには:

gcloud init

Cloud SQL for MySQL インスタンスを準備する

このチュートリアルで使用する Cloud SQL for MySQL インスタンスをセットアップします。

第 2 世代のインスタンスを作成します。このチュートリアルでは、インスタンスの名前は rails-cloudsql-instance です。
インスタンス内にデータベースを作成します。このチュートリアルでは、本番環境のデータベースの名前は cat_list_production です。
インスタンスの root ユーザーパスワードを設定します。

Rails 用のローカル環境のセットアップ

このチュートリアルのために、以下のようにローカル環境をセットアップします。

Ruby バージョン 2.3.4 以降をインストールします。
Rails 5 gem をインストールします。
Bundler gem をインストールします。

Rails とその依存関係のインストールの詳細については、公式の Rails スタートガイドをご覧ください。

前提条件を満たしたら、Cloud SQL for MySQL を使用して Rails アプリを作成し、デプロイできます。以下のセクションでは、Cloud SQL for MySQL の構成、接続、アプリのデプロイについて説明します。

猫をリストするための新しいアプリを作成する

rails new コマンドを実行して新しい Rails アプリを作成します。このアプリは Cloud SQL for MySQL に猫のリストを保存します。
```
rails new cat_sample_app
```
生成された Rails アプリのあるディレクトリに移動します。
```
cd cat_sample_app
```

アプリケーションをローカルで実行する

ローカルのパソコン上で新しい Rails アプリケーションを実行するには:

Bundler を使用して依存関係をインストールします。
```
bundle install
```
ローカルウェブサーバーを起動します。
```
bundle exec bin/rails server
```
ウェブブラウザで http://localhost:3000/ にアクセスします。

「Yay! You're on Rails!メッセージがアプリからページに表示されます。

実行中の新しい Rails アプリのスクリーンショット

猫リストのスキャフォールディングを生成する

Cat という名前のリソースのスキャフォールディングを生成します。これは、名前と年齢を含む猫のリストを作成するために使用されます。

スキャフォールディングを生成します。

bundle exec rails generate scaffold Cat name:string age:integer

このコマンドは、Cat リソースのモデル、コントローラ、ビューを生成します。

invoke  active_record
create    db/migrate/20170804210744_create_cats.rb
create    app/models/cat.rb
invoke    rspec
create      spec/models/cat_spec.rb
invoke  resource_route
route    resources :cats
invoke  scaffold_controller
create    app/controllers/cats_controller.rb
invoke    erb
create      app/views/cats
create      app/views/cats/index.html.erb
create      app/views/cats/edit.html.erb
create      app/views/cats/show.html.erb
create      app/views/cats/new.html.erb
create      app/views/cats/_form.html.erb
invoke    jbuilder
create      app/views/cats/index.json.jbuilder
create      app/views/cats/show.json.jbuilder
create      app/views/cats/_cat.json.jbuilder
invoke  assets
invoke    js
create      app/assets/javascripts/cats.js
invoke    scss
create      app/assets/stylesheets/cats.scss
invoke  scss
create    app/assets/stylesheets/scaffolds.scss

config/routes.rb ファイルを開いて、生成された内容を確認します。

appengine/rails-cloudsql-mysql/config/routes.rb

GitHub で表示

Rails.application.routes.draw do
  resources :cats
  get 'cats/index'
  # For details on the DSL available within this file, see http://guides.rubyonrails.org/routing.html

end

ファイルに root 'cats#index' を追加します。

appengine/rails-cloudsql-mysql/config/routes.rb

GitHub で表示

Rails.application.routes.draw do
  resources :cats
  get 'cats/index'

  # For details on the DSL available within this file, see http://guides.rubyonrails.org/routing.html
  root 'cats#index'
end

ファイルを保存して閉じます。
前述の説明のとおりに Rails アプリをテストします。

App Engine での Cloud SQL for MySQL の使用

Cloud SQL for MySQL は、Google Cloud でリレーショナル MySQL データベースを設定、メンテナンス、運用、管理するためのフルマネージドデータベースサービスです。つまり、Rails アプリで Cloud SQL を他のリレーショナルデータベースと同じように使用できます。

Cloud SQL for MySQL をセットアップする

本番環境の Rails アプリで Cloud SQL の使用を開始するには:

mysql2gemとappenginegemをGemfileファイルに追加します。
```
bundle add mysql2
bundle add appengine
```
Rails Gemfile に、次の gem エントリが追加されます。

appengine/rails-cloudsql-mysql/Gemfile

GitHub で表示
```
# Added at 2017-08-07 11:54:06 -0700 by USER:
gem "mysql2", "~> 0.4.8"

# Added at 2017-08-07 11:54:12 -0700 by USER:
gem "appengine", "~> 0.4.1"
```
注: appengine gem には、本番環境でのデータベースの移行を実行するための Rake タスクが用意されています。

Rails アプリを Cloud SQL に接続するように構成するため、config/database.yml ファイルを開きます。次のような SQLite 用のボイラープレートデータベース設定が表示されます。

appengine/rails-cloudsql-mysql/config/boilerplate.database.yml

GitHub で表示

# SQLite version 3.x
#   gem install sqlite3
#
#   Ensure the SQLite 3 gem is defined in your Gemfile
#   gem 'sqlite3'
#
default: &default
  adapter: sqlite3
  pool: 5
  timeout: 5000

development:
  <<: *default
  database: db/development.sqlite3

# Warning: The database defined as "test" will be erased and
# re-generated from your development database when you run "rake".
# Do not set this db to the same as development or production.
test:
  <<: *default
  database: db/test.sqlite3

production:
  <<: *default
  database: db/production.sqlite3

App Engine 本番環境用の Cloud SQL インスタンス接続名を構成します。
1. インスタンス接続名を取得します。
```
gcloud sql instances describe rails-cloudsql-instance
```
2. connectionNameの横にある値をコピーします。
database.yml 本番環境のデータベース構成を次のように変更します。

appengine/rails-cloudsql-mysql/config/database.yml

GitHub で表示
```
production:
  adapter: mysql2
  pool: 5
  timeout: 5000
  username: "[YOUR_MYSQL_USERNAME]"
  password: "[YOUR_MYSQL_PASSWORD]"
  database: "cat_list_production"
  socket:   "/cloudsql/[YOUR_INSTANCE_CONNECTION_NAME]"
```
ここで
- [YOUR_MYSQL_USERNAME] は MySQL のユーザー名を表します。
- [YOUR_MYSQL_PASSWORD] は MySQL のパスワードを表します。
- [YOUR_INSTANCE_CONNECTION_NAME] は、前の手順でコピーしたインスタンス接続名を表します。

これで、App Engine フレキシブル環境にデプロイしたときに Rails アプリが Cloud SQL を使用するようセットアップされました。

App Engine フレキシブル環境へのアプリのデプロイ

App Engine フレキシブル環境では、app.yaml というファイルを使用してアプリのデプロイ構成を記述します。このファイルが存在しない場合は、gcloud CLI によりデプロイ構成が自動的に推測されます。しかし、Rails の秘密鍵と Cloud SQL に必要な構成設定を提供するためにこのファイルを定義してください。

サンプルアプリケーションを App Engine にデプロイするように構成するには、Rails アプリケーションディレクトリのルートにapp.yamlという名前の新しいファイルを作成し、次の行を追加します。

appengine/rails-cloudsql-mysql/app.yaml

GitHub で表示

entrypoint: bundle exec rackup --port $PORT
env: flex
runtime: ruby

`app.yaml` ファイルで Rails 秘密鍵を構成する

Rails アプリが production 環境にデプロイされたときにユーザーセッションデータの保護に使用される秘密鍵を環境変数 SECRET_KEY_BASE に設定します。この環境変数は、Rails アプリの config/secrets.yml ファイルから読み込まれます。

新しい秘密鍵を生成します。
```
bundle exec bin/rails secret
```
生成された秘密鍵をコピーします。
前の手順で作成した app.yaml ファイルを開き、env_variables セクションを追加します。env_variables は、App Engine フレキシブル環境の環境変数を定義します。app.yaml ファイルは次の例のようになります。[SECRET_KEY] は実際の秘密鍵に置き換えてください。

appengine/rails-cloudsql-mysql/app.yaml

GitHub で表示
```
entrypoint: bundle exec rackup --port $PORT
env: flex
runtime: ruby

env_variables:
  SECRET_KEY_BASE: [SECRET_KEY]
```

`app.yaml` ファイルで Cloud SQL インスタンスを構成します。

次に、app.yaml 構成ファイルに Cloud SQL インスタンス接続名を指定することで、指定した Cloud SQL インスタンスを使用するように App Engine フレキシブル環境を構成します。

app.yaml ファイルを開き、beta_settings という名前の新しいセクションを追加します。
インスタンス接続名を値として、ネストされたパラメータ cloud_sql_instances を定義します。

注: Cloud SQL インスタンス接続名を取得するには、gcloud sql instances describe rails-cloudsql-instance を実行します。
app.yaml は次のようになります。

appengine/rails-cloudsql-mysql/app.yaml

GitHub で表示
```
entrypoint: bundle exec rackup --port $PORT
env: flex
runtime: ruby

env_variables:
  SECRET_KEY_BASE: [SECRET_KEY]

beta_settings:
  cloud_sql_instances: [YOUR_INSTANCE_CONNECTION_NAME]
```

App Engine フレキシブル環境アプリを作成する

アプリを初めてデプロイする場合は、App Engine フレキシブル環境アプリを作成し、Rails アプリを実行するリージョンを選択する必要があります。

App Engine アプリを作成します。
```
gcloud app create
```
Ruby アプリの App Engine フレキシブル環境をサポートするリージョンを選択します。リージョンとゾーンの詳細については、こちらをご覧ください。

新しいバージョンをデプロイする

次に、現在のデフォルトバージョンからのトラフィックをリダイレクトせずに、app.yaml ファイルに記述された新しいバージョンの Rails アプリをデプロイします。

Rails アセットをプリコンパイルします。
```
bundle exec bin/rails assets:precompile
```
アセットのコンパイルが完了したら、アプリの新しいバージョンをデプロイします。
```
gcloud app deploy --no-promote
```
デプロイメントが完了するまで数分かかることがあります。成功メッセージが表示されるのを待ちます。デプロイされたバージョンは、App Engine のバージョンリストで確認できます。

新しいバージョンをデプロイした後、この新しいバージョンにアクセスしようとすると、データベースの移行がまだ終わっていないため、次のエラーメッセージが表示されます。

新しい Rails アプリのエラーメッセージのスクリーンショット

`appengine` gem に必要な権限を付与する

次に、appengine gem を使用して本番環境データベースの移行を行うために、cloudbuild サービスアカウントにアクセス権を付与します。

使用可能なプロジェクトを一覧表示します。
```
gcloud projects list
```
出力結果からアプリのデプロイに使用するプロジェクトを探し、そのプロジェクト番号をコピーします。
データベースの移行を行うために、ロール roles/editor のプロジェクト IAM ポリシーに新しいメンバーを追加します。[YOUR-PROJECT-ID] は実際の Google Cloud プロジェクト ID に置き換え、[PROJECT_NUMBER] は前のステップでコピーしたプロジェクト番号に置き換えます。
```
gcloud projects add-iam-policy-binding [YOUR-PROJECT-ID] \
  --member=serviceAccount:[PROJECT_NUMBER]@cloudbuild.gserviceaccount.com \
  --role=roles/editor
```

Rails データベースを移行する

Rails データベース移行は、SQL 構文を直接使わずにデータベースのスキーマを更新するために使用されます。次に、cat_list_production データベースを移行します。

appengine gem には、Rake タスク appengine:exec が用意されており、本番の App Engine フレキシブル環境にデプロイされた最新のアプリに対してコマンドを実行します。

本番環境で Cloud SQL for MySQL cat_list_production データベースを移行します。

bundle exec rake appengine:exec -- bundle exec rake db:migrate

次のような出力が表示されます。

---------- EXECUTE COMMAND ----------
bundle exec rake db:migrate
Debuggee gcp:787021104993:8dae9032f8b02004 successfully registered
== 20170804210744 CreateCats: migrating =======================================
-- create_table(:cats)
   -> 0.0219s
== 20170804210744 CreateCats: migrated (0.0220s) ==============================

---------- CLEANUP ----------

データベースの移行を確認するため、次のアドレスにアクセスします。
```
[YOUR-VERSION]-dot-[YOUR-PROJECT-ID].appspot.com
```
注: バージョンのリストを取得するには、gcloud app versions list を使用します。最後の default サービスバージョン項目が最新のデプロイメントです。

デプロイメントが成功すると、次のような出力が表示されます。

実行中の新しい Rails アプリのスクリーンショット

トラフィックを新しいバージョンに移行する

最後に、次のコマンドを使用して、新しくデプロイしたバージョンにトラフィックを誘導します。

gcloud app services set-traffic default --splits [YOUR-VERSION]=1

これで、次のアドレスからアプリの新しいバージョンにアクセスできます。

https://[YOUR-PROJECT-ID].appspot.com

App Engine のログを見る

Rails アプリをデプロイした後、ログを見ることができます。アプリログを読むには、Google Cloud Console にあるログエクスプローラを使用します。

詳細については、gcloud CLI を使用したログの読み取りをご覧ください。

リソースのクリーンアップ

チュートリアルが終了したら、作成したリソースをクリーンアップして、割り当ての使用を停止し、課金されないようにできます。次のセクションで、リソースを削除または無効にする方法を説明します。

プロジェクトの削除

課金をなくす最も簡単な方法は、チュートリアル用に作成したプロジェクトを削除することです。

プロジェクトを削除するには:

注意: プロジェクトを削除すると、次のような影響があります。

プロジェクト内のすべてのものが削除されます。このドキュメントのタスクで既存のプロジェクトを使用した場合、それを削除すると、そのプロジェクトで行った他の作業もすべて削除されます。
カスタムプロジェクト ID が失われます。このプロジェクトを作成したときに、将来使用するカスタムプロジェクト ID を作成した可能性があります。そのプロジェクト ID を使用した URL（たとえば、appspot.com）を保持するには、プロジェクト全体ではなくプロジェクト内の選択したリソースだけを削除します。

複数のアーキテクチャ、チュートリアル、クイックスタートを実施する予定がある場合は、プロジェクトを再利用すると、プロジェクトの割り当て上限を超えないようにすることができます。

Google Cloud コンソールで、[リソースの管理] ページに移動します。
[リソースの管理] に移動
プロジェクトリストで、削除するプロジェクトを選択し、[削除] をクリックします。
ダイアログでプロジェクト ID を入力し、[シャットダウン] をクリックしてプロジェクトを削除します。

App Engine のバージョンの削除

アプリのバージョンを削除するには:

Google Cloud コンソールで、App Engine の [バージョン] ページに移動します。
[バージョン] に移動
デフォルト以外で削除するアプリのバージョンのチェックボックスをオンにします。
注: App Engine アプリのデフォルトバージョンを削除する唯一の方法は、プロジェクトを削除することです。ただし、Google Cloud コンソールでデフォルトバージョンを停止することもできます。このアクションによって、バージョンに関連付けられているすべてのインスタンスがシャットダウンします。これらのインスタンスは、必要に応じてあとで再起動できます。

App Engine スタンダード環境では、お使いのアプリに手動スケーリングまたは基本スケーリングがある場合、デフォルトバージョンを停止させることができます。
アプリのバージョンを削除するには、[削除] をクリックします。

Cloud SQL インスタンスの削除

Cloud SQL インスタンスを削除するには:

Google Cloud コンソールで、[インスタンス] ページに移動します。
[インスタンス] に移動
削除する SQL インスタンスの名前をクリックします。
インスタンスを削除するには、 [削除] をクリックして、指示に従います。

次のステップ

App Engine フレキシブル環境で Ruby Bookshelf サンプルアプリを実行する方法を学習する。
Compute Engine で Ruby Bookshelf サンプルアプリを実行する方法を学習する。
Google Kubernetes Engine で Ruby Bookshelf サンプルアプリを実行する方法を学習する。

Rails 5 での Cloud SQL for MySQL の使用

始める前に

Cloud SQL for MySQL インスタンスを準備する

Rails 用のローカル環境のセットアップ

猫をリストするための新しいアプリを作成する

アプリケーションをローカルで実行する

猫リストのスキャフォールディングを生成する

App Engine での Cloud SQL for MySQL の使用

Cloud SQL for MySQL をセットアップする

App Engine フレキシブル環境へのアプリのデプロイ

app.yaml ファイルで Rails 秘密鍵を構成する

app.yaml ファイルで Cloud SQL インスタンスを構成します。

App Engine フレキシブル環境アプリを作成する

新しいバージョンをデプロイする

appengine gem に必要な権限を付与する

Rails データベースを移行する

トラフィックを新しいバージョンに移行する

App Engine のログを見る

リソースのクリーンアップ

プロジェクトの削除

App Engine のバージョンの削除

Cloud SQL インスタンスの削除

次のステップ

`app.yaml` ファイルで Rails 秘密鍵を構成する

`app.yaml` ファイルで Cloud SQL インスタンスを構成します。

`appengine` gem に必要な権限を付与する