Cloud Run から Cloud SQL for SQL Server に接続する

Cloud Run から Cloud SQL for SQL Server に接続する

MySQL   |  PostgreSQL   |  SQL Server

Google Cloud コンソールとクライアント アプリケーションを使用して、SQL Server インスタンスに接続された Cloud Run にサンプルアプリをデプロイする方法を学習します。

すべてのステップを適切なタイミングで完了した場合、通常、このクイックスタートで作成されるリソースにかかる費用は 1 ドル（USD）未満です。

始める前に

注: プロジェクトに使用する名前は 4～30 文字にする必要があります。名前を入力すると、フォームにプロジェクト ID の候補が示されます。これは編集できます。プロジェクト ID は 6～30 文字で、先頭を小文字にします。残りの文字には、ダッシュ、小文字、数字を使用できますが、最後の文字にダッシュは使えません。

1. Google Cloud アカウントにログインします。Google Cloud を初めて使用する場合は、アカウントを作成して、実際のシナリオでの Google プロダクトのパフォーマンスを評価してください。新規のお客様には、ワークロードの実行、テスト、デプロイができる無料クレジット $300 分を差し上げます。

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

   注: この手順で作成するリソースをそのまま保持する予定でない場合、既存のプロジェクトを選択するのではなく、新しいプロジェクトを作成してください。チュートリアルの終了後にそのプロジェクトを削除すれば、プロジェクトに関連するすべてのリソースを削除できます。

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

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

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

   注: この手順で作成するリソースをそのまま保持する予定でない場合、既存のプロジェクトを選択するのではなく、新しいプロジェクトを作成してください。チュートリアルの終了後にそのプロジェクトを削除すれば、プロジェクトに関連するすべてのリソースを削除できます。

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

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

6. Cloud Run で Cloud SQL サンプルアプリを実行するために必要な Cloud APIs を有効にします。

   コンソール

   [API を有効にする] をクリックして、このクイックスタートで必要な API を有効にします。

   API を有効にする

   これにより、次の API が有効になります。

   • Compute Engine API
   • Cloud SQL Admin API
   • Cloud Run API
   • Container Registry API
   • Cloud Build API
   • Service Networking API

   gcloud

   次のボタンをクリックして Cloud Shell を開きます。これにより、ブラウザから Google Cloud リソースにコマンドラインで直接アクセスできます。Cloud Shell を使用して、このクイックスタートで紹介する gcloud コマンドを実行できます。

   Cloud Shell を開く

   Cloud Shell を使用して次の gcloud コマンドを実行します。

   gcloud services enable compute.googleapis.com sqladmin.googleapis.com run.googleapis.com \
   containerregistry.googleapis.com cloudbuild.googleapis.com servicenetworking.googleapis.com

   このコマンドにより、次の API が有効になります。

   • Compute Engine API
   • Cloud SQL Admin API
   • Cloud Run API
   • Container Registry API
   • Cloud Build API
   • Service Networking API

Cloud SQL の設定

Cloud SQL インスタンスを作成する

パブリック IP

Cloud Run では、パブリック IP 経由で Cloud SQL for SQL Server に接続することはできません。代わりにプライベート IP を使用してください。

プライベート IP

コンソール

IP アドレス範囲を割り振り、プライベート接続を作成して Cloud SQL のプライベート サービス アクセスを構成する

1. Google Cloud コンソールの [VPC ネットワーク] ページに移動します。

   [VPC ネットワーク] に移動

2. default VPC ネットワークを選択します。
3. [プライベート サービス接続] タブを選択します。
4. [サービスに割り当てられた IP 範囲] を選択します。
5. [IP 範囲の割り当て] をクリックします。
6. 割り振られた範囲の [名前] には google-managed-services-default を指定します。
7. IP 範囲の [自動] オプションを選択し、接頭辞の長さを 16 として指定します。
8. [割り当て] をクリックして、割り振る範囲を作成します。
9. default VPC ネットワークの [サービスへのプライベート接続] タブを選択します。
10. ネットワークとサービス プロデューサーとの間にプライベート接続を作成するには、[接続の作成] をクリックします。
11. [割り当て] で [google-managed-services-default] を選択します。
12. [接続] をクリックして接続を作成します。

プライベート IP アドレスと SSL を有効にしてインスタンスを作成する

1. Google Cloud コンソールで Cloud SQL の [インスタンス] ページに移動します。

   Cloud SQL の [インスタンス] に移動

2. [インスタンスを作成] をクリックします。
3. [SQL Server] をクリックします。
4. [インスタンス ID] に「quickstart-instance」と入力します。
5. SQL Server ユーザーのパスワードを入力します。このパスワードはこの後で使用できるように保存してください。
6. [リージョンとゾーンの可用性の選択] で [シングルゾーン] オプションをクリックします。
7. [構成オプションを表示] をクリックして開きます。
8. [マシンタイプ] で [軽量] を選択します。
9. [接続] で、[プライベート IP] を選択します。
10. [ネットワーク] プルダウン メニューから [デフォルト] を選択します。
11. プライベート IP のみを使用するインスタンスを作成するには、[パブリック IP] チェックボックスをオフにします。
12. [インスタンスを作成] をクリックし、インスタンスが初期化されて起動するまで待ちます。
13. [接続] をクリックします。
14. [セキュリティ] で [SSL 接続のみ許可] を選択し、SSL 接続を有効にします。
15. [SSL 接続のみ許可] ダイアログで [保存して再起動] をクリックし、インスタンスが再起動するのを待ちます。

gcloud

IP アドレス範囲を割り振り、プライベート接続を作成して Cloud SQL のプライベート サービス アクセスを構成する

1. gcloud compute addresses create コマンドを実行して、IP アドレス範囲を割り振ります。

   gcloud compute addresses create google-managed-services-default \
   --global --purpose=VPC_PEERING --prefix-length=16 \
   --description="peering range for Google" --network=default

2. gcloud services vpc-peerings connect コマンドを実行して、割り振られた IP アドレス範囲へのプライベート接続を作成します。YOUR_PROJECT_ID は、プロジェクトのプロジェクト ID に置き換えます。

   gcloud services vpc-peerings connect --service=servicenetworking.googleapis.com \
   --ranges=google-managed-services-default --network=default \
   --project=YOUR_PROJECT_ID

プライベート IP アドレスと SSL を有効にしてインスタンスを作成する

1. 次のコマンドを実行する前に、DB_ROOT_PASSWORD をデータベース ユーザーのパスワードに置き換えます。

必要に応じて、次のパラメータの値を変更します。

• --database-version: データベース エンジンのタイプとバージョン。指定しない場合は、API のデフォルトが使用されます。現在利用可能なバージョンを確認するには、gcloud database versions ドキュメントをご覧ください。
• --cpu: マシン内のコア数。
• --memory: マシンに搭載するメモリ量を示す整数。サイズの単位を指定できます（例: 3,072 MB、9 GB）。単位を指定しない場合、GB が使用されます。
• --region: インスタンスのリージョンのロケーション（asia-east1、us-east1 など）。指定しない場合は、デフォルトで us-central1 が使用されます。リージョンの一覧をご覧ください。

gcloud sql instances create コマンドを実行して、プライベート IP アドレスを持つ Cloud SQL インスタンスを作成します。

gcloud sql instances create quickstart-instance \
--database-version=SQLSERVER_2017_STANDARD \
 --cpu=1 \
 --memory=4GB \
 --region=us-central \
 --root-password=DB_ROOT_PASSWORD \
 --no-assign-ip \
--network=default

2. gcloud sql instances patch コマンドを実行して、インスタンスで SSL 接続のみ許可します。

gcloud sql instances patch quickstart-instance --require-ssl

データベースの作成

コンソール

1. Google Cloud コンソールで Cloud SQL の [インスタンス] ページに移動します。

   Cloud SQL の [インスタンス] に移動

2. [quickstart-instance] を選択します。
3. SQL ナビゲーション メニューから [データベース] を選択します。
4. [データベースを作成] をクリックします。
1. [新しいデータベース] ダイアログ ボックスの [データベース名] フィールドに「quickstart-db」と入力します。
2. [作成] をクリックします。

gcloud

gcloud sql databases create コマンドを実行してデータベースを作成します。

gcloud sql databases create quickstart-db --instance=quickstart-instance

サンプルアプリを Cloud Run にデプロイする

Cloud Run サービス アカウントを構成する

Cloud Run で使用するサービス アカウントが、Cloud SQL に接続する権限を持つ Cloud SQL Client ロールを持つように構成します。

コンソール

1. Google Cloud コンソールの [IAM] ページに移動します。

   [IAM] に移動

2. Compute Engine のデフォルトのサービス アカウントという名前のサービス アカウントの鉛筆アイコンをクリックします。
3. [別のロールを追加] をクリックします。
4. Cloud SQL クライアントという名前のロールを追加します。
5. [保存] をクリックします。

gcloud

1. 次の gcloud コマンドを実行して、プロジェクトのサービス アカウントのリストを取得します。

   gcloud iam service-accounts list

2. Compute Engine サービス アカウントのメールアドレスをコピーします。
3. 次のコマンドを実行して、Cloud SQL クライアントのロールを Compute Engine サービス アカウントに追加します。

   gcloud projects add-iam-policy-binding YOUR_PROJECT_ID \
     --member="serviceAccount:SERVICE_ACCOUNT_EMAIL" \
     --role="roles/cloudsql.client"

Cloud SQL サンプルアプリを構成する

Cloud SQL インスタンス、データベース、クライアント権限を持つサービス アカウントを使用して、Cloud SQL インスタンスに接続するようにサンプル アプリケーションを構成できるようになりました。

パブリック IP

Cloud Run では、パブリック IP 経由で Cloud SQL for SQL Server に接続することはできません。プライベート IP を使用してください。

プライベート IP

プライベート IP パスの場合、アプリケーションはサーバーレス VPC アクセスを介してインスタンスに直接接続します。この方法では、Cloud SQL Auth Proxy を使用せずに TCP ソケットを使用して Cloud SQL インスタンスに直接接続します。

Go

SSL サーバー証明書を作成してダウンロードする

1. Google Cloud Console で、Cloud SQL の [インスタンス] ページに移動します。

   Cloud SQL の [インスタンス] に移動

2. quickstart-instance をクリックして、[概要] ページを表示します。
3. [接続] タブをクリックします。
4. [セキュリティ] セクションの [証明書をダウンロード] をクリックして、SSL サーバー証明書をダウンロードします。

プライベート IP を使用したインスタンスへの接続用にサーバーレス VPC 接続を作成する

1. Google Cloud Console で、[サーバーレス VPC アクセス] - [コネクタの作成] ページに移動します。

   サーバーレス VPC コネクタを作成する

2. [名前] に「quickstart-connector」と入力します。
3. [ネットワーク] プルダウン メニューから [デフォルト] を選択します。
4. [サブネット] プルダウン メニューから [カスタム IP 範囲] を選択します。
5. [IP 範囲] 入力ボックスに「10.8.0.0」と入力します。
6. [作成] をクリックします。

SSL サーバー証明書を使用してサンプルアプリを構築する

1. Cloud Shell エディタで、サンプルアプリのソースコードを開きます。

   Cloud Shell エディタを開く
2. [Cloud Shell で開く] ダイアログで、[確認] をクリックしてサンプルアプリのコードをダウンロードし、Cloud Shell エディタでサンプルアプリのディレクトリを開きます。
3. SSL サーバー証明書ファイルを certs フォルダにアップロードします。
   1. Cloud Shell エディタで certs フォルダを右クリックし、[ファイルをアップロード] を選択します。
   2. ローカルマシンで server-ca.pem ファイルを選択します。
   3. SSL サーバー証明書ファイルを選択したら、[開く] をクリックして Cloud Shell エディタにファイルをアップロードするプロセスを完了します。
4. Cloud Shell で次のコマンドを実行して、Docker コンテナをビルドし、Container Registry に公開します。YOUR_PROJECT_ID は、プロジェクトのプロジェクト ID に置き換えます。

   gcloud builds submit --tag gcr.io/YOUR_PROJECT_ID/run-sql
   

Java

SSL サーバー証明書を作成してダウンロードする

Java ユーザーの場合、コネクタはすでに安全な接続を提供しているため、SSL サーバー証明書の作成とダウンロードは不要です。

プライベート IP を使用したインスタンスへの接続用にサーバーレス VPC 接続を作成する

1. Google Cloud Console で、[サーバーレス VPC アクセス] - [コネクタの作成] ページに移動します。

   サーバーレス VPC コネクタを作成する

2. [名前] に「quickstart-connector」と入力します。
3. [ネットワーク] プルダウン メニューから [デフォルト] を選択します。
4. [サブネット] プルダウン メニューから [カスタム IP 範囲] を選択します。
5. [IP 範囲] 入力ボックスに「10.8.0.0」と入力します。
6. [作成] をクリックします。

サンプルアプリを構築する

1. Cloud Shell エディタで、サンプルアプリのソースコードを開きます。

   Cloud Shell エディタを開く
2. [Cloud Shell で開く] ダイアログで、[確認] をクリックしてサンプルアプリのコードをダウンロードし、Cloud Shell エディタでサンプルアプリのディレクトリを開きます。
3. Cloud Shell で次のコマンドを実行して、Docker コンテナをビルドし、Container Registry に公開します。YOUR_PROJECT_ID は、プロジェクトのプロジェクト ID に置き換えます。

   mvn clean package com.google.cloud.tools:jib-maven-plugin:2.8.0:build \
    -Dimage=gcr.io/YOUR_PROJECT_ID/run-sql -DskipTests
   

Python

SSL サーバー証明書を作成してダウンロードする

1. Google Cloud Console で、Cloud SQL の [インスタンス] ページに移動します。

   Cloud SQL の [インスタンス] に移動

2. quickstart-instance をクリックして、[概要] ページを表示します。
3. [接続] タブをクリックします。
4. [セキュリティ] セクションの [証明書をダウンロード] をクリックして、SSL サーバー証明書をダウンロードします。

プライベート IP を使用したインスタンスへの接続用にサーバーレス VPC 接続を作成する

1. Google Cloud Console で、[サーバーレス VPC アクセス] - [コネクタの作成] ページに移動します。

   サーバーレス VPC コネクタを作成する

2. [名前] に「quickstart-connector」と入力します。
3. [ネットワーク] プルダウン メニューから [デフォルト] を選択します。
4. [サブネット] プルダウン メニューから [カスタム IP 範囲] を選択します。
5. [IP 範囲] 入力ボックスに「10.8.0.0」と入力します。
6. [作成] をクリックします。

SSL サーバー証明書を使用してサンプルアプリを構築する

1. Cloud Shell エディタで、サンプルアプリのソースコードを開きます。

   Cloud Shell エディタを開く
2. [Cloud Shell で開く] ダイアログで、[確認] をクリックしてサンプルアプリのコードをダウンロードし、Cloud Shell エディタでサンプルアプリのディレクトリを開きます。
3. SSL サーバー証明書ファイルを certs フォルダにアップロードします。
   1. Cloud Shell エディタで certs フォルダを右クリックし、[ファイルをアップロード] を選択します。
   2. ローカルマシンで server-ca.pem ファイルを選択します。
   3. SSL サーバー証明書ファイルを選択したら、[開く] をクリックして Cloud Shell エディタにファイルをアップロードするプロセスを完了します。
4. Cloud Shell で次のコマンドを実行して、Docker コンテナをビルドし、Container Registry に公開します。YOUR_PROJECT_ID は、プロジェクトのプロジェクト ID に置き換えます。

   gcloud builds submit --tag gcr.io/YOUR_PROJECT_ID/run-sql
   

サンプルアプリをデプロイする

サンプルを Cloud Run にデプロイする手順は、Cloud SQL インスタンスに割り当てられた IP アドレスの種類によって異なります。

パブリック IP

Cloud Run では、パブリック IP 経由で Cloud SQL for SQL Server に接続することはできません。プライベート IP を使用してください。

プライベート IP

コンソール

1. Google Cloud コンソールで [Cloud Run] ページに移動します。

   [Cloud Run] に移動

2. [サービスを作成] をクリックします。

3. 既存のコンテナ イメージからデプロイするオプションを選択したままにして、[選択] をクリックし、前の手順で作成した gcr.io/YOUR_PROJECT_ID/run-sql コンテナ イメージを指定します。
4. [サービス名] に「quickstart-service」と入力します。
5. [認証] セクションで、Allow unauthenticated invocations オプションを選択します。
6. [コンテナ、変数とシークレット、接続、セキュリティ] セクションを開きます。
7. [環境変数] で [変数を追加] をクリックして、次の環境変数を作成します。次のように環境変数の値を設定します。
• DB_NAME: quickstart-db に設定します。
• DB_USER: sqlserver に設定します。
• DB_PASS: Cloud SQL インスタンスの作成で作成した sqlserver ユーザーのパスワードに設定します。
• INSTANCE_CONNECTION_NAME: Google Cloud コンソールの [Cloud SQL インスタンス] ページに表示されるインスタンスの接続名に置き換えます。
• DB_PORT: 1433 に設定します。
注: Java ユーザーの場合、コネクタは安全な接続をすでに提供しているため、INSTANCE_HOST、DB_ROOT_CERT、PRIVATE_IP 環境変数を設定しないでください。
• INSTANCE_HOST: Cloud SQL インスタンスの [概要] ページの説明に従って、インスタンスのプライベート IP アドレスに設定します。
• DB_ROOT_CERT: certs/server-ca.pem に設定します。
• PRIVATE_IP: TRUE に設定します。

8. Cloud SQL への接続を有効にします。

   1. [接続] をクリックします。
   2. [Cloud SQL 接続] セクションの [接続を追加] をクリックします。
   3. 先ほど作成した quickstart-instance Cloud SQL インスタンスを選択します。
   4. [VPC ネットワーク] プルダウン メニューから default: Serverless VPC Access Connector "quickstart-connector" を選択します。
   5. [すべてのトラフィックを VPC コネクタ経由でルーティングする] オプションを選択します。

9. [作成] をクリックして、Cloud Run サービスの作成を完了します。

10. Cloud Run サービスをデプロイすると、[サービスの詳細] ページの一番上に、実行中のサービスの URL が表示されます。[URL] リンクをクリックして、Cloud SQL に接続された Cloud Run にデプロイされたサンプルアプリを確認します。

    

gcloud

1. 次のコマンドを実行する前に、次のように置き換えます。

• YOUR_PROJECT_ID: プロジェクト ID。

• INSTANCE_CONNECTION_NAME: Google Cloud コンソールの [Cloud SQL インスタンス] ページに表示されるインスタンスの接続名に置き換えます。

• DB_PASS: Cloud SQL インスタンスを作成するで作成した sqlserver ユーザーのパスワードに置き換えます。
• INSTANCE_HOST: インスタンスのプライベート IP アドレスに置き換えます。インスタンスのプライベート IP アドレスが表示されている Cloud SQL インスタンスの [概要] ページに移動します。

次のように gcloud run deploy コマンドを実行して、Cloud Run サービスを作成します。

gcloud run deploy run-sql --image gcr.io/YOUR_PROJECT_ID/run-sql \
  --add-cloudsql-instances INSTANCE_CONNECTION_NAME \
  --vpc-connector="quickstart-connector" --vpc-egress=all-traffic \
  --set-env-vars DB_NAME="quickstart-db" \
  --set-env-vars DB_USER="sqlserver" \
  --set-env-vars DB_PASS="DB_PASS" \
  --set-env-vars INSTANCE_CONNECTION_NAME="INSTANCE_CONNECTION_NAME" \
  --set-env-vars DB_PORT="1433" \
  --set-env-vars INSTANCE_HOST="INSTANCE_HOST" \
  --set-env-vars DB_ROOT_CERT="certs/server-ca.pem" \
  --set-env-vars PRIVATE_IP="TRUE"

Java コネクタによってすでに安全な接続が提供されているので、Java ユーザーは、以下のように、INSTANCE_HOST、DB_ROOT_CERT、PRIVATE_IP --set-env-vars フラグを指定せずに、gcloud run deploy コマンドを実行して Cloud Run サービスを作成する必要があります。

gcloud run deploy run-sql --image gcr.io/YOUR_PROJECT_ID/run-sql \
  --add-cloudsql-instances INSTANCE_CONNECTION_NAME \
  --vpc-connector="quickstart-connector" --vpc-egress=all-traffic \
  --set-env-vars DB_NAME="quickstart-db" \
  --set-env-vars DB_USER="sqlserver" \
  --set-env-vars DB_PASS="DB_PASS" \
  --set-env-vars INSTANCE_CONNECTION_NAME="INSTANCE_CONNECTION_NAME" \
  --set-env-vars DB_PORT="1433"

リージョンを指定するように求められたら、us-central1 に該当する数値を入力します。

2. Cloud Run サービスがデプロイされたことを示す確認メッセージが表示されたら、メッセージの [Service URL] リンクをクリックして、Cloud SQL に接続された Cloud Run のサンプルアプリを確認します。

   

クリーンアップ

このページで使用したリソースについて、Google Cloud アカウントに課金されないようにするには、次の操作を行います。

1. Google Cloud コンソールで Cloud SQL の [インスタンス] ページに移動します。

   Cloud SQL の [インスタンス] に移動

2. quickstart-instance インスタンスを選択して [インスタンスの詳細] ページを開きます。
3. ページ上部にあるアイコンバーで、[削除] をクリックします。
4. [インスタンスの削除] ダイアログ ボックスで「quickstart-instance」と入力し、[削除] をクリックしてインスタンスを削除します。

5. Google Cloud コンソールで [Cloud Run] ページに移動します。

   [Cloud Run] に移動

6. quickstart-service サービス名の横にあるチェックボックスをオンにします。
7. [Cloud Run] ページの上部にある [削除] をクリックします。

省略可能なクリーンアップ手順

Compute Engine サービス アカウントに割り当てた Cloud SQL クライアントのロールを使用しない場合は、削除できます。

1. Google Cloud Console の [IAM] ページに移動します。

   [IAM] に移動

2. Compute Engine のデフォルトのサービス アカウントという名前の IAM アカウントの編集アイコン（鉛筆の形）をクリックします。
3. Cloud SQL クライアントのロールを削除します。
4. [保存] をクリックします。

このクイックスタートで有効にした API を使用しない場合は、無効にすることができます。

• このクイックスタートで有効にした API:
  • Compute Engine API
  • Cloud SQL Admin API
  • Cloud Run API
  • Container Registry API
  • Cloud Build API

1. Google Cloud Console の [API] ページに移動します。

   [API] に移動

2. 無効にする API を選択し、[API を無効にする] ボタンをクリックします。

次のステップ

必要に応じて、Cloud SQL インスタンスの作成で詳細をご確認ください。

Cloud SQL インスタンスの SQL Server ユーザーとデータベースの作成についても確認できます。

料金の詳細については、Cloud SQL for SQL Server の料金をご覧ください。

以下の詳細を確認してください。

• パブリック IP アドレスを持つ Cloud SQL インスタンスの構成。
• プライベート IP アドレスを持つ Cloud SQL インスタンスの構成。

また、他の Google Cloud アプリケーションから Cloud SQL インスタンスへの接続についても確認できます。

• App Engine スタンダード環境で実行されているアプリケーションからの接続
• Compute Engine で実行中のアプリケーションからの接続
• GKE で実行中のアプリケーションからの接続
• Cloud Functions からの接続
• Cloud Run からの接続