Eseguire il failover manuale di un'istanza principale o secondaria

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

Alta disponibilità su istanze principali e secondarie

AlloyDB per PostgreSQL supporta la disponibilità elevata sia sulle istanze principali che su quelle secondarie.

Alta disponibilità sulle istanze principali

Per contribuire a garantire l'alta disponibilità (HA), ogni istanza principale AlloyDB ha sia un nodo attivo che un nodo in standby, che si trovano in zone diverse. Se il nodo attivo non è disponibile, AlloyDB esegue il failover automatico dell'istanza principale sul nodo in standby, rendendolo il nuovo nodo attivo.

Puoi eseguire il failover manuale 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. Mette il nodo principale offline.

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

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

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, immagina di avere un'istanza principale i cui nodi attivi 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 la conseguente esecuzione del nodo attivo nella zona us-central1-b. Se preferisci mantenere attivo il node nella zona us-central1-a, puoi avviare un failover manuale per fare in modo che AlloyDB ripristini i node dell'istanza principale nelle posizioni precedenti all'interruzione.

Durante le operazioni di manutenzione, un'istanza principale ad alta disponibilità e un'istanza di base typically experience minimal maintenance downtime of less than a second. Poiché il failover manuale è una procedura intenzionale e controllata, non è inteso per simulare guasti hardware o di rete imprevisti. In alternativa, puoi testare l'alta disponibilità per l'istanza principale utilizzando l'iniezione di errori.

Alta disponibilità nelle istanze secondarie

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

Per impostazione predefinita, l'HA è configurato 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 riserva

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

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 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.

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 della tua 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 è posizionata l'istanza.
  • CLUSTER_ID: l'ID del cluster in cui è posizionata l'istanza.
  • PROJECT_ID: l'ID del progetto in cui è collocato il cluster.

Per verificare che il failover abbia funzionato, segui questi passaggi:

  1. Prima di eseguire il failover, tieni presente le 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 in standby siano cambiate di posizione.

Esegui un failover manuale su un'istanza secondaria

Il failover manuale di un'istanza secondaria è simile alla procedura seguita per il failover manuale dell'istanza principale.

Per eseguire il failover di un cluster secondario manualmente:

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 il failover.

gcloud

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

Utilizza il comando gcloud alloydb instances failover per forzare il failover di un'istanza secondaria alla sua istanza di 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 per 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