使用 Cloud SQL Proxy Operator 連線

本頁面說明如何使用 Cloud SQL Proxy Operator 連線至 Cloud SQL 執行個體。如要進一步瞭解 Cloud SQL Proxy Operator 的運作方式，請參閱「關於 Cloud SQL Proxy Operator」。

總覽

Cloud SQL Proxy Operator 會設定部署在 Google Kubernetes Engine (GKE) 的應用程式，使用 Cloud SQL Auth Proxy 連線至 Cloud SQL 資料庫執行個體。建議使用 Cloud SQL Auth Proxy 連線至 Cloud SQL 執行個體。如要進一步瞭解 Cloud SQL Auth Proxy，請參閱「關於 Cloud SQL Auth Proxy」。

在 GKE 中執行的應用程式可以使用 Cloud SQL Auth Proxy 連線。

事前準備

連線至 Cloud SQL 執行個體前，請先完成下列工作：

  1. 如果是使用者或服務帳戶，請確認帳戶具備 Cloud SQL 用戶端角色。這個角色包含 cloudsql.instances.connect 權限，可授權主體連線至專案中的所有 Cloud SQL 執行個體。

    前往「IAM」頁面

    您可以在 IAM 政策繫結中加入 IAM 條件，授予帳戶權限，使其只能連線至特定 Cloud SQL 執行個體。

  2. 啟用 Cloud SQL Admin API (如果尚未啟用)。

    啟用 API 所需的角色

    如要啟用 API，您必須具備 serviceusage.services.enable 權限。如果您建立了專案，可能已透過擁有者角色 (roles/owner) 取得這項權限。否則，您可以透過 Service Usage 管理員角色 (roles/serviceusage.serviceUsageAdmin) 取得這項權限。瞭解如何授予角色。

    啟用 API

  3. 安裝並初始化 gcloud CLI。

安裝 Cloud SQL Proxy Operator

請按照下列步驟安裝 Cloud SQL Proxy Operator。

  1. 確認 kubectl 可連線至 GKE 叢集。
    kubectl cluster-info
     如要進一步瞭解如何將 Google Kubernetes Engine 連線至 Cloud SQL，請參閱「從 Google Kubernetes Engine 連線」。
  2. 使用 Helm 安裝 cert-manager。您必須使用這裡指定的版本和 CLI 引數，才能在 GKE 叢集上使用 cert-manager。
          helm repo add jetstack https://charts.jetstack.io
      helm repo update
      helm install \
        cert-manager jetstack/cert-manager \
        --namespace cert-manager \
        --version "v1.9.1" \
        --create-namespace \
        --set global.leaderElection.namespace=cert-manager \
        --set installCRDs=true
  3. 將 Cloud SQL Proxy Operator 安裝至 Kubernetes 叢集： 
    kubectl apply -f https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy-operator/v1.8.5/cloud-sql-proxy-operator.yaml
  4. 等待 Cloud SQL Proxy Operator 啟動。
    kubectl rollout status deployment -n cloud-sql-proxy-operator-system cloud-sql-proxy-operator-controller-manager --timeout=90s
  5. 確認 Cloud SQL Proxy Operator 已安裝並執行：
    kubectl get pods -n cloud-sql-proxy-operator-system

後續步驟