Applica gli aggiornamenti della configurazione durante le riparazioni

Questo documento descrive come configurare il MIG in modo da applicare il modello di istanza e le configurazioni per istanza più recenti quando si ricrea una VM durante le operazioni di riparazione. L'applicazione dell'ultima configurazione disponibile durante un'operazione di riparazione è nota anche come aggiornamento durante la riparazione. Questo documento descrive anche come verificare se l'aggiornamento durante la riparazione è abilitato nel tuo MIG e, se abilitato, come disattivarlo.

Per impostazione predefinita, durante una riparazione, un MIG ricrea una VM utilizzando la stessa configurazione dell'istanza utilizzata inizialmente per crearla. Se sono disponibili aggiornamenti per il modello di istanza o per le configurazioni per istanza del gruppo, puoi applicare queste modifiche a una VM in fase di riparazione.

Se vuoi applicare automaticamente gli aggiornamenti di configurazione a tutte o a un gruppo di VM (PROACTIVE) o aggiornare in modo selettivo istanze specifiche (OPPORTUNISTIC), consulta la pagina relativa all'applicazione di nuove configurazioni alle VM in un MIG.

Prima di iniziare

  • Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione verifica la tua identità per l'accesso a Google Cloud servizi e API. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti su Compute Engine selezionando una delle seguenti opzioni:

    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. Installa Google Cloud CLI. Dopo l'installazione, inizializza Google Cloud CLI eseguendo il seguente comando: 

      gcloud init

      Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

    2. Set a default region and zone.

    REST

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

      Installa Google Cloud CLI. Dopo l'installazione, inizializza Google Cloud CLI eseguendo il seguente comando: 

      gcloud init

      Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

    Per saperne di più, consulta Autenticarsi per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud .

Configura l'aggiornamento durante la riparazione

Per configurare l'aggiornamento durante la riparazione, utilizza la console Google Cloud , 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 MIG in cui vuoi configurare l'aggiornamento durante la riparazione.

  3. Fai clic su Modifica per modificare il MIG.

  4. Fai clic su Ciclo di vita dell'istanza e autoriparazione per espandere la sezione.

  5. Nella sezione Aggiornamenti durante la riparazione delle istanze VM, seleziona Aggiorna la configurazione dell'istanza.

  6. Fai clic su Salva.

gcloud

Per un gruppo MIG esistente, utilizza il comando update:

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

Per un nuovo MIG, utilizza il comando create:

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

Sostituisci quanto segue:

  • MIG_NAME: il nome del gruppo di istanze
  • INSTANCE_TEMPLATE_URL: l'URL del template di istanza che vuoi utilizzare per creare le VM nel MIG. L'URL può contenere l'ID o il nome del modello di istanza. Specifica uno dei seguenti valori:
    • Per un template di istanza regionale: projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_ID
    • Per un template di istanza globale: INSTANCE_TEMPLATE_ID
  • SIZE: la dimensione target del gruppo di istanze.

REST

Per un MIG esistente a livello di zona, utilizza il metodo instanceGroupManagers.patch oppure, per un MIG esistente a livello di regione, utilizza il metodo regionInstanceGroupManagers.patch.

Esegui la seguente chiamata per configurare l'aggiornamento durante la riparazione in un MIG esistente a livello di zona:

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

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

Esegui la seguente chiamata per configurare l'aggiornamento durante la riparazione quando crei un MIG a livello di zona:

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

Sostituisci quanto segue:

  • PROJECT_ID: il tuo ID progetto
  • ZONE: la zona in cui si trova il MIG
  • MIG_NAME: il nome del gruppo di istanze
  • INSTANCE_TEMPLATE_URL: l'URL del template di istanza che vuoi utilizzare per creare le VM nel MIG. L'URL può contenere l'ID o il nome del modello di istanza. Specifica uno dei seguenti valori:
    • Per un template di istanza regionale: projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_ID
    • Per un template di istanza globale: INSTANCE_TEMPLATE_ID
  • SIZE: la dimensione target del gruppo di istanze.

Controlla se l'aggiornamento durante la riparazione è abilitato

Per impostazione predefinita, un MIG non aggiorna una VM durante una riparazione. Per verificare se l'aggiornamento durante la riparazione è abilitato per il tuo MIG, utilizza la console Google Cloud , gcloud CLI o REST per visualizzare la configurazione dell'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 MIG di cui vuoi controllare la configurazione.

  3. Fai clic sulla scheda Dettagli.

  4. Nella sezione Ciclo di vita di un'istanza VM, controlla l'opzione selezionata per Aggiornamenti durante la riparazione delle istanze VM. Se il campo mostra Aggiorna la configurazione dell'istanza, l'aggiornamento durante la riparazione è abilitato.

gcloud

Utilizza il comando describe come segue:

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

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

  • NO: predefinito. Il MIG non aggiorna le VM quando vengono riparate.
  • YES: il MIG aggiorna le VM durante la riparazione.

Di seguito è riportato un output di esempio:

instanceLifecyclePolicy:
 forceUpdateOnRepair: YES

REST

Per un MIG a livello di zona, utilizza il metodo instanceGroupManagers.get o, per un MIG a livello di regione, utilizza il metodo regionInstanceGroupManagers.get.

Ad esempio, in un MIG a livello di zona, utilizza il seguente comando:

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

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

  • NO: predefinito. Il MIG non aggiorna le VM quando vengono riparate.
  • YES: il MIG 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 MIG
  • MIG_NAME: il nome del gruppo di istanze

Disattiva l'aggiornamento durante la riparazione

Quando il MIG ripara una VM, se vuoi che utilizzi il modello di istanza o le configurazioni per istanza originali utilizzati per creare la VM, devi disattivare l'aggiornamento durante la riparazione. Per impostazione predefinita, l'aggiornamento durante la riparazione è disabilitato per un MIG.

Utilizza la console Google Cloud , gcloud CLI, 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 MIG in cui vuoi configurare l'aggiornamento durante la riparazione.

  3. Fai clic su Modifica per modificare il MIG.

  4. Fai clic su Ciclo di vita dell'istanza e autoriparazione per espandere la sezione.

  5. Nella sezione Aggiornamenti durante la riparazione delle istanze VM, seleziona Mantieni la stessa configurazione dell'istanza.

  6. Fai clic su Salva.

gcloud

Utilizza 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 MIG a livello di zona, utilizza il metodo instanceGroupManagers.patch o, per un MIG a livello di regione, utilizza il metodo regionInstanceGroupManagers.patch.

Ad esempio, per disattivare l'aggiornamento durante la riparazione per un MIG a livello di zona, utilizza il seguente comando:

PATCH https://compute.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 MIG
  • MIG_NAME: il nome del gruppo di istanze

Passaggi successivi