從 Google Kubernetes Engine 連線至 MySQL 適用的 Cloud SQL

從 Google Kubernetes Engine 連線至 MySQL 適用的 Cloud SQL

MySQL  |  PostgreSQL  |  SQL Server

本頁說明如何使用 Google Cloud 控制台和用戶端應用程式，在 Google Kubernetes Engine (GKE) 上部署連結至 MySQL 執行個體的範例應用程式。假設您及時完成所有步驟 (包括清理作業)，本快速入門導覽課程建立的資源通常不會超過一美元。

事前準備

登入 Google Cloud 帳戶。如果您是 Google Cloud新手，歡迎 建立帳戶，親自評估產品在實際工作環境中的成效。新客戶還能獲得價值 $300 美元的免費抵免額，可用於執行、測試及部署工作負載。

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

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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 you have the permissions required to complete this guide.

Verify that billing is enabled for your Google Cloud project.

Enable the Artifact Registry, Cloud Build, Cloud SQL Admin, Compute Engine, Kubernetes Engine, Service Networking APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

安裝 gcloud CLI。

注意：如果您先前已安裝 gcloud CLI，請執行 gcloud components update，確認您使用的是最新版本。

若您採用的是外部識別資訊提供者 (IdP)，請先使用聯合身分登入 gcloud CLI。

執行下列指令，初始化 gcloud CLI：

gcloud init

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

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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 you have the permissions required to complete this guide.

Verify that billing is enabled for your Google Cloud project.

Enable the Artifact Registry, Cloud Build, Cloud SQL Admin, Compute Engine, Kubernetes Engine, Service Networking APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

安裝 gcloud CLI。

注意：如果您先前已安裝 gcloud CLI，請執行 gcloud components update，確認您使用的是最新版本。

若您採用的是外部識別資訊提供者 (IdP)，請先使用聯合身分登入 gcloud CLI。

執行下列指令，初始化 gcloud CLI：

gcloud init

必要的角色

如要取得完成本快速入門導覽課程所述工作所需的權限，請要求管理員在快速入門導覽課程專案中授予您下列 IAM 角色：

• 建立、更新或刪除所有 Cloud SQL 執行個體、資料庫和使用者：
  • Cloud SQL 管理員 (roles/cloudsql.admin)
  • Compute 檢視者 (roles/compute.viewer)
• 建立具有私人 IP 的 Cloud SQL 執行個體 (私人服務存取連線)： Compute Network Admin (roles/compute.networkadmin)
• 建立及管理 Google Kubernetes Engine 叢集： Kubernetes Engine 管理員 (roles/container.admin)
• 為專案建立及管理服務帳戶：
  • 專案 IAM 管理員 (roles/resourcemanager.projectIamAdmin)
  • 服務帳戶管理員 (roles/serviceAccountAdmin)
• 在 Artifact Registry 中為專案建立存放區： Artifact Registry 管理員 (roles/artifactregistry.admin)
• 在 Cloud Build 中提交及建構應用程式：
  • Cloud Build 編輯者 (roles/cloudbuilds.builds.editor)
  • Storage 物件建立者 (roles/storage.objectCreator)
  • Storage Bucket 檢視器 (roles/storage.bucketViewer)
  • 服務帳戶使用者 (roles/iam.serviceAccountUser)
  • 記錄檢視器 (roles/logging.viewer)

如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

您或許也能透過自訂角色或其他預先定義的角色，取得必要權限。

設定 Cloud SQL

建立 Cloud SQL 執行個體

公開 IP

控制台

建立具有公開 IP 位址的執行個體

1. 前往 Google Cloud 控制台的「Cloud SQL Instances」頁面。

   前往 Cloud SQL 執行個體

2. 點選「建立執行個體」。
3. 按一下 [MySQL]。
4. 在「Instance ID」(執行個體 ID) 中輸入 quickstart-instance。
5. 輸入超級使用者的密碼。請儲存這個密碼，以供日後使用。
6. 在「選擇區域和可用區供應情形」部分，點選「單一可用區」選項。
7. 按一下並展開「顯示設定」部分。
8. 在「Machine Type」(機器類型) 下拉式選單中，選取「Lightweight」(輕量)。

9. 按一下「建立執行個體」，然後等待執行個體初始化並啟動。

gcloud

建立具有公開 IP 位址的執行個體

執行下列 gcloud sql instances create 指令前，請將 DB_ROOT_PASSWORD 替換為資料庫使用者的密碼。

視需要修改下列參數的值：

• --database_version：資料庫引擎類型和版本。 如未指定，系統會使用 API 預設值。 如要查看目前可用的版本，請參閱 gcloud database versions 說明文件。
• --cpu：機器中所需的核心數量。
• --memory：整數值，表示機器所需的記憶體容量。請提供大小單位 (例如 3072MB 或 9GB)。如未指定單位，系統會假設您使用的是 GB。
• --region：執行個體所在的區域位置 (例如 asia-east1、us-east1)。如未指定，系統會使用預設的 us-central。 查看完整區域清單。

執行 gcloud sql instances create 指令，建立 Cloud SQL 執行個體。

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

私人 IP

控制台

建立啟用 SSL 的私人 IP 位址執行個體

1. 前往 Google Cloud 控制台的「Cloud SQL Instances」頁面。

   前往 Cloud SQL 執行個體

2. 點選「建立執行個體」。
3. 按一下 [MySQL]。
4. 在「Instance ID」(執行個體 ID) 中輸入 quickstart-instance。
5. 輸入超級使用者的密碼。請儲存這個密碼，以供日後使用。
6. 在「選擇區域和可用區供應情形」部分，點選「單一可用區」選項。
7. 按一下並展開「顯示設定選項」。
8. 在「機型」部分，選取「輕量」。
9. 在「連線」部分，選取「私人 IP」。
10. 在「網路」下拉式選單中選取「預設」。
11. 如果看到「必須使用私人服務連線」對話方塊，請按一下「設定連線」按鈕。
• 在「啟用 Service Networking API」對話方塊中，按一下「啟用 API」按鈕。
• 在「Allocate an IP range」(分配 IP 範圍) 對話方塊中，選取「Use an automatically allocated IP range」(使用系統自動分配的 IP 範圍)，然後按一下「Continue」(繼續)。
• 在「建立連線」對話方塊中，按一下「建立連線」。
12. 取消勾選「公開 IP」核取方塊，即可建立僅使用私人 IP 的執行個體。
13. 按一下「建立執行個體」，然後等待執行個體初始化並啟動。
14. 按一下「連線」。
15. 在「安全性」部分中，選取「僅允許 SSL 連線」即可啟用 SSL 連線。
16. 在「啟用 SSL」對話方塊中，按一下「啟用並重新啟動」，然後等待執行個體重新啟動。

gcloud

建立啟用 SSL 的私人 IP 位址執行個體

如要建立僅具私人 IP 位址的執行個體，只需設定私人服務連線，即可啟用來自其他 Google Cloud 服務 (例如 GKE) 的連線。

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：整數，表示要納入機器的記憶體量。可以提供大小單位 (例如 3072MB 或 9GB)。如未指定單位，系統會假設您使用的是 GB。
• --region：執行個體所在的區域位置 (例如 asia-east1、us-east1)。如未指定，則會使用預設值 us-central1。查看完整區域清單。

執行 gcloud sql instances create 指令，建立使用私人 IP 位址的 Cloud SQL 執行個體。

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

4. 執行 gcloud sql instances patch 指令，僅允許執行個體使用 SSL 連線。

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

建立資料庫

請按照下列步驟建立資料庫：

控制台

1. 前往 Google Cloud 控制台的「Cloud SQL Instances」頁面。

   前往 Cloud SQL 執行個體

2. 選取「quickstart-instance」。
3. 在 SQL 導覽選單中，選取「資料庫」。
4. 按一下 [Create database] (建立資料庫)。
1. 在「Create a database」(建立資料庫) 對話方塊的「Database name」(資料庫名稱) 欄位中，輸入 quickstart-db。保留字元集和定序的值。
2. 點選「建立」。

gcloud

執行 gcloud sql databases create 指令來建立資料庫。

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

新增使用者

控制台

1. 前往 Google Cloud 控制台的「Cloud SQL Instances」頁面。

   前往 Cloud SQL 執行個體

2. 如要開啟執行個體的「總覽」頁面，請按一下執行個體名稱。
3. 在 SQL 導覽選單中選取「使用者」。
4. 按一下「新增使用者帳戶」。
• 在「Add a user account to instance instance_name」(在執行個體「instance_name」中新增使用者帳戶) 頁面中， 新增下列資訊：
  • 使用者名稱：設為 quickstart-user
  • 密碼：指定資料庫使用者的密碼。 請記下這個值，本快速入門導覽課程的後續步驟會用到。
  • 在「主機名稱」部分，預設為「允許任何主機」，表示使用者可以從任何 IP 位址連線。

    選取「依 IP 位址或位址範圍限制主機」，然後在「主機」區段中輸入 IP 位址或位址範圍。使用者只能從指定的 IP 位址或位址連線。

5. 按一下「新增」。

gcloud

執行下列指令前，請先將 DB_PASS 替換成資料庫使用者的密碼。請記下這個值，本快速入門導覽課程的後續步驟會用到。

執行 gcloud sql users create 指令來建立使用者。

gcloud sql users create quickstart-user \
--instance=quickstart-instance \
--password=DB_PASS

Cloud SQL 的使用者名稱長度限制與地端部署 MySQL 相同：MySQL 8.0 以上版本為 32 個字元，舊版則為 16 個字元。

建立 GKE 叢集

控制台

1. 在 Google Cloud 控制台中，前往「Google Kubernetes Engine」頁面。

   前往「Google Kubernetes Engine」

2. 點選「建立」。
3. 按一下 GKE Autopilot 的「設定」。
4. 在「Name」部分指定叢集名稱為 gke-cloud-sql-quickstart。
5. 點選「建立」。

gcloud

執行 gcloud container clusters create-auto 指令來建立叢集。

gcloud container clusters create-auto gke-cloud-sql-quickstart \
    --region us-central1

使用 Cloud Shell 從 GitHub 複製 Cloud SQL 範例應用程式

有了 Cloud SQL 執行個體、資料庫和 GKE 叢集，您現在可以複製及設定範例應用程式，連線至 Cloud SQL 執行個體。範例應用程式儲存在 GitHub 中。 本快速入門導覽課程的其餘步驟需要使用 Cloud Shell、gcloud 和 kubectl。Cloud Shell 已預先安裝 gcloud 和 kubectl 工具。

Go

1. 在 Cloud Shell 編輯器中開啟範例應用程式的原始碼。

   開啟 Cloud Shell 編輯器
2. 在 Open in Cloud Shell 對話方塊中，按一下「確認」，下載範例應用程式程式碼，並在 Cloud Shell 編輯器中開啟範例應用程式目錄。

Java

1. 在 Cloud Shell 編輯器中開啟範例應用程式的原始碼。
   開啟 Cloud Shell 編輯器
2. 在 Open in Cloud Shell 對話方塊中，按一下「確認」，下載範例應用程式程式碼，並在 Cloud Shell 編輯器中開啟範例應用程式目錄。

Node.js

1. 在 Cloud Shell 編輯器中開啟範例應用程式的原始碼。
   開啟 Cloud Shell 編輯器
2. 在 Open in Cloud Shell 對話方塊中，按一下「確認」，下載範例應用程式程式碼，並在 Cloud Shell 編輯器中開啟範例應用程式目錄。

Python

1. 在 Cloud Shell 編輯器中開啟範例應用程式的原始碼。
   開啟 Cloud Shell 編輯器
2. 在 Open in Cloud Shell 對話方塊中，按一下「確認」，下載範例應用程式程式碼，並在 Cloud Shell 編輯器中開啟範例應用程式目錄。

啟用 GKE 叢集

啟用您剛建立的 GKE 叢集，做為本快速入門導覽課程中其餘指令使用的預設叢集。

執行下列 gcloud container clusters get-credentials 指令，啟用 GKE 叢集。

gcloud container clusters get-credentials gke-cloud-sql-quickstart \
  --region us-central1

設定服務帳戶

建立及設定供 GKE 使用的 Google Cloud 服務帳戶，並指派 Cloud SQL 用戶端角色，授予連線至 Cloud SQL 的權限。

1. 執行下列 gcloud iam service-accounts create 指令，建立新的服務帳戶：

   gcloud iam service-accounts create gke-quickstart-service-account \
     --display-name="GKE Quickstart Service Account"

2. 執行下列 gcloud projects add-iam-policy-binding 指令，將 Cloud SQL Client 角色 新增至您剛建立的 Google Cloud 服務帳戶。將 YOUR_PROJECT_ID 替換為專案 ID。

   gcloud projects add-iam-policy-binding YOUR_PROJECT_ID \
     --member="serviceAccount:gke-quickstart-service-account@YOUR_PROJECT_ID.iam.gserviceaccount.com" \
     --role="roles/cloudsql.client"

3. 範例應用程式會使用記錄功能，因此請執行 gcloud projects add-iam-policy-binding 指令，將「記錄寫入者」角色新增至您剛建立的 Google Cloud 服務帳戶。將 YOUR_PROJECT_ID 替換為專案 ID。

   gcloud projects add-iam-policy-binding YOUR_PROJECT_ID \
     --member="serviceAccount:gke-quickstart-service-account@YOUR_PROJECT_ID.iam.gserviceaccount.com" \
     --role="roles/logging.logWriter"

4. 服務帳戶必須能夠從 Artifactory 存放區提取映像檔，因此請執行
   gcloud projects add-iam-policy-binding 指令，將「Artifact Registry Reader」角色新增至服務帳戶。將 YOUR_PROJECT_ID 替換為專案 ID。

   gcloud projects add-iam-policy-binding YOUR_PROJECT_ID \
     --member="serviceAccount:gke-quickstart-service-account@YOUR_PROJECT_ID.iam.gserviceaccount.com" \
     --role="roles/artifactregistry.reader"

建立 Kubernetes 服務帳戶，並透過 Workload Identity Federation for GKE 將該帳戶繫結至 Google Cloud 服務帳戶，以設定存取 Cloud SQL 的權限。

1. 建立 Kubernetes 服務帳戶。
   1. 在 Cloud Shell 編輯器中更新 service-account.yaml 檔案。 將 <YOUR-KSA-NAME> 替換為 ksa-cloud-sql。
   2. 在 Cloud Shell 中執行 kubectl apply 指令，如下所示：

      kubectl apply -f service-account.yaml

2. 執行下列 gcloud iam service-accounts add-iam-policy-binding 指令，啟用 Google Cloud 服務帳戶和 Kubernetes 服務帳戶的 IAM 繫結。進行下列替換：
   • 將 YOUR_PROJECT_ID 替換為專案 ID。
   • YOUR_K8S_NAMESPACE，也就是在 GKE 中建立叢集的預設命名空間。default
   • YOUR_KSA_NAME搭配 ksa-cloud-sql。

   gcloud iam service-accounts add-iam-policy-binding \
     --role="roles/iam.workloadIdentityUser" \
     --member="serviceAccount:YOUR_PROJECT_ID.svc.id.goog[YOUR_K8S_NAMESPACE/YOUR_KSA_NAME]" \
     gke-quickstart-service-account@YOUR_PROJECT_ID.iam.gserviceaccount.com

3. 執行下列 kubectl annotate 指令，為 Kubernetes 服務帳戶加上 IAM 繫結註解。進行下列替換：
   • YOUR_KSA_NAME搭配 ksa-cloud-sql。
   • 將 YOUR_PROJECT_ID 替換為專案 ID。

   kubectl annotate serviceaccount \
     YOUR_KSA_NAME  \
     iam.gke.io/gcp-service-account=gke-quickstart-service-account@YOUR_PROJECT_ID.iam.gserviceaccount.com

設定密鑰

執行下列 kubectl create secret generic 指令，為範例應用程式使用的資料庫、使用者和使用者密碼建立 Kubernetes Secret。每個 Secret 的值都以本快速入門導覽課程先前步驟中指定的值為準。將 DB_PASS 替換為您在上一個「建立使用者」快速入門導覽課程步驟中建立的 quickstart-user 密碼。

kubectl create secret generic gke-cloud-sql-secrets \
  --from-literal=database=quickstart-db \
  --from-literal=username=quickstart-user \
  --from-literal=password=DB_PASS

建構範例應用程式

Go

1. 返回 Cloud Shell 編輯器，然後點選 Open Terminal，開啟 Cloud Shell 提示。
2. 在 Cloud Shell 提示中，執行下列 gcloud artifacts repositories create 指令，在 Artifact Registry 中建立名為 gke-cloud-sql-repo 的存放區，該存放區與叢集位於相同區域。將 YOUR_PROJECT_ID 替換為專案 ID。

   gcloud artifacts repositories create gke-cloud-sql-repo \
     --project=YOUR_PROJECT_ID \
     --repository-format=docker \
     --location=us-central1 \
     --description="GKE Quickstart sample app"

3. 將目錄變更為您先前從 GitHub 複製 Cloud SQL 範例應用程式的位置。範例應用程式目錄包含範例應用程式的 Dockerfile。 舉例來說，如要將目錄變更為範例應用程式的目錄，可以執行下列指令：

   cd ~/cloudshell_open/golang-samples/cloudsql/mysql/database-sql
     

4. 執行下列 gcloud builds submit 指令，建構 Docker 容器並發布至 Artifact Registry。將 YOUR_PROJECT_ID 替換為專案 ID。

   gcloud builds submit \
     --tag us-central1-docker.pkg.dev/YOUR_PROJECT_ID/gke-cloud-sql-repo/gke-sql .

Java

1. 返回 Cloud Shell 編輯器，然後點選 Open Terminal，開啟 Cloud Shell 提示。
2. 在 Cloud Shell 提示中，執行下列 gcloud artifacts repositories create 指令，在 Artifact Registry 中建立名為 gke-cloud-sql-repo 的存放區，該存放區與叢集位於相同區域。將 YOUR_PROJECT_ID 替換為專案 ID。

   gcloud artifacts repositories create gke-cloud-sql-repo \
     --project=YOUR_PROJECT_ID \
     --repository-format=docker \
     --location=us-central1 \
     --description="GKE Quickstart sample app"

3. 將目錄變更為您先前從 GitHub 複製 Cloud SQL 範例應用程式的位置。範例應用程式目錄包含範例應用程式的 pom.xml。 舉例來說，如要將目錄變更為範例應用程式的目錄，可以執行下列指令：

   cd ~/cloudshell_open/java-docs-samples/cloud-sql/mysql/servlet
     

4. 執行 mvn 指令，建構 Docker 容器並發布至 Artifact Registry。將 YOUR_PROJECT_ID 替換為專案 ID。

   mvn clean package com.google.cloud.tools:jib-maven-plugin:2.8.0:build \
     -Dimage=us-central1-docker.pkg.dev/YOUR_PROJECT_ID/gke-cloud-sql-repo/gke-sql \
     -DskipTests -Djib.to.credHelper=gcloud

Node.js

1. 返回 Cloud Shell 編輯器，然後點選 Open Terminal，開啟 Cloud Shell 提示。
2. 在 Cloud Shell 提示中，執行下列 gcloud artifacts repositories create 指令，在 Artifact Registry 中建立名為 gke-cloud-sql-repo 的存放區，該存放區與叢集位於相同區域。將 YOUR_PROJECT_ID 替換為專案 ID。

   gcloud artifacts repositories create gke-cloud-sql-repo \
     --project=YOUR_PROJECT_ID \
     --repository-format=docker \
     --location=us-central1 \
     --description="GKE Quickstart sample app"

3. 將目錄變更為您先前從 GitHub 複製 Cloud SQL 範例應用程式的位置。範例應用程式目錄包含範例應用程式的 Dockerfile。 舉例來說，如要將目錄變更為範例應用程式的目錄，可以執行下列指令：

   cd ~/cloudshell_open/nodejs-docs-samples/cloud-sql/mysql/mysql
     

4. 執行下列 gcloud builds submit 指令，建構 Docker 容器並發布至 Artifact Registry。將 YOUR_PROJECT_ID 替換為專案 ID。

   gcloud builds submit \
     --tag us-central1-docker.pkg.dev/YOUR_PROJECT_ID/gke-cloud-sql-repo/gke-sql .

Python

1. 返回 Cloud Shell 編輯器，然後點選 Open Terminal，開啟 Cloud Shell 提示。
2. 在 Cloud Shell 提示中，執行下列 gcloud artifacts repositories create 指令，在 Artifact Registry 中建立名為 gke-cloud-sql-repo 的存放區，該存放區與叢集位於相同區域。將 YOUR_PROJECT_ID 替換為專案 ID。

   gcloud artifacts repositories create gke-cloud-sql-repo \
     --project=YOUR_PROJECT_ID \
     --repository-format=docker \
     --location=us-central1 \
     --description="GKE Quickstart sample app"

3. 將目錄變更為您先前從 GitHub 複製 Cloud SQL 範例應用程式的位置。範例應用程式目錄包含範例應用程式的 Dockerfile。 舉例來說，如要將目錄變更為範例應用程式的目錄，可以執行下列指令：

   cd ~/cloudshell_open/python-docs-samples/cloud-sql/mysql/sqlalchemy
     

4. 執行下列 gcloud builds submit 指令，建構 Docker 容器並發布至 Artifact Registry。將 YOUR_PROJECT_ID 替換為專案 ID。

   gcloud builds submit \
     --tag us-central1-docker.pkg.dev/YOUR_PROJECT_ID/gke-cloud-sql-repo/gke-sql .

部署範例應用程式

公開 IP

範例應用程式設定完成後，即可部署範例應用程式。

Go

部署的範例應用程式會使用 Kubernetes Sidecar 模式執行的 Cloud SQL Proxy，連線至 Cloud SQL 執行個體。如要採用 Sidecar 模式，請部署工作負載，並新增一個容器，與範例應用程式的容器共用同一個 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 執行個體的「總覽」頁面中，查看執行個體連線名稱。
   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: "3306"
           # 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=3306"
             - "<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: "3306"  
           - 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 Sidecar 模式執行的 Cloud SQL Proxy，連線至 Cloud SQL 執行個體。如要採用 Sidecar 模式，請部署工作負載，並新增一個容器，與範例應用程式的容器共用同一個 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 執行個體的「總覽」頁面中，查看執行個體連線名稱。
   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"
           - name: INSTANCE_HOST
             value: "127.0.0.1"
           - name: DB_PORT
             value: "3306"  
           - 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
         - 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=3306"
             - "<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」位址。

   

cloud-sql/mysql/mysql/deployment.yaml

Python

部署的範例應用程式會使用 Kubernetes Sidecar 模式執行的 Cloud SQL Proxy，連線至 Cloud SQL 執行個體。如要採用 Sidecar 模式，請部署工作負載，並新增一個容器，與範例應用程式的容器共用同一個 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 執行個體的「總覽」頁面中，查看執行個體連線名稱。
   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: "3306"
           # 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=3306"
             - "<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」位址。

   

私人 IP

範例應用程式設定完成後，即可部署範例應用程式。

Go

部署的範例應用程式會使用 Kubernetes Sidecar 模式執行的 Cloud SQL Proxy，連線至 Cloud SQL 執行個體。如要採用 Sidecar 模式，請部署工作負載，並新增一個容器，與範例應用程式的容器共用同一個 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 執行個體的「總覽」頁面中，查看執行個體連線名稱。
   • 啟用 Cloud SQL Auth Proxy，使用私人 IP 位址連線至 Cloud SQL 執行個體。移除 # 註解符號和結尾的空白字元，取消註解 "--private-ip" 標記。未註解的旗標 應如下所示：

     - "--private-ip"

   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: "3306"
           # 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=3306"
             - "<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: "3306"  
           - 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 Sidecar 模式執行的 Cloud SQL Proxy，連線至 Cloud SQL 執行個體。如要採用 Sidecar 模式，請部署工作負載，並新增一個容器，與範例應用程式的容器共用同一個 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 執行個體的「總覽」頁面中，查看執行個體連線名稱。
   • 啟用 Cloud SQL Auth Proxy，使用私人 IP 位址連線至 Cloud SQL 執行個體。移除 # 註解符號和結尾的空白字元，取消註解 "--private-ip" 標記。未註解的旗標 應如下所示：

     - "--private-ip"

   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"
           - name: INSTANCE_HOST
             value: "127.0.0.1"
           - name: DB_PORT
             value: "3306"  
           - 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
         - 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=3306"
             - "<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」位址。

   

cloud-sql/mysql/mysql/deployment.yaml

Python

部署的範例應用程式會使用 Kubernetes Sidecar 模式執行的 Cloud SQL Proxy，連線至 Cloud SQL 執行個體。如要採用 Sidecar 模式，請部署工作負載，並新增一個容器，與範例應用程式的容器共用同一個 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 執行個體的「總覽」頁面中，查看執行個體連線名稱。
   • 啟用 Cloud SQL Auth Proxy，使用私人 IP 位址連線至 Cloud SQL 執行個體。移除 # 註解符號和結尾的空白字元，取消註解 "--private-ip" 標記。未註解的旗標 應如下所示：

     - "--private-ip"

   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: "3306"
           # 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=3306"
             - "<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」位址。

   

清除所用資源

為了避免系統向您的 Google Cloud 帳戶收取本頁面所用資源的費用，請按照下列步驟操作。

1. 前往 Google Cloud 控制台的「Cloud SQL Instances」頁面。

   前往 Cloud SQL 執行個體

2. 選取 quickstart-instance 執行個體，開啟「Instance details」(執行個體詳細資料) 頁面。
3. 在頁面頂端的圖示列中，按一下 [刪除]。
4. 在「Delete instance」(刪除執行個體) 對話方塊中輸入 quickstart-instance，然後按一下「Delete」(刪除) 以刪除執行個體。

5. 在 Google Cloud 控制台中，前往「Google Kubernetes Engine」頁面。

   前往「Google Kubernetes Engine」

6. 按一下「gke-cloud-sql-quickstart」服務名稱旁邊的核取方塊。
7. 按一下 Google Kubernetes Engine 頁面頂端的「刪除」按鈕。

選用清除步驟

如果您未使用為本快速入門導覽課程建立的 Google Cloud 服務帳戶，可以將其移除。

1. 前往 Google Cloud 控制台的「Service accounts」(服務帳戶) 頁面。

   前往「IAM」頁面

2. 勾選名為「gke-quickstart-service-account」的 IAM 帳戶核取方塊。
3. 按一下「移除」並確認移除。

如果您未使用本快速入門導覽課程啟用的 API，可以停用這些 API。

• 本快速入門導覽課程中啟用的 API：
  • Compute Engine API
  • Cloud SQL Admin API
  • Google Kubernetes Engine API
  • Artifact Registry API
  • Cloud Build API

1. 前往 Google Cloud 控制台的「APIs」頁面。

   前往 API 頁面

2. 選取要停用的 API，然後按一下「停用 API」按鈕。

後續步驟

您可以根據需求，進一步瞭解如何建立 Cloud SQL 執行個體。

您也可以瞭解如何為 Cloud SQL 執行個體建立 MySQL 使用者和資料庫。

另請參閱 Cloud SQL 定價資訊。

請點選下列連結瞭解更多資訊：

• Cloud SQL 中的所有連線選項。
• 使用公開 IP 位址設定 Cloud SQL 執行個體。
• 為 Cloud SQL 執行個體設定私人 IP 位址。

此外，您也可以瞭解如何從其他 Google Cloud 應用程式連線至 Cloud SQL 執行個體：

• 從在 App Engine 標準環境中執行的應用程式
• 從在 Compute Engine 中執行的應用程式
• 從 GKE 上執行的應用程式
• 從 Cloud Run