Abilita e disabilita alta disponibilità

Questa pagina descrive come configurare un'istanza per l'alta disponibilità.

Puoi configurare l'alta disponibilità per un'istanza quando la crei oppure abilitare l'alta disponibilità per un'istanza esistente.

Per saperne di più sull'alta disponibilità, consulta Panoramica della configurazione dell'alta disponibilità.

La configurazione legacy per l'alta disponibilità utilizzava un'istanza failover replica. La nuova configurazione non utilizza un failover replica. Utilizza invece i dischi permanenti a livello di regione di Google, che replicano in modo sincrono i dati a livello di blocco tra due zone in una regione. Se hai un'istanza MySQL esistente che utilizza la configurazione legacy ad alta disponibilità, puoi aggiornare la configurazione per utilizzare la versione attuale. Per altre procedure relative alla configurazione legacy per l'alta disponibilità, vedi Configurazione legacy per l'alta disponibilità.

Crea una nuova istanza configurata per l'alta disponibilità

Quando crei un'istanza e la configuri per l'alta disponibilità, Cloud SQL la crea come istanza regionale.

Per creare un'istanza configurata per l'alta disponibilità:

Console

  1. Nella console Google Cloud, vai alla pagina Istanze Cloud SQL.

    Vai a Istanze Cloud SQL

  2. Seleziona Crea istanza.
  3. Seleziona il motore del database.
  4. Nella sezione Scegli regione e disponibilità a livello di zona, seleziona Più zone (disponibilità elevata).
  5. Espandi Specifica zone.
  6. Seleziona la zona principale e quella secondaria. Quando la zona secondaria viene utilizzata durante la creazione o la modifica dell'istanza, si applicano le seguenti condizioni:
    • Per impostazione predefinita, le zone sono Any per la zona principale e Any (different from primary) per la zona secondaria.

      • Se vengono specificate sia la zona primaria che quella secondaria, devono essere zone diverse.

  7. Fai clic su Salva.

    Tornerai alla pagina dell'istanza per l'istanza principale mentre l'istanza viene aggiornata.

gcloud

  1. Crea l'istanza a livello di regione: 
    gcloud sql instances create REGIONAL_INSTANCE_NAME \
--availability-type=REGIONAL \
--database-version=DATABASE_VERSION \
--tier=MACHINE_TYPE \
--enable-bin-log
    Per un elenco completo dei parametri disponibili, consulta la pagina di riferimento gcloud sql instances create.
  2. Puoi specificare sia la zona principale che quella secondaria utilizzando i parametri --zone e --secondary-zone. Quando la zona secondaria viene utilizzata durante la creazione o la modifica dell'istanza, si applicano le seguenti limitazioni:
    • Le zone devono essere zone valide.
    • Se viene specificata la zona secondaria, è necessario specificare anche la zona principale.
    • Se vengono specificate le zone primarie e secondarie, devono essere zone diverse.
    • Se vengono specificate le zone primarie e secondarie, devono appartenere alla stessa regione.
  3. Configura l'utente root: 
    gcloud sql users set-password root --host=% \
--instance=PRIMARY_INSTANCE_NAME \
--password=PASSWORD

Terraform

Per creare un'istanza ad alta disponibilità, utilizza una risorsa Terraform. 

resource "google_sql_database_instance" "mysql_instance_ha" {
  name             = "mysql-instance-ha"
  region           = "asia-northeast1"
  database_version = "MYSQL_8_0"
  settings {
    tier              = "db-f1-micro"
    availability_type = "REGIONAL"
    backup_configuration {
      enabled            = true
      binary_log_enabled = true
      start_time         = "20:55"
    }
  }
  # set `deletion_protection` to true, will ensure that one cannot accidentally delete this instance by
  # use of Terraform whereas `deletion_protection_enabled` flag protects this instance at the GCP level.
  deletion_protection = false
}

Applica le modifiche

Per applicare la tua configurazione Terraform a un progetto Google Cloud, completa i passaggi nelle sezioni seguenti.

Prepara Cloud Shell

  1. Avvia Cloud Shell.

  2. Imposta il progetto Google Cloud predefinito a cui vuoi applicare le configurazioni Terraform.

    Devi eseguire questo comando una sola volta per progetto e puoi eseguirlo in qualsiasi directory.

    export GOOGLE_CLOUD_PROJECT=PROJECT_ID

    Le variabili di ambiente vengono sostituite se imposti valori espliciti nel file di configurazione Terraform.

Prepara la directory

Ogni file di configurazione Terraform deve avere la propria directory (chiamata anche modulo principale).

  1. In Cloud Shell, crea una directory e un nuovo file al suo interno. Il nome del file deve avere l'estensione .tf, ad esempio main.tf. In questo tutorial, il file è denominato main.tf. 
    mkdir DIRECTORY && cd DIRECTORY && touch main.tf

  2. Se stai seguendo un tutorial, puoi copiare il codice campione in ogni sezione o passaggio.

    Copia il codice campione nel nuovo oggetto main.tf.

    Facoltativamente, copia il codice da GitHub. Questa opzione è consigliata se lo snippet Terraform fa parte di una soluzione end-to-end.

  3. Esamina e modifica i parametri di esempio da applicare al tuo ambiente.
  4. Salva le modifiche.
  5. Inizializza Terraform. Devi eseguire questa operazione una sola volta per directory. 
    terraform init

    Facoltativamente, per utilizzare la versione più recente del provider Google, includi l'opzione -upgrade: 

    terraform init -upgrade

Applica le modifiche

  1. Esamina la configurazione e verifica che le risorse che Terraform creerà o aggiornerà soddisfino le tue aspettative: 
    terraform plan

    Apporta le correzioni necessarie alla configurazione.

  2. Applica la configurazione Terraform eseguendo questo comando e inserendo yes al prompt: 
    terraform apply

    Attendi finché in Terraform non viene visualizzato il messaggio "Applicazione completata!".

  3. Apri il progetto Google Cloud per visualizzare i risultati. Nella console Google Cloud, vai alle risorse nella UI per assicurarti che Terraform le abbia create o aggiornate.

Elimina le modifiche

Per eliminare le modifiche:

  1. Per disabilitare la protezione dall'eliminazione, imposta l'argomento deletion_protection nel file di configurazione di Terraform su false. 
    deletion_protection =  "false"
  2. Applica la configurazione Terraform aggiornata eseguendo questo comando e inserendo yes al prompt: 
    terraform apply

  1. Per rimuovere le risorse applicate in precedenza con la tua configurazione Terraform, esegui questo comando e inserisci yes al prompt:

    terraform destroy

REST v1

Per l'elenco completo dei parametri per la richiesta, consulta la pagina instances:insert.

Crea l'istanza a livello di regione.

  1. Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

    • project-id: l'ID progetto
    • instance-name: il nome dell'istanza
    • database-version: la stringa enum della versione del database
    • region La regione Google Cloud
    • machine-type Il tipo di macchina

    Metodo HTTP e URL: 

    POST https://sqladmin.googleapis.com/v1/projects/project-id/instances

    Corpo JSON della richiesta: 

    {
  "name": "instance-name",
  "region": "region",
  "databaseVersion": "database-version",
   "settings": {
     "tier": "machine-type",
     "backupConfiguration": {
         "binaryLogEnabled": true,
         "enabled": true
      },
      "availabilityType": "REGIONAL"
   }
}

    Per inviare la richiesta, espandi una delle seguenti opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

  2. Al termine dell'inizializzazione dell'istanza, aggiorna la password root sull'istanza:

    Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

    • project-id: l'ID progetto
    • instance-id: l'ID istanza
    • password: la nuova password dell'utente root

    Metodo HTTP e URL: 

    PATCH https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/users?name=root&host=%25'

    Corpo JSON della richiesta: 

    {
   "name": "root",
   "host": "%",
   "password": "password"}

    Per inviare la richiesta, espandi una delle seguenti opzioni:

    Dovresti ricevere un codice di stato di operazione riuscita (2xx) e una risposta vuota.

REST v1beta4

Per l'elenco completo dei parametri per la richiesta, consulta la pagina instances:insert.

Crea l'istanza a livello di regione.

  1. Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

    • project-id: l'ID progetto
    • instance-name: il nome dell'istanza
    • database-version: la stringa enum della versione del database
    • region La regione Google Cloud
    • machine-type Il tipo di macchina

    Metodo HTTP e URL: 

    POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances

    Corpo JSON della richiesta: 

    {
  "name": "instance-name",
  "region": "region",
  "databaseVersion": "database-version",
   "settings": {
     "tier": "machine-type",
     "backupConfiguration": {
         "binaryLogEnabled": true,
         "enabled": true
      },
      "availabilityType": "REGIONAL"
   }
}

    Per inviare la richiesta, espandi una delle seguenti opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

  2. Al termine dell'inizializzazione dell'istanza, aggiorna la password root sull'istanza:

    Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

    • project-id: l'ID progetto
    • instance-id: l'ID istanza
    • password: la nuova password dell'utente root

    Metodo HTTP e URL: 

    PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/users?name=root&host=%25'

    Corpo JSON della richiesta: 

    {
   "name": "root",
   "host": "%",
   "password": "password"}

    Per inviare la richiesta, espandi una delle seguenti opzioni:

    Dovresti ricevere un codice di stato di operazione riuscita (2xx) e una risposta vuota.

Per maggiori dettagli sulla creazione di un'istanza, consulta Creazione di istanze.

Configura un'istanza esistente per l'alta disponibilità

Puoi configurare un'istanza Cloud SQL per garantire l'alta disponibilità utilizzando la console Google Cloud, gcloud CLI o l'API.

Console

Per configurare l'alta disponibilità di un'istanza:

  1. Nella console Google Cloud, vai alla pagina Istanze Cloud SQL.

    Vai a Istanze Cloud SQL

  2. Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.
  3. Fai clic su Modifica.
  4. Nella sezione Scegli regione e disponibilità a livello di zona, seleziona Più zone (disponibilità elevata).
  5. Espandi Specifica zone.
  6. Seleziona la zona principale e quella secondaria. Quando utilizzi la zona secondaria durante la creazione o la modifica di un'istanza, si applicano le seguenti condizioni:
    • Per impostazione predefinita, le zone sono Any per la zona principale e Any (different from primary) per la zona secondaria.

      • Se specifichi sia la zona principale che quella secondaria, devono essere zone diverse.

  7. Fai clic su Salva.

gcloud

Per configurare un'istanza in modo che sia regionale e ad alta disponibilità, utilizza il comando gcloud sql instances patch:

gcloud sql instances patch INSTANCE_NAME \
--availability-type REGIONAL \
--enable-bin-log \
--backup-start-time=HH:MM

Effettua le seguenti sostituzioni:

  • INSTANCE_NAME: il nome dell'istanza Cloud SQL che stai configurando per l'alta disponibilità
  • HH:MM: l'ora (in ore e minuti)

REST v1

Per configurare un'istanza in modo che sia regionale e ad alta disponibilità:

  1. Controlla l'istanza per verificare se i backup automatici e i log binari sono abilitati. Sono obbligatori per le istanze ad alta disponibilità.

    Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

    • PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud che contiene l'istanza
    • INSTANCE_NAME: il nome dell'istanza che stai configurando per l'alta disponibilità

    Metodo HTTP e URL: 

    GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

    Per inviare la richiesta, espandi una delle seguenti opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

    {
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "MYSQL_8_0"
}

    L'output contiene una sezione simile alla seguente:

      "backupConfiguration": {
    "kind": "sql#backupConfiguration",
    "startTime": "12:00",
    "enabled": true,
    "binaryLogEnabled": true
    }

  2. Se enabled o binaryLogEnabled sono false, utilizza il metodo instances:patch per abilitarli entrambi. Per abilitare i backup, imposta enabled su true e startTime su un valore che corrisponde all'inizio della finestra di backup. Per abilitare il logging binario, imposta binaryLogEnabled su true.

    Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

    • PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud che contiene l'istanza
    • INSTANCE_NAME: il nome dell'istanza principale o di replica di lettura che stai configurando per l'alta disponibilità
    • START_TIME: l'ora (in ore e minuti)

    Metodo HTTP e URL: 

    PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

    Corpo JSON della richiesta: 

    {
  "settings":
  {
    "backupConfiguration":
    {
      "startTime": "START_TIME",
      "enabled": true,
      "binaryLogEnabled": true
    }
  }
}

    Per inviare la richiesta, espandi una delle seguenti opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

  3. Configura l'istanza in modo che sia regionale e ad alta disponibilità:

    Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

    • PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud che contiene l'istanza
    • INSTANCE_NAME: il nome dell'istanza che stai configurando per l'alta disponibilità

    Metodo HTTP e URL: 

    PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

    Corpo JSON della richiesta: 

    {
  "settings": {"availabilityType": "REGIONAL" }
}

    Per inviare la richiesta, espandi una delle seguenti opzioni:

    Dovresti ricevere un codice di stato di operazione riuscita (2xx) e una risposta vuota.

REST v1beta4

Per configurare un'istanza in modo che sia regionale e ad alta disponibilità:

  1. Controlla l'istanza per verificare se i backup automatici e i log binari sono abilitati. Sono obbligatori per le istanze ad alta disponibilità.

    Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

    • PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud che contiene l'istanza
    • INSTANCE_NAME: il nome dell'istanza che stai configurando per l'alta disponibilità

    Metodo HTTP e URL: 

    GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

    Per inviare la richiesta, espandi una delle seguenti opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

    {
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "MYSQL_8_0"
}

    L'output contiene una sezione simile alla seguente:

      "backupConfiguration": {
    "kind": "sql#backupConfiguration",
    "startTime": "12:00",
    "enabled": true,
    "binaryLogEnabled": true
    }

  2. Se enabled o binaryLogEnabled sono false, utilizza il metodo instances:patch per abilitarli entrambi. Per abilitare i backup, imposta enabled su true e startTime su un valore che corrisponde all'inizio della finestra di backup. Per abilitare il logging binario, imposta binaryLogEnabled su true.

    Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

    • PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud che contiene l'istanza
    • INSTANCE_NAME: il nome dell'istanza principale o di replica di lettura che stai configurando per l'alta disponibilità
    • START_TIME: l'ora (in ore e minuti)

    Metodo HTTP e URL: 

    PATCH https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

    Corpo JSON della richiesta: 

    {
  "settings":
  {
    "backupConfiguration":
    {
      "startTime": "START_TIME",
      "enabled": true,
      "binaryLogEnabled": true
    }
  }
}

    Per inviare la richiesta, espandi una delle seguenti opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

  3. Configura l'istanza in modo che sia regionale e ad alta disponibilità:

    Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

    • PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud che contiene l'istanza
    • INSTANCE_NAME: il nome dell'istanza che stai configurando per l'alta disponibilità

    Metodo HTTP e URL: 

    PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

    Corpo JSON della richiesta: 

    {
  "settings": {"availabilityType": "REGIONAL" }
}

    Per inviare la richiesta, espandi una delle seguenti opzioni:

    Dovresti ricevere un codice di stato di operazione riuscita (2xx) e una risposta vuota.

Avvia failover

Il test del failover è facoltativo, ma è consigliato per consentirti di vedere come reagisce l'applicazione in caso di failover.

Per scoprire di più sui failover, consulta la panoramica del failover.

Console

  1. Nella console Google Cloud, vai alla pagina Istanze Cloud SQL.

    Vai a Istanze Cloud SQL

  2. Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.
  3. Fai clic su Failover.
  4. Nella finestra di dialogo Attiva manualmente un failover, inserisci l'ID dell'istanza nel campo di testo, quindi fai clic su Attiva failover.

gcloud

Avvia il failover:

gcloud sql instances failover PRIMARY_INSTANCE_NAME

REST v1

  1. Descrivi l'istanza principale per ottenere il valore del campo settingsVersion.

    Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

    • PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud che contiene l'istanza
    • INSTANCE_NAME: il nome dell'istanza che stai configurando per l'alta disponibilità

    Metodo HTTP e URL: 

    GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

    Per inviare la richiesta, espandi una delle seguenti opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

    {
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "MYSQL_8_0"
}
  2. Avvia il failover:

    Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

    • project-id: l'ID progetto
    • instance-name: il nome dell'istanza
    • settings-version: il valore settingsVersion di instanceInfo

    Metodo HTTP e URL: 

    POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-name/failover

    Corpo JSON della richiesta: 

    {
  "failoverContext":
     {
        "settingsVersion":"settings-version"
     }
}

    Per inviare la richiesta, espandi una delle seguenti opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

REST v1beta4

  1. Descrivi l'istanza principale per ottenere il valore del campo settingsVersion.

    Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

    • PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud che contiene l'istanza
    • INSTANCE_NAME: il nome dell'istanza che stai configurando per l'alta disponibilità

    Metodo HTTP e URL: 

    GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

    Per inviare la richiesta, espandi una delle seguenti opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

    {
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "MYSQL_8_0"
}
  2. Avvia il failover:

    Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

    • project-id: l'ID progetto
    • instance-name: il nome dell'istanza
    • settings-version: il valore settingsVersion di instanceInfo

    Metodo HTTP e URL: 

    POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-name/failover

    Corpo JSON della richiesta: 

    {
  "failoverContext":
     {
        "settingsVersion":"settings-version"
     }
}

    Per inviare la richiesta, espandi una delle seguenti opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

L'istanza esegue il failover e non è disponibile per fornire dati per alcuni minuti.

Verificare la configurazione dell'alta disponibilità di un'istanza

Per verificare l'alta disponibilità di un'istanza e visualizzare le zone in cui è in esecuzione:

Console

  1. Nella console Google Cloud, vai alla pagina Istanze Cloud SQL.

    Vai a Istanze Cloud SQL

  2. Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.
  3. Verifica che le seguenti impostazioni di alta disponibilità siano visualizzate nella sezione Configurazione:
    • Disponibilità elevata (a livello di regione)
    • Si trova in: mostra la zona principale attuale dell'istanza.

gcloud

gcloud sql instances describe INSTANCE_NAME

L'output indica che availabilityType è REGIONAL. I campi gceZone e secondaryGceZone mostrano le zone primarie e secondarie attuali dell'istanza.

REST v1

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

  • PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud che contiene l'istanza
  • INSTANCE_NAME: il nome dell'istanza che stai configurando per l'alta disponibilità

Metodo HTTP e URL: 

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

Per inviare la richiesta, espandi una delle seguenti opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "MYSQL_8_0"
}

L'output indica che availabilityType è REGIONAL. I campi gceZone e secondaryGceZone mostrano le zone primarie e secondarie attuali dell'istanza.

REST v1beta4

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

  • PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud che contiene l'istanza
  • INSTANCE_NAME: il nome dell'istanza che stai configurando per l'alta disponibilità

Metodo HTTP e URL: 

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

Per inviare la richiesta, espandi una delle seguenti opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "MYSQL_8_0"
}

L'output indica che availabilityType è REGIONAL. I campi gceZone e secondaryGceZone mostrano le zone primarie e secondarie attuali dell'istanza.

Modifica le zone di un'istanza ad alta disponibilità

La modifica di una o entrambe le zone di un'istanza ad alta disponibilità esistente provoca un tempo di inattività di alcuni minuti mentre l'istanza viene riconfigurata. Per visualizzare le zone principali e secondarie attuali in cui è in esecuzione l'istanza ad alta disponibilità, consulta Verificare la configurazione ad alta disponibilità di un'istanza.

Per modificare le zone di un'istanza ad alta disponibilità:

Console

  1. Nella console Google Cloud, vai alla pagina Istanze Cloud SQL.

    Vai a Istanze Cloud SQL

  2. Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.
  3. Fai clic su Modifica.
  4. Nella sezione Scegli regione e disponibilità a livello di zona, espandi Specifica zone e seleziona nuove zone. Per impostazione predefinita, le zone sono Any per la zona principale e Any (different from primary) per la zona secondaria. Si applicano le seguenti limitazioni:
    • Puoi specificare solo la zona principale oppure sia la zona primaria che quella secondaria.
    • Se vengono specificate sia la zona primaria che quella secondaria, devono essere zone diverse.
  5. Fai clic su Salva.

    Tornerai alla pagina dell'istanza per l'istanza principale mentre l'istanza viene aggiornata.

gcloud

Modifica la zona in cui è in esecuzione l'istanza:

gcloud sql instances patch INSTANCE_NAME \
  --zone=PRIMARY_ZONE --secondary-zone=SECONDARY_ZONE

Il parametro --secondary-zone è facoltativo. Se la ometti, Cloud SQL selezionerà una zona disponibile diversa da quella principale.

Si applicano le seguenti limitazioni:

  • Le zone devono essere zone valide appartenenti alla stessa regione dell'istanza Cloud SQL.
  • Se viene specificata la zona secondaria, deve essere diversa da quella principale.

REST v1

  1. Modifica le zone dell'istanza regionale:

    Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

    • PROJECT_ID: l'ID progetto
    • INSTANCE_NAME: il nome dell'istanza
    • PRIMARY_ZONE: la zona principale
    • SECONDARY_ZONE: la zona secondaria

    Metodo HTTP e URL: 

    PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

    Corpo JSON della richiesta: 

    {
"settings": {"locationPreference": {"zone": "PRIMARY_ZONE", "secondaryZone": "SECONDARY_ZONE"}}
}

    Per inviare la richiesta, espandi una delle seguenti opzioni:

    Dovresti ricevere un codice di stato di operazione riuscita (2xx) e una risposta vuota.

    Il parametro secondaryZone è facoltativo. Se la ometti, Cloud SQL selezionerà una zona disponibile diversa da quella principale.

    Si applicano le seguenti limitazioni:

    • Le zone devono essere zone valide.
    • Qualsiasi zona che scegli deve appartenere alla stessa regione dell'istanza Cloud SQL.

REST v1beta4

  1. Modifica le zone dell'istanza regionale:

    Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

    • PROJECT_ID: l'ID progetto
    • INSTANCE_NAME: il nome dell'istanza
    • PRIMARY_ZONE: la zona principale
    • SECONDARY_ZONE: la zona secondaria

    Metodo HTTP e URL: 

    PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

    Corpo JSON della richiesta: 

    {
"settings": {"locationPreference": {"zone": "PRIMARY_ZONE", "secondaryZone": "SECONDARY_ZONE"}}
}

    Per inviare la richiesta, espandi una delle seguenti opzioni:

    Dovresti ricevere un codice di stato di operazione riuscita (2xx) e una risposta vuota.

    Il parametro secondaryZone è facoltativo. Se la ometti, Cloud SQL selezionerà una zona disponibile diversa da quella principale.

    Si applicano le seguenti limitazioni:

    • Le zone devono essere zone valide.
    • Qualsiasi zona che scegli deve appartenere alla stessa regione dell'istanza Cloud SQL.

Disattiva l'alta disponibilità per un'istanza

Puoi disattivare l'alta disponibilità per un'istanza Cloud SQL utilizzando la console Google Cloud, gcloud CLI o l'API.

Console

Per disattivare l'alta disponibilità per un'istanza:

  1. Nella console Google Cloud, vai alla pagina Istanze Cloud SQL.

    Vai a Istanze Cloud SQL

  2. Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.
  3. Fai clic su Modifica.
  4. Apri Backup automatici.
  5. Nella sezione Disponibilità, fai clic su Zona singola.
  6. Fai clic su Salva. Questa modifica richiede il riavvio dell'istanza.
  7. Quando viene visualizzata la finestra di dialogo, fai clic su Salva e riavvia.

gcloud

Per disattivare l'alta disponibilità per un'istanza, utilizza il comando gcloud sql instances patch:

gcloud sql instances patch INSTANCE_NAME \
--availability-type ZONAL

Sostituisci INSTANCE_NAME con il nome dell'istanza Cloud SQL per cui stai disattivando l'alta disponibilità.

REST v1

Per modificare il tipo di disponibilità dell'istanza in ZONAL, utilizza il metodo instances:patch. Questo metodo disattiva l'alta disponibilità per l'istanza.

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

  • PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud che contiene l'istanza
  • INSTANCE_NAME: il nome dell'istanza per la quale stai disattivando l'alta disponibilità

Metodo HTTP e URL: 

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

Corpo JSON della richiesta: 

{
  "settings": {"availabilityType": "ZONAL" }
}

Per inviare la richiesta, espandi una delle seguenti opzioni:

Dovresti ricevere un codice di stato di operazione riuscita (2xx) e una risposta vuota.

REST v1beta4

Per modificare il tipo di disponibilità dell'istanza in ZONAL, utilizza il metodo instances:patch. Questo metodo disattiva l'alta disponibilità per l'istanza.

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

  • PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud che contiene l'istanza
  • INSTANCE_NAME: il nome dell'istanza per la quale stai disattivando l'alta disponibilità

Metodo HTTP e URL: 

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

Corpo JSON della richiesta: 

{
  "settings": {"availabilityType": "ZONAL" }
}

Per inviare la richiesta, espandi una delle seguenti opzioni:

Dovresti ricevere un codice di stato di operazione riuscita (2xx) e una risposta vuota.

Risolvere i problemi

Problema Risoluzione dei problemi
Non puoi trovare le metriche per un failover manuale. Nelle metriche vengono presi in considerazione solo i failover automatici.
Le risorse dell'istanza Cloud SQL (CPU e RAM) hanno quasi raggiunto il 100% di utilizzo, causando l'arresto dell'istanza ad alta disponibilità. La dimensione della macchina dell'istanza è troppo piccola per il caricamento.

Modifica l'istanza per eseguire l'upgrade a una dimensione della macchina più grande e ottenere più CPU e memoria.

Passaggi successivi