Esegui la connessione utilizzando l'operatore Cloud SQL Proxy

Questa pagina descrive come connetterti alla tua istanza Cloud SQL utilizzando l'operatore proxy Cloud SQL. Per saperne di più sul funzionamento dell'operatore proxy Cloud SQL, consulta Informazioni sull'operatore proxy Cloud SQL.

Panoramica

L'operatore proxy Cloud SQL configura le applicazioni di cui è stato eseguito il deployment su Google Kubernetes Engine (GKE) per connettersi alle istanze di database Cloud SQL utilizzando il Cloud SQL Auth Proxy. L'utilizzo del Cloud SQL Auth Proxy è il metodo consigliato per connettersi a un'istanza Cloud SQL. Per saperne di più sul proxy di autenticazione Cloud SQL, consulta Informazioni sul proxy di autenticazione Cloud SQL.

Le applicazioni in esecuzione in GKE possono connettersi utilizzando il Cloud SQL Auth Proxy.

Prima di iniziare

Prima di poterti connettere a un'istanza Cloud SQL, segui questi passaggi:

  1. Per un account utente o di servizio, assicurati che l'account disponga del ruolo Client Cloud SQL. Questo ruolo contiene l'autorizzazione cloudsql.instances.connect, che autorizza un'entità a connettersi a tutte le istanze Cloud SQL di un progetto.

    Vai alla pagina IAM

    Facoltativamente, puoi includere una condizione IAM nell'associazione della policy IAM che concede al service account l'autorizzazione per connettersi solo a un'istanza Cloud SQL specifica.

  2. Abilita l'API Cloud SQL Admin, se non è già abilitata.

    Ruoli richiesti per abilitare le API

    Per abilitare le API, devi disporre dell'autorizzazione serviceusage.services.enable. Se hai creato il progetto, probabilmente hai già questa autorizzazione tramite il ruolo Proprietario (roles/owner). In caso contrario, puoi ottenere questa autorizzazione tramite il ruolo Amministratore Service Usage (roles/serviceusage.serviceUsageAdmin). Scopri come concedere i ruoli.

    Abilitare l'API

  3. Installa e inizializza gcloud CLI.

Installa l'operatore proxy Cloud SQL

Per installare l'operatore proxy Cloud SQL, segui questi passaggi.

  1. Verifica che kubectl possa connettersi al tuo cluster GKE.
    kubectl cluster-info
    Per saperne di più sulla connessione di Google Kubernetes Engine a Cloud SQL, consulta Connettiti da Google Kubernetes Engine.
  2. Installa cert-manager utilizzando Helm. Per utilizzare cert-manager sul tuo cluster GKE, dovrai utilizzare gli argomenti version e cli specificati qui.
          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. Installa l'operatore proxy Cloud SQL nel tuo cluster Kubernetes:
    kubectl apply -f https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy-operator/v1.8.5/cloud-sql-proxy-operator.yaml
        
  4. Attendi l'avvio dell'operatore proxy Cloud SQL.
    kubectl rollout status deployment -n cloud-sql-proxy-operator-system cloud-sql-proxy-operator-controller-manager --timeout=90s
        
  5. Verifica che l'operatore proxy Cloud SQL sia installato e in esecuzione:
    kubectl get pods -n cloud-sql-proxy-operator-system
      

Passaggi successivi