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 è il processo mediante il quale la tua identità viene verificata per l'accesso ai Google Cloud servizi e alle 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. After installing the Google Cloud CLI, initialize it by running the following command: 

        gcloud init

        If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

      2. Set a default region and zone.

        3. REST

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

          After installing the Google Cloud CLI, initialize it by running the following command: 

          gcloud init

          If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

        Per saperne di più, consulta la sezione 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. Nella sezione Ciclo di vita di un'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 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 modello 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 modello di istanza regionale: projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_ID
    • Per un modello 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 modello 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 modello di istanza regionale: projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_ID
    • Per un modello 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 è selezionata l'opzione 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. Nella sezione Ciclo di vita di un'istanza VM, per Aggiornamenti durante la riparazione delle istanze VM, seleziona Mantieni la stessa configurazione dell'istanza.

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