Cloud Run から接続する

Cloud Run から接続する

このページでは、 Google Cloud コンソールとクライアント アプリケーションを使用して、Cloud Run サービスにサンプル アプリケーションをデプロイするプロセスについて説明します。このサンプル アプリケーションは、Cloud Run を AlloyDB for PostgreSQL に接続します。

始める前に

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.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

1. Cloud Run で AlloyDB for PostgreSQL サンプル アプリケーションを実行するために必要な Cloud APIs を有効にします。

   API を有効にする

   1. [プロジェクトを確認] の手順で、変更するプロジェクトの名前を確認して [次へ] をクリックします。

   2. [API を有効にする] の手順で、[有効にする] をクリックして、次の機能を有効にします。

      • AlloyDB API
      • Cloud Run Admin API
      • Compute Engine API
      • Cloud Build API
      • Container Registry API
      • Service Networking API
      • Cloud Resource Manager API

クラスタとそのプライマリ インスタンスを作成する

1. Google Cloud コンソールで、[クラスタ] ページに移動します。

   [クラスタ] に移動

2. [クラスタを作成] をクリックします。

   Google Cloud コンソールに、選択可能なクラスタの種類が表示されます。[高可用性] を選択します。

3. [続行] をクリックします。

   [クラスタを構成する] セクションが開きます。

4. [基本情報] の [クラスタ ID] フィールドに「my-cluster」と入力します。

5. [パスワード] フィールドに任意のパスワードを入力します。このパスワードはメモしておいてください。このクイックスタートの後半で使用します。

6. [リージョン] フィールドで [us-central1 (Iowa)] を選択します。

7. [接続] の [ネットワーク] プルダウンで、[default] を選択します。

   プライベート サービス アクセスをまだ設定していない場合は、[プライベート サービス アクセス接続は必須です] というダイアログが表示されます。

   [プライベート サービス アクセス接続は必須です] ダイアログで、プライベート サービス アクセス接続を作成するには、次の操作を行います。

   1. [接続を設定] をクリックします。

      [Service Networking API の有効化] という新しいペインが表示されます。

   2. このペインで、[自動的に割り当てられた IP 範囲を使用する] を選択します。

   3. [続行] をクリックします。

   4. [接続を作成] をクリックし、接続構成が完了するまで待ちます。

      ペインの表示が消えます。

8. [続行] をクリックします。

   [プライマリ インスタンスの構成] セクションが開きます。

9. [基本情報] の [インスタンス ID] フィールドに「my-primary」と入力します。

10. [マシン] の値として [2 vCPU, 16 GB] を選択します。

11. [クラスタを作成] をクリックします。

    クラスタが作成されるまで待ちます。

インスタンスに接続してデータベースを作成する

1. 新しく作成したクラスタの [概要] ページを開いていない場合は、 Google Cloud コンソールで [クラスタ] ページに移動します。

   [クラスタ] に移動

2. クラスタの [概要] ページを表示するには、「my-cluster」というクラスタ名をクリックします。

3. ナビゲーション メニューで [AlloyDB Studio] をクリックします。

4. [AlloyDB Studio にログインする] ページの [データベース] リストで、[postgres] を選択します。

5. [ユーザー] プルダウン リストで [postgres] を選択します。

6. [パスワード] フィールドに、クラスタとそのプライマリ インスタンスを作成するで作成したパスワードを入力します。

7. [認証] をクリックします。[エクスプローラ] ペインに、データベースに登録されているオブジェクトのリストが表示されます。

8. [エディタ 1] タブで、データベースを作成します。

   CREATE DATABASE quickstart_db;
   

9. [実行] をクリックします。[結果] ペインに Statement executed successfully メッセージが表示されるまで待ちます。

プロジェクト ID を探す

1. Google Cloud コンソールで [ダッシュボード] ページに移動します。

   ダッシュボードに移動

2. [プロジェクト情報] カードでプロジェクト ID を確認します。

3. プロジェクト ID をメモします。このクイックスタートのこの後のステップで必要になります。

Artifact Registry にサンプル アプリケーションのイメージを登録する

1. Google Cloud コンソールで Cloud Shell を開きます。

   Cloud Shell を開く

2. Cloud Shell エディタで、次のコマンドを使用して、GitHub からサンプルのアプリケーション コードを含むリポジトリのクローンを作成します。

   cloudshell_open --repo_url \
   "https://github.com/GoogleCloudPlatform/alloydb-auth-proxy" \
   --dir \
   "examples/go" \
   --force_new_clone

3. Artifact Registry に Docker イメージ用のリポジトリを作成します。

   gcloud artifacts repositories create cloud-run-source-deploy --location us-central1 --repository-format=docker --project PROJECT_ID

   PROJECT_ID は、プロジェクトの ID に置き換えます。

4. [Cloud Shell の承認] ダイアログで、[承認] をクリックします。この手順をすでに行っている場合は、このプロンプトが表示されません。

5. Docker コンテナをビルドして Artifact Registry に公開するには、次のコマンドを使用します。

    gcloud builds submit --tag  us-central1-docker.pkg.dev/PROJECT_ID/cloud-run-source-deploy/run-sql --project PROJECT_ID

   PROJECT_ID は、プロジェクトの ID に置き換えます。

新しいインスタンスの IP アドレスを確認する

1. Google Cloud コンソールで、[クラスタ] ページに移動します。

   [クラスタ] に移動

2. テーブルで、リソース名が my-primary の行を見つけます。

3. その行のプライベート IP アドレスをメモします。このクイックスタートのこの後のステップで必要になります。

   IP アドレスは 172.19.209.2:5432 のような形式になります。

Cloud Run のサービスを作成する

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

   Cloud Run に移動

2. [サービス] タブで、[コンテナをデプロイ] をクリックします。

3. [サービスの作成] ページで、[既存のコンテナ イメージから 1 つのリビジョンをデプロイする] オプションを選択します。

4. [コンテナ イメージの URL] フィールドをクリックして、[選択] をクリックします。

5. [コンテナ イメージの選択] ペインで、次の手順を行います。

   1. [Artifact Registry] タブを選択します。
   2. us-central1-docker.pkg.dev/PROJECT_ID/cloud-run-source-deploy を開きます。
   3. run-sql を開きます。
   4. 最新のイメージを選択します。
   5. [選択] をクリックします。

6. [サービス名] フィールドに「quickstart-service」と入力します。

7. [リージョン] リストで、[us-central1 (Iowa)] がデフォルトで選択されていることを確認します。

8. [認証] で、[未認証の呼び出しを許可] を選択します。

9. [CPU の割り当てと料金] セクションで、[リクエストの処理中にのみ CPU を割り当てる] が選択されていることを確認します。

10. [コンテナ、ボリューム、ネットワーキング、セキュリティ] セクションを開きます。

11. [コンテナ] タブで [変数とシークレット] タブを選択し、次の操作を行います。

    1. [環境変数] セクションで、[変数を追加] をクリックします。

    2. Name フィールドと Value フィールドに次のように入力します。

       • DB_NAME: quickstart_db
       • DB_USER: postgres
       • DB_PASS: クラスタとそのプライマリ インスタンスを作成するでクラスタを作成したときに入力したパスワード。
       • DB_PORT: 5432
       • INSTANCE_HOST: 新しいインスタンスの IP アドレスを確認するで確認したクラスタのプライマリ インスタンスの IP アドレス。ポート番号は含めないでください。たとえば、172.19.209.2:5432 ではなく 172.19.209.2 に設定します。

12. [コンテナ] タブから [ネットワーキング] タブに切り替えて、次の操作を行います。

    1. [アウトバウンド トラフィック用の VPC に接続する] チェックボックスをオンにします。

    2. [VPC に直接トラフィックを送信する] オプションを選択します。

    3. [ネットワーク] プルダウン リストで、[default] 値を選択します。

    4. [サブネット] プルダウン リストで、[default] 値が選択されていることを確認します。

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

    Cloud Run サービスがデプロイされると、[quickstart-service] ページの [URL] フィールドにサンプル アプリケーションの URL が表示されます。

    アプリケーションは AlloyDB をデータストアとして使用します。

サンプル アプリケーションを表示する

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

   Cloud Run に移動

2. [quickstart-service] ページで、 [クリップボードにコピー] をクリックして、アプリケーションの URL をコピーします。

3. 新しいブラウザタブで、コピーしたアプリの URL を貼り付け、[入力] をクリックします。

   次のような、サンプルの投票収集ウェブ アプリケーションが表示されます。

   

クリーンアップ

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

クラスタをクリーンアップする

1. Google Cloud コンソールで、[クラスタ] ページに移動します。

   [クラスタ] に移動

2. 削除する my-cluster クラスタの横にある [ 操作] をクリックし、[ 削除] をクリックします。

3. [クラスタの削除] ダイアログが表示されたら、[my-cluster] フィールドに my-cluster と入力して、削除することを確認します。

4. [削除] をクリックします。

サービスをクリーンアップする

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

   Cloud Run に移動

2. quickstart-service サービス名の横にあるチェックボックスをオンにします。

3. [Cloud Run] ページの上部にある [ 削除] をクリックします。

4. [quickstart-service の削除] ダイアログが表示されたら、[削除] をクリックして確定します。

次のステップ

• プロジェクトの AlloyDB へのアクセスを有効にする

• 他のユーザーに AlloyDB へのアクセス権を付与する

• プライベート サービス アクセスを有効にする

• クラスタとそのプライマリ インスタンスを作成する