Connettiti utilizzando l'IP pubblico

Per connetterti all'istanza AlloyDB per PostgreSQL dall'esterno della tua rete Virtual Private Cloud (VPC) o per consentire all'istanza di connettersi a risorse esterne, puoi abilitare la connettività IP pubblico. AlloyDB supporta connessioni IP pubbliche sia in entrata che in uscita:

• IP pubblico in entrata: assegna un indirizzo IPv4 pubblico alla tua istanza AlloyDB in modo che i client esterni possano connettersi. Facoltativamente, puoi limitare le connessioni dirette a indirizzi IP esterni o intervalli CIDR specifici, chiamati reti esterne autorizzate. Le reti esterne autorizzate non sono necessarie quando ti connetti utilizzando gli AlloyDB Language Connector o l'AlloyDB Auth Proxy e non puoi specificare una rete privata come rete esterna autorizzata.
• IP pubblico in uscita: assegna due indirizzi IP pubblici in uscita statici a un'istanza principale o secondaria in modo che il database possa avviare connessioni a origini esterne, ad esempio durante una migrazione del database.

Crea un'istanza AlloyDB

Per creare un'istanza con IP pubblico, segui questi passaggi:

Console

1. Vai alla pagina Cluster.

   Vai a Cluster

2. Fai clic su un cluster nella colonna Nome risorsa.

3. Nella pagina Panoramica, vai a Istanze nel cluster e fai clic su Crea istanza principale.

4. Configura l'istanza principale:

   1. Nel campo ID istanza, inserisci un ID per l'istanza principale.
   2. In Disponibilità a livello di zona, seleziona una delle seguenti opzioni:
      1. Per creare un'istanza di produzione ad alta affidabilità con failover automatico, seleziona Più zone (alta affidabilità).
      2. Per creare un'istanza di base che non deve essere ad alta affidabilità, seleziona Zona singola.
   3. Seleziona un tipo di macchina.
   4. In Connettività, seleziona Abilita IP pubblico per supportare le connessioni in entrata.
   5. (Facoltativo) Per aggiungere la connettività in uscita, in Indirizzi IP pubblici in uscita, seleziona Abilita IP pubblico in uscita.
   6. (Facoltativo) Per configurare i requisiti SSL o del connettore nell'istanza, espandi Opzioni di configurazione avanzate, quindi segui questi passaggi:
      1. Per impostazione predefinita, le istanze AlloyDB richiedono che tutte le connessioni utilizzino la crittografia SSL. Per consentire connessioni non SSL, deseleziona la casella di controllo Consenti solo connessioni SSL.
      2. Per richiedere che tutte le connessioni del database all'istanza utilizzino il proxy di autenticazione AlloyDB o le librerie dei connettori sicuri fornite da Google, seleziona Applica mTLS mediante connettori AlloyDB.

   7. (Facoltativo) Per limitare le connessioni dirette a indirizzi IP specifici, aggiungi un elenco separato da virgole di intervalli CIDR:

      1. In Reti esterne autorizzate, inserisci un elenco separato da virgole di intervalli CIDR. Per ogni intervallo CIDR, inserisci un blocco CIDR, ad esempio 64.233.160.0/16. Per ridurre al minimo la potenziale superficie di attacco, mantieni l'elenco di indirizzi il più piccolo possibile.

         Puoi anche fare clic su Utilizza il mio IP per consentire ad AlloyDB di compilare l'indirizzo IPv4 della macchina client da cui accedi Google Cloud.

         Nota: l'opzione Utilizza il mio IP non è disponibile per i client che utilizzano indirizzi IPv6.

   8. Fai clic su Crea istanza.

gcloud

Per utilizzare gcloud CLI, puoi installare e inizializzare Google Cloud CLI oppure puoi utilizzare Cloud Shell.

Per saperne di più sulla creazione di altri tipi di istanze, consulta Crea un'istanza di pool di lettura e Crea un'istanza secondaria.

Utilizza il comando gcloud alloydb instances create per creare un'istanza.

gcloud alloydb instances create INSTANCE_ID \
    --instance-type=PRIMARY \
    --cpu-count=CPU_COUNT \
    --region=REGION_ID \
    --cluster=CLUSTER_ID \
    --project=PROJECT_ID \
    --database-flags=password.enforce_complexity=on \
    --assign-inbound-public-ip=ASSIGN_IPV4

Sostituisci quanto segue:

• INSTANCE_ID: l'ID dell'istanza che stai creando. Deve iniziare con una lettera minuscola e può contenere lettere minuscole, numeri e trattini.
• CPU_COUNT: il numero di vCPU che vuoi per l'istanza. I valori validi includono:
  • 2: 2 vCPU, 16 GB di RAM
  • 4: 4 vCPU, 32 GB di RAM
  • 8: 8 vCPU, 64 GB di RAM
  • 16: 16 vCPU, 128 GB di RAM
  • 32: 32 vCPU, 256 GB di RAM
  • 64: 64 vCPU, 512 GB di RAM
  • 96: 96 vCPU, 768 GB di RAM
  • 128: 128 vCPU, 864 GB di RAM
• REGION_ID: la regione in cui vuoi posizionare l'istanza.
• CLUSTER_ID: l'ID del cluster che hai creato in precedenza.

(Facoltativo) Aggiungi reti esterne autorizzate

Per limitare le connessioni dirette a indirizzi IP specifici, aggiungi un elenco separato da virgole di intervalli CIDR:

gcloud alloydb instances create INSTANCE_ID \
    --instance-type=PRIMARY \
    --cpu-count=CPU_COUNT \
    --region=REGION_ID \
    --cluster=CLUSTER_ID \
    --project=PROJECT_ID \
    --database-flags=password.enforce_complexity=on \
    --assign-inbound-public-ip=ASSIGN_IPV4 \
    --authorized-external-networks=CIDR_RANGE1,CIDR_RANGE2,...

Sostituisci quanto segue:

• CIDR_RANGE: un elenco separato da virgole di blocchi CIDR, ad esempio 64.233.160.0/16. Per ridurre al minimo la potenziale superficie di attacco, mantieni l'elenco di indirizzi il più piccolo possibile.

(Facoltativo) Aggiungi la connettività in uscita

Aggiungi il flag --outbound-public-ip per abilitare gli indirizzi IP pubblici in uscita. Puoi attivare l'IP pubblico in uscita solo per le istanze principali e secondarie.

gcloud alloydb instances create INSTANCE_ID \
    --instance-type=PRIMARY \
    --cpu-count=CPU_COUNT \
    --region=REGION_ID \
    --cluster=CLUSTER_ID \
    --project=PROJECT_ID \
    --database-flags=password.enforce_complexity=on \
    --assign-inbound-public-ip=ASSIGN_IPV4 \
    --outbound-public-ip

Abilita l'IP pubblico su un'istanza

Per abilitare la connettività in entrata utilizzando l'IP pubblico, segui questi passaggi:

Console

1. Vai alla pagina Cluster.

   Vai a Cluster

2. Fai clic su un cluster nella colonna Nome risorsa.

3. Nella pagina Panoramica che si apre, vai alla sezione Istanze nel cluster e individua l'istanza principale.

4. Fai clic su Azioni istanza > Modifica.

5. In Connettività, seleziona la casella di controllo Abilita IP pubblico per supportare le connessioni in entrata.

6. (Facoltativo) Per limitare le connessioni dirette a indirizzi IP specifici, in Reti esterne autorizzate, inserisci un elenco separato da virgole di intervalli CIDR.

   Per ogni intervallo CIDR, inserisci un blocco CIDR, ad esempio 64.233.160.0/16. Per ridurre al minimo la potenziale superficie di attacco, mantieni l'elenco di indirizzi il più ridotto possibile.

7. Fai clic su Aggiorna istanza per salvare le modifiche.

gcloud

Per utilizzare gcloud CLI, puoi installare e inizializzare Google Cloud CLI oppure puoi utilizzare Cloud Shell.

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 \
    --database-flags=password.enforce_complexity=on \
    --assign-inbound-public-ip=ASSIGN_IPV4

Sostituisci quanto segue:

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

(Facoltativo) Aggiungi reti esterne autorizzate

Per limitare le connessioni dirette a indirizzi IP specifici, aggiungi un elenco separato da virgole di intervalli CIDR:

gcloud alloydb instances update INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --database-flags=password.enforce_complexity=on \
    --assign-inbound-public-ip=ASSIGN_IPV4 \
    --authorized-external-networks=CIDR_RANGE1,CIDR_RANGE2,...

Sostituisci quanto segue:

• CIDR_RANGE: un elenco separato da virgole di blocchi CIDR, ad esempio 64.233.160.0/16. Per ridurre al minimo la potenziale superficie di attacco, mantieni l'elenco di indirizzi il più piccolo possibile.

Disabilita l'IP pubblico su un'istanza

Quando disabiliti l'IP pubblico sulla tua istanza, AlloyDB rimuove l'indirizzo IP pubblico dall'istanza e cancella l'elenco delle reti autorizzate. Tutte le connessioni in entrata alla tua istanza non vanno a buon fine. Le reti esterne autorizzate possono essere utilizzate solo con l'IP pubblico.

Per disabilitare l'IP pubblico:

Console

1. Vai alla pagina Cluster.

   Vai a Cluster

2. Fai clic su un cluster nella colonna Nome risorsa.

3. Nella pagina Panoramica che si apre, vai alla sezione Istanze nel cluster e individua l'istanza principale.

4. Fai clic su Azioni istanza > Modifica.

5. In Connettività, deseleziona la casella di controllo Abilita IP pubblico per interrompere le connessioni in entrata.

6. (Facoltativo) Nella sezione Reti esterne autorizzate, elimina gli intervalli CIDR separati da virgole.

7. Fai clic su Aggiorna istanza per salvare le modifiche.

gcloud

Per utilizzare gcloud CLI, puoi installare e inizializzare Google Cloud CLI oppure puoi utilizzare Cloud Shell.

Utilizza il comando gcloud alloydb instances update per disattivare l'IP pubblico nell'istanza.

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

Sostituisci quanto segue:

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

Aggiorna le reti esterne autorizzate per un'istanza

Puoi aggiornare l'elenco delle reti esterne autorizzate sulla tua istanza in qualsiasi momento. L'IP pubblico deve essere abilitato nell'istanza quando aggiorni l'elenco delle reti esterne autorizzate.

Le reti esterne autorizzate non possono essere aggiunte o rimosse singolarmente e l'elenco delle reti viene sovrascritto ogni volta che viene eseguito il comando di aggiornamento dell'elenco. Per aggiornare le reti esterne autorizzate nell'istanza, devi fornire un elenco separato da virgole di tutte le reti esterne autorizzate ogni volta che vuoi aggiungere o rimuovere una rete. Ogni rete esterna autorizzata deve essere in formato CIDR.

Nota: per limitare il numero e le dimensioni delle reti autorizzate, puoi applicare una policy dell'organizzazione personalizzata. Per saperne di più, consulta Vincoli e operazioni personalizzati supportati.

Per aggiornare l'elenco delle reti esterne autorizzate sulla tua istanza, segui questi passaggi:

Console

1. Vai alla pagina Cluster.

   Vai a Cluster

2. Fai clic su un cluster nella colonna Nome risorsa.

3. Nella pagina Panoramica che si apre, vai alla sezione Istanze nel cluster e individua l'istanza principale.

4. Fai clic su Azioni istanza > Modifica.

5. In Reti esterne autorizzate, inserisci un elenco di intervalli CIDR separati da virgole. Per ogni intervallo CIDR, inserisci un blocco CIDR, ad esempio 64.233.160.0/16. Per ridurre al minimo la potenziale superficie di attacco, mantieni l'elenco di indirizzi il più piccolo possibile.

6. Fai clic su Aggiorna istanza per salvare le modifiche.

gcloud

Per utilizzare gcloud CLI, puoi installare e inizializzare Google Cloud CLI oppure puoi utilizzare Cloud Shell.

Utilizza il comando gcloud alloydb instances update per aggiornare le reti esterne autorizzate sulla tua istanza.

gcloud alloydb instances update INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --authorized-external-networks=CIDR_RANGE1,CIDR_RANGE2,...

Sostituisci quanto segue:

• INSTANCE_ID: l'ID dell'istanza che stai aggiornando.
• CLUSTER_ID: l'ID del cluster che contiene l'istanza.
• REGION_ID: la regione in cui si trova il cluster.
• CIDR_RANGE: un elenco separato da virgole di blocchi CIDR, ad esempio 64.233.160.0/16. Per ridurre al minimo la potenziale superficie di attacco, mantieni l'elenco di indirizzi il più piccolo possibile.

Aggiungi la connettività in uscita a un'istanza

Puoi attivare l'IP pubblico in uscita per stabilire una connessione dalla tua istanza AlloyDB a origini esterne. AlloyDB genera due indirizzi IP pubblici in uscita che rimangono coerenti finché non disattivi la connettività in uscita nell'istanza. Puoi attivare l'IP pubblico in uscita solo per le istanze principali e secondarie.

Per abilitare l'IP pubblico in uscita, segui questi passaggi:

Console

1. Vai alla pagina Cluster.

   Vai a Cluster

2. Fai clic su un cluster nella colonna Nome risorsa.

3. Nella pagina Panoramica che si apre, vai alla sezione Istanze nel tuo cluster e individua l'istanza principale.

4. Fai clic su Azioni istanza > Modifica.

5. In Connettività dell'IP pubblico in uscita, seleziona la casella di controllo Abilita IP pubblico in uscita per supportare le connessioni in uscita.

6. Fai clic su Aggiorna istanza per salvare le modifiche.

gcloud

Per utilizzare gcloud CLI, puoi installare e inizializzare Google Cloud CLI oppure puoi utilizzare Cloud Shell.

Utilizza il comando gcloud alloydb instances update per attivare l'IP pubblico in uscita sull'istanza.

gcloud alloydb instances update INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID \
    --outbound-public-ip

Sostituisci quanto segue:

• INSTANCE_ID: l'ID dell'istanza per cui stai aggiungendo la connettività in uscita.
• CLUSTER_ID: l'ID del cluster per cui stai aggiungendo la connettività in uscita.
• REGION_ID: la regione in cui si trova il cluster.

Visualizza i dettagli di connettività di un'istanza

Visualizza l'elenco delle reti esterne autorizzate sulla tua istanza in qualsiasi momento e l'indirizzo IP pubblico assegnato utilizzando il comando gcloud alloydb instances describe. Puoi anche visualizzare gli indirizzi IP pubblici in uscita, se hai abilitato la connettività in uscita sulla tua istanza.

Per visualizzare i dettagli della connettività, segui questi passaggi:

Console

1. Vai alla pagina Cluster.

   Vai a Cluster

2. Fai clic su un cluster nella colonna Nome risorsa.

3. Vai alla pagina Connettività, dove puoi visualizzare le informazioni sulla configurazione dell'IP pubblico, tra cui Connettività dell'IP pubblico e IP pubblico in uscita.

   Per visualizzare le informazioni sull'IP pubblico, puoi anche scegliere un'istanza da Istanze nel cluster e poi fare clic su Visualizza configurazione della connettività.

gcloud

Per utilizzare gcloud CLI, puoi installare e inizializzare Google Cloud CLI oppure puoi utilizzare Cloud Shell.

gcloud alloydb instances describe INSTANCE_ID \
    --cluster=CLUSTER_ID \
    --region=REGION_ID

Sostituisci quanto segue:

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

Passaggi successivi

• Panoramica della connessione
• Policy dell'organizzazione e vincoli personalizzati
• Connettiti utilizzando il proxy di autenticazione AlloyDB
• Connettiti utilizzando AlloyDB Language Connector