從 Cloud Run 連線至 PostgreSQL 適用的 Cloud SQL

從 Cloud Run 連線至 PostgreSQL 適用的 Cloud SQL

MySQL   |  PostgreSQL   |  SQL Server

瞭解如何使用 Google Cloud 控制台和用戶端應用程式，在 Cloud Run 上部署連結至 PostgreSQL 執行個體的範例應用程式。

假設您及時完成所有步驟，在這個快速入門導覽課程中建立的資源費用通常不到一美元。

---

如要直接在 Google Cloud 控制台中，按照這項工作的逐步指南操作，請按一下「Guide me」(逐步引導)：

「Guide me」(逐步引導)

---

事前準備

注意： 專案名稱長度必須介於 4 到 30 個半形字元之間。輸入名稱時，表單會建議專案 ID，您可以編輯。專案 ID 必須介於 6 到 30 個字元之間，且第一個字元必須是小寫字母。其餘字元可以使用破折號、小寫英文字母或數字，但最後一個字元不得為破折號。

登入 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 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.

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 billing is enabled for your Google Cloud project.

1. 確認您具備完成本快速入門導覽課程所需的權限。
2. 啟用必要的 Cloud API，以便在 Cloud Run 執行 Cloud SQL 範例應用程式。

   控制台

   按一下「Enable 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 \
   artifactregistry.googleapis.com cloudbuild.googleapis.com servicenetworking.googleapis.com

   這個指令會啟用下列 API：

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

必要的角色

如要取得所需權限，在 Cloud Run 部署連結至 PostgreSQL 執行個體的範例應用程式，請要求管理員在您要使用的專案中，授予您下列 IAM 角色：

• 建立或刪除 Artifact Registry 存放區：Artifact Registry 寫入者 (roles/artifactregistry.writer)
• 建立或刪除執行個體、資料庫和使用者：Cloud SQL 管理員角色 (roles/cloudsql.admin)。
• 建立或刪除 IAM 服務帳戶：服務帳戶管理員角色 (roles/iam.serviceAccountAdmin)。
• 建立連線：
  • Service Networking 管理員 (roles/servicenetworking.networksAdmin))
  • 服務使用情形管理員 (roles/serviceusage.serviceUsageAdmin)。
• 查看物件和中繼資料：Storage 物件檢視者 (roles/storage.objectViewer)
• 提供管理專案政策的權限：專案 IAM 管理員 (roles/resourcemanager.projectIamAdmin)。
• 具備所有 Cloud Run 資源的讀取和寫入權限：Cloud Run 開發人員 (roles/run.developer)。
• 部署及管理 Cloud Run 原始碼部署的資源：Cloud Run 原始碼開發人員 (roles/run.sourceDeveloper)。
• 如要允許公開存取：Cloud Run 管理員 (roles/run.admin)。
• 如要以服務帳戶身分執行作業：服務帳戶使用者 (roles/iam.serviceAccountUser)。

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

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

設定 Cloud SQL

建立 Cloud SQL 執行個體

公開 IP

請按照下列步驟設定 Cloud SQL 執行個體，並透過公開 IP 連線：

控制台

1. 前往 Google Cloud 控制台的「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面。

   前往「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面

2. 點選「建立執行個體」。
3. 在「Create instance」(建立執行個體) 選單中，選取「New instance」(新增執行個體)。
4. 按一下「Choose PostgreSQL」(選擇 PostgreSQL)。
5. 確認執行個體的 Cloud SQL 版本已選取「Enterprise Plus」。
6. 在「Instance ID」(執行個體 ID) 欄位中輸入 quickstart-instance。
7. 在「Password」(密碼) 欄位中，輸入 postgres 使用者的密碼。請儲存這個密碼，日後會用到。
8. 在「Choose region and zonal availability」(選擇區域和可用區供應情形) 專區中，選取「Single zone」(單一可用區)。
9. 按一下「顯示設定選項」選單。
10. 展開「機器設定」節點。
11. 在「機器類型」區域，選取「4 個 vCPU，32 GB」類型。
12. 按一下「Create instance」(建立執行個體)，然後等待執行個體初始化並啟動。

gcloud

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

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

• --database-version：資料庫引擎類型和版本。如未指定，則會使用 API 預設值。 如要查看目前可用的版本，請參閱 gcloud 資料庫版本說明文件。
• --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=POSTGRES_14 \
 --cpu=1 \
 --memory=4GB \
 --region=us-central \
 --root-password=DB_ROOT_PASSWORD

私人 IP

請按照下列步驟設定 Cloud SQL 執行個體，以便透過私人 IP 連線：

控制台

分配 IP 位址範圍並建立私人連線，為 Cloud SQL 設定私人服務存取權

1. 前往 Google Cloud 控制台的「VPC Networks」(虛擬私有雲網路) 頁面。

   前往「VPC networks」(虛擬私有雲網路)

2. 選取「default」虛擬私有雲網路。
3. 選取 [Private service connection] (私人服務連線) 分頁標籤。
4. 選取「分配的服務 IP 範圍」分頁標籤。
5. 按一下「Allocate IP range」(分配 IP 範圍)。
6. 在「Name」(名稱) 部分，指定 google-managed-services-default 做為分配範圍。
7. 選取 IP 範圍的「自動」選項，並將前置碼長度指定為 16。
8. 按一下 [Allocate] (分配)，建立已分配範圍。
9. 選取 default 虛擬私有雲網路的「Private connections to services」(私人服務連線) 分頁標籤。
10. 按一下「建立連線」，在您的網路和服務生產者之間建立私人連線。
11. 在「Assigned allocation」(已指派的分配範圍) 部分，選取「google-managed-services-default」。
12. 按一下 [Connect] (連線) 建立連線。

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

1. 前往 Google Cloud 控制台的「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面。

   前往「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面

2. 點選「建立執行個體」。
3. 在「Create instance」(建立執行個體) 選單中，選取「New instance」(新增執行個體)。
4. 按一下「Choose PostgreSQL」(選擇 PostgreSQL)。
5. 確認執行個體的 Cloud SQL 版本已選取「Enterprise Plus」。
6. 在「Instance ID」(執行個體 ID) 欄位中輸入 quickstart-instance。
7. 在「Password」(密碼) 欄位中，輸入 postgres 使用者的密碼。請儲存這個密碼，日後會用到。
8. 在「Choose region and zonal availability」(選擇區域和可用區供應情形) 專區中選取「Single zone」(單一可用區)。
9. 按一下「顯示設定選項」選單。
10. 展開「機器設定」節點。
11. 在「機器類型」區域，選取「4 個 vCPU，32 GB」類型。
12. 展開「連線」節點。
13. 取消勾選「公開 IP」核取方塊，建立僅有私人 IP 位址的執行個體。
14. 勾選「Private IP」(私人 IP) 核取方塊。
15. 勾選「私人服務連線 (PSA)」核取方塊。
16. 在「虛擬私有雲網路」下拉式選單中，選取「預設」。
17. 在「Security」(安全性) 專區中，確認已選取「Allow only SSL connections」(僅允許 SSL 連線)，以便啟用 SSL 連線。
18. 按一下「建立執行個體」，然後等待執行個體初始化並啟動。

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 資料庫版本說明文件。
   • --cpu：機器中的核心數量。
   • --memory：整數值，表示機器要包含多少記憶體。您可以提供大小單位 (例如 3072MB 或 9GB)。如未指定單位，系統會假設為 GB。
   • --region：執行個體的區域位置 (例如 asia-east1、us-east1)。如未指定，則會使用預設的 us-central1。查看區域完整清單。

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

gcloud sql instances create quickstart-instance \
--database-version=POSTGRES_14 \
 --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 Instances」(Cloud SQL 執行個體) 頁面。

   前往「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面

2. 選取「quickstart-instance」。
3. 在 SQL 導覽選單中，選取「資料庫」。
4. 按一下「 建立資料庫」。
1. 在「New 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 執行個體) 頁面。

   前往「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面

2. 點選執行個體名稱，開啟執行個體的「總覽」頁面。
3. 在 SQL 導覽選單中，選取「使用者」。
4. 按一下「新增使用者帳戶」。
5. 在「Add a user account to instance instance_name」(在執行個體「instance_name」中新增使用者帳戶) 頁面中，新增下列資訊：
   • 在「Username」欄位中輸入 quickstart-user
   • 在「Password」(密碼) 欄位中，指定資料庫使用者的密碼。請記下這個值，以便在本快速入門導覽課程的後續步驟中使用。
6. 按一下「新增」。

gcloud

執行下列指令前，請先完成下列替換作業：

1. 將 PASSWORD 替換為資料庫使用者的密碼。 請記下這個值，以便在本快速入門導覽課程的後續步驟中使用。

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

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

Cloud SQL 的使用者名稱長度限制與地端部署 PostgreSQL 相同。

將範例應用程式部署至 Cloud Run

設定 Cloud Run 服務帳戶

設定 Cloud Run 使用的 Compute Engine 預設服務帳戶，使其具備 Cloud SQL 用戶端和Storage 物件檢視者角色。

控制台

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

   前往「IAM Service accounts」(IAM 服務帳戶) 頁面

2. 按一下服務帳戶旁的「Actions」(動作) 選單，然後點選「Manage access」(管理存取權)。
3. 按一下「Add another role」(新增其他角色)，然後在「Role」(角色) 下拉式選單中，找到並選取「Cloud SQL Client」(Cloud SQL 用戶端) (roles/cloudsql.client)。
4. 按一下「Add another role」(新增其他角色)，然後在「Role」(角色) 下拉式選單中，找到並選取「Storage Object Viewer」(Storage 物件檢視者) (roles/storage.objectViewer)。
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"

4. 執行下列指令，將 Storage 物件檢視者角色新增至 Compute Engine 預設服務帳戶：

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

設定 Cloud SQL 範例應用程式

有了 Cloud SQL 執行個體、資料庫和具備用戶端權限的服務帳戶，您現在可以設定範例應用程式，連線至 Cloud SQL 執行個體。

公開 IP

如果是公開 IP 路徑，Cloud Run 會提供加密功能，並透過 Unix 通訊端使用 Cloud SQL Auth Proxy 進行連線。

Go

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

   開啟 Cloud Shell 編輯器

2. 在「Open in Cloud Shell」(在 Cloud Shell 中開啟) 對話方塊中，按一下「Confirm」(確認)，下載範例應用程式程式碼，並在 Cloud Shell 編輯器中開啟範例應用程式目錄。
3. 在 Cloud SQL 執行個體所在的區域，建立名為 run-sql 的 Artifact Registry Docker 存放區。將 YOUR_PROJECT_ID 替換為專案 ID，並將 YOUR_REGION_NAME 替換為區域名稱。

     gcloud artifacts repositories create run-sql \
       --project=YOUR_PROJECT_ID \
       --repository-format=docker \
       --location=YOUR_REGION_NAME \
       --description="Quickstart Cloud SQL sample app"
     

4. 在 Cloud Shell 執行下列指令，建構 Docker 容器並發布至 Artifact Registry。 將 YOUR_PROJECT_ID 替換為專案 ID，並將 YOUR_REGION_NAME 替換為區域名稱。

   gcloud builds submit --tag YOUR_REGION_NAME-docker.pkg.dev/YOUR_PROJECT_ID/run-sql/run-sql

Java

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

   開啟 Cloud Shell 編輯器

2. 在「Open in Cloud Shell」(在 Cloud Shell 中開啟) 對話方塊中，按一下「Confirm」(確認)，下載範例應用程式程式碼，並在 Cloud Shell 編輯器中開啟範例應用程式目錄。
3. 在 Cloud SQL 執行個體所在的區域，建立名為 run-sql 的 Artifact Registry Docker 存放區。將 YOUR_PROJECT_ID 替換為專案 ID，並將 YOUR_REGION_NAME 替換為區域名稱。

     gcloud artifacts repositories create run-sql \
       --project=YOUR_PROJECT_ID \
       --repository-format=docker \
       --location=YOUR_REGION_NAME \
       --description="Quickstart Cloud SQL sample app"
     

4. 在 Cloud Shell 執行下列 mvn 指令，建構 Docker 容器並發布至 Artifact Registry。將 YOUR_PROJECT_ID 替換為專案 ID，並將 YOUR_REGION_NAME 替換為區域名稱。

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

Node.js

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

   開啟 Cloud Shell 編輯器

2. 在「Open in Cloud Shell」(在 Cloud Shell 中開啟) 對話方塊中，按一下「Confirm」(確認)，下載範例應用程式程式碼，並在 Cloud Shell 編輯器中開啟範例應用程式目錄。
3. 在 Cloud SQL 執行個體所在的區域，建立名為 run-sql 的 Artifact Registry Docker 存放區。將 YOUR_PROJECT_ID 替換為專案 ID，並將 YOUR_REGION_NAME 替換為區域名稱。

     gcloud artifacts repositories create run-sql \
       --project=YOUR_PROJECT_ID \
       --repository-format=docker \
       --location=YOUR_REGION_NAME \
       --description="Quickstart Cloud SQL sample app"
     

4. 在 Cloud Shell 執行下列指令，建構 Docker 容器並發布至 Artifact Registry。 將 YOUR_PROJECT_ID 替換為專案 ID，並將 YOUR_REGION_NAME 替換為區域名稱。

   gcloud builds submit --tag YOUR_REGION_NAME-docker.pkg.dev/YOUR_PROJECT_ID/run-sql/run-sql

Python

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

   開啟 Cloud Shell 編輯器

2. 在「Open in Cloud Shell」(在 Cloud Shell 中開啟) 對話方塊中，按一下「Confirm」(確認)，下載範例應用程式程式碼，並在 Cloud Shell 編輯器中開啟範例應用程式目錄。
3. 在 Cloud SQL 執行個體所在的區域，建立名為 run-sql 的 Artifact Registry Docker 存放區。將 YOUR_PROJECT_ID 替換為專案 ID，並將 YOUR_REGION_NAME 替換為區域名稱。

     gcloud artifacts repositories create run-sql \
       --project=YOUR_PROJECT_ID \
       --repository-format=docker \
       --location=YOUR_REGION_NAME \
       --description="Quickstart Cloud SQL sample app"
     

4. 在 Cloud Shell 執行下列指令，建構 Docker 容器並發布至 Artifact Registry。 將 YOUR_PROJECT_ID 替換為專案 ID，並將 YOUR_REGION_NAME 替換為區域名稱。

   gcloud builds submit --tag YOUR_REGION_NAME-docker.pkg.dev/YOUR_PROJECT_ID/run-sql/run-sql

私人 IP

如果是私人 IP 路徑，應用程式會透過直連虛擬私有雲輸出或 VPC 連接器，直接連線至執行個體。這個方法會使用 TCP 通訊端直接連線至 Cloud SQL 執行個體，不需使用 Cloud SQL Auth Proxy。

Go

建立及下載 SSL 伺服器和用戶端憑證

1. 前往 Google Cloud 控制台的「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面。

   前往「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面

2. 按一下「quickstart-instance」即可查看「總覽」頁面
3. 按一下「連線」分頁標籤。
4. 在「安全性」部分，按一下「建立用戶端憑證」。
5. 在「Create a client certificate」(建立用戶端憑證) 對話方塊中，輸入 quickstart-key 做為名稱，然後按一下「Create」(建立)。

6. 在「已建立新的安全資料傳輸層 (SSL) 憑證」對話方塊中，點選各個下載連結，下載憑證。然後按一下「Close」(關閉)。

   重要事項：請妥善保管這組私密金鑰。如果遺失，就必須建立新的用戶端憑證。

使用 SSL 憑證建構範例應用程式

1. 在 Cloud Shell 編輯器中，開啟範例應用程式的原始碼。
   開啟 Cloud Shell 編輯器
2. 在「Open in Cloud Shell」(在 Cloud Shell 中開啟) 對話方塊中，按一下「Confirm」(確認)，下載範例應用程式程式碼，並在 Cloud Shell 編輯器中開啟範例應用程式目錄。
3. 將 SSL 憑證檔案上傳至 certs 資料夾。
   1. 在 Cloud Shell 編輯器中，在「certs」資料夾上按一下滑鼠右鍵，然後選取「Upload Files」。
   2. 在本機電腦上選取下列檔案：
   • client-key.pem
   • client-cert.pem
   • server-ca.pem
   3. 選取三個 SSL 憑證檔案後，按一下「開啟」，即可完成將檔案上傳至 Cloud Shell 編輯器的程序。
4. 在 Cloud SQL 執行個體所在的區域，建立名為 run-sql 的 Artifact Registry Docker 存放區。將 YOUR_PROJECT_ID 替換為專案 ID，並將 YOUR_REGION_NAME 替換為區域名稱。

     gcloud artifacts repositories create run-sql \
       --project=YOUR_PROJECT_ID \
       --repository-format=docker \
       --location=YOUR_REGION_NAME \
       --description="Quickstart Cloud SQL sample app"
     

5. 在 Cloud Shell 執行下列指令，建構 Docker 容器並發布至 Artifact Registry。 將 YOUR_PROJECT_ID 替換為專案 ID，並將 YOUR_REGION_NAME 替換為區域名稱。

   gcloud builds submit --tag YOUR_REGION_NAME-docker.pkg.dev/YOUR_PROJECT_ID/run-sql/run-sql

Java

建立及下載 SSL 伺服器和用戶端憑證

Java 使用者可透過 Java 連接器建立安全連線，因此不必建立及下載 SSL 伺服器和用戶端憑證。

建構範例應用程式

1. 在 Cloud Shell 編輯器中，開啟範例應用程式的原始碼。
   開啟 Cloud Shell 編輯器
2. 在「Open in Cloud Shell」(在 Cloud Shell 中開啟) 對話方塊中，按一下「Confirm」(確認)，下載範例應用程式程式碼，並在 Cloud Shell 編輯器中開啟範例應用程式目錄。
3. 在 Cloud SQL 執行個體所在的區域，建立名為 run-sql 的 Artifact Registry Docker 存放區。將 YOUR_PROJECT_ID 替換為專案 ID，並將 YOUR_REGION_NAME 替換為區域名稱。

     gcloud artifacts repositories create run-sql \
       --project=YOUR_PROJECT_ID \
       --repository-format=docker \
       --location=YOUR_REGION_NAME \
       --description="Quickstart Cloud SQL sample app"
     

4. 在 Cloud Shell 執行下列指令，建構 Docker 容器並發布至 Artifact Registry。 將 YOUR_PROJECT_ID 替換為專案 ID，並將 YOUR_REGION_NAME 替換為區域名稱。

   gcloud builds submit --tag YOUR_REGION_NAME-docker.pkg.dev/YOUR_PROJECT_ID/run-sql/run-sql

Node.js

建立及下載 SSL 伺服器和用戶端憑證

1. 前往 Google Cloud 控制台的「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面。

   前往「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面

2. 按一下「quickstart-instance」即可查看「總覽」頁面
3. 按一下「連線」分頁標籤。
4. 在「安全性」部分，按一下「建立用戶端憑證」。
5. 在「Create a client certificate」(建立用戶端憑證) 對話方塊中，輸入 quickstart-key 做為名稱，然後按一下「Create」(建立)。

6. 在「已建立新的安全資料傳輸層 (SSL) 憑證」對話方塊中，點選各個下載連結，下載憑證。然後按一下「Close」(關閉)。

   重要事項：請妥善保管這組私密金鑰。如果遺失，就必須建立新的用戶端憑證。

使用 SSL 憑證建構範例應用程式

1. 在 Cloud Shell 編輯器中，開啟範例應用程式的原始碼。
   開啟 Cloud Shell 編輯器
2. 在「Open in Cloud Shell」(在 Cloud Shell 中開啟) 對話方塊中，按一下「Confirm」(確認)，下載範例應用程式程式碼，並在 Cloud Shell 編輯器中開啟範例應用程式目錄。
3. 將 SSL 憑證檔案上傳至 certs 資料夾。
   1. 在 Cloud Shell 編輯器中，在「certs」資料夾上按一下滑鼠右鍵，然後選取「Upload Files」。
   2. 在本機電腦上選取下列檔案：
   • client-key.pem
   • client-cert.pem
   • server-ca.pem
   3. 選取三個 SSL 憑證檔案後，按一下「開啟」，即可完成將檔案上傳至 Cloud Shell 編輯器的程序。
4. 在 Cloud SQL 執行個體所在的區域，建立名為 run-sql 的 Artifact Registry Docker 存放區。將 YOUR_PROJECT_ID 替換為專案 ID，並將 YOUR_REGION_NAME 替換為區域名稱。

     gcloud artifacts repositories create run-sql \
       --project=YOUR_PROJECT_ID \
       --repository-format=docker \
       --location=YOUR_REGION_NAME \
       --description="Quickstart Cloud SQL sample app"
     

5. 在 Cloud Shell 執行下列指令，建構 Docker 容器並發布至 Artifact Registry。 將 YOUR_PROJECT_ID 替換為專案 ID，並將 YOUR_REGION_NAME 替換為區域名稱。

   gcloud builds submit --tag YOUR_REGION_NAME-docker.pkg.dev/YOUR_PROJECT_ID/run-sql/run-sql

Python

建立及下載 SSL 伺服器和用戶端憑證

1. 前往 Google Cloud 控制台的「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面。

   前往「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面

2. 按一下「quickstart-instance」即可查看「總覽」頁面
3. 按一下「連線」分頁標籤。
4. 在「安全性」部分，按一下「建立用戶端憑證」。
5. 在「Create a client certificate」(建立用戶端憑證) 對話方塊中，輸入 quickstart-key 做為名稱，然後按一下「Create」(建立)。

6. 在「已建立新的安全資料傳輸層 (SSL) 憑證」對話方塊中，點選各個下載連結，下載憑證。然後按一下「Close」(關閉)。

   重要事項：請妥善保管這組私密金鑰。如果遺失，就必須建立新的用戶端憑證。

使用 SSL 憑證建構範例應用程式

1. 在 Cloud Shell 編輯器中，開啟範例應用程式的原始碼。
   開啟 Cloud Shell 編輯器
2. 在「Open in Cloud Shell」(在 Cloud Shell 中開啟) 對話方塊中，按一下「Confirm」(確認)，下載範例應用程式程式碼，並在 Cloud Shell 編輯器中開啟範例應用程式目錄。
3. 將 SSL 憑證檔案上傳至 certs 資料夾。
   1. 在 Cloud Shell 編輯器中，在「certs」資料夾上按一下滑鼠右鍵，然後選取「Upload Files」。
   2. 在本機電腦上選取下列檔案：
   • client-key.pem
   • client-cert.pem
   • server-ca.pem
   3. 選取三個 SSL 憑證檔案後，按一下「開啟」，即可完成將檔案上傳至 Cloud Shell 編輯器的程序。
4. 在 Cloud SQL 執行個體所在的區域，建立名為 run-sql 的 Artifact Registry Docker 存放區。將 YOUR_PROJECT_ID 替換為專案 ID，並將 YOUR_REGION_NAME 替換為區域名稱。

     gcloud artifacts repositories create run-sql \
       --project=YOUR_PROJECT_ID \
       --repository-format=docker \
       --location=YOUR_REGION_NAME \
       --description="Quickstart Cloud SQL sample app"
     

5. 在 Cloud Shell 執行下列指令，建構 Docker 容器並發布至 Artifact Registry。 將 YOUR_PROJECT_ID 替換為專案 ID，並將 YOUR_REGION_NAME 替換為區域名稱。

   gcloud builds submit --tag YOUR_REGION_NAME-docker.pkg.dev/YOUR_PROJECT_ID/run-sql/run-sql

部署範例應用程式

將範例部署至 Cloud Run 的步驟，取決於您指派給 Cloud SQL 執行個體的 IP 位址類型。

映像檔連線方法會因設定的環境變數而異。

• 如要使用 TCP 連線，請設定 INSTANCE_HOST 環境變數的值。這個連線方法會採用設為環境變數的憑證和通訊埠。
• 如要使用 Unix 通訊端連線，請設定 INSTANCE_UNIX_SOCKET 環境變數的值。

  請勿設定 INSTANCE_HOST 環境變數的值。

  Java 原生不支援 Unix 通訊端。如果應用程式是以 Java 編寫，則必須使用 Cloud SQL Java 連接器。

• 如要使用其中一個 Cloud SQL 語言連接器連線，請設定 INSTANCE_CONNECTION_NAME 環境變數的值。

  請勿設定下列環境變數的值：

  • INSTANCE_HOST
  • INSTANCE_UNIX_SOCKET
  • DB_PORT
  • DB_ROOT_CERT
  • DB_CERT
  • DB_KEY
  Cloud SQL 語言連接器已使用 Cloud SQL Auth Proxy 伺服器提供安全連線，該伺服器會透過通訊埠 3307 建立與 Cloud SQL 的連線，因此不會使用這些值。

公開 IP

控制台

注意：如要使用控制台部署函式，您必須啟用必要 API、取得必要角色，並點選「Write a function」(編寫函式) 表單。

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

   前往 Cloud Run

2. 按一下「Create container」(建立容器)，然後選取「Service」(服務)，即可顯示「Create service」(建立服務) 表單。

3. 按一下「容器映像檔網址」輸入欄位中的「選取」按鈕。
1. 選取您在上一個步驟中建立的 gcr.io/YOUR_PROJECT_ID/run-sql 容器映像檔。
4. 在「Service name」(服務名稱) 欄位中輸入 quickstart-service。
5. 在「Authentication」(驗證) 部分，選取「Allow public access」選項。如果您沒有選取這項設定的權限 (Cloud Run 管理員角色)，服務會部署並要求驗證。
6. 展開「Container, Variables & Secrets, Connections, Security」(容器、變數和密鑰、連線、安全性) 專區。
7. 按一下「環境變數」底下的「新增變數」，建立下列 Environment variables。按照下列方式設定環境變數的值：
• INSTANCE_UNIX_SOCKET：設為 /cloudsql/YOUR_PROJECT_ID:us-central1:quickstart-instance。
• INSTANCE_CONNECTION_NAME：設為執行個體的連線名稱，顯示在 Google Cloud 控制台的「Cloud SQL instances」(Cloud SQL 執行個體) 頁面。
• DB_NAME：設為 quickstart-db
• DB_USER：設為 quickstart-user
• DB_PASS：設為您在先前「建立使用者」快速入門導覽課程步驟中建立的 quickstart-user 密碼。

8. 啟用連線至 Cloud SQL：

   • 按一下「連線」分頁標籤。
   • 按一下「Cloud SQL 連線」專區下方的「新增連線」按鈕。
   • 從下拉式選單中選取先前建立的quickstart-instance。

   

9. 按一下「建立」，建立 Cloud Run 服務。

10. Cloud Run 服務部署完畢後，「Service details」(服務詳細資料) 頁面頂端會顯示執行中服務的網址。按一下「網址」連結，即可查看部署在 Cloud Run 且已連結至 Cloud SQL 的範例應用程式。

    

gcloud

1. 執行下列指令前，請先完成下列替換作業：

• YOUR_PROJECT_ID 為您的專案 ID。

• 將 INSTANCE_CONNECTION_NAME 替換為執行個體的連線名稱，該名稱會顯示在 Google Cloud 控制台的「Cloud SQL instances」(Cloud SQL 執行個體) 頁面。

• DB_PASS：您在先前「建立使用者」快速入門導覽課程步驟中，為 quickstart-user 建立的密碼。

執行下列 gcloud run deploy 指令，建立 Cloud Run 服務。環境變數會因您要使用的連線方法而異：

gcloud run deploy run-sql --image gcr.io/YOUR_PROJECT_ID/run-sql \
    --add-cloudsql-instances INSTANCE_CONNECTION_NAME \
    --set-env-vars INSTANCE_CONNECTION_NAME="INSTANCE_CONNECTION_NAME" \
    --set-env-vars DB_NAME="quickstart-db" \
    --set-env-vars DB_USER="quickstart-user" \
    --set-env-vars DB_PASS="DB_PASS"

系統提示您指定區域時，請輸入 us-central1 的對應數字選項。

2. 看到 Cloud Run 服務已部署的確認訊息後，請按一下訊息中的「Service URL」(服務網址) 連結，查看 Cloud Run 上已連結至 Cloud SQL 的範例應用程式。

   

私人 IP

控制台

注意：如要使用控制台部署函式，您必須啟用必要 API、取得必要角色，並點選「Write a function」(編寫函式) 表單。

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

   前往 Cloud Run

2. 按一下「Create container」(建立容器)，然後選取「Service」(服務)，即可顯示「Create service」(建立服務) 表單。

3. 保留從現有容器映像檔部署的選項，然後按一下「選取」，指定您在上一步建立的 gcr.io/YOUR_PROJECT_ID/run-sql 容器映像檔。
4. 在「Service name」(服務名稱) 中輸入 quickstart-service。
5. 在「Authentication」(驗證) 部分，選取「Allow public access」選項。如果 Allow public access 選項。如果您沒有選取這項設定的權限 (Cloud Run 管理員角色)，服務會部署並要求驗證。
6. 展開「Container, Variables & Secrets, Connections, Security」(容器、變數和密鑰、連線、安全性) 專區。
7. 按一下「環境變數」下方的「新增變數」，建立下列環境變數。按照下列方式設定環境變數的值：
• DB_NAME：設為 quickstart-db。
• DB_USER：設為 quickstart-user。
• DB_PASS：設為您在先前「建立使用者」快速入門導覽課程步驟中指定的 quickstart-user 密碼。
• INSTANCE_CONNECTION_NAME：設為執行個體的連線名稱，顯示在 Google Cloud 控制台的「Cloud SQL instances」(Cloud SQL 執行個體) 頁面。
• DB_PORT：設為 5432。
• DB_ROOT_CERT：設為 certs/server-ca.pem。
• DB_CERT：設為 certs/client-cert.pem。
• DB_KEY：設為 certs/client-key.pem。
• PRIVATE_IP：設為 TRUE。

8. 啟用連線至 Cloud SQL：

   1. 按一下「連線」。
   2. 在「Cloud SQL connections」(Cloud SQL 連線) 區段中，按一下「Add Connection」(新增連線)。
   3. 選取先前建立的 quickstart-instance Cloud SQL 執行個體。
   4. 在「網路」分頁中，選取「連線至虛擬私有雲以傳送傳出流量」，然後在「網路」和「子網路」欄位中選取「預設」。
   5. 選取「將所有流量轉送至虛擬私有雲」選項。

9. 按一下「建立」，建立 Cloud Run 服務。

10. Cloud Run 服務部署完畢後，「Service details」(服務詳細資料) 頁面頂端會顯示執行中服務的網址。按一下「網址」連結，即可查看部署在 Cloud Run 且已連結至 Cloud SQL 的範例應用程式。

    

gcloud

1. 執行下列指令前，請先完成下列替換作業：

• YOUR_PROJECT_ID 為您的專案 ID。
• INSTANCE_CONNECTION_NAME 替換為執行個體的連線名稱，該名稱會顯示在 Google Cloud 控制台的「Cloud SQL instances」(Cloud SQL 執行個體) 頁面。
• DB_PASS：您在先前「建立使用者」快速入門導覽課程步驟中，為 quickstart-user 建立的密碼。

執行 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-egress=all-traffic \
    --network=default \
    --subnet=default \
    --set-env-vars DB_NAME="quickstart-db" \
    --set-env-vars DB_USER="quickstart-user" \
    --set-env-vars DB_PASS="DB_PASS" \
    --set-env-vars INSTANCE_CONNECTION_NAME="INSTANCE_CONNECTION_NAME"
  

系統提示您指定區域時，請輸入 us-central1 的對應數字選項。

2. 看到 Cloud Run 服務已部署的確認訊息後，請按一下訊息中的「Service URL」(服務網址) 連結，查看 Cloud Run 上已連結至 Cloud SQL 的範例應用程式。

   

清除所用資源

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

1. 前往 Google Cloud 控制台的「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面。

   前往「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面

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

5. 前往 Google Cloud 控制台的「Cloud Run」頁面。

   前往 Cloud Run

6. 選取「quickstart-service」服務名稱旁的核取方塊。
7. 按一下 Cloud Run 頁面頂端的「Delete」(刪除)。

選用清理步驟

如果您不使用指派給 Compute Engine 服務帳戶的 Cloud SQL 用戶端角色，可以將其移除。

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

   前往「IAM」頁面

2. 按一下名為「Compute Engine default service account」(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 控制台的「APIs」頁面。

   前往 API 頁面

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

後續步驟

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

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

如要進一步瞭解定價，請參閱「PostgreSQL 適用的 Cloud SQL 定價」。

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

• 使用公開 IP 位址設定 Cloud SQL 執行個體。
• 使用私人 IP 位址設定 Cloud SQL 執行個體。

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

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