Utilizzare la replica tra regioni

Per mantenere la disponibilità tra regioni e scalare i workload di lettura a livello globale, puoi creare e gestire cluster secondari AlloyDB per PostgreSQL, aggiungere istanze di pool di lettura ed eseguire operazioni di cambio o promozione.

Per una panoramica concettuale della replica tra regioni, consulta la panoramica della replica tra regioni.

Prima di iniziare

  • Il progetto Google Cloud che stai utilizzando deve essere stato abilitato per accedere 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.

Crea un cluster secondario

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

Se aggiorni la configurazione del cluster primario dopo aver creato il cluster secondario, le modifiche non saranno disponibili nel cluster secondario. Tuttavia, puoi aggiornare manualmente il cluster secondario in modo che abbia la configurazione più recente disponibile nel cluster primario.

Puoi creare fino a cinque cluster secondari per un cluster primario. Tutti i cluster secondari vengono replicati da un'unica istanza principale. Se promuovi un cluster secondario, questo diventa un cluster primario indipendente.

Il seguente diagramma illustra come promuovere il cluster secondario denominato cluster-2 in us-east4:

Esempio di promozione di un cluster secondario.

Figura 1. Esempio di promozione di un cluster secondario.

Per creare un cluster secondario e un'istanza secondaria AlloyDB, segui questi passaggi:

Per impostazione predefinita, AlloyDB crea istanze secondarie con la stessa configurazione della macchina dell'istanza principale al momento della creazione. Tuttavia, se esegui lo scale up dell'istanza principale dopo aver creato quella secondaria, AlloyDB non esegue automaticamente lo scale up dell'istanza secondaria, ma devi farlo manualmente.

Console

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

    Vai a Cluster

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

  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. Nel menu Regione, seleziona una regione per il cluster secondario. Per il ripristino di emergenza regionale, ti consigliamo di selezionare una regione diversa da quella del cluster principale. Tuttavia, puoi anche creare un cluster secondario nella stessa regione.
    3. Configura la crittografia per il cluster secondario:

      • Se il cluster primario utilizza la crittografia gestita da Google: per impostazione predefinita, AlloyDB cripta il cluster secondario utilizzando la crittografia gestita da Google. Per criptare il cluster secondario con una chiave di crittografia gestita dal cliente (CMEK), fai clic su Opzioni di configurazione avanzate, poi su Opzioni di crittografia avanzate e infine seleziona Chiave Cloud KMS.
      • Se il cluster primario utilizza CMEK: devi criptare anche il cluster secondario con CMEK. Nella sezione Crittografia, l'opzione Chiave Cloud KMS viene selezionata automaticamente.
    4. Se utilizzi la chiave Cloud KMS, seleziona una chiave nella stessa regione del cluster secondario:

      1. (Facoltativo) Nel menu Tipo di gestione delle chiavi, seleziona un tipo di gestione delle chiavi (il valore predefinito è Cloud KMS).
      2. Fai clic su Seleziona una chiave Cloud KMS e seleziona una chiave dal menu.

        La console Google Cloud limita questo menu alle chiavi all'interno del progetto Google Cloud corrente e della regione selezionata. Per utilizzare una chiave che non è presente in questo elenco, scegli una delle opzioni in fondo al menu Seleziona una chiave Cloud KMS:

        • Per sfogliare le chiavi di un altro progetto, fai clic su Cambia progetto e seleziona il progetto.
        • Per specificare una chiave in base al nome della risorsa, fai clic su Inserisci la chiave manualmente. Nella finestra di dialogo Inserisci il nome risorsa della chiave, nel campo Nome risorsa della chiave, inserisci il nome risorsa della chiave e poi fai clic su Salva.

      L'utilizzo di CMEK con AlloyDB richiede una configurazione aggiuntiva. Per saperne di più, consulta Proteggi i dati con le chiavi di crittografia.

    5. Fai clic su Continua.

  5. Configura l'istanza secondaria. Nel campo ID istanza, inserisci un ID risorsa per l'istanza secondaria. L'ID risorsa deve essere univoco in un cluster.

  6. Fai clic su Crea cluster.

gcloud

Per utilizzare gcloud CLI, puoi installare e inizializzare Google Cloud CLI oppure puoi 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 e a cui vuoi associare l'istanza secondaria.
  • SECONDARY_INSTANCE_ID: l'ID dell'istanza secondaria che vuoi creare.
  • REGION_ID: l'ID della regione del cluster secondario, ad esempio us-central1. Per il ripristino di emergenza regionale, ti consigliamo di selezionare una regione diversa da quella del cluster principale.
  • PROJECT_ID: l'ID del progetto del cluster principale.
  • LOCATION_ID: la località in cui si trova il cluster principale, ad esempio us-central1.
  • PRIMARY_CLUSTER_ID: l'ID del cluster primario a cui è associato il cluster secondario.

Per disattivare la creazione di backup automatici nel cluster secondario, passa il flag --no-enable-automated-backup al comando gcloud alloydb clusters create-secondary.

Per creare un'istanza secondaria abilitata per Private Service Connect, aggiungi 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 e 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
 gcloud alloydb instances create-secondary SECONDARY_INSTANCE_ID \
 --cluster=SECONDARY_CLUSTER_ID \
 --region=REGION_ID \
 --allowed-psc-projects=ALLOWED_PSC_PROJECTS

Sostituisci quanto segue:

  • ALLOWED_PSC_PROJECTS (facoltativo): l'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 e my-project-n. Se il tuo cluster utilizza Private Service Connect come metodo di connessione all'istanza, devi impostare un elenco di progetti o numeri consentiti.

Per creare un'istanza secondaria per un cluster abilitato per l'IP pubblico, aggiungi il flag --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

Facoltativamente, passa un elenco di blocchi CIDR separati da virgole, ad esempio 64.233.160.0/16, al flag --authorized-external-networks per impostare le reti esterne autorizzate sulla tua istanza.

Visualizza 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. Nella colonna Nome risorsa, fai clic su un cluster secondario.

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

Aggiorna un'istanza secondaria

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

Configura i flag di database su un'istanza secondaria

Per aggiungere, modificare o eliminare i flag di 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 sul cluster secondario che vuoi modificare.

  3. Nella pagina Panoramica, vai alla sezione Istanze nel cluster, trova l'istanza secondaria e fai clic su Modifica istanza secondaria.

  4. Fai clic su Mostra opzioni avanzate, quindi espandi Flag.

  5. Aggiungi, modifica o elimina un flag di database nell'istanza:

    Aggiungi un flag

    1. Fai clic su Aggiungi un flag di database.
    2. Nel menu Scegli un flag, seleziona un flag.
    3. In Valore, inserisci o seleziona un valore per il flag.
    4. Fai clic su Fine.

    Modifica un flag

    1. Espandi il flag di database che vuoi modificare.
    2. Nella sezione Modifica flag di database, aggiorna il valore del flag.
    3. Fai clic su Fine.

    Elimina un flag

    • Per il flag di database che vuoi rimuovere, fai clic su  Elimina.
  6. Fai clic su Aggiorna istanza.

gcloud

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

 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 dei flag di database. Ogni specifica è costituita 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, specifica il nome del flag seguito da un segno di uguale (=).
  • REGION_ID: la regione in cui si trova l'istanza secondaria, ad esempio us-central1.
  • CLUSTER_ID: l'ID del cluster in cui si trova l'istanza secondaria.
  • PROJECT_ID: l'ID del progetto in cui si trova il cluster secondario.

Scala il tipo di macchina dell'istanza secondaria

Per scalare il tipo di macchina dell'istanza secondaria, completa i seguenti passaggi:

Console

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

    Vai a Cluster

  2. Nella colonna Nome risorsa, fai clic sul cluster secondario che vuoi modificare.

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

    Questa azione non è disponibile se lo stato del cluster è Manutenzione. Attendi che lo stato diventi Pronto.

  4. Nella sezione Macchina, seleziona facoltativamente una serie nel menu Serie di macchine, quindi seleziona una configurazione nel menu Tipo di macchina.

  5. Fai clic su Aggiorna istanza.

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)
    • 96 (96 vCPU, 768 GB di RAM)
    • 128 (128 vCPU, 864 GB di RAM)
  • REGION_ID: la regione in cui si trova l'istanza.
  • CLUSTER_ID: l'ID del cluster in cui si trova l'istanza.
  • PROJECT_ID: l'ID del progetto in cui si trova 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. La manutenzione impedisce temporaneamente la riconfigurazione dell'istanza. Esegui di nuovo il comando dopo che il cluster è tornato allo stato READY.

Per controllare lo stato del cluster, consulta Visualizza i dettagli del cluster.

Aggiungi istanze del pool di lettura a un cluster secondario

Per aggiungere un'istanza del pool di lettura a un cluster secondario, segui questi passaggi:

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

    Vai a Cluster

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

  3. Nella pagina Panoramica, vai alla sezione Istanze nel tuo 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. Nella sezione Modalità di scalabilità, mantieni selezionata l'opzione Manuale e inserisci un numero di nodi nel campo Numero di nodi (oppure seleziona Scalabilità automatica per configurare il numero di nodi Minimo e Massimo).

      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. Nella sezione Macchina, seleziona facoltativamente una serie nel menu Serie di macchine, quindi seleziona una configurazione nel menu Tipo di macchina.

    4. (Facoltativo) Per impostare flag personalizzati sulla tua istanza, fai clic su Mostra opzioni avanzate, espandi Flag e segui questi passaggi per ogni flag:

      1. Fai clic su Aggiungi un flag di database.
      2. Nel menu Scegli un flag, seleziona un flag.
      3. In Valore, inserisci o seleziona un valore per il flag.
      4. Fai clic su Fine.
  5. Fai clic su Crea pool di lettura.

Disaster recovery avanzato

Per scenari di ripristino di emergenza avanzati, AlloyDB supporta lo switchover e il failover tra regioni:

Esegui un cambio

Lo switchover ti consente di invertire i ruoli dei cluster primario e secondario senza perdita di dati. Utilizza questa operazione per migrazioni pianificate, manutenzione di routine o esercitazioni di ripristino di emergenza. Quando completi lo switchover, la direzione della replica viene invertita.

Se esegui un cambio quando hai più cluster secondari, vengono apportate le seguenti modifiche:

  • Il cluster secondario che riceve il comando di switchover diventa un cluster primario.
  • Il cluster primario precedente diventa un cluster secondario, che esegue la replica dal nuovo cluster primario.
  • Tutti gli altri cluster secondari passano alla replica dal nuovo cluster principale.

Il seguente diagramma illustra un cambio da cluster-1 in us-central1 a cluster-2 in us-east4:

Esempio di esecuzione di un cambio a uno dei due cluster secondari.

Figura 2. Esempio di esecuzione di un cambio a uno dei due cluster secondari.

Prima di eseguire uno switchover, verifica che tutte le regioni a cui appartengono le istanze principali e secondarie siano online e che le istanze siano in uno stato integro. Per saperne di più, consulta Monitora un'istanza utilizzando la dashboard Insight di sistema di AlloyDB.

Per eseguire uno switchover, segui questi passaggi:

Console

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

    Vai a Cluster

  2. Nella colonna Nome risorsa, fai clic sul cluster secondario di cui vuoi eseguire il failover.

  3. Nella pagina Panoramica, fai clic su Switchover.

  4. Nella finestra di dialogo Vuoi eseguire il cambio del cluster?, nel campo ID cluster, inserisci l'ID del cluster principale associato per confermare che vuoi eseguire il cambio del cluster.

  5. Fai clic su Switchover.

    Al termine del cambio, il campo Tipo di cluster nella pagina Panoramica viene aggiornato in Cluster primario per il cluster che ha eseguito il cambio e in Cluster secondario per il cluster primario precedente.

gcloud

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 cambiare.
  • REGION_ID: l'ID della regione del cluster secondario, ad esempio us-central1.
  • PROJECT_ID: l'ID del progetto del cluster secondario.

(Facoltativo) Verifica lo stato della replica

Per consentire il completamento del cambio con un ritardo minimo e senza perdita di dati, verifica che il cluster secondario abbia applicato tutte le transazioni ricevute dal cluster primario:

  1. Interrompi tutte le scritture nel cluster principale.
  2. Controlla lo stato della replica del cluster secondario:

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

      Vai a Cluster

    2. Nella colonna Nome risorsa, fai clic sul cluster secondario di cui vuoi eseguire il failover.

    3. Nel menu di navigazione di AlloyDB, fai clic su Insight sul sistema.

    4. Nel menu Istanza, seleziona Secondaria: SECONDARY_INSTANCE_ID, dove SECONDARY_INSTANCE_ID è l'ID dell'istanza secondaria.

    5. Individua il grafico Ritardo della replica dall'istanza principale e verifica che mostri un ritardo minimo.

      Un valore di ritardo pari a 0 è ottimale. Se il ritardo è superiore a 0, l'operazione di cambio potrebbe richiedere più tempo per essere completata mentre applica le transazioni rimanenti.

    6. Individua il grafico Stato della replica e verifica che tutti i nodi rappresentati nel grafico siano nello stato streaming.

Promuovi un cluster secondario

La promozione di un cluster secondario lo rende un cluster primario autonomo con funzionalità di lettura e scrittura complete. Utilizza questa operazione principalmente per ripristino di emergenza quando la regione che ospita il cluster primario non è disponibile.

Per impostazione predefinita, la promozione rende il cluster secondario un cluster primario autonomo. Tuttavia, puoi facoltativamente attivare il failover tra regioni (anteprima) per automatizzare la ricreazione dell'istanza principale originale. Il failover tra regioni è supportato solo per le topologie con un singolo cluster primario e un singolo cluster secondario.

Per promuovere un cluster secondario a cluster primario o per aggiungere facoltativamente l'orchestrazione del failover, segui questi passaggi:

Console

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

    Vai a Cluster

  2. Nella colonna Nome risorsa, fai clic sul cluster secondario che vuoi promuovere.

  3. Nella pagina Panoramica, scegli se eseguire una promozione autonoma o una promozione con orchestrazione del failover:

    • Promuovi a un cluster primario autonomo:
      1. Fai clic su Promuovi.
      2. Nella finestra di dialogo visualizzata, nel campo ID cluster, inserisci l'ID cluster secondario, quindi fai clic su Promuovi.
    • Promuovi con l'orchestrazione del failover (anteprima):
      1. Fai clic su Failover.
      2. Nella finestra di dialogo visualizzata, nel campo ID cluster, inserisci l'ID del cluster secondario, quindi fai clic su Attiva failover.

    Al termine della promozione, il campo Tipo di cluster nella pagina Panoramica viene aggiornato da Cluster secondario a Cluster primario. Se hai selezionato Failover, AlloyDB ricrea il cluster primario originale in background quando la sua regione diventa disponibile; durante questo processo, lo Stato mostra Ricreazione in corso e il Tipo di cluster viene aggiornato a Cluster secondario al termine della ricreazione.

gcloud

Per promuovere un cluster secondario a un cluster primario autonomo, utilizza il comando gcloud alloydb clusters promote:

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

Per eseguire una promozione con l'orchestrazione del failover (anteprima), aggiungi il flag facoltativo --failover. Questo flag ricrea automaticamente l'istanza principale originale come secondaria e aggiorna gli endpoint associati per instradare il traffico al nuovo cluster principale.

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

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.

Utilizza gli endpoint di scrittura per evitare lo split-brain

Per semplificare ulteriormente il workflow di ripristino di emergenza durante un failover tra regioni, Google consiglia di gestire le connessioni al database con endpoint di scrittura per connetterti al cluster.

Quando esegui un failover tra regioni, AlloyDB aggiorna automaticamente il record DNS dell'endpoint di scrittura in modo che punti al nuovo cluster principale. In questo modo, il nuovo traffico di scrittura viene indirizzato lontano dall'istanza principale originale e verso quella nuova.

Prima di utilizzare gli endpoint di scrittura durante un failover tra regioni, tieni presente quanto segue:

  • Aggiornamento DNS immediato: il record DNS per l'endpoint di scrittura viene aggiornato immediatamente dopo la promozione.
  • Aggiornamento dei metadati ritardato: i metadati dell'endpoint di scrittura potrebbero continuare a mostrare l'indirizzo dell'istanza primaria originale fino al ripristino della regione del cluster primario originale.

Recupero dati durante il failover tra regioni

Quando esegui un failover tra regioni, AlloyDB esegue automaticamente un backup del cluster primario originale prima di ricrearlo come cluster secondario. Uno scenario di split-brain si verifica quando sia il cluster primario originale sia quello nuovo accettano scritture contemporaneamente. Per evitare questi scenari, le scritture sul database primario originale vengono interrotte prima dell'esecuzione del backup. Utilizza questo backup per recuperare le transazioni che non sono state replicate nel cluster secondario a causa di un ritardo durante il failover.

Questo backup viene creato automaticamente nell'ambito dell'orchestrazione del failover ed è distinto dai backup automatici pianificati regolarmente e dai backup on demand. Puoi utilizzarlo per creare un nuovo cluster temporaneo e riconciliare manualmente i dati mancanti.

Questo backup acquisisce le scritture accettate dall'istanza principale originale prima che venisse arrestata, ma non unisce automaticamente le scritture nel nuovo cluster principale.

Passaggi successivi