Eseguire il failover manuale di un'istanza principale o secondaria

Questo documento descrive come eseguire manualmente il failover di un'istanza principale o secondaria.

Alta disponibilità sulle istanze primaria e secondaria

AlloyDB per PostgreSQL supporta l'alta disponibilità sia sulle istanze principali che su quelle secondarie.

Alta disponibilità sulle istanze principali

Per garantire l'alta disponibilità, ogni istanza principale AlloyDB ha un nodo attivo e un nodo di standby, che si trovano in zone diverse. Se il nodo attivo non è più disponibile, AlloyDB esegue automaticamente il failover dell'istanza principale al nodo di standby, che diventa il nuovo nodo attivo.

Puoi eseguire manualmente il failover dell'istanza principale sul nodo di standby in qualsiasi momento, anche se il nodo attivo funziona come previsto. Quando avvii un failover manuale, AlloyDB esegue le seguenti operazioni:

  1. Porta offline il nodo principale.

  2. Trasforma il nodo di standby nel nuovo nodo attivo.

  3. Riattiva il nodo attivo precedente come nuovo nodo di standby.

Il failover manuale scambia i ruoli attivo e di standby dei nodi dell'istanza principale. Puoi attivare un failover manuale ogni volta che vuoi che si verifichi questo scambio.

Ad esempio, supponiamo di avere un'istanza principale i cui nodi attivo e in standby si trovano rispettivamente nelle zone us-central1-a e us-central1-b. Un'interruzione in us-central1-a attiva un failover automatico, con conseguente hosting del nodo attivo nella zona us-central1-b. Se preferisci mantenere il nodo attivo nella zona us-central1-a, puoi avviare un failover manuale per fare in modo che AlloyDB scambi i nodi dell'istanza primaria con le loro posizioni precedenti all'interruzione.

Durante le operazioni di manutenzione, un'istanza primaria HA e un'istanza di base in genere subiscono un tempo di inattività per manutenzione minimo inferiore a un secondo. Poiché il failover manuale è una procedura intenzionale e controllata, non è pensato per simulare guasti imprevisti dell'hardware o della rete. In alternativa, puoi testare l'alta disponibilità per l'istanza principale utilizzando l'inserimento di errori.

Alta disponibilità sulle istanze secondarie

AlloyDB offre l'alta disponibilità sulle istanze secondarie per supportare il ripristino di emergenza e per ridurre i tempi di inattività quando un'istanza secondaria non è disponibile.

Per impostazione predefinita, l'alta disponibilità è configurata su un'istanza secondaria.

Un'istanza secondaria di AlloyDB include i seguenti nodi:

  • Un nodo secondario attivo, che risponde alle richieste
  • Un nodo secondario di standby

I nodi attivi e in standby si trovano in due zone diverse di una regione. Se AlloyDB rileva l'indisponibilità del nodo attivo, il nodo attivo esegue il failover sul nodo di standby per fungere da nuovo nodo attivo. I tuoi dati vengono poi reindirizzati al nuovo nodo attivo. Questo processo è chiamato failover.

Prima di iniziare

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

Esegui un failover manuale su un'istanza principale

Console

  1. Vai alla pagina Cluster.

Vai a Cluster

  1. Nella colonna Nome risorsa, fai clic sul nome di un cluster.

  2. Nella sezione Istanze nel cluster, apri il menu Azioni istanza dell'istanza principale.

  3. Fai clic su Failover.

  4. Nella finestra di dialogo visualizzata, inserisci l'ID dell'istanza.

  5. Fai clic su Attiva failover.

gcloud

Esegui il comando gcloud alloydb instances failover:

gcloud alloydb instances failover INSTANCE_ID \
    --region=REGION_ID \
    --cluster=CLUSTER_ID \
    --project=PROJECT_ID

Sostituisci quanto segue:

  • INSTANCE_ID: l'ID dell'istanza.
  • REGION_ID: la regione in cui si trova l'istanza.
  • CLUSTER_ID: l'ID del cluster in cui viene inserita l'istanza.
  • PROJECT_ID: l'ID del progetto in cui si trova il cluster.

Per verificare che il failover abbia funzionato:

  1. Prima di eseguire il failover, prendi nota delle zone dei nodi dell'istanza principale.

  2. Dopo aver eseguito il failover, prendi nota delle nuove zone dei due nodi.

  3. Verifica che le zone dei nodi attivi e di standby siano state scambiate.

Eseguire un failover manuale su un'istanza secondaria

Il failover manuale di un'istanza secondaria è simile ai passaggi seguiti per il failover manuale dell'istanza principale.

Per eseguire manualmente il failover di un cluster secondario:

Console

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

    Vai a Cluster

  2. Fai clic sul nome di un cluster secondario nella colonna Nome risorsa.

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

  4. Nella finestra di dialogo visualizzata, inserisci l'ID dell'istanza e fai clic su Attiva failover.

gcloud

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

Utilizza il comando gcloud alloydb instances failover per forzare il failover della relativa istanza secondaria in standby.

 gcloud alloydb instances failover SECONDARY_INSTANCE_ID \
 --cluster=SECONDARY_CLUSTER_ID \
 --region=REGION_ID \
 --project=PROJECT_ID

Sostituisci quanto segue:

  • SECONDARY_INSTANCE_ID: l'ID dell'istanza secondaria di cui vuoi eseguire il failover.
  • SECONDARY_CLUSTER_ID: l'ID del cluster secondario a cui è associata l'istanza secondaria.
  • REGION_ID: l'ID della regione dell'istanza secondaria, ad esempio us-central1.
  • PROJECT_ID: l'ID del progetto del cluster secondario.

Passaggi successivi