Connettiti ad AlloyDB da Cloud Shell utilizzando il proxy di autenticazione

Per connetterti alla tua istanza AlloyDB per PostgreSQL ed eseguire query SQL da un terminale del browser preconfigurato senza installare strumenti client locali, puoi utilizzare Cloud Shell e il proxy di autenticazione AlloyDB.

Prima di iniziare

  1. Nella console Google Cloud , nella pagina di selezione del progetto, seleziona o crea un progetto Google Cloud .

    Vai al selettore di progetti

  2. Verifica che la fatturazione sia attivata per il tuo progetto Google Cloud . La verifica della fatturazione attiva tutti i servizi necessari.

  3. Assicurati di avere un'istanza AlloyDB configurata per l'IP pubblico. Cloud Shell non può connettersi a un indirizzo IP privato.

Ruoli obbligatori

Per utilizzare il proxy di autenticazione, il tuo account utente deve disporre dei seguenti ruoli IAM (Identity and Access Management):

Se non disponi dei ruoli richiesti, chiedi all'amministratore di concederli o segui questi passaggi per concederli al tuo account utente:

  1. Nella console Google Cloud vai alla pagina IAM.

    Vai a IAM

  2. Trova il tuo account utente nell'elenco delle entità.

  3. Fai clic su Modifica entità.

  4. Fai clic su Aggiungi un altro ruolo.

  5. Cerca e seleziona il ruolo Client AlloyDB.

  6. Fai clic su Applica.

  7. Fai clic su Aggiungi un altro ruolo.

  8. Cerca e seleziona il ruolo Service Usage Consumer.

  9. Fai clic su Applica.

  10. Fai clic su Salva.

Connettiti all'istanza AlloyDB

L'ambiente Cloud Shell include il proxy di autenticazione (alloydb-auth-proxy) e psql, il terminale interattivo PostgreSQL.

  1. Attiva Cloud Shell.

    Attiva Cloud Shell

  2. Fai clic su Autorizza Cloud Shell. Devi eseguire questa operazione solo la prima volta che utilizzi Cloud Shell.

  3. Conferma la tua identità utente nell'editor di Cloud Shell. Verifica di aver eseguito l'accesso con l'account utente che dispone dei ruoli IAM richiesti.

    gcloud config list

  4. Recupera l'URI di connessione per la tua istanza:

    1. Nella console Google Cloud , vai alla pagina Cluster.

      Vai a Cluster

    2. Seleziona il cluster e trova l'istanza principale.

    3. Fai clic su Visualizza configurazione di connettività.

    4. Copia l'URI di connessione.

  5. Avvia il proxy di autenticazione. Nel terminale Cloud Shell, utilizza l'URI copiato e specifica il flag --public-ip:

    alloydb-auth-proxy CONNECTION_URI --public-ip

    Sostituisci quanto segue:

    • CONNECTION_URI: l'URI di connessione che hai copiato dalla console Google Cloud .

    Il proxy di autenticazione si avvia e visualizza un messaggio che conferma che è in ascolto su 127.0.0.1:5432.

  6. Apri una nuova scheda di Cloud Shell e connettiti al database utilizzando psql:

    psql "host=localhost user=POSTGRES_USERNAME dbname=POSTGRES_DATABASE port=5432"

    Per aprire un nuovo riquadro del terminale nella finestra di Cloud Shell esistente, premi Ctrl+B+" o fai clic su Aggiungi Aggiungi. In questo modo puoi mantenere in esecuzione il proxy di autenticazione in un riquadro mentre esegui i comandi di connessione nel secondo riquadro.

    Per passare da un riquadro all'altro, premi Ctrl+B+keyboard_arrow_up o Ctrl+B+keyboard_arrow_down.

    Sostituisci quanto segue:

    • POSTGRES_USERNAME: il tuo utente AlloyDB, in genere postgres.
    • POSTGRES_DATABASE: il nome del tuo database AlloyDB, in genere postgres.

  7. Quando richiesto, inserisci la password dell'utente PostgreSQL.

  8. Verifica la connessione eseguendo una query SQL:

    SELECT now();

  9. Per interrompere psql, inserisci \q.

  10. Per arrestare Cloud Shell, inserisci exit.

  11. Per arrestare il proxy di autenticazione, premi Ctrl+C.

Esegui la pulizia

Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questa pagina, segui questi passaggi.

  1. Nella console Google Cloud , vai alla pagina Cluster.

    Vai a Cluster

  2. Fai clic sul cluster che hai creato.

  3. Fai clic su Elimina cluster.

  4. Nella finestra di dialogo di conferma, inserisci l'ID del cluster e fai clic su Elimina per eliminare il cluster e le relative istanze.

Passaggi successivi