Google Kubernetes Engine から Cloud SQL for PostgreSQL に接続する

コンソール

パブリック IP アドレスを持つインスタンスを作成する

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

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

2. [インスタンスを作成] をクリックします。
3. [PostgreSQL] をクリックします。
4. [インスタンス ID] に「quickstart-instance」と入力します。
5. postgres ユーザーのパスワードを入力します。このパスワードはこの後で使用できるように保存してください。
6. [リージョンとゾーンの可用性の選択] で [シングルゾーン] オプションをクリックします。
7. [構成を表示] セクションをクリックして開きます。
8. [マシンタイプ] プルダウン メニューで、[軽量] を選択します。

9. [インスタンスを作成] をクリックし、インスタンスが初期化されて起動されるまで待ちます。

gcloud

パブリック IP アドレスを持つインスタンスを作成する

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

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

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

gcloud sql instances create コマンドを実行して、Cloud SQL インスタンスを作成します。

gcloud sql instances create quickstart-instance \
--database-version=POSTGRES_13 \
--cpu=1 \
--memory=4GB \
--region=us-central \
--root-password=DB_ROOT_PASSWORD

コンソール

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

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

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

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

gcloud

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

プライベート IP アドレスを使用してインスタンスを作成する場合は、GKE などの他の Google Cloud サービスからの接続を有効にするようにプライベート サービス アクセスを構成する必要があります。

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 コマンドを実行して、プライベート サービス アクセス接続を作成します。

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

3. gcloud sql instances create コマンドを実行して次のようにインスタンスを作成する前に、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 beta sql instances create quickstart-instance \
--database-version=POSTGRES_13 \
 --cpu=1 \
 --memory=4GB \
 --region=us-central \
 --root-password=DB_ROOT_PASSWORD \
 --no-assign-ip \
--network=default

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

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

Go

デプロイされたサンプルアプリは、Kubernetes サイドカー パターンで実行されている Cloud SQL Proxy を使用して Cloud SQL インスタンスに接続します。サイドカー パターンは、サンプルアプリのコンテナと同じ Kubernetes Pod を共有する追加のコンテナでワークロードをデプロイすることで実現されます。

1. gcloud sql instances describe コマンドを実行して、Cloud SQL インスタンス接続名を取得します。

   gcloud sql instances describe quickstart-instance --format='value(connectionName)'

2. Cloud Shell エディタで deployment.yaml ファイルを更新します。次のように置き換えて編集します。
   • <YOUR_KSA_NAME> を ksa-cloud-sql に置き換えます。
   • <LOCATION> を us-central1 に置き換えます。
   • <YOUR_PROJECT_ID> をプロジェクト ID で置き換えます。
   • <YOUR-DB-SECRET> を gke-cloud-sql-secrets に置き換えます。
   • <INSTANCE_CONNECTION_NAME> を前の手順で gcloud コマンドから取得した Cloud SQL インスタンス接続名に置き換えます。形式は project_id:region:instance_name です。インスタンスの接続名は、Cloud SQL インスタンスの [概要] ページにも表示されます。
   • プライベート IP アドレスを使用して Cloud SQL インスタンスに接続できるように、Cloud SQL Auth プロキシを有効にします。# コメント記号と末尾のホワイト スペースを削除して、"-ip_address_types=PRIVATE" フラグのコメント化解除します。コメント化を解除したフラグは次のようになります。

     - "-ip_address_types=PRIVATE"

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: gke-cloud-sql-quickstart
   spec:
     selector:
       matchLabels:
         app: gke-cloud-sql-app
     template:
       metadata:
         labels:
           app: gke-cloud-sql-app
       spec:
         serviceAccountName: <YOUR-KSA-NAME>
         containers:
         - name: gke-cloud-sql-app
           # Replace <LOCATION> with your Artifact Registry location (e.g., us-central1).
           # Replace <YOUR_PROJECT_ID> with your project ID.
           image: <LOCATION>-docker.pkg.dev/<YOUR_PROJECT_ID>/gke-cloud-sql-repo/gke-sql:latest
           # This app listens on port 8080 for web traffic by default.
           ports:
           - containerPort: 8080
           env:
           - name: PORT
             value: "8080"
           # This project uses environment variables to determine
           # how you would like to run your application
           # To use the Go Connector (recommended) - use INSTANCE_CONNECTION_NAME (proj:region:instance)
           # To use TCP - Setting INSTANCE_HOST will use TCP (e.g., 127.0.0.1)
           # To use Unix, use INSTANCE_UNIX_SOCKET (e.g., /cloudsql/proj:region:instance)
           - name: INSTANCE_HOST
             value: "127.0.0.1"
           - name: DB_PORT
             value: "5432"
           # For Automatic IAM Authentication with the Go Connector
           # use DB_IAM_USER instead of DB_USER (recommended)
           # You may also remove the DB_PASS environment variable if
           # you use Automatic IAM Authentication
           - name: DB_USER
             valueFrom:
               secretKeyRef:
                 name: <YOUR-DB-SECRET>
                 key: username
           - name: DB_PASS
             valueFrom:
               secretKeyRef:
                 name: <YOUR-DB-SECRET>
                 key: password
           - name: DB_NAME
             valueFrom:
               secretKeyRef:
                 name: <YOUR-DB-SECRET>
                 key: database
         # If you are using the Go Connector (recommended), you can
         # remove cloud-sql-proxy (everything below this line)
         - name: cloud-sql-proxy
           # This uses the latest version of the Cloud SQL Proxy
           # It is recommended to use a specific version for production environments.
           # See: https://github.com/GoogleCloudPlatform/cloudsql-proxy
           image: gcr.io/cloud-sql-connectors/cloud-sql-proxy:latest
           args:
             # If connecting from a VPC-native GKE cluster, you can use the
             # following flag to have the proxy connect over private IP
             # - "--private-ip"
   
             # If you are not connecting with Automatic IAM, you can delete
             # the following flag.
             - "--auto-iam-authn"
   
             # tcp should be set to the port the proxy should listen on
             # and should match the DB_PORT value set above.
             # Defaults: MySQL: 3306, Postgres: 5432, SQLServer: 1433
             - "--port=5432"
             - "<INSTANCE_CONNECTION_NAME>"
           securityContext:
             # The default Cloud SQL proxy image runs as the
             # "nonroot" user and group (uid: 65532) by default.
             runAsNonRoot: true
   

3. Cloud Shell で、次のように kubectl apply コマンドを実行して、サンプルアプリをデプロイします。

   kubectl apply -f deployment.yaml

4. 次の kubectl apply コマンドを実行して、デプロイの前にロードバランサを追加し、インターネット経由でロードバランサにアクセスできるようにします。

   kubectl apply -f service.yaml

5. 次のように kubectl get コマンドを実行して、サービスの詳細を取得します。

   kubectl get services

6. サービスの詳細で外部 IP アドレスが利用可能になったらコピーします。アドレスが使用可能になるまで数分かかることがあります。
7. デプロイされたサンプルアプリを表示します。ブラウザ ウィンドウを開き、サービスの外部 IP アドレスに移動します。

   

Java

デプロイされたサンプルアプリは、Cloud SQL Java コネクタを使用して Cloud SQL インスタンスに接続します。

1. gcloud sql instances describe コマンドを実行して、Cloud SQL インスタンス接続名を取得します。

   gcloud sql instances describe quickstart-instance --format='value(connectionName)'

2. Cloud Shell エディタで deployment.yaml ファイルを更新します。次のように置き換えます。
   • <YOUR_KSA_NAME>: ksa-cloud-sql。
   • <LOCATION>: us-central1。
   • <YOUR_PROJECT_ID>: プロジェクト ID。
   • <YOUR-DB-SECRET>: gke-cloud-sql-secrets。
   • <INSTANCE_CONNECTION_NAME>: 前の手順で gcloud コマンドから取得した Cloud SQL インスタンス接続名。形式は project_id:region:instance_name です。インスタンスの接続名は、Cloud SQL インスタンスの [概要] ページにも表示されます。
   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: gke-cloud-sql-quickstart
   spec:
     selector:
       matchLabels:
         app: gke-cloud-sql-app
     template:
       metadata:
         labels:
           app: gke-cloud-sql-app
       spec:
         # For more information about using Kubernetes service accounts see: 
         # https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts
         serviceAccountName: <YOUR-KSA-NAME> # TODO(developer): replace this value.
         containers:
         - name: gke-cloud-sql-app
           # Replace <LOCATION> with your Artifact Registry location (e.g., us-central1).
           # Replace <YOUR_PROJECT_ID> with your project ID.
           image: <LOCATION>-docker.pkg.dev/<YOUR_PROJECT_ID>/gke-cloud-sql-repo/gke-sql:latest
           # This app listens on port 8080 for web traffic by default.
           ports:
           - containerPort: 8080
           env:
           - name: PORT
             value: "8080"
           - name: INSTANCE_CONNECTION_NAME
             value: <INSTANCE_CONNECTION_NAME>
           - name: DB_HOST
             value: "127.0.0.1"
           - name: DB_PORT
             value: "5432"  
           - name: DB_USER
             valueFrom:
               secretKeyRef:
                 name: <YOUR-DB-SECRET>
                 key: username
           - name: DB_PASS
             valueFrom:
               secretKeyRef:
                 name: <YOUR-DB-SECRET>
                 key: password
           - name: DB_NAME
             valueFrom:
               secretKeyRef:
                 name: <YOUR-DB-SECRET>
                 key: database
   

3. Cloud Shell で、次のように kubectl apply コマンドを実行して、サンプルアプリをデプロイします。

   kubectl apply -f deployment.yaml

4. 次の kubectl apply コマンドを実行して、デプロイの前にロードバランサを追加し、インターネット経由でロードバランサにアクセスできるようにします。

   kubectl apply -f service.yaml

5. 次のように kubectl get コマンドを実行して、サービスの詳細を取得します。

   kubectl get services

6. サービスの詳細で外部 IP アドレスが利用可能になったらコピーします。アドレスが使用可能になるまで数分かかることがあります。
7. デプロイされたサンプルアプリを表示します。ブラウザ ウィンドウを開き、サービスの外部 IP アドレスに移動します。

   

Node.js

デプロイされたサンプルアプリは、Kubernetes サイドカー パターンで実行されている Cloud SQL Proxy を使用して Cloud SQL インスタンスに接続します。サイドカー パターンは、サンプルアプリのコンテナと同じ Kubernetes Pod を共有する追加のコンテナでワークロードをデプロイすることで実現されます。

1. gcloud sql instances describe コマンドを実行して、Cloud SQL インスタンス接続名を取得します。

   gcloud sql instances describe quickstart-instance --format='value(connectionName)'

2. Cloud Shell エディタで deployment.yaml ファイルを更新します。次のように置き換えて編集します。
   • <YOUR_KSA_NAME> を ksa-cloud-sql に置き換えます。
   • <LOCATION> を us-central1 に置き換えます。
   • <YOUR_PROJECT_ID> をプロジェクト ID で置き換えます。
   • <YOUR-DB-SECRET> を gke-cloud-sql-secrets に置き換えます。
   • <INSTANCE_CONNECTION_NAME> を前の手順で gcloud コマンドから取得した Cloud SQL インスタンス接続名に置き換えます。形式は project_id:region:instance_name です。インスタンスの接続名は、Cloud SQL インスタンスの [概要] ページにも表示されます。
   • プライベート IP アドレスを使用して Cloud SQL インスタンスに接続できるように、Cloud SQL Auth プロキシを有効にします。# コメント記号と末尾のホワイト スペースを削除して、"-ip_address_types=PRIVATE" フラグのコメント化解除します。コメント化を解除したフラグは次のようになります。

     - "-ip_address_types=PRIVATE"

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: gke-cloud-sql-quickstart
   spec:
     selector:
       matchLabels:
         app: gke-cloud-sql-app
     template:
       metadata:
         labels:
           app: gke-cloud-sql-app
       spec:
         serviceAccountName: <YOUR-KSA-NAME>
         containers:
         - name: gke-cloud-sql-app
           # Replace <LOCATION> with your Artifact Registry location (e.g., us-central1).
           # Replace <YOUR_PROJECT_ID> with your project ID.
           image: <LOCATION>-docker.pkg.dev/<YOUR_PROJECT_ID>/gke-cloud-sql-repo/gke-sql:latest
           # This app listens on port 8080 for web traffic by default.
           ports:
           - containerPort: 8080
           env:
           - name: PORT
             value: "8080"
           # This project uses environment variables to determine
           # how you would like to run your application
           # To use the Node.js connector (recommended) - use INSTANCE_CONNECTION_NAME (proj:region:instance)
           # To use TCP - Setting INSTANCE_HOST will use TCP (e.g., 127.0.0.1)
           # To use Unix, use INSTANCE_UNIX_SOCKET (e.g., /cloudsql/proj:region:instance)
           - name: INSTANCE_HOST
             value: "127.0.0.1"
           - name: DB_PORT
             value: "5432"
           # For Automatic IAM Authentication with the Node.js Connector
           # use DB_IAM_USER instead of DB_USER (recommended)
           # You may also remove the DB_PASS environment variable if
           # you use Automatic IAM Authentication
           - name: DB_USER
             valueFrom:
               secretKeyRef:
                 name: <YOUR-DB-SECRET>
                 key: username
           - name: DB_PASS
             valueFrom:
               secretKeyRef:
                 name: <YOUR-DB-SECRET>
                 key: password
           - name: DB_NAME
             valueFrom:
               secretKeyRef:
                 name: <YOUR-DB-SECRET>
                 key: database
         # If you are using the Node.js Connector (recommended), you can
         # remove cloud-sql-proxy (everything below this line)
         - name: cloud-sql-proxy
           # This uses the latest version of the Cloud SQL proxy
           # It is recommended to use a specific version for production environments.
           # See: https://github.com/GoogleCloudPlatform/cloudsql-proxy 
           image: gcr.io/cloud-sql-connectors/cloud-sql-proxy:latest
           args:
             # If connecting from a VPC-native GKE cluster, you can use the
             # following flag to have the proxy connect over private IP
             # - "--private-ip"
   
             # If you are not connecting with Automatic IAM, you can delete
             # the following flag.
             - "--auto-iam-authn"
   
             # tcp should be set to the port the proxy should listen on
             # and should match the DB_PORT value set above.
             # Defaults: MySQL: 3306, Postgres: 5432, SQLServer: 1433
             - "--port=5432"
             - "<INSTANCE_CONNECTION_NAME>"
           securityContext:
             # The default Cloud SQL proxy image runs as the
             # "nonroot" user and group (uid: 65532) by default.
             runAsNonRoot: true
   

3. Cloud Shell で、次のように kubectl apply コマンドを実行して、サンプルアプリをデプロイします。

   kubectl apply -f deployment.yaml

4. 次の kubectl apply コマンドを実行して、デプロイの前にロードバランサを追加し、インターネット経由でロードバランサにアクセスできるようにします。

   kubectl apply -f service.yaml

5. 次のように kubectl get コマンドを実行して、サービスの詳細を取得します。

   kubectl get services

6. サービスの詳細で外部 IP アドレスが利用可能になったらコピーします。アドレスが使用可能になるまで数分かかることがあります。
7. デプロイされたサンプルアプリを表示します。ブラウザ ウィンドウを開き、サービスの外部 IP アドレスに移動します。

   

Python

デプロイされたサンプルアプリは、Kubernetes サイドカー パターンで実行されている Cloud SQL Proxy を使用して Cloud SQL インスタンスに接続します。サイドカー パターンは、サンプルアプリのコンテナと同じ Kubernetes Pod を共有する追加のコンテナでワークロードをデプロイすることで実現されます。

1. gcloud sql instances describe コマンドを実行して、Cloud SQL インスタンス接続名を取得します。

   gcloud sql instances describe quickstart-instance --format='value(connectionName)'

2. Cloud Shell エディタで deployment.yaml ファイルを更新します。次のように置き換えて編集します。
   • <YOUR_KSA_NAME> を ksa-cloud-sql に置き換えます。
   • <LOCATION> を us-central1 に置き換えます。
   • <YOUR_PROJECT_ID> をプロジェクト ID で置き換えます。
   • <YOUR-DB-SECRET> を gke-cloud-sql-secrets に置き換えます。
   • <INSTANCE_CONNECTION_NAME> を前の手順で gcloud コマンドから取得した Cloud SQL インスタンス接続名に置き換えます。形式は project_id:region:instance_name です。インスタンスの接続名は、Cloud SQL インスタンスの [概要] ページにも表示されます。
   • プライベート IP アドレスを使用して Cloud SQL インスタンスに接続できるように、Cloud SQL Auth プロキシを有効にします。# コメント記号と末尾のホワイト スペースを削除して、"-ip_address_types=PRIVATE" フラグのコメント化解除します。コメント化を解除したフラグは次のようになります。

     - "-ip_address_types=PRIVATE"

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: gke-cloud-sql-quickstart
   spec:
     selector:
       matchLabels:
         app: gke-cloud-sql-app
     template:
       metadata:
         labels:
           app: gke-cloud-sql-app
       spec:
         serviceAccountName: <YOUR-KSA-NAME>
         containers:
         - name: gke-cloud-sql-app
           # Replace <LOCATION> with your Artifact Registry location (e.g., us-central1).
           # Replace <YOUR_PROJECT_ID> with your project ID.
           image: <LOCATION>-docker.pkg.dev/<YOUR_PROJECT_ID>/gke-cloud-sql-repo/gke-sql:latest
           # This app listens on port 8080 for web traffic by default.
           ports:
           - containerPort: 8080
           env:
           - name: PORT
             value: "8080"
           # This project uses environment variables to determine
           # how you would like to run your application
           # To use the Python Connector (recommended) - use INSTANCE_CONNECTION_NAME (proj:region:instance)
           # To use TCP - Setting INSTANCE_HOST will use TCP (e.g., 127.0.0.1)
           # To use Unix, use INSTANCE_UNIX_SOCKET (e.g., /cloudsql/proj:region:instance)
           - name: INSTANCE_HOST
             value: "127.0.0.1"
           - name: DB_PORT
             value: "5432"
           # For Automatic IAM Authentication with the Python Connector
           # use DB_IAM_USER instead of DB_USER (recommended)
           # You may also remove the DB_PASS environment variable if
           # you use Automatic IAM Authentication
           - name: DB_USER
             valueFrom:
               secretKeyRef:
                 name: <YOUR-DB-SECRET>
                 key: username
           - name: DB_PASS
             valueFrom:
               secretKeyRef:
                 name: <YOUR-DB-SECRET>
                 key: password
           - name: DB_NAME
             valueFrom:
               secretKeyRef:
                 name: <YOUR-DB-SECRET>
                 key: database
         # If you are using the Python Connector (recommended), you can
         # remove cloud-sql-proxy (everything below this line)
         - name: cloud-sql-proxy
           # This uses the latest version of the Cloud SQL proxy
           # It is recommended to use a specific version for production environments.
           # See: https://github.com/GoogleCloudPlatform/cloudsql-proxy 
           image: gcr.io/cloud-sql-connectors/cloud-sql-proxy:latest
           args:
             # If connecting from a VPC-native GKE cluster, you can use the
             # following flag to have the proxy connect over private IP
             # - "--private-ip"
   
             # If you are not connecting with Automatic IAM, you can delete
             # the following flag.
             - "--auto-iam-authn"
   
             # tcp should be set to the port the proxy should listen on
             # and should match the DB_PORT value set above.
             # Defaults: MySQL: 3306, Postgres: 5432, SQLServer: 1433
             - "--port=5432"
             - "<INSTANCE_CONNECTION_NAME>"
           securityContext:
             # The default Cloud SQL proxy image runs as the
             # "nonroot" user and group (uid: 65532) by default.
             runAsNonRoot: true
   

3. Cloud Shell で、次のように kubectl apply コマンドを実行して、サンプルアプリをデプロイします。

   kubectl apply -f deployment.yaml

4. 次の kubectl apply コマンドを実行して、デプロイの前にロードバランサを追加し、インターネット経由でロードバランサにアクセスできるようにします。

   kubectl apply -f service.yaml

5. 次のように kubectl get コマンドを実行して、サービスの詳細を取得します。

   kubectl get services

6. サービスの詳細で外部 IP アドレスが利用可能になったらコピーします。アドレスが使用可能になるまで数分かかることがあります。
7. デプロイされたサンプルアプリを表示します。ブラウザ ウィンドウを開き、サービスの外部 IP アドレスに移動します。