Connetti da Compute Engine

Per eseguire query SQL e gestire il database da una macchina virtuale (VM) nella tua rete Virtual Private Cloud (VPC), puoi connettere lo strumento client psql su una VM Compute Engine a un'istanza AlloyDB tramite l'accesso privato ai servizi:

  1. Crea una VM di Compute Engine che possa connettersi alle istanze AlloyDB utilizzando l'accesso privato ai servizi.
  2. Installa il client psql sulla VM di Compute Engine.
  3. Recupera l'indirizzo IP dell'istanza AlloyDB a cui vuoi connetterti.
  4. Esegui il client psql.

Le prime due attività sono operazioni una tantum. Dopo aver creato una VM di Compute Engine e aver installato il client psql, puoi continuare a utilizzare la VM per connettere psql alle istanze AlloyDB completando le attività rimanenti.

Prima di iniziare

  • Il progetto Google Cloud che stai utilizzando deve essere stato abilitato per accedere ad AlloyDB.
  • Una rete VPC nel progetto Google Cloud che stai utilizzando deve essere già configurata per l'accesso privato ai servizi ad AlloyDB.
  • Devi disporre di uno di questi ruoli IAM nel progetto Google Cloud che stai utilizzando:
    • roles/alloydb.admin (il ruolo IAM predefinito AlloyDB Admin)
    • roles/owner (il ruolo IAM di base Proprietario)
    • roles/editor (il ruolo IAM di base Editor)

    Se non disponi di nessuno di questi ruoli, contatta l'Amministratore organizzazione per richiedere l'accesso.

  • Se l'host client ha un firewall, deve consentire le connessioni in uscita alla porta 5432 sugli indirizzi IP delle istanze AlloyDB.

Crea una VM di Compute Engine

  1. Nella console Google Cloud , vai alla pagina Istanze VM.

    Vai a Istanze VM

  2. Seleziona il progetto contenente l'istanza AlloyDB a cui vuoi connetterti.
  3. Fai clic su Crea istanza.
  4. Fai clic sulla sezione Configurazione macchina.
  5. Inserisci un Nome per l'istanza.
  6. Configura la regione e la zona in cui vuoi creare l'istanza.
  7. Seleziona una serie di macchine e il tipo di macchina corrispondente.
  8. Mantieni i valori predefiniti nella sezione Sistema operativo e spazio di archiviazione.
  9. Fai clic sulla sezione Networking e imposta Interfacce di rete sulla rete VPC configurata per l'accesso privato ai servizi ad AlloyDB.
    Se l'opzione Interfacce di rete non è impostata sulla rete VPC configurata per l'accesso privato ai servizi, espandila e imposta Rete sulla rete VPC.
  10. Mantieni i valori predefiniti nella sezione Osservabilità.
  11. Fai clic sulla sezione Sicurezza.
  12. In Identità e accesso API, imposta Ambiti di accesso su Consenti l'accesso completo a tutte le API Cloud.
  13. Mantieni i valori predefiniti nella sezione Avanzate.
  14. Fai clic su Crea.

Dopo aver creato la VM, connettiti alla VM di Compute Engine che hai creato utilizzando SSH.

Installa lo strumento client psql

Per installare lo strumento client psql sull'host client, consulta Installa lo strumento client psql.

Se utilizzi una VM di Compute Engine come host client, segui questi passaggi per connetterti alla VM e installare psql:

  1. Connettiti alla VM di Compute Engine che hai creato utilizzando SSH.

    Console

    1. Nella console Google Cloud , vai alla pagina Istanze VM.

      Vai a Istanze VM

    2. Nell'elenco delle istanze della macchina virtuale, fai clic su SSH nella riga dell'istanza che hai creato.

    gcloud

    Utilizza il comando gcloud compute ssh per connetterti all'istanza che hai creato.

    gcloud compute ssh --project=PROJECT_ID --zone=ZONE VM_NAME

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID del progetto che contiene l'istanza
    • ZONE: il nome della zona in cui si trova l'istanza
    • VM_NAME: il nome dell'istanza

  2. Installa il client psql dal gestore di pacchetti: 

    sudo apt-get update
sudo apt-get install postgresql-client

Ottieni l'indirizzo IP dell'istanza AlloyDB

Per ottenere l'indirizzo IP dell'istanza AlloyDB a cui vuoi connetterti, visualizza le impostazioni dell'istanza.

Esegui il client psql

  1. Connettiti alla VM che hai creato utilizzando SSH.

    Console

    1. Nella console Google Cloud , vai alla pagina Istanze VM.

      Vai a Istanze VM

    2. Nell'elenco delle istanze della macchina virtuale, fai clic su SSH nella riga dell'istanza che hai creato.

    gcloud

    Utilizza il comando gcloud compute ssh per connetterti all'istanza che hai creato.

    gcloud compute ssh --project=PROJECT_ID --zone=ZONE VM_NAME

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID del progetto che contiene l'istanza.
    • ZONE: il nome della zona in cui si trova l'istanza.
    • VM_NAME: il nome dell'istanza
  2. Esegui lo strumento client psql: 
    psql -h IP_ADDRESS -p 5432 -U USERNAME -d postgres

    Ti viene chiesto di inserire la password dell'utente USERNAME.

    Se è la prima volta che ti connetti, specifica postgres sia per USERNAME sia per il database. Il comando è simile al seguente:

    psql -h IP_ADDRESS -p 5432 -U postgres -d postgres

    Utilizza la password che hai impostato quando hai creato il cluster.

Passaggi successivi