Manutenzione self-service

In questa pagina viene descritta la manutenzione self-service, che ti consente di accettare un aggiornamento di manutenzione della tua istanza al di fuori del normale flusso dei manutenzione.

Panoramica

Cloud SQL rilascia regolarmente miglioramenti software, come patch per vulnerabilità note, tramite nuove versioni di manutenzione. Sebbene Cloud SQL programmi gli aggiornamenti di manutenzione ogni pochi mesi per assicurarti di avere la versione di manutenzione più recente, ti consigliamo di utilizzare la manutenzione self-service se:

  • Devi eseguire un aggiornamento prima del prossimo evento di manutenzione pianificato.
  • Vuoi recuperare la versione di manutenzione più recente dopo aver saltato di manutenzione pianificata recente.

Non è necessario eseguire manualmente l'aggiornamento all'ultima versione. Puoi consenti a Cloud SQL di aggiornare automaticamente la versione di manutenzione durante successivo evento di manutenzione pianificato.

Gestire la manutenzione su tutte le repliche di lettura di un'istanza principale

Quando esegui la manutenzione self-service su un'istanza principale che repliche di lettura, Cloud SQL applica automaticamente l'aggiornamento di manutenzione a tutti e le sue repliche di lettura. Se hai più di tre istanze di replica di lettura, le istanze vengono divise in gruppi e aggiornate in parallelo. Come passaggio finale, l'aggiornamento di manutenzione viene applicato all'istanza principale.

Se necessario, puoi comunque eseguire la manutenzione self-service su una singola replica di lettura. Tuttavia, per assicurare che tutte le istanze di replica di lettura l'istanza principale opera sulla stessa versione di manutenzione, ti consigliamo di eseguire la manutenzione self-service su tutte le repliche di lettura di un'istanza principale contemporaneamente.

Per aggiornare una singola istanza di replica di lettura, specificala quando esegui la manutenzione self-service.

Prima di iniziare

Prima di eseguire la manutenzione self-service, controlla la versione di manutenzione corrente. Poi puoi determinare il target di manutenzione a cui vuoi eseguire l'aggiornamento e aggiorna l'istanza a quella versione. Se utilizzi le repliche di lettura, aggiorna tutte le repliche di lettura dell'istanza principale a quella versione.

Per visualizzare la versione di manutenzione corrente di un'istanza, segui la procedura riportata di seguito:

gcloud

Prima di eseguire il seguente comando gcloud, esegui la sostituzione seguente:

  • INSTANCE_ID: l'istanza su cui eseguire la query
gcloud sql instances describe INSTANCE_ID

La versione di manutenzione installata sull'istanza è indicata accanto all'attributo maintenanceVersion.

REST v1

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 delle seguenti opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

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

Cerca l'elemento maintenanceVersion nell' Sezione DatabaseInstance della risposta.

REST v1beta4

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 delle seguenti opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

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

Cerca l'elemento maintenanceVersion nell' Sezione DatabaseInstance della risposta.

Determina la versione di manutenzione di destinazione

Utilizza il seguente metodo per visualizzare le versioni di manutenzione che puoi selezionare come target. Non puoi eseguire l'aggiornamento a una versione precedente a quella attuale di manutenzione.

gcloud

Prima di eseguire il seguente comando gcloud, esegui la sostituzione seguente:

  • INSTANCE_ID: l'istanza su cui eseguire una query
gcloud sql instances describe INSTANCE_ID

La versione di manutenzione disponibile è indicata accanto all'attributo availableMaintenanceVersions.

REST v1

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 delle seguenti opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

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

Cerca l'elemento availableMaintenanceVersions nell' Sezione DatabaseInstance della risposta.

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"
}

Cerca l'elemento availableMaintenanceVersions nell' Sezione DatabaseInstance della risposta.

Aggiorna tutte le repliche di lettura di un'istanza principale alla versione di manutenzione di destinazione

Per eseguire un aggiornamento di manutenzione su tutte le istanze di replica di lettura di un'istanza principale, utilizza la seguente procedura.

gcloud

Prima di utilizzare il seguente comando gcloud, esegui la seguente sostituzione:

  • PRIMARY_INSTANCE_ID: l'ID dell'istanza principale
  • MAINTENANCE_VERSION: la versione di manutenzione Cloud SQL da applicare
gcloud sql instances patch PRIMARY_INSTANCE_ID \
   --maintenance-version=MAINTENANCE_VERSION

Al prompt di conferma, digita Y per continuare oppure digita N per annullare.

Se selezioni Y, la procedura di aggiornamento applica prima la versione di manutenzione specificata a tutte le repliche di lettura prima di aggiornare l'istanza principale. Tutte le istanze di replica di lettura già aggiornate alla versione di manutenzione di destinazione vengono ignorate.

Se selezioni N, non viene aggiornata alcuna istanza.

Dopo il completamento dell'aggiornamento delle repliche di lettura e dell'istanza principale, appare un messaggio simile al seguente:

  Patching Cloud SQL instance....done.
  Patching Cloud SQL instance....done.
  Patching Cloud SQL instance....done.
  Updated [https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/PRIMARY_INSTANCE_ID]

Terraform

Per creare un'istanza, utilizza una risorsa Terraform.

resource "google_sql_database_instance" "mysql_ssm_instance_name" {
  name                = "mysql-ssm-instance-name"
  region              = "asia-northeast1"
  database_version    = "MYSQL_5_7"
  maintenance_version = "MYSQL_5_7_38.R20220809.02_00"
  settings {
    tier = "db-f1-micro"
  }
  # 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 configurazione Terraform in un progetto Google Cloud, completa i passaggi nelle seguenti sezioni.

Prepara Cloud Shell

  1. Avvia Cloud Shell.

  2. Imposta il progetto Google Cloud predefinito dove 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 in Terraform di configurazione del deployment.

Prepara la directory

Ogni file di configurazione di Terraform deve avere una 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 contenere .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 di esempio in ogni sezione o passaggio.

    Copia il codice di esempio nel file main.tf appena creato.

    Facoltativamente, copia il codice da GitHub. Opzione consigliata quando 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

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

    terraform init -upgrade

Applica le modifiche

  1. Rivedi la configurazione e verifica che le risorse che Terraform sta per creare o aggiornare corrispondano alle tue aspettative: 
    terraform plan

    Apporta le correzioni necessarie alla configurazione.

  2. Applica la configurazione Terraform eseguendo questo comando e inserendo yes alla richiesta: 
    terraform apply

    Attendi finché Terraform non visualizzi il messaggio "Applicazione completata!". per creare un nuovo messaggio email.

  3. Apri il progetto Google Cloud 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, procedi nel seguente modo:

  1. Per disattivare la protezione dall'eliminazione, imposta l'argomento deletion_protection su false nel file di configurazione Terraform. 
    deletion_protection =  "false"
  2. Applica la configurazione Terraform aggiornata eseguendo il comando seguente inserendo yes alla richiesta: 
    terraform apply

  1. Rimuovi le risorse applicate in precedenza con la configurazione Terraform eseguendo il seguente comando e inserendo yes al prompt:

    terraform destroy

REST v1

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

  • PROJECT_ID: l'ID progetto
  • PROJECT_ID: l'ID istanza dell'istanza principale
  • MAINTENANCE_VERSION: la versione di manutenzione del software Cloud SQL da applicare

Metodo HTTP e URL: 

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

Corpo JSON della richiesta: 

{
  "maintenanceVersion": "MAINTENANCE_VERSION"
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "startTime": "08:00",
  "endTime": "08:01",
  "operationType": UPDATE,
  "name": "OPERATION_ID",
  "targetId": "PRIMARY_INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

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

  • PROJECT_ID: l'ID progetto
  • INSTANCE_ID: l'ID istanza dell'istanza principale
  • MAINTENANCE_VERSION: la versione di manutenzione del software Cloud SQL da applicare

Metodo HTTP e URL: 

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

Corpo JSON della richiesta: 

{
  "maintenanceVersion": "MAINTENANCE_VERSION"
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "startTime": "08:00",
  "endTime": "08:01",
  "operationType": UPDATE,
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Aggiorna una singola istanza alla versione di manutenzione di destinazione

Per eseguire un aggiornamento di manutenzione su una singola istanza, utilizza la seguente procedura. Se necessario, puoi utilizzare questa procedura aggiorna una singola istanza di replica di lettura.

gcloud

Prima di utilizzare il seguente comando gcloud, esegui quanto segue sostituzioni:

  • INSTANCE_ID: l'ID dell'istanza. Questa istanza può essere un'istanza di replica di lettura.
  • MAINTENANCE_VERSION: la versione di manutenzione di Cloud SQL da applicare
  gcloud sql instances patch INSTANCE_ID \
     --maintenance-version=MAINTENANCE_VERSION

Se specifichi una replica di lettura, viene visualizzata una richiesta di conferma . Digita Y per continuare o N per annullare.

  • Se selezioni Y, la procedura di aggiornamento applica la versione di manutenzione specificata solo alla replica di lettura specificata.
  • Se selezioni N, non viene aggiornata alcuna istanza.

Al termine dell'aggiornamento dell'istanza, viene visualizzato un messaggio simile al seguente:

  Patching Cloud SQL instance....done.
  Updated [https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID]

Terraform

Per creare un'istanza, utilizza una risorsa Terraform.

resource "google_sql_database_instance" "mysql_ssm_instance_name" {
  name                = "mysql-ssm-instance-name"
  region              = "asia-northeast1"
  database_version    = "MYSQL_5_7"
  maintenance_version = "MYSQL_5_7_38.R20220809.02_00"
  settings {
    tier = "db-f1-micro"
  }
  # 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 configurazione Terraform in un progetto Google Cloud, completa i passaggi nelle seguenti sezioni.

Prepara Cloud Shell

  1. Avvia Cloud Shell.

  2. Imposta il progetto Google Cloud predefinito dove 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 in Terraform di configurazione del deployment.

Prepara la directory

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

  1. In Cloud Shell, crea una directory e un nuovo file al suo interno. Il nome 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 di esempio in ogni sezione o passaggio.

    Copia il codice di esempio nel file main.tf appena creato.

    Facoltativamente, copia il codice da GitHub. Opzione consigliata quando 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

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

    terraform init -upgrade

Applica le modifiche

  1. Rivedi la configurazione e verifica che le risorse che Terraform sta per creare o aggiornare corrispondano alle tue aspettative: 
    terraform plan

    Apporta le correzioni necessarie alla configurazione.

  2. Applica la configurazione Terraform eseguendo questo comando e inserendo yes alla richiesta: 
    terraform apply

    Attendi finché Terraform non visualizzi il messaggio "Applicazione completata!". per creare un nuovo messaggio email.

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

Elimina le modifiche

Per eliminare le modifiche, procedi nel seguente modo:

  1. Per disattivare la protezione dall'eliminazione, imposta l'argomento deletion_protection su false nel file di configurazione Terraform. 
    deletion_protection =  "false"
  2. Applica la configurazione Terraform aggiornata eseguendo il comando seguente inserendo yes alla richiesta: 
    terraform apply

  1. Rimuovi le risorse applicate in precedenza con la configurazione Terraform eseguendo il seguente comando e inserendo yes al prompt:

    terraform destroy

REST v1

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

  • PROJECT_ID: l'ID progetto
  • PROJECT_ID: l'ID istanza, che può essere un'istanza di replica di lettura
  • MAINTENANCE_VERSION: la versione di manutenzione del software Cloud SQL da applicare

Metodo HTTP e URL: 

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

Corpo JSON della richiesta: 

{
  "maintenanceVersion": "MAINTENANCE_VERSION"
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "startTime": "08:00",
  "endTime": "08:01",
  "operationType": UPDATE,
  "name": "OPERATION_ID",
  "targetId": "PRIMARY_INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

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

  • PROJECT_ID: l'ID progetto
  • INSTANCE_ID: l'ID istanza, che può essere un istanza di replica di lettura
  • MAINTENANCE_VERSION: la versione di manutenzione del software Cloud SQL da applicare

Metodo HTTP e URL: 

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

Corpo JSON della richiesta: 

{
  "maintenanceVersion": "MAINTENANCE_VERSION"
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "startTime": "08:00",
  "endTime": "08:01",
  "operationType": UPDATE,
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Risoluzione dei problemi

Problema Risoluzione dei problemi
Impossibile applicare l'aggiornamento di manutenzione a un'istanza arrestata. Per risolvere il problema, avvia l'istanza prima di eseguire l'aggiornamento della manutenzione self-service.
A causa di una differenza nella versione principale del database, l'aggiornamento di manutenzione non è riuscito.

Non puoi utilizzare la manutenzione self-service per eseguire l'upgrade del database principale di un'istanza.

Per eseguire l'upgrade della versione principale di un'istanza, utilizza una delle le seguenti procedure:
A causa di una differenza nella versione secondaria del database, aggiornamento non riuscito.

Non puoi utilizzare la manutenzione self-service per eseguire l'upgrade della versione secondaria del database di un'istanza.

Per eseguire l'upgrade della versione secondaria di un'istanza, segui i passaggi descritti in Eseguire l'upgrade della versione secondaria del database.

Passaggi successivi