使用 gcloud CLI 連線

gcloud beta alloydb connect 指令可讓您建立與 AlloyDB for PostgreSQL 執行個體的授權加密連線。這項指令會自動啟動 AlloyDB Auth Proxy 並執行 psql 用戶端工具。

使用這個指令，從本機電腦或 Cloud Shell 等環境手動管理及開發資料庫。

詳情請參閱「連線總覽」。

事前準備

  1. 安裝 Google Cloud CLI。
  2. 安裝 psql 用戶端工具。
  3. 確認您的 Identity and Access Management (IAM) 主體具備 AlloyDB 用戶端 (roles/alloydb.client) 角色。詳情請參閱「管理 IAM 驗證」。

連線至執行個體

如要使用預設 postgres 使用者和資料庫，透過私人 IP 連線至執行個體，請執行下列指令：

gcloud beta alloydb connect INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID

透過公開 IP 連線

如果執行個體已啟用公開 IP 位址，您可以新增 --public-ip 旗標來連線至該執行個體：

gcloud beta alloydb connect INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --public-ip

使用 IAM 驗證

gcloud beta alloydb connect 指令支援自動 IAM 驗證。使用 --auto-iam-authn 旗標，以已登入的 gcloud CLI 使用者或服務帳戶身分進行驗證。

gcloud beta alloydb connect INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --auto-iam-authn

如要進一步瞭解 IAM 驗證，請參閱「IAM 資料庫驗證」。

透過 Private Service Connect 連線

如果使用 Private Service Connect，請新增 --psc 旗標：

gcloud beta alloydb connect INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --psc

連線至特定使用者和資料庫

如要以特定資料庫使用者身分連線至特定資料庫，請使用 --user 和 --database 旗標：

gcloud beta alloydb connect INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --user=USER_NAME \
    --database=DATABASE_NAME

服務帳戶模擬

您可以使用模擬服務帳戶授權連線。使用模擬功能時，Auth Proxy 會使用指定服務帳戶的憑證擷取連線資訊。

如要使用模擬服務帳戶連線，請新增 --impersonate-service-account 旗標：

gcloud beta alloydb connect INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --impersonate-service-account=SERVICE_ACCOUNT_EMAIL

Auth Proxy 會使用模擬服務帳戶擷取連線資訊。不過，系統不會自動向資料庫驗證身分。如要以模擬服務帳戶的身分向資料庫進行驗證，請新增 --auto-iam-authn 旗標。模擬的服務帳戶必須是資料庫中的使用者。

gcloud beta alloydb connect INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --impersonate-service-account=SERVICE_ACCOUNT_EMAIL \
    --auto-iam-authn

後續步驟