Utilizzare la replica tra regioni

Questa pagina descrive come utilizzare la replica tra regioni creando e lavorando con cluster secondari.

Per una panoramica concettuale della replica tra regioni, consulta Informazioni sulla replica tra regioni.

Nota: non puoi attivare Query Insights avanzato per AlloyDB nelle istanze dei cluster di repliche tra regioni. Per ulteriori informazioni, consulta la sezione Limitazioni e le Domande frequenti.

Prima di iniziare

• Il progetto Google Cloud che utilizzi deve essere stato abilitato per accedere ad AlloyDB.
• Devi disporre di uno di questi ruoli IAM nel progetto Google Cloud che utilizzi:
  • 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 dell'organizzazione per richiedere l'accesso.

Crea un cluster secondario

Quando crei un cluster secondario, AlloyDB copia e applica al cluster secondario parte della configurazione del cluster principale, tra cui il recupero point-in-time (PITR) e la configurazione del backup. AlloyDB non aggiunge istanze del pool di lettura al cluster secondario dopo averlo creato, indipendentemente dal numero di istanze del pool di lettura esistenti nel cluster principale.

Se aggiorni la configurazione del cluster principale dopo aver creato il cluster secondario, le modifiche non sono disponibili nel cluster secondario. Tuttavia, puoi aggiornare manualmente il cluster secondario per avere la configurazione più recente disponibile nel cluster principale.

Per creare un cluster secondario e un'istanza secondaria AlloyDB:

Console

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

   Vai a Cluster

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

3. Nella pagina Panoramica, fai clic su Crea cluster secondario.

4. Configura il cluster secondario:

   1. Nel campo ID cluster, inserisci un ID risorsa per il cluster secondario.
   2. Seleziona una regione per il cluster secondario diversa da quella del cluster principale.
   3. Seleziona la crittografia gestita da Google predefinita o una chiave gestita dal cliente (CMEK) come metodo di crittografia per criptare il cluster secondario.

   Se vuoi criptare questo cluster utilizzando la chiave CMEK, segui questi passaggi:

   1. Fai clic su Opzioni di crittografia avanzate.
   2. Seleziona Chiave di crittografia gestita dal cliente (CMEK).

   3. Seleziona una chiave gestita dal cliente dal menu visualizzato.

      La console Google Cloud limita questo elenco alle chiavi nello stessoGoogle Cloud progetto e nella stessa regione del nuovo cluster.

      Per utilizzare una chiave non presente in questo elenco:

      1. Fai clic su Non vedi la chiave? Inserisci il nome della risorsa della chiave.
      2. Inserisci il nome della risorsa nel campo Nome risorsa della chiave.
      3. Fai clic su Salva.
      4. Fai clic su Continua.

   L'utilizzo della chiave CMEK con AlloyDB richiede una configurazione aggiuntiva. Per maggiori informazioni, consulta Utilizzare CMEK.

   Se l'istanza principale associata è criptata con una chiave CMEK, devi criptare anche il relativo cluster secondario con una chiave CMEK.

5. Configura l'istanza secondaria:

   1. Nel campo ID istanza, inserisci un ID risorsa per l'istanza secondaria. L'ID risorsa deve essere univoco all'interno di un cluster.

6. Fai clic su Crea cluster.

gcloud

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

Utilizza il comando gcloud alloydb clusters create-secondary:

 gcloud alloydb clusters create-secondary SECONDARY_CLUSTER_ID \
 --region=REGION_ID \
 --primary-cluster=projects/PROJECT_ID/locations/LOCATION_ID/clusters/ PRIMARY_CLUSTER_ID \
 gcloud alloydb instances create-secondary SECONDARY_INSTANCE_ID \
 --cluster=SECONDARY_CLUSTER_ID \
 --region=REGION_ID

Sostituisci quanto segue:

• SECONDARY_CLUSTER_ID: l'ID del cluster secondario che vuoi creare.
• SECONDARY_INSTANCE_ID: l'ID dell'istanza secondaria che vuoi creare.
• REGION_ID: l'ID della regione del cluster secondario, ad esempio us-central1.
• PROJECT_ID: l'ID del progetto del cluster secondario.
• LOCATION_ID: la posizione in cui si trova il cluster principale, ad esempio us-central1.
• PRIMARY_CLUSTER_ID: l'ID del cluster principale a cui è associato il cluster secondario.
• SECONDARY_CLUSTER_ID: l'ID del cluster secondario a cui è associata l'istanza secondaria.
• ALLOWED_PROJECT (Facoltativo): l'elenco separato da virgole di ID progetto o numeri progetto a cui vuoi consentire l'accesso all'istanza, ad esempio my-project-1, 12345,my-project-n. Devi impostare un elenco di progetti o numeri consentiti, se il tuo cluster utilizza Private Service Connect come metodo di connessione all'istanza.
• --no-enable-automated-backup(Facoltativo) Disattiva la creazione di backup automatici sul cluster secondario.

Per creare un cluster e un'istanza secondari abilitati per Private Service Connect, aggiungi il flag --enable-private-service-connect quando crei un cluster e il flag --allowed-psc-projects per impostare un elenco separato da virgole di ID progetto o numeri di progetto a cui vuoi consentire l'accesso all'istanza, ad esempio my-project-1, 12345,my-project-n.

 gcloud alloydb clusters create-secondary SECONDARY_CLUSTER_ID \
 --region=REGION_ID \
 --primary-cluster=projects/PROJECT_ID/locations/LOCATION_ID/clusters/ PRIMARY_CLUSTER_ID \
 --enable-private-service-connect
 gcloud alloydb instances create-secondary SECONDARY_INSTANCE_ID \
 --cluster=SECONDARY_CLUSTER_ID \
 --region=REGION_ID \
 --allowed-psc-projects=ALLOWED_PROJECT_LIST

Sostituisci quanto segue:

• ALLOWED_PROJECT (Facoltativo): l'elenco separato da virgole degli ID progetto o dei numeri di progetto a cui vuoi consentire l'accesso all'istanza, ad esempio my-project-1, 12345, my-project-n. Devi impostare un elenco di progetti o numeri consentiti se il tuo cluster utilizza Private Service Connect come metodo di connessione all'istanza.

Per creare un'istanza secondaria per un cluster con IP pubblico abilitato, aggiungi il parametro --assign-inbound-public-ip=ASSIGN_IPV4.

 gcloud alloydb instances create-secondary SECONDARY_INSTANCE_ID \
 --cluster=SECONDARY_CLUSTER_ID \
 --region=REGION_ID \
  --assign-inbound-public-ip=ASSIGN_IPV4

Se vuoi, puoi passare l'elenco separato da virgole dei blocchi CIDR, ad esempio 64.233.160.0/16, al parametro --authorized-external-networks per impostare le reti esterne autorizzate nella tua istanza.

Visualizzare un cluster secondario

Per visualizzare informazioni dettagliate su un cluster secondario AlloyDB, segui questi passaggi:

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

   Vai a Cluster

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

3. Nella pagina Panoramica, visualizza tutti i dettagli del cluster secondario.

Aggiornare un'istanza secondaria

Puoi aggiornare un'istanza secondaria per aggiungere, modificare o eliminare i flag del database. Puoi anche eseguire il ridimensionamento del tipo di macchina dell'istanza secondaria.

Configurare i flag di database su un'istanza secondaria

Per aggiungere, modificare o eliminare i flag del database, completa i seguenti passaggi:

Console

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

   Vai a Cluster

2. Nella colonna Nome risorsa, fai clic su un cluster secondario da modificare.

3. Nella pagina Panoramica, vai a Istanze nel cluster, seleziona l'istanza secondaria e poi fai clic su Modifica secondaria.

4. Aggiungi, modifica o elimina un flag di database dall'istanza:

   Aggiungere una segnalazione

   1. Per aggiungere un flag di database all'istanza, fai clic su Aggiungi flag.
   2. Seleziona un indicatore dall'elenco Nuovo indicatore database.
   3. Specifica un valore per il flag.
   4. Fai clic su Fine.

   Modificare un indicatore

   1. Per modificare un flag di database presente nell'istanza, espandi il flag di database e modifica il valore del flag esistente nella sezione Modifica flag di database.
   2. Fai clic su Fine.

   Eliminare un indicatore

   1. Per eliminare un flag del database dall'istanza, seleziona un flag e fai clic sull'icona di eliminazione.
   2. Fai clic su Fine.

5. Fai clic su Aggiorna secondario.

gcloud

Utilizza il comando gcloud alloydb instances update per modificare i flag del database per un'istanza secondaria.

Attenzione: l'esecuzione del seguente comando sovrascrive tutti i flag di database impostati in precedenza. Eventuali flag di database non inclusi esplicitamente nell'elenco--database-flags vengono reimpostati sul valore predefinito. Per conservare i flag del database dell'istanza aggiungendone di nuovi, devi includere sia i flag attuali che quelli nuovi nell'elenco --database-flags.

 gcloud alloydb instances update SECONDARY_INSTANCE_ID \
  --database-flags FLAGS_LIST \
  --region=REGION_ID \
  --cluster=CLUSTER_ID \
  --project=PROJECT_ID

Sostituisci quanto segue:

• SECONDARY_INSTANCE_ID: l'ID dell'istanza secondaria.
• FLAGS_LIST: un elenco separato da virgole di una o più specifiche di indicatori del database. Ogni specifica è composta dal nome del flag, da un segno di uguale (=) e dal valore da assegnare ai flag. Per i flag di database che non accettano valori, fornisci il nome del flag seguito da un segno di uguale (=).
• REGION_ID: la regione in cui è collocata l'istanza secondaria, ad esempio us-central1.
• CLUSTER_ID: l'ID del cluster in cui è posizionata l'istanza secondaria.
• PROJECT_ID: l'ID del progetto in cui è posizionato il cluster secondario.

Esegui il ridimensionamento del tipo di macchina dell'istanza secondaria

Per eseguire il ridimensionamento del tipo di macchina dell'istanza secondaria:

Console

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

   Vai a Cluster

2. Nella colonna Nome risorsa, fai clic su un cluster secondario da modificare.

3. Nella pagina Panoramica, vai alla sezione Istanze nel cluster e fai clic su Modifica secondario.

   Tieni presente che questa azione non è disponibile se la pagina riporta lo stato Manutenzione per un cluster. L'azione diventa di nuovo disponibile dopo che lo stato Stato diventa Pronto.

4. Seleziona un tipo di macchina.

5. Fai clic su Aggiorna secondario.

gcloud

Utilizza il comando gcloud alloydb instances update per modificare il tipo di macchina dell'istanza secondaria.

 gcloud alloydb instances update SECONDARY_INSTANCE_ID \
  --cpu-count=CPU_COUNT \
  --region=REGION_ID \
  --cluster=CLUSTER_ID \
  --project=PROJECT_ID

Sostituisci quanto segue:

• SECONDARY_INSTANCE_ID: l'ID dell'istanza secondaria che stai aggiornando.

• 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)

• REGION_ID: la regione in cui è posizionata l'istanza.

• CLUSTER_ID: l'ID del cluster in cui è posizionata l'istanza.

• PROJECT_ID: l'ID del progetto in cui è posizionato il cluster.

Se il comando restituisce un messaggio di errore che include la frase invalid cluster state MAINTENANCE, significa che il cluster è in fase di manutenzione di routine. In questo modo, la ricofigurazione dell'istanza non sarà consentita temporaneamente. Esegui nuovamente il comando quando il cluster torna allo stato READY.

Per controllare lo stato del cluster, vedi Visualizzare i dettagli del cluster.

Aggiungere istanze del pool di lettura a un cluster secondario

Per aggiungere un'istanza del pool di lettura a un cluster secondario:

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

   Vai a Cluster

2. Nella colonna Nome risorsa, fai clic su un cluster secondario a cui vuoi aggiungere un'istanza del pool di lettura.

3. Nella pagina Panoramica, vai alla sezione Istanze nel cluster e fai clic su Aggiungi pool di lettura.

4. Configura l'istanza del pool di lettura:

   1. Nel campo ID istanza pool di lettura, inserisci un ID per l'istanza del pool di lettura.
   2. Nel campo Numero di nodi, inserisci un numero di nodi. Il numero di nodi in un'istanza del pool di lettura determina la capacità di calcolo complessiva dell'istanza. Puoi avere un massimo di 20 nodi in tutte le istanze del pool di lettura di un cluster.
   3. Seleziona un tipo di macchina.

   4. (Facoltativo) Imposta flag personalizzati per l'istanza. Per ogni indicatore, svolgi le seguenti operazioni:

      1. Fai clic su Aggiungi indicatore.
      2. Seleziona un indicatore dall'elenco Nuovo indicatore database.
      3. Specifica un valore per il flag.
      4. Fai clic su Fine.

5. Fai clic su Aggiungi pool di lettura.

Promuovere un cluster secondario

Prima di promuovere un cluster secondario, svolgi i seguenti passaggi per verificare che il cluster secondario abbia applicato tutte le transazioni ricevute dal cluster principale:

1. Interrompi tutte le scritture nel cluster principale.

2. Controlla lo stato della replica del cluster secondario completando i seguenti passaggi:

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

      Vai a Cluster

   2. Nell'elenco dei cluster, fai clic sul nome del cluster secondario da promuovere.

   3. Nella pagina dei dettagli del cluster, fai clic su Monitoraggio.

   4. Nell'elenco Monitoraggio, seleziona l'istanza secondaria. Nell'elenco viene visualizzato come Secondario: INSTANCE_NAME.

   5. Nell'elenco delle metriche, individua il grafico Ritardo della replica dall'istanza principale.

   6. Verifica che il grafico mostri un ritardo minimo.

      Un valore di tempo di latenza di 0 è ideale. Se il ritardo è superiore a 0, puoi comunque promuovere il cluster secondario, a rischio di perdere alcune transazioni recenti già committate nel cluster principale.

   7. Nell'elenco delle metriche, individua il grafico Stato replica.

   8. Verifica che tutti i nodi rappresentati nel grafico abbiano un valore streaming.

Per promuovere un cluster secondario a cluster principale:

Console

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

   Vai a Cluster

2. Nella colonna Nome risorsa, fai clic su un cluster secondario da promuovere come cluster principale.

3. Nella pagina Panoramica, fai clic su Promuovi cluster.

4. Nella finestra di dialogo visualizzata, inserisci l'ID cluster secondario per confermare che vuoi promuovere il cluster.

5. Fai clic su Promuovi.

   Dopo la promozione del cluster, il campo Tipo: cluster secondario (alta disponibilità) nella pagina Panoramica viene aggiornato in Tipo: alta disponibilità con pool di lettura.

gcloud

Utilizza il comando gcloud alloydb clusters promote:

 gcloud alloydb clusters promote SECONDARY_CLUSTER_ID \
 --region=REGION_ID \
 --project=PROJECT_ID \

Sostituisci quanto segue:

• SECONDARY_CLUSTER_ID: l'ID del cluster secondario che vuoi promuovere.
• REGION_ID: l'ID della regione del cluster secondario,ad esempious-central1.
• PROJECT_ID: l'ID del progetto del cluster secondario.

Eseguire uno switchover

Prima di eseguire il passaggio, verifica che entrambe le regioni a cui appartengono le istanze principali e secondarie siano online e che le istanze siano in uno stato corretto. Per ulteriori informazioni, consulta Monitorare un'istanza utilizzando la dashboard Approfondimenti sul sistema di AlloyDB.

Utilizza il comando gcloud alloydb clusters switchover:

   gcloud alloydb clusters switchover SECONDARY_CLUSTER_ID \
   --region=REGION_ID \
   --project=PROJECT_ID \

Sostituisci quanto segue:

• SECONDARY_CLUSTER_ID: l'ID del cluster secondario che vuoi promuovere.
• REGION_ID: l'ID della regione del cluster secondario, ad esempio us-central1.
• PROJECT_ID: l'ID del progetto del cluster secondario.

Passaggi successivi

• Visualizza i dettagli del cluster.
• Visualizza l'elenco dei cluster.