Manutenzione self-service

Questa pagina descrive la manutenzione self-service, che ti consente di accettare un update di manutenzione sull'istanza al di fuori del normale flusso della manutenzione pianificata.

Panoramica

Cloud SQL rilascia regolarmente miglioramenti software, come per le vulnerabilità note, tramite nuove versioni di manutenzione. Cloud SQL pianifica gli aggiornamenti di manutenzione una volta a intervalli mesi per assicurarti di avere la versione di manutenzione più recente, ti consigliamo di utilizzare manutenzione self-service se:

  • Devi eseguire un aggiornamento prima del prossimo evento di manutenzione pianificato.
  • Vuoi aggiornare la tua versione di manutenzione all'ultima versione dopo aver saltato l'evento di manutenzione pianificato più recente.

Non è necessario eseguire l'aggiornamento manuale alla versione più recente. Puoi lasciare che sia Cloud SQL ad aggiornare automaticamente la versione di manutenzione durante il prossimo 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 suddivise 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 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, specifica l'istanza di replica di lettura quando esegui il self-service manutenzione.

Prima di iniziare

Prima di eseguire la manutenzione self-service, controlla innanzitutto lo stato attuale di manutenzione. Puoi quindi determinare la versione di manutenzione di destinazione a cui vuoi eseguire l'aggiornamento e aggiornare 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 attuale di un'istanza, utilizza la procedura seguente:

gcloud

Prima di eseguire questo comando gcloud, esegui quanto segue sostituzione:

  • INSTANCE_ID: l'istanza su cui eseguire una 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, 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 di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

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

Cerca l'elemento maintenanceVersion nella 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 di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

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

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 questo comando gcloud, esegui quanto segue sostituzione:

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

La versione di manutenzione disponibile è indicata accanto al 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 di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

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

Cerca l'elemento availableMaintenanceVersions nella 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 di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

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

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 procedura riportata di seguito.

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 di Cloud SQL da applicare
gcloud sql instances patch PRIMARY_INSTANCE_ID \
   --maintenance-version=MAINTENANCE_VERSION

Al prompt di conferma, digita Y per continuare o 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 nessuna istanza.

Al termine dell'aggiornamento delle repliche di lettura e dell'istanza principale, viene visualizzato 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" "postgres_ssm_instance_name" {
  name                = "postgres-ssm-instance-name"
  region              = "asia-northeast1"
  database_version    = "POSTGRES_14"
  maintenance_version = "POSTGRES_14_4.R20220710.01_07"
  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 in cui vuoi applicare le configurazioni Terraform.

    Devi eseguire questo comando una sola volta per progetto e puoi farlo 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 all'interno di quella directory. 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 campione in ogni sezione o passaggio.

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

    Se vuoi, copia il codice da GitHub. Questa 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

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

    terraform init -upgrade

Applica le modifiche

  1. Rivedi la configurazione e verifica che le risorse che Terraform creerà o che l'aggiornamento soddisfi le tue aspettative: 
    terraform plan

    Apporta le correzioni necessarie alla configurazione.

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

    Attendi che Terraform mostri il messaggio "Applicazione completata".

  3. Apri il tuo 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:

  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 tua configurazione Terraform eseguendo questo comando e inserendo yes al prompt:

    terraform destroy

REST v1

Prima di utilizzare i dati della richiesta, apporta 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, apporta 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"
}

Aggiornare 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 per aggiornare 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 replica di lettura.
  • MAINTENANCE_VERSION: la versione di manutenzione 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 nessuna 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" "postgres_ssm_instance_name" {
  name                = "postgres-ssm-instance-name"
  region              = "asia-northeast1"
  database_version    = "POSTGRES_14"
  maintenance_version = "POSTGRES_14_4.R20220710.01_07"
  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 farlo 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 campione in ogni sezione o passaggio.

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

    Se vuoi, copia il codice da GitHub. Questa 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

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

    terraform init -upgrade

Applica le modifiche

  1. Rivedi la configurazione e verifica che le risorse che Terraform creerà o che l'aggiornamento soddisfi le tue aspettative: 
    terraform plan

    Apporta le correzioni necessarie alla configurazione.

  2. Applica la configurazione di Terraform eseguendo il seguente comando e inserendo yes al prompt: 
    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 nell'interfaccia utente per assicurarti che Terraform le abbia create o aggiornate.

Elimina le modifiche

Per eliminare le modifiche:

  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 tua configurazione Terraform eseguendo questo comando e inserendo yes al prompt:

    terraform destroy

REST v1

Prima di utilizzare i dati della richiesta, apporta 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, apporta 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 il self-service aggiornamento di manutenzione.
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:

Passaggi successivi