Questa pagina descrive come configurare un'istanza per l'alta disponibilità.
Puoi configurare un'istanza per l'alta disponibilità quando la crei oppure puoi abilitare l'alta disponibilità su un'istanza esistente.
Per saperne di più sull'alta disponibilità, consulta Panoramica della configurazione 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
-
Nella console Google Cloud , vai alla pagina Istanze Cloud SQL.
- Seleziona Crea istanza.
- Seleziona il motore del database.
- Nella sezione Scegli la disponibilità per regione e zona, seleziona Più zone (a disponibilità elevata).
- Espandi Specifica zone.
- Seleziona le zone primaria e secondaria. Quando la zona secondaria viene utilizzata durante la creazione o la modifica dell'istanza, si applicano le seguenti condizioni:
- Le zone sono impostate per impostazione predefinita su
Any
per la zona primaria eAny (different from primary)
per la zona secondaria.
Se vengono specificate sia la zona primaria che quella secondaria, devono essere zone diverse.
- Le zone sono impostate per impostazione predefinita su
- Fai clic su Salva.
Viene visualizzata di nuovo la pagina dell'istanza principale mentre l'istanza viene aggiornata.
gcloud
- Crea l'istanza regionale:
gcloud sql instances create REGIONAL_INSTANCE_NAME \ --availability-type=REGIONAL \ --database-version=SQLSERVER_2017_STANDARD \ --cpu=NUMBER_CPUS \ --memory=MEMORY_SIZE
- Configura l'utente root:
gcloud sql users set-password root no-host \ --instance=REGIONAL_INSTANCE_NAME \ --password=PASSWORD
Terraform
Per creare un'istanza con alta disponibilità, utilizza una risorsa Terraform.
Applica le modifiche
Per applicare la configurazione di Terraform in un progetto Google Cloud , completa i passaggi nelle sezioni seguenti.
Prepara Cloud Shell
- Avvia Cloud Shell.
-
Imposta il progetto Google Cloud predefinito in 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 di Terraform deve avere la propria directory (chiamata anche modulo radice).
-
In Cloud Shell, crea una directory e un nuovo file al suo interno. Il nome file deve avere l'estensione
.tf
, ad esempiomain.tf
. In questo tutorial, il file viene denominatomain.tf
.mkdir DIRECTORY && cd DIRECTORY && touch main.tf
-
Se stai seguendo un tutorial, puoi copiare il codice campione in ogni sezione o passaggio.
Copia il codice campione nel file
main.tf
appena creato.(Facoltativo) Copia il codice da GitHub. Questa operazione è consigliata quando lo snippet Terraform fa parte di una soluzione end-to-end.
- Rivedi e modifica i parametri di esempio da applicare al tuo ambiente.
- Salva le modifiche.
-
Inizializza Terraform. Devi effettuare questa operazione una sola volta per directory.
terraform init
(Facoltativo) Per utilizzare l'ultima versione del provider Google, includi l'opzione
-upgrade
:terraform init -upgrade
Applica le modifiche
-
Rivedi la configurazione e verifica che le risorse che Terraform creerà o
aggiornerà corrispondano alle tue aspettative:
terraform plan
Apporta le correzioni necessarie alla configurazione.
-
Applica la configurazione di Terraform eseguendo il comando seguente e inserendo
yes
al prompt:terraform apply
Attendi che Terraform visualizzi il messaggio "Apply complete!" (Applicazione completata).
- Apri il tuo Google Cloud progetto per visualizzare i risultati. Nella console Google Cloud , vai alle risorse nell'interfaccia utente per assicurarti che Terraform le abbia create o aggiornate.
Elimina le modifiche
Per eliminare le modifiche:
- Per disattivare la protezione dall'eliminazione, imposta l'argomento
deletion_protection
sufalse
nel file di configurazione Terraform.deletion_protection = "false"
- Applica la configurazione Terraform aggiornata eseguendo il comando seguente e
inserendo
yes
al prompt:terraform apply
-
Rimuovi le risorse applicate in precedenza con la configurazione Terraform eseguendo il seguente comando e inserendo
yes
al prompt:terraform destroy
REST v1
Per l'elenco completo dei parametri per la richiesta, consulta la pagina instances:insert.Crea l'istanza regionale.
-
Prima di utilizzare i dati della richiesta, apporta 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": { "enabled": true }, "availabilityType": "REGIONAL" } }
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
- Al termine dell'inizializzazione dell'istanza, aggiorna la password root sull'istanza:
Prima di utilizzare i dati della richiesta, apporta 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?host=%25&name=sqlserver'
Corpo JSON della richiesta:
{ "name": "sqlserver", "host": "nohost", "password": "password"}
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere un codice di stato riuscito (2xx) e una risposta vuota.
REST v1beta4
Per l'elenco completo dei parametri per la richiesta, consulta la pagina instances:insert.Crea l'istanza regionale.
-
Prima di utilizzare i dati della richiesta, apporta 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": { "enabled": true }, "availabilityType": "REGIONAL" } }
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
- Al termine dell'inizializzazione dell'istanza, aggiorna la password root sull'istanza:
Prima di utilizzare i dati della richiesta, apporta 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?host=%25&name=sqlserver'
Corpo JSON della richiesta:
{ "name": "sqlserver", "host": "nohost", "password": "password"}
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere un codice di stato riuscito (2xx) e una risposta vuota.
Per maggiori dettagli sulla creazione di un'istanza, vedi Creazione di istanze.
Configurare un'istanza esistente per l'alta disponibilità
Puoi configurare un'istanza Cloud SQL per l'alta disponibilità utilizzando la console Google Cloud , gcloud CLI o l'API.
Console
Per configurare un'istanza per l'alta disponibilità:
-
Nella console Google Cloud , vai alla pagina Istanze Cloud SQL.
- Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.
- Fai clic su Modifica.
- Nella sezione Backup automatici e alta disponibilità, seleziona Alta disponibilità (regionale). Ti consigliamo inoltre di attivare l'opzione Backup automatici.
- Fai clic su Salva.
gcloud
Per configurare un'istanza in modo che sia un'istanza regionale ad alta disponibilità, utilizza il comando gcloud sql instances patch
:
gcloud sql instances patch INSTANCE_NAME \ --availability-type REGIONAL
Sostituisci INSTANCE_NAME con il nome dell'istanza Cloud SQL che stai configurando per l'alta disponibilità.
REST v1
Per configurare un'istanza in modo che sia un'istanza regionale ad alta disponibilità:
Prima di utilizzare i dati della richiesta, apporta 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 di queste opzioni:
Dovresti ricevere un codice di stato riuscito (2xx) e una risposta vuota.
REST v1beta4
Per configurare un'istanza in modo che sia un'istanza regionale ad alta disponibilità:
Prima di utilizzare i dati della richiesta, apporta 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 di queste opzioni:
Dovresti ricevere un codice di stato riuscito (2xx) e una risposta vuota.
Avvia failover
Il test del failover è facoltativo, ma consigliato per vedere come risponde la tua applicazione in caso di failover.
Per saperne di più sui failover, consulta la panoramica del failover.
Console
-
Nella console Google Cloud , vai alla pagina Istanze Cloud SQL.
- Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.
- Fai clic su Failover.
- Nella finestra di dialogo Attiva manualmente un failover, inserisci l'ID della tua istanza nel campo di testo e poi fai clic su Attiva failover.
gcloud
Avvia il failover:
gcloud sql instances failover PRIMARY_INSTANCE_NAME
REST v1
- Descrivi l'istanza principale per ottenere il valore del campo
settingsVersion
.Prima di utilizzare i dati della richiesta, apporta 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 di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{ "kind": "sql#instance", "state": "RUNNABLE", "databaseVersion": "SQLSERVER_2019_STANDARD" }
- Avvia il failover:
Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:
- project-id: l'ID progetto
- instance-name: il nome dell'istanza
- settings-version: settingsVersion da 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 di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
REST v1beta4
- Descrivi l'istanza principale per ottenere il valore del campo
settingsVersion
.Prima di utilizzare i dati della richiesta, apporta 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 di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{ "kind": "sql#instance", "state": "RUNNABLE", "databaseVersion": "SQLSERVER_2019_STANDARD" }
- Avvia il failover:
Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:
- project-id: l'ID progetto
- instance-name: il nome dell'istanza
- settings-version: settingsVersion da 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 di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
L'istanza esegue il failover e non è disponibile per la pubblicazione dei dati per alcuni minuti.
Verificare la configurazione dell'alta disponibilità di un'istanza
Per verificare che un'istanza abbia l'alta disponibilità e per visualizzare le zone in cui è in esecuzione:
Console
-
Nella console Google Cloud , vai alla pagina Istanze Cloud SQL.
- Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.
- 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 primaria attuale dell'istanza.
gcloud
gcloud sql instances describe INSTANCE_NAME
L'output indica che availabilityType
è REGIONAL
.
I campi gceZone
e secondaryGceZone
mostrano le zone
primaria e secondaria correnti dell'istanza.
REST v1
Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:
- project-id: l'ID progetto
- instance-id: l'ID istanza
Metodo HTTP e URL:
GET https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{ "kind": "sql#instance", "state": "RUNNABLE", "databaseVersion": "SQLSERVER_2019_STANDARD" }
L'output indica che availabilityType
è REGIONAL
.
I campi gceZone
e secondaryGceZone
mostrano le zone
primaria e secondaria correnti dell'istanza.
REST v1beta4
Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:
- project-id: l'ID progetto
- instance-id: l'ID istanza
Metodo HTTP e URL:
GET https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{ "kind": "sql#instance", "state": "RUNNABLE", "databaseVersion": "SQLSERVER_2017_STANDARD", }
L'output indica che availabilityType
è REGIONAL
.
I campi gceZone
e secondaryGceZone
mostrano le zone
primaria e secondaria correnti dell'istanza.
Modificare le zone di un'istanza ad alta disponibilità
La modifica di una o entrambe le zone di un'istanza ad alta disponibilità esistente causa alcuni minuti di inattività durante la riconfigurazione dell'istanza. Per visualizzare le zone primarie 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
-
Nella console Google Cloud , vai alla pagina Istanze Cloud SQL.
- Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.
- Fai clic su Modifica.
- Nella sezione Scegli la disponibilità per regione e zona, espandi
Specifica zone e seleziona le nuove zone. Le zone sono impostate per impostazione predefinita su
Any
per la zona primaria eAny (different from primary)
per la zona secondaria. Si applicano le seguenti limitazioni:- Puoi specificare solo la zona principale o sia la zona principale che quella secondaria.
- Se vengono specificate sia la zona primaria che quella secondaria, devono essere zone diverse.
- Fai clic su Salva.
Viene visualizzata di nuovo la pagina dell'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 lo ometti,
Cloud SQL selezionerà una zona disponibile diversa dalla
zona primaria.
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 dalla zona principale.
REST v1
Modifica le zone dell'istanza regionale:
Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:
- PROJECT_ID: l'ID progetto
- INSTANCE_NAME: il nome dell'istanza
- PRIMARY_ZONE: la zona primaria
- 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 di queste opzioni:
Dovresti ricevere un codice di stato riuscito (2xx) e una risposta vuota.
Il parametro
secondaryZone
è facoltativo. Se lo ometti, Cloud SQL selezionerà una zona disponibile diversa dalla zona primaria.Si applicano le seguenti limitazioni:
- Le zone devono essere valide.
- Tutte le zone che scegli devono appartenere alla stessa regione dell'istanza Cloud SQL.
REST v1beta4
Modifica le zone dell'istanza regionale:
Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:
- PROJECT_ID: l'ID progetto
- INSTANCE_NAME: il nome dell'istanza
- PRIMARY_ZONE: la zona primaria
- 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 di queste opzioni:
Dovresti ricevere un codice di stato riuscito (2xx) e una risposta vuota.
Il parametro
secondaryZone
è facoltativo. Se lo ometti, Cloud SQL selezionerà una zona disponibile diversa dalla zona primaria.Si applicano le seguenti limitazioni:
- Le zone devono essere valide.
- Tutte le zone che scegli devono appartenere alla stessa regione dell'istanza Cloud SQL.
Disattivare 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.
Se disattivi l'alta disponibilità per un'istanza, in caso di interruzione a livello di zona, devi recuperare l'istanza manualmente. Per saperne di più, consulta Opzioni di ripristino per le istanze autonome.
Console
Per disattivare l'alta disponibilità per un'istanza:
-
Nella console Google Cloud , vai alla pagina Istanze Cloud SQL.
- Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.
- Fai clic su Modifica.
- Apri Backup automatici.
- Nella sezione Disponibilità, fai clic su Zona singola.
- Fai clic su Salva. Questa modifica richiede il riavvio dell'istanza.
- Quando viene visualizzata la finestra di dialogo, fai clic su Salva e riavvia.
gcloud
Per disattivare la disponibilità elevata 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, apporta 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 cui 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 di queste opzioni:
Dovresti ricevere un codice di stato riuscito (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, apporta 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 cui 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 di queste opzioni:
Dovresti ricevere un codice di stato riuscito (2xx) e una risposta vuota.
Risoluzione dei problemi
Problema | Risoluzione dei problemi |
---|---|
Non riesci a trovare le metriche per un failover manuale. | Nelle metriche vengono conteggiati solo i failover automatici. |
Le risorse dell'istanza Cloud SQL (CPU e RAM) sono vicine al 100% di utilizzo, il che causa l'interruzione dell'istanza ad alta disponibilità. | Le dimensioni della macchina dell'istanza sono troppo piccole per il carico.
Modifica l'istanza per eseguire l'upgrade a una dimensione della macchina più grande per ottenere più CPU e memoria. |
Passaggi successivi
- Scopri di più su come funziona la configurazione dell'alta disponibilità.
- Verifica la risposta della tua applicazione alle connessioni interrotte riavviando l'istanza.
- Scopri di più sulla gestione delle connessioni al database.
- Scopri di più su Google Cloud Observability.