Connettersi dal laptop

Per esplorare AlloyDB per PostgreSQL o lavorare in un ambiente di sviluppo locale, puoi stabilire una connessione sicura dal tuo laptop o dalla tua workstation locale a un'istanza AlloyDB utilizzando il proxy di autenticazione AlloyDB su un indirizzo IP pubblico.

Prima di iniziare

Prima di connetterti dal tuo laptop, completa i seguenti prerequisiti:

Ruoli obbligatori

Per connetterti dal tuo laptop, concedi all'entità Identity and Access Management (IAM) (account utente o account di servizio) i seguenti ruoli predefiniti:

  • Client AlloyDB (roles/alloydb.client)
  • Service Usage Consumer (roles/serviceusage.serviceUsageConsumer)

Abilita l'IP pubblico nell'istanza AlloyDB

Il modo più semplice per connetterti dal tuo laptop è abilitare l'IP pubblico sulla tua istanza AlloyDB. Puoi abilitare l'IP pubblico quando crei un'istanza o aggiorni un'istanza esistente per abilitarlo.

Console

  1. Vai alla pagina Cluster nella console Google Cloud .

    Vai a Cluster

  2. Per visualizzare i dettagli del cluster, fai clic su un cluster in Nome risorsa.

  3. In Istanze nel tuo cluster, individua l'istanza a cui vuoi connetterti.

  4. Fai clic su Azioni istanza e poi su Modifica.

  5. In Connettività, seleziona Abilita IP pubblico.

  6. Per salvare le modifiche, fai clic su Aggiorna istanza.

gcloud

Utilizza il comando gcloud alloydb instances update per attivare l'IP pubblico nell'istanza:

gcloud alloydb instances update INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --assign-inbound-public-ip=ASSIGN_IPV4

Sostituisci quanto segue:

  • INSTANCE_ID: l'ID dell'istanza AlloyDB.
  • CLUSTER_ID: l'ID del cluster.
  • REGION_ID: la regione in cui si trova il cluster.

Recupera l'URI di connessione dell'istanza

Quando avvii il client proxy di autenticazione, devi identificare l'istanza utilizzando il relativo URI di connessione univoco. Recupera l'URI di connessione utilizzando il comando gcloud CLI alloydb instances describe sul terminale del tuo laptop.

gcloud alloydb instances describe INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --format="value(name)"

Il comando restituisce l'URI di connessione, che ha un formato simile al seguente:

projects/myproject/locations/us-central1/clusters/mycluster/instances/myprimary

Avvia il proxy di autenticazione AlloyDB con IP pubblico

Ora che hai l'URI di connessione dell'istanza, avvia il client proxy di autenticazione utilizzando il terminale del tuo laptop. Utilizza il flag --public-ip per indicare al proxy di autenticazione AlloyDB di connettersi tramite il percorso di rete con IP pubblico.

./alloydb-auth-proxy CONNECTION_URI --public-ip

Sostituisci CONNECTION_URI con l'URI di connessione dell'istanza che hai ottenuto in Recupera l'URI di connessione dell'istanza.

Quando il proxy di autenticazione AlloyDB si avvia correttamente, il terminale mostra che il proxy di autenticazione AlloyDB è in ascolto delle connessioni TCP locali sulla porta 5432:

Authorizing with Application Default Credentials
Listening on 127.0.0.1:5432
The proxy has started successfully and is ready for new connections!

Connettiti al database utilizzando psql

Mentre il proxy di autenticazione AlloyDB è in esecuzione, apri una finestra del terminale separata sul tuo laptop per connetterti al database.

Esegui lo strumento client psql, scegliendo come target l'indirizzo del listener locale 127.0.0.1 e la porta 5432:

psql -h 127.0.0.1 -U postgres -d postgres

Quando richiesto, inserisci la password dell'utente del database postgres.

Il comando psql si connette al client proxy di autenticazione, che inoltra la connessione tramite un tunnel sicuro alla tua istanza AlloyDB. Il comando psql mostra un prompt che conferma che il tuo laptop è connesso in modo sicuro all'istanza AlloyDB:

psql (18.2 (Debian 18.2-1), server 16.11)
Type "help" for help.

postgres=>

Passaggi successivi