Applicare aggiornamenti alla configurazione delle VM in modo selettivo in un gruppo di istanze gestite

Questo documento descrive come applicare in modo selettivo gli aggiornamenti di configurazione alle istanze di macchine virtuali (VM) in un gruppo di istanze gestite (MIG).

Compute Engine gestisce le VM in un MIG in base ai componenti di configurazione che utilizzi: modello di istanza, configurazione facoltativa per tutte le istanze e configurazione stateful facoltativa.

Ogni volta che aggiorni la configurazione delle VM di un MIG modificando questi componenti, Compute Engine applica automaticamente la configurazione aggiornata alle nuove VM aggiunte al gruppo.

Per applicare una configurazione aggiornata alle VM esistenti, puoi configurare un aggiornamento selettivo, noto anche come tipo di aggiornamento "opportunistico". Questo tipo di aggiornamento offre i seguenti vantaggi:

• Puoi selezionare le VM da aggiornare.
• Puoi controllare la tempistica e la sequenza degli aggiornamenti.
• Puoi utilizzare gcloud CLI o REST per aggiornare immediatamente tutte le VM.

In alternativa, se vuoi automatizzare l'implementazione di una nuova configurazione per tutte le VM o per un sottoinsieme casuale di VM in un MIG, consulta la pagina relativa all'applicazione automatica degli aggiornamenti alla configurazione delle VM in un MIG. Per aiutarti a decidere, consulta la sezione Metodi per applicare una nuova configurazione alle VM esistenti.

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.

  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 .

Applica la configurazione aggiornata alle VM selezionate

Assicurati che il tipo di criterio di aggiornamento del gruppo sia impostato su "opportunistico" per impedire al MIG di applicare automaticamente una nuova configurazione VM alle VM esistenti. Per ulteriori informazioni, consulta Controllare il tipo di policy di aggiornamento del gruppo.

Quindi, utilizza gcloud CLI o REST per aggiornare la configurazione del MIG e applicare l'ultima configurazione a VM specifiche del gruppo o a tutte le VM del gruppo.

gcloud compute instance-groups managed set-instance-template INSTANCE_GROUP_NAME \
    --template=INSTANCE_TEMPLATE

gcloud compute instance-groups managed update-instances INSTANCE_GROUP_NAME \
    --instances INSTANCE_NAMES \
    --most-disruptive-allowed-action DISRUPTION_LEVEL \
    --minimal-action DISRUPTION_LEVEL

gcloud compute instance-groups managed update-instances INSTANCE_GROUP_NAME \
    --all-instances \
    --most-disruptive-allowed-action DISRUPTION_LEVEL \
    --minimal-action DISRUPTION_LEVEL

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME

{
  "updatePolicy": {
    "type": "OPPORTUNISTIC"
  },
  "versions": [{
    "instanceTemplate": "global/instanceTemplates/NEW_TEMPLATE",
  }]
}

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME/applyUpdatesToInstances
{
  "instances": [
    "zones/ZONE/instances/INSTANCE_NAME_1",
    "zones/ZONE/instances/INSTANCE_NAME_2"
  ],
  "minimalAction": DISRUPTION_LEVEL,
  "mostDisruptiveAllowedAction": DISRUPTION_LEVEL
}

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME/applyUpdatesToInstances
{
  "allInstances": true,
  "minimalAction": DISRUPTION_LEVEL,
  "mostDisruptiveAllowedAction": DISRUPTION_LEVEL
}

Dopo aver inviato una richiesta, puoi controllare lo stato per verificare che l'aggiornamento sia stato completato.

Controllare il livello di interruzione durante gli aggiornamenti selettivi

A seconda della natura di un aggiornamento, potrebbe interrompere lo stato di un'istanza. Ad esempio, la modifica del disco di avvio di un'istanza richiede la sostituzione dell'istanza. Puoi controllare il livello di interruzione durante un aggiornamento selettivo impostando le seguenti opzioni:

• Azione minima: utilizza questa opzione per ridurre al minimo le interruzioni o per applicare un'azione più invasiva del necessario.

  • Per limitare al massimo le interruzioni, imposta l'azione minima su NONE. Se l'aggiornamento richiede un'azione più invasiva, Compute Engine esegue l'azione necessaria per eseguire l'aggiornamento.
  • Per applicare un'azione più distruttiva del necessario, imposta l'azione minima su RESTART o REPLACE. Ad esempio, Compute Engine non deve riavviare una VM per modificarne i metadati. Tuttavia, se la tua applicazione legge i metadati dell'istanza solo quando una VM viene riavviata, puoi impostare l'azione minima su RESTART per rilevare le modifiche ai metadati.

• Azione più invasiva consentita: utilizza questa opzione per impedire un aggiornamento se richiede un'interruzione più lunga di quanto tu possa permetterti. Se l'aggiornamento richiede un'azione più invasiva di quella impostata con questo flag, la richiesta di aggiornamento non va a buon fine. Ad esempio, se imposti l'azione più invasiva consentita su RESTART, il tentativo di aggiornare l'immagine del disco di avvio non va a buon fine perché l'aggiornamento richiede la ricreazione dell'istanza, un'azione più invasiva di un riavvio.

Quando aggiorni le VM selezionate, entrambe le opzioni accettano i seguenti valori:

L'azione consentita più distruttiva non può essere meno distruttiva dell'azione minima.

Quando aggiorni le VM in modo selettivo, vengono applicate le seguenti impostazioni predefinite:

• L'azione minima predefinita è NONE, che limita al massimo le interruzioni.
• L'azione più invasiva consentita per impostazione predefinita è REPLACE. Se non riesci a tollerare un'interruzione di questo tipo, imposta l'azione consentita più invasiva in modo che sia meno invasiva.

Passaggi successivi

• Scopri di più su come visualizzare le informazioni su MIG e VM gestite.
• Scopri di più sulla creazione di modelli di istanza.
• Scopri come utilizzare le famiglie di immagini e una sostituzione progressiva per aggiornare l'immagine sistema operativo su tutte le VM in un MIG.