Applicare gli aggiornamenti di configurazione durante le riparazioni

Questo documento descrive come configurare il gruppo di istanze gestite in modo da applicare il modello di istanza e le configurazioni per istanza più recenti quando viene ricreata una VM durante le operazioni di riparazione. L'applicazione della configurazione più recente disponibile durante un'operazione di riparazione è nota anche come aggiornamento durante la riparazione. Il presente documento descrive inoltre come per controllare se l'aggiornamento sulla riparazione è abilitato nel tuo gruppo di istanze gestite e, se abilitato, come disattiva l'aggiornamento in caso di riparazione.

Per impostazione predefinita, durante una riparazione, un gruppo di istanze gestite ricrea una VM utilizzando la stessa istanza utilizzata originariamente per creare la VM. Se sono disponibili aggiornamenti per il modello di istanza o le configurazioni per istanza del gruppo, puoi applicare queste modifiche a una VM in fase di riparazione.

Se vuoi applicare automaticamente gli aggiornamenti della configurazione a tutte o a un insieme di VM (PROACTIVE) o aggiornare selettivamente istanze specifiche (OPPORTUNISTIC), consulta Applicazione di nuove configurazioni alle VM in un gruppo di istanze gestite.

Prima di iniziare

  • Se non l'hai già fatto, configura l'autenticazione. Autenticazione è Il processo di verifica dell'identità per l'accesso ai servizi e alle API di Google Cloud. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi eseguire l'autenticazione Compute Engine come segue.

    Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

    1. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

      3. REST

      Per utilizzare gli esempi dell'API REST in questa pagina in un ambiente di sviluppo locale, utilizza le credenziali fornite a gcloud CLI.

        Install the Google Cloud CLI, then initialize it by running the following command: 

        gcloud init

      Per ulteriori informazioni, vedi Esegui l'autenticazione per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud.

Configura l'aggiornamento in caso di riparazione

Per configurare l'aggiornamento in caso di riparazione, usa la console Google Cloud tramite gcloud CLI o REST.

Console

  1. Nella console Google Cloud, vai alla pagina Gruppi di istanze.

    Vai a Gruppi di istanze

  2. Fai clic sul nome del gruppo di istanze gestite in cui vuoi configurare l'aggiornamento al termine della riparazione.

  3. Fai clic su Modifica per modificare il gruppo di istanze gestite.

  4. Nella sezione Ciclo di vita dell'istanza VM, per Aggiornamenti durante la riparazione delle istanze VM, seleziona Aggiorna la configurazione dell'istanza.

  5. Fai clic su Salva.

gcloud

Per un gruppo di istanze gestite esistente, utilizza Comando update:

gcloud compute instance-groups managed update MIG_NAME \
    --force-update-on-repair

Per un nuovo gruppo di istanze gestite, utilizza Comando create:

gcloud compute instance-groups managed create MIG_NAME \
    --template INSTANCE_TEMPLATE \
    --size SIZE \
    --force-update-on-repair

Sostituisci quanto segue:

  • MIG_NAME: il nome del gruppo di istanze.
  • INSTANCE_TEMPLATE: il nome del modello di istanza da utilizzare per il gruppo.
  • SIZE: la dimensione target del gruppo di istanze.

REST

Per un gruppo di istanze gestite di zona esistente, utilizza il metodo instanceGroupManagers.patch oppure, per un gruppo di istanze gestite regionale esistente, utilizza il metodo regionInstanceGroupManagers.patch.

Esegui la seguente chiamata per configurare l'aggiornamento in caso di riparazione in un gruppo di istanze gestite zonale esistente:

PATCH https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME

{
"instanceLifecyclePolicy":
  { "forceUpdateOnRepair": YES
  }
}

Per un nuovo gruppo di istanze gestite a livello di zona, utilizza il metodo instanceGroupManagers.insert oppure, per un nuovo gruppo di istanze gestite a livello di regione, utilizza il metodo regionInstanceGroupManagers.insert.

Esegui la seguente chiamata per configurare l'aggiornamento al termine della riparazione quando crei un gruppo di istanze gestite a livello di zona:

POST https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers
{
"name": "MIG_NAME",
"instanceTemplate": "INSTANCE_TEMPLATE",
"targetSize": SIZE,
"instanceLifecyclePolicy":
  { "forceUpdateOnRepair": YES
  }
}

Sostituisci quanto segue:

  • PROJECT_ID: il tuo ID progetto.
  • ZONE: la zona in cui si trova il gruppo di istanze gestite.
  • MIG_NAME: il nome del gruppo di istanze.
  • INSTANCE_TEMPLATE: il nome del modello di istanza da utilizzare per il gruppo.
  • SIZE: la dimensione target del gruppo di istanze.

Controlla se l'aggiornamento durante la riparazione è attivo

Per impostazione predefinita, un gruppo di istanze gestite non aggiorna una VM durante una riparazione. Per verificare se l'aggiornamento al termine della riparazione è abilitato per il tuo MIG, utilizza la console Google Cloud, l'interfaccia a riga di comando gcloud o REST per visualizzare la configurazione dell'aggiornamento al termine della riparazione.

Console

  1. Nella console Google Cloud, vai alla pagina Gruppi di istanze.

    Vai a Gruppi di istanze

  2. Fai clic sul nome del gruppo di istanze gestite di cui vuoi controllare la configurazione.

  3. Fai clic sulla scheda Dettagli.

  4. Nella sezione Ciclo di vita dell'istanza VM, seleziona l'opzione selezionata. per Aggiornamenti durante la riparazione delle istanze VM. Se è selezionata l'opzione Aggiorna la configurazione dell'istanza, l'aggiornamento al termine della riparazione è abilitato.

gcloud

Utilizza la Comando describe come segue:

gcloud compute instance-groups managed describe MIG_NAME \
--format="(instanceLifecyclePolicy)"

Nel corpo della risposta, controlla il campo forceUpdateOnRepair, che ha uno dei seguenti valori:

  • NO: impostazione predefinita. Il gruppo di istanze gestite non aggiorna le VM quando vengono riparate.
  • YES: il gruppo di istanze gestite aggiorna le VM durante la riparazione.

Di seguito è riportato un output di esempio:

instanceLifecyclePolicy:
 forceUpdateOnRepair: YES

REST

Per un gruppo di istanze gestite a livello di zona, utilizza il metodo instanceGroupManagers.get oppure, per un gruppo di istanze gestite a livello di regione, utilizza il metodo regionInstanceGroupManagers.get.

Ad esempio, in un gruppo di istanze gestite a livello di zona, utilizza il comando seguente:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME

Nel corpo della risposta, controlla il campo instanceLifecyclePolicy.forceUpdateOnRepair, che ha uno dei seguenti valori:

  • NO: valore predefinito. Il gruppo di istanze gestite non aggiorna le VM quando vengono riparate.
  • YES: il gruppo di istanze gestite aggiorna le VM durante la riparazione.

Di seguito è riportato un esempio di risposta:

{
...
"name": "example-mig",
"targetSize": 12,
...
"instanceLifecyclePolicy": {
  "forceUpdateOnRepair": "YES"
  },
...
}

Sostituisci quanto segue:

  • PROJECT_ID: il tuo ID progetto.
  • ZONE: la zona in cui si trova il gruppo di istanze gestite.
  • MIG_NAME: il nome del gruppo di istanze.

Disattivare l'aggiornamento durante la riparazione

Quando il gruppo di istanze gestite ripara una VM, se vuoi che utilizzi l'istanza originale o le configurazioni per istanza utilizzate per creare la VM, devi disattivare l'aggiornamento al momento della riparazione. Per impostazione predefinita, l'aggiornamento alla riparazione è disabilitato per un gruppo di istanze gestite.

Utilizza la console Google Cloud, l'interfaccia a riga di comando gcloud o REST per disattivare l'aggiornamento durante la riparazione.

Console

  1. Nella console Google Cloud, vai alla pagina Gruppi di istanze.

    Vai a Gruppi di istanze

  2. Fai clic sul nome del gruppo di istanze gestite in cui vuoi disattivare l'aggiornamento in caso di riparazione.

  3. Fai clic su Modifica per modificare il gruppo di istanze gestite.

  4. Nella sezione Ciclo di vita dell'istanza VM, per Aggiornamenti durante la riparazione delle istanze VM, seleziona Mantieni la stessa configurazione dell'istanza.

  5. Fai clic su Salva.

gcloud

Usa il comando update per impostare il flag --no-force-update-on-repair come segue:

gcloud compute instance-groups managed update MIG_NAME \
    --no-force-update-on-repair

REST

Per un gruppo di istanze gestite a livello di zona, utilizza Metodo instanceGroupManagers.patch, oppure, per un gruppo di istanze gestite a livello di regione, utilizza metodo regionInstanceGroupManagers.patch.

Ad esempio, per disabilitare l'aggiornamento al momento della riparazione per un gruppo di istanze gestite a livello di zona, usa quanto segue :

PATCH https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME
{
"instanceLifecyclePolicy":
{ "forceUpdateOnRepair": NO
}
}

Sostituisci quanto segue:

  • PROJECT_ID: il tuo ID progetto.
  • ZONE: la zona in cui si trova il gruppo di istanze gestite.
  • MIG_NAME: il nome del gruppo di istanze.

Passaggi successivi