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:

  • Hai bisogno di 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 l'aggiornamento manuale alla versione più recente. 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 con repliche di lettura, Cloud SQL applica automaticamente l'aggiornamento della manutenzione a tutte 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 di lettura. Tuttavia, per assicurarti che tutte le istanze di replica di lettura e l'istanza principale funzionino con la stessa versione di manutenzione, consigliamo di eseguire contemporaneamente la manutenzione self-service su tutte le repliche di lettura di un'istanza principale.

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. 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 attuale di un'istanza, utilizza la procedura seguente:

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, 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": "SQLSERVER_2019_STANDARD"
}

Cerca l'elemento maintenanceVersion 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": "SQLSERVER_2019_STANDARD"
}

Cerca l'elemento maintenanceVersion nella 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 il 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, 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": "SQLSERVER_2019_STANDARD"
}

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 di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

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

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 quanto segue 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 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" "sqlserver_ssm_instance_name" {
  name                = "sqlserver-ssm-instance-name"
  region              = "asia-northeast1"
  database_version    = "SQLSERVER_2019_STANDARD"
  maintenance_version = "SQLSERVER_2019_STANDARD_CU16_GDR.R20220821.00_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 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 di Terraform.

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

    Se vuoi, 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

    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 sta per creare o aggiornare corrispondano alle 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 nella UI per assicurarti create o aggiornate da Terraform.

Elimina le modifiche

Per eliminare le modifiche:

  1. Per disattivare la protezione dell'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 le seguenti sostituzione:

  • 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 visualizzato un messaggio di conferma. Digita Y per continuare o N per annullare.

  • Se selezioni Y, la procedura di aggiornamento applica il valore specificato di manutenzione solo per la 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" "sqlserver_ssm_instance_name" {
  name                = "sqlserver-ssm-instance-name"
  region              = "asia-northeast1"
  database_version    = "SQLSERVER_2019_STANDARD"
  maintenance_version = "SQLSERVER_2019_STANDARD_CU16_GDR.R20220821.00_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 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 di Terraform.

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

    Se vuoi, 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

    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 sta per creare o aggiornare corrispondano alle 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 nella UI per assicurarti create o aggiornate da Terraform.

Elimina le modifiche

Per eliminare le modifiche:

  1. Per disattivare la protezione dell'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 della versione principale del database di un'istanza.

Per eseguire l'upgrade della versione principale di un'istanza, utilizza una delle seguenti procedure:

Passaggi successivi