Connettiti utilizzando gcloud CLI

Il comando gcloud beta alloydb connect ti consente di stabilire una connessione autorizzata e criptata a un'istanza AlloyDB per PostgreSQL. Automatizza l'avvio del proxy di autenticazione AlloyDB e l'esecuzione dello strumento client psql.

Utilizza questo comando per l'amministrazione e lo sviluppo manuali del database da ambienti come la tua macchina locale o Cloud Shell.

Per saperne di più, consulta la panoramica delle connessioni.

Prima di iniziare

  1. Installa Google Cloud CLI.
  2. Installa lo strumento client psql.
  3. Assicurati che l'entità Identity and Access Management (IAM) disponga del ruolo Client AlloyDB (roles/alloydb.client). Per saperne di più, consulta Gestisci l'autenticazione IAM.

Connettiti a un'istanza

Per connetterti a un'istanza utilizzando l'utente e il database postgres predefiniti su un IP privato, esegui:

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

Connettiti tramite IP pubblico

Se l'istanza ha un indirizzo IP pubblico abilitato, puoi connetterti aggiungendo il flag --public-ip:

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

Esegui l'autenticazione utilizzando IAM

Il comando gcloud beta alloydb connect supporta l'autenticazione IAM automatica. Utilizza il flag --auto-iam-authn per autenticarti come utente gcloud CLI che ha eseguito l'accesso o come account di servizio.

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

Per saperne di più sull'autenticazione IAM, consulta Autenticazione database IAM.

Connettiti tramite Private Service Connect

Se utilizzi Private Service Connect, aggiungi il flag --psc:

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

Connettiti a un utente e a un database specifici

Per connetterti come utente di un database specifico a un database specifico, utilizza i flag --user e --database:

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

Simulazione dell'identità dei service account

Puoi utilizzare un account di servizio di cui è stata simulata l'identità per autorizzare la connessione. Quando utilizzi la simulazione dell'identità, il proxy di autenticazione utilizza le credenziali del account di servizio specificato per recuperare le informazioni sulla connessione.

Per connetterti utilizzando un account di servizio di cui è stata simulata l'identità, aggiungi il flag --impersonate-service-account:

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

Il proxy di autenticazione utilizza il account di servizio di cui è stata eseguita l'impersonificazione per recuperare le informazioni sulla connessione. Tuttavia, non esegue automaticamente l'autenticazione nel database. Per autenticarti anche nel database come account di servizio di cui è stata simulata l'identità, aggiungi il flag --auto-iam-authn. Il account di servizio di cui viene simulata l'identità deve essere un utente nel tuo database.

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

Passaggi successivi