Connettiti ad AlloyDB da Cloud Shell utilizzando il proxy di autenticazione

Scopri come stabilire una connessione sicura all'istanza AlloyDB per PostgreSQL da un terminale Cloud Shell utilizzando il proxy di autenticazione AlloyDB. Questa guida rapida è adatta ai nuovi utenti che vogliono un ambiente semplice e preconfigurato per connettersi alla propria istanza e testare query SQL di base.

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 abilitata 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 Auth Proxy, 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 dei principal.

  3. Fai clic su Modifica soggetto principale.

  4. Fai clic su Aggiungi un altro ruolo.

  5. Cerca e seleziona il ruolo AlloyDB Client.

  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 farlo solo la prima volta che utilizzi Cloud Shell.

  3. Conferma l'identità dell'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 l'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 Cloud Shell esistente, premi Ctrl+b+" o fai clic su 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+freccia su o Ctrl+B+freccia giù.

    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 del tuo utente PostgreSQL.

  8. Verifica la connessione eseguendo una query SQL.

    SELECT now();

  9. Per arrestare psql, inserisci \q.

  10. Per arrestare Cloud Shell, inserisci exit.

  11. Per arrestare il proxy di autenticazione, inserisci 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