Sostituire le proprietà del modello di istanza con una configurazione per tutte le istanze

Console

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

   Vai a Gruppi di istanze

2. Seleziona il MIG di cui vuoi impostare la configurazione per tutte le istanze.

3. Fai clic su Aggiorna VM.

4. Nella sezione Configurazione di tutte le istanze:

   • Per aggiungere o aggiornare i valori dei metadati, fai clic su Gestisci metadati. Completa la configurazione e fai clic su Salva.
   • Per aggiungere o aggiornare le etichette, fai clic su Gestisci etichette. Completa la configurazione e fai clic su Salva.

5. Dopo aver completato la configurazione delle proprietà nella configurazione di tutte le istanze, fai clic su Aggiorna VM.

   Se il tipo di aggiornamento del gruppo di istanze gestite è impostato su Automatico, la configurazione per tutte le istanze impostata viene applicata immediatamente a tutte le VM esistenti. Se il tipo di aggiornamento è Selettivo, devi applicare la configurazione in modo selettivo alle VM esistenti. Per ulteriori informazioni, consulta Applicare una configurazione per tutte le istanze alle VM esistenti.

gcloud

Aggiungi o aggiorna una configurazione per tutte le istanze utilizzando il comando all-instances-config update.

gcloud compute instance-groups managed all-instances-config update INSTANCE_GROUP_NAME \
    --metadata=KEY1=VALUE1,KEY2=VALUE2 \
    --labels=KEY3=VALUE3,KEY4=VALUE4

Sostituisci quanto segue:

• INSTANCE_GROUP_NAME: il nome del gruppo di istanze gestite.
• KEYS e VALUES: coppie chiave/valore per etichette o metadati. Se la chiave non esiste, il comando di aggiornamento la aggiunge. I valori delle chiavi esistenti vengono aggiornati.

Ricordati di applicare la configurazione aggiornata alle VM esistenti nel gruppo di istanze gestite.

REST

Aggiungi o aggiorna una configurazione per tutte le istanze inviando una richiesta PATCH su un gruppo di istanze gestite a livello di zona o regionale.

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

{
  "allInstancesConfig": {
    "properties": {
      "metadata": {
        "KEY1": "VALUE1",
        ...
      },
      "labels": {
        "KEY2": "VALUE2",
        ...
      },
    }
  }
}

Sostituisci quanto segue:

• PROJECT_ID: il progetto in cui esiste il gruppo di istanze gestite.
• REGION: la regione in cui si trova il gruppo di istanze gestite. Per un gruppo di istanze gestite a livello di zona, sostituisci regions/REGION con zones/ZONE.
• INSTANCE_GROUP_NAME: il nome del gruppo di istanze gestite.
• KEYS e VALUES: coppie chiave/valore per etichette o metadati. Se la chiave non esiste, la richiesta la aggiunge. Per le chiavi esistenti, il valore viene aggiornato.

Ricordati di applicare la configurazione aggiornata alle VM esistenti nel gruppo di istanze gestite.

gcloud

Puoi configurare gli aggiornamenti automatici (proattivi) utilizzando il comando update.

gcloud compute instance-groups managed update INSTANCE_GROUP_NAME \
    --update-policy-type=proactive \
    --update-policy-max-unavailable=MAX_UNAVAILABLE \
    --update-policy-max-surge=MAX_SURGE \
    --update-policy-min-ready=MIN_READY \
    --update-policy-minimal-action=MINIMAL_ACTION \
    --update-policy-replacement-method=REPLACEMENT_METHOD

Sostituisci quanto segue:

• INSTANCE_GROUP_NAME: il nome del gruppo di istanze gestite.
• MAX_UNAVAILABLE (facoltativo): il numero massimo di istanze che possono non essere disponibili durante l'aggiornamento. Ad esempio, se impostate il flag update-minimal-action su restart, questo limita il numero di VM riavviate contemporaneamente. Può essere un numero fisso (ad esempio 5) o una percentuale delle dimensioni del gruppo di istanze gestite (ad esempio 10%).
• MAX_SURGE (facoltativo): numero massimo di istanze aggiuntive che possono essere create durante l'aggiornamento. Può essere un numero fisso (ad esempio 5) o una percentuale delle dimensioni del gruppo di istanze gestite (ad esempio 10%).
• MIN_READY (facoltativo): il tempo minimo per cui una VM riavviata o sostituita deve essere pronta per essere considerata disponibile. Ad esempio 10s per 10 secondi. Consulta l'argomento gcloud datetimes per informazioni sui formati della durata.
• MINIMAL_ACTION (facoltativo): azione da eseguire su ogni istanza durante l'aggiornamento della configurazione:
  • refresh: applica la nuova configurazione alle istanze in esecuzione senza riavviarle.
  • restart: riavvia le VM durante l'aggiornamento, il che è utile se la tua app legge i metadati solo durante il riavvio.
  • replace: elimina le VM e creane di nuove a cui applicare la nuova configurazione.
• REPLACEMENT_METHOD (facoltativo): specifica l'azione utilizzata per sostituire un'istanza:
  • recreate: attende che l'istanza precedente venga eliminata e poi crea una nuova istanza con lo stesso nome dell'altra.
  • substitute: crea un'istanza con un nuovo nome ed elimina la precedente

REST

Puoi configurare gli aggiornamenti automatici (proattivi) inviando una richiesta PATCH su un MIG di zona o regionale.

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

{
  "updatePolicy": {
    "type": "PROACTIVE",
    "maxUnavailable": {
      "percent": MAX_UNAVAILABLE
    },
    "maxSurge": {
      "percent": MAX_SURGE
    },
    "minimalAction": MINIMAL_ACTION,
    "replacementMethod": REPLACEMENT_METHOD
  }
}

Sostituisci quanto segue:

• PROJECT_ID: il progetto in cui esiste il gruppo di istanze gestite.
• REGION: la regione in cui si trova il gruppo di istanze gestite. Per un gruppo di istanze gestite a livello di zona, sostituisci regions/REGION con zones/ZONE.
• INSTANCE_GROUP_NAME: il nome del gruppo di istanze gestite.
• MAX_UNAVAILABLE (facoltativo): il numero massimo di istanze che possono non essere disponibili durante l'aggiornamento. Ad esempio, se impostate il flag update-minimal-action su RESTART, questo limita il numero di VM riavviate contemporaneamente. Può essere una percentuale (ad esempio, specifica "percent": 80 per l'80%) o un numero fisso. Per specificare un numero fisso, sostituisci "percent": MAX_UNAVAILABLE con "fixed": MAX_UNAVAILABLE.
• MAX_SURGE (facoltativo): numero massimo di istanze aggiuntive che possono essere create durante l'aggiornamento. Può essere una percentuale o un numero fisso.
• MINIMAL_ACTION (facoltativo): azione da eseguire su ogni istanza durante l'aggiornamento della configurazione:
  • REFRESH: applica la nuova configurazione alle istanze in esecuzione senza riavviarle.
  • RESTART: riavvia le VM durante l'aggiornamento, il che è utile se la tua app legge i metadati solo durante il riavvio.
  • REPLACE: elimina le VM e creane di nuove a cui applicare la nuova configurazione.
• REPLACEMENT_METHOD (facoltativo): specifica l'azione utilizzata per sostituire un'istanza:
  • RECREATE: attende che l'istanza precedente venga eliminata, quindi crea una nuova istanza con lo stesso nome di quella precedente.
  • SUBSTITUTE: crea un'istanza con un nuovo nome ed elimina la precedente

gcloud

Puoi configurare gli aggiornamenti selettivi (opportunistici) utilizzando il comando update:

gcloud compute instance-groups managed update INSTANCE_GROUP_NAME \
    --update-policy-type=opportunistic

Quando imposti il tipo di aggiornamento del gruppo su opportunistic, devi avviare l'aggiornamento quando vuoi applicare la nuova configurazione alle VM esistenti.

Applicare la configurazione a VM specifiche

Per aggiornare le istanze selezionate, utilizza il seguente comando:

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

Applicare la configurazione a tutte le VM

Per aggiornare tutte le istanze esistenti, utilizza il seguente comando:

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

Sostituisci quanto segue:

• INSTANCE_GROUP_NAME: il nome del gruppo di istanze gestite.
• INSTANCE_NAMES: un elenco di istanze a cui applicare il modello.
• MINIMAL_ACTION (facoltativo): azione da eseguire su ogni istanza durante l'aggiornamento della configurazione:
  • refresh (valore predefinito): applica la nuova configurazione alle istanze in esecuzione senza riavviarle.
  • restart: riavvia le VM durante l'aggiornamento, il che è utile se la tua app legge i metadati solo durante il riavvio.
  • replace: elimina le VM e creane di nuove a cui applicare la nuova configurazione.
• MOST_DISRUPTIVE_ALLOWED_ACTION (facoltativo): esegui al massimo questa azione su ogni istanza. Se l'aggiornamento della configurazione richiede un'azione più invasiva di quella specificata qui, l'aggiornamento non va a buon fine e non vengono apportate modifiche.
  • none: nessuna azione
  • refresh: applica la nuova configurazione senza arrestare le istanze, se possibile. Ad esempio, utilizza refresh per applicare modifiche che influiscono solo su metadati o dischi aggiuntivi.
  • restart: applica la nuova configurazione senza sostituire le istanze, se possibile. Ad esempio, è sufficiente arrestare le istanze e riavviarle per applicare le modifiche al tipo di macchina.
  • replace: sostituisci le vecchie istanze in base al --replacement-method flag.

REST

Puoi configurare gli aggiornamenti selettivi (opportunistici) inviando una PATCH richiesta su un gruppo di istanze gestite o regionale.

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

{
  "updatePolicy": {
    "type": "OPPORTUNISTIC"
  }
}

Quando imposti il tipo di aggiornamento del gruppo su OPPORTUNISTIC, devi avviare l'aggiornamento quando vuoi applicare la nuova configurazione alle VM esistenti.

Applicare la configurazione a VM specifiche

Per aggiornare istanze specifiche, utilizza la seguente richiesta:

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": MINIMAL_ACTION,
  "mostDisruptiveAllowedAction": MOST_DISRUPTIVE_ALLOWED_ACTION
}

Applicare la configurazione a tutte le VM

Per aggiornare tutte le istanze esistenti, utilizza la seguente richiesta:

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

{
  "allInstances": true,
  "minimalAction": MINIMAL_ACTION,
  "mostDisruptiveAllowedAction": MOST_DISRUPTIVE_ALLOWED_ACTION
}

Sostituisci quanto segue:

• PROJECT_ID: il progetto in cui esiste il gruppo di istanze gestite.
• REGION: la regione in cui si trova il gruppo di istanze gestite. Per un gruppo di istanze gestite a livello di zona, sostituisci regions/REGION con zones/ZONE.
• INSTANCE_GROUP_NAME: il nome del gruppo di istanze gestite.
• MINIMAL_ACTION (facoltativo): azione da eseguire su ogni istanza durante l'aggiornamento della configurazione:
  • REFRESH: applica la nuova configurazione alle istanze in esecuzione senza riavviarle.
  • RESTART: riavvia le VM durante l'aggiornamento, il che è utile se la tua app legge i metadati solo durante il riavvio.
  • REPLACE: elimina le VM e creane di nuove a cui applicare la nuova configurazione.
• MOST_DISRUPTIVE_ALLOWED_ACTION (facoltativo): esegui al massimo questa azione su ogni istanza. Se l'aggiornamento della configurazione richiede un'azione più invasiva di quella specificata qui, l'aggiornamento non va a buon fine e non vengono apportate modifiche.
  • NONE: nessuna azione
  • REFRESH: applica la nuova configurazione senza arrestare le istanze, se possibile. Ad esempio, utilizza REFRESH per applicare modifiche che interessano solo i metadati o altri dischi.
  • RESTART: applica la nuova configurazione senza sostituire le istanze, se possibile. Ad esempio, è sufficiente arrestare le istanze e riavviarle per applicare le modifiche al tipo di macchina.
  • REPLACE: sostituisci le vecchie istanze in base al campo updatePolicy.replacementMethod del gruppo.

Console

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

   Vai a Gruppi di istanze

2. Seleziona il MIG di cui vuoi visualizzare la configurazione per tutte le istanze.

3. Vai alla scheda Dettagli.

4. Se la configurazione più recente per tutte le istanze viene applicata a tutte le VM, nella sezione Configurazione per tutte le istanze, il timestamp Ultima modifica e il campo Stato devono mostrare i valori come segue:

   • Ultima modifica: mostra l'ora in cui hai applicato la configurazione per tutte le istanze a tutte le VM.
   • Stato: viene visualizzato Applicato a tutte le VM. Se l'opzione tutte le istanze non viene applicata a tutte le VM, lo stato visualizzato è Aggiornamento VM in attesa.

gcloud

Utilizza il comando describe e includi il flag --format per cercare il valore status.allInstancesConfig.effective.

gcloud compute instance-groups managed describe INSTANCE_GROUP_NAME \
    --format="(status.allInstancesConfig)"

Esempio di output:

status:
  allInstancesConfig:
    currentRevision: 2022-12-02T10:30:15.012345Z
    effective: true

Se il valore effective è impostato su true, a tutte le VM viene applicata la configurazione più recente. Il valore currentRevision mostra il timestamp della ultima modifica alla configurazione di tutte le istanze del gruppo.

Se il valore effective è impostato su false, la configurazione più recente non è ancora applicata a tutte le VM.

Per controllare lo stato di ogni VM, puoi elencare tutte le VM del gruppo di istanze gestite o controllare ogni VM singolarmente con il comando describe-instance:

gcloud compute instance-groups managed describe-instance INSTANCE_GROUP_NAME \
    --instance INSTANCE_NAME

Esempio di output:

allInstancesConfig:
  revision: 2022-12-02T10:30:15.012345Z
currentAction: NONE
id: '8393021473297481188'
instance: .../projects/PROJECT/zones/ZONE/instances/INSTANCE_NAME
instanceStatus: RUNNING
name: INSTANCE_NAME
version:
  instanceTemplate: .../projects/PROJECT/global/instanceTemplates/INSTANCE_TEMPLATE

Per vedere a quali VM è stata applicata la configurazione più recente, confronta il timestamp revision su ogni VM con il timestamp currentRevision sul gruppo di istanze gestite.

REST

Invia una richiesta GET per il gruppo di istanze gestite a livello di zona o a livello di regione per verificare il valore del flag status.allInstancesConfig.effective.

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

Risposta di esempio:

{
  ...
  "status": {
    "isStable": "true",
    "versionTarget": {
      "isReached": "true"
    },
    "allInstancesConfig": {
      "currentRevision": "2022-12-02T10:30:15.012345Z",
      "effective": "true"
    },
  ...
  },
  ...
}

Se il campo effective è impostato su true, a tutte le VM viene applicata la configurazione più recente. Il campo currentRevision mostra il timestamp della modifica più recente alla configurazione di tutte le istanze del gruppo.

Se il campo effective è impostato su false, la configurazione più recente non è ancora applicata a tutte le VM.

Per controllare lo stato di ogni istanza, elenca le istanze gestite per il gruppo di istanze gestite a livello di zona o a livello di regione:

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

Esempio di output:

{
  "managedInstances": [
    ...
    {
      "instance": ".../zones/ZONE/instances/INSTANCE_NAME",
      "instanceStatus": "RUNNING",
      "currentAction": "NONE",
      "allInstancesConfig": {
        "revision": "2022-12-02T10:30:15.012345Z"
      },
      "version": {
        "name": "V1",
        "instanceTemplate": ".../projects/.../instanceTemplates/INSTANCE_TEMPLATE"
      }
    },
    {
      ...
    }
  ]
}

Per vedere a quali VM è stata applicata la configurazione più recente, confronta il timestamp revision su ogni VM con il timestamp currentRevision sul gruppo di istanze gestite.

Console

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

   Vai a Gruppi di istanze

2. Seleziona il MIG di cui vuoi visualizzare la configurazione per tutte le istanze.

3. Vai alla scheda Dettagli.

4. Consulta la sezione Configurazione di tutte le istanze.

gcloud

Utilizza il comando describe e includi il flag --format per mostrare il valore di configurazione per tutte le istanze del gruppo.

gcloud compute instance-groups managed describe INSTANCE_GROUP_NAME \
    --format="(allInstancesConfig)"

Il comando restituisce la configurazione di tutte le istanze del gruppo, se esistente.

REST

Invia una richiesta GET a un gruppo di istanze gestite a livello di zona o regionale e cerca il campo allInstancesConfig.

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

Se il campo allInstancesConfig non è impostato, il gruppo non ha configurazione per tutte le istanze.

Console

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

   Vai a Gruppi di istanze

2. Seleziona il gruppo di istanze gestite da cui vuoi eliminare la configurazione per tutte le istanze.

3. Fai clic su Aggiorna VM.

4. Nella sezione Configurazione di tutte le istanze:

   • Per eliminare i metadati, fai clic su Gestisci metadati.
   • Per eliminare le etichette, fai clic su Gestisci etichette.

5. Nel riquadro Gestisci metadati o Gestisci etichette, segui questi passaggi:

   1. Tieni premuto il cursore su un'impostazione per attivare l'opzione di eliminazione, quindi fai clic su delete Elimina elemento.
   2. Fai clic su Salva.

6. Al termine dell'eliminazione, fai clic su Aggiorna VM.

   Se il tipo di aggiornamento del gruppo di istanze gestite è impostato su Automatico, le modifiche alla configurazione di tutte le istanze vengono applicate immediatamente a tutte le VM esistenti. Se il tipo di aggiornamento è Selettivo, devi applicare la configurazione in modo selettivo alle VM esistenti. Per ulteriori informazioni, consulta Applicare una configurazione per tutte le istanze alle VM esistenti.

gcloud

Per eliminare le proprietà, utilizza il comando all-instances-configuration delete e specifica una o più chiavi per le proprietà da eliminare.

gcloud compute instance-groups managed all-instances-config delete INSTANCE_GROUP_NAME \
    --metadata=KEY1[, KEY1]\
    --labels=KEY1[, KEY1]

Ricordati di applicare la configurazione aggiornata alle VM esistenti nel gruppo di istanze gestite.

REST

Per eliminare le proprietà, invia una richiesta PATCH a un MIG di zona o regionale e specifica un valore null come chiave per ogni proprietà che vuoi rimuovere.

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME
{
  "allInstancesConfig": {
    "properties": {
      "metadata": {
        "KEY1": null,
        ...
      },
      "labels": {
        "KEY2": null,
        ...
      }
    }
  }
}

Ricordati di applicare la configurazione aggiornata alle VM esistenti nel gruppo di istanze gestite.