Esegui l'override delle proprietà del modello di istanza con una configurazione di tutte le istanze

---

Anteprima

Questo prodotto o funzionalità è soggetto ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici del servizio. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Questa pagina spiega come utilizzare una configurazione di tutte le istanze per impostare le proprietà di etichette e metadati per tutte le istanze di macchine virtuali (VM) in un gruppo di istanze gestite senza dover creare un nuovo modello di istanza.

Puoi continuare a utilizzare i modelli di istanza per impostare le proprietà delle istanze nel gruppo di istanze gestite. Tuttavia, l'utilizzo di una configurazione di tutte le istanze di un gruppo di istanze gestite è più semplice in alcuni scenari, ad esempio nei seguenti:

• Devi aggiornare i metadati o le etichette dell'istanza di frequente e senza l'overhead associato alla creazione di nuovi modelli ogni volta. Ricorda che i modelli di istanza sono immutabili, il che significa che non possono essere modificati dopo la creazione.

• Vuoi avere più gruppi di istanze gestite basati su un modello di istanza, ma devi configurare le etichette o i metadati per ogni gruppo di istanze gestite in modo diverso. Ad esempio, se hai un'app ma vuoi supportare ambienti diversi per sviluppo, test e produzione. Puoi creare un singolo modello di istanza e riutilizzarlo per tutti gli ambienti impostando metadati diversi con una configurazione di tutte le istanze diversa per ogni ambiente.

• Un team è proprietario dell'infrastruttura e delle immagini, mentre un altro esegue le app che richiedono la configurazione. Puoi avere un'infrastruttura di provisioning del team con un modello di istanza, mentre il team dedicato alle app può gestire le configurazioni delle app con le configurazioni di tutte le istanze.

• Hai un agente in esecuzione sulle tue VM e vuoi configurarlo utilizzando i metadati. Vuoi assicurarti che la configurazione dell'agente VM venga mantenuta anche dopo le modifiche al modello di istanza del gruppo. Utilizza il modello di istanza per controllare la versione dell'app e configurare l'agente VM tramite una configurazione di tutte le istanze.

Se imposti la stessa proprietà utilizzando sia il modello di istanza del gruppo di istanze gestite e la relativa configurazione di tutte le istanze, il gruppo di istanze gestite assegna la priorità al valore della configurazione di tutte le istanze. Ad esempio, se i metadati per enable-guest-attributes sono impostati su FALSE nel modello di istanza del gruppo di istanze gestite e TRUE nella configurazione di tutte le istanze del gruppo di istanze gestite, Compute Engine applica TRUE su tutte le istanze del gruppo. Ciò ti consente di utilizzare una configurazione di tutte le istanze per sostituire le proprietà definite nel modello di istanza.

Prima di iniziare

• Crea un gruppo di istanze gestite.
• Configurare l'autenticazione.
  

  Seleziona la scheda relativa a come intendi utilizzare gli esempi di questa pagina:

  gcloud

  1. Installa Google Cloud CLI, quindi inizializzalo eseguendo il comando seguente:

     gcloud init

     Nota: se hai installato lgcloud CLI in precedenza, assicurati di avere la versione più recente eseguendo gcloud components update.
  2. Imposta una regione e una zona predefinite.

  REST

  Per utilizzare gli esempi di API REST su questa pagina in un ambiente di sviluppo locale, devi utilizzare le credenziali che fornisci allgcloud CLI.

  Installa Google Cloud CLI, quindi inizializzalo eseguendo il comando seguente:

  gcloud init

Limitazioni

• Puoi eseguire l'override delle seguenti proprietà del modello di istanza solo con una configurazione di tutte le istanze:

  • Metadati
  • Etichette

• Non puoi eseguire il canary per aggiornare una configurazione di tutte le istanze. Quando applichi la configurazione al gruppo, Compute Engine applica le proprietà a tutte le nuove istanze e alle istanze esistenti in base al tuo criterio di aggiornamento. Se vuoi controllare quali istanze esistenti vengono aggiornate e quando, puoi utilizzare gli aggiornamenti selettivi.

• Se utilizzi la configurazione stateful nel gruppo di istanze gestite, non puoi impostare la stessa proprietà in nessuna configurazione per istanza e contemporaneamente nella configurazione di tutte le istanze del gruppo.

Impostare le proprietà in una configurazione di tutte le istanze

Crea e aggiorna la configurazione di tutte le istanze di un gruppo di istanze gestite utilizzando l'interfaccia alla gcloud CLI o REST.

Nota: la configurazione specificata per le VM in un gruppo di istanze gestite viene applicata automaticamente alle nuove VM aggiunte al gruppo. Per applicare la configurazione più recente alle VM esistenti, consulta Applicare una configurazione di tutte le istanze alle VM esistenti.

gcloud

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

gcloud beta 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: nome del gruppo di istanze gestite.
• KEYS e VALUES: coppie chiave-valore per etichette o metadati. Se la chiave non esiste, viene aggiunta dal comando di aggiornamento. Per le chiavi esistenti, i relativi valori vengono aggiornati.

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

REST

Aggiungi o aggiorna una configurazione di tutte le istanze effettuando una richiesta PATCH su un MIG a livello di zona o regionale.

PATCH https://compute.googleapis.com/compute/beta/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: 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 relativo valore viene aggiornato.

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

Applica una configurazione di tutte le istanze alle VM esistenti

La configurazione VM specificata per le VM in un gruppo di istanze gestite viene applicata automaticamente alle nuove VM aggiunte al gruppo.

Per applicare una configurazione VM aggiornata, inclusa una configurazione di tutte le istanze aggiornata, alle VM esistenti nel gruppo, utilizza uno dei seguenti metodi:

• Automatico (proattivo): utilizza questo metodo se vuoi che il gruppo di istanze gestite applichi automaticamente le nuove configurazioni a tutte o a un sottoinsieme di VM esistenti nel gruppo. Il livello di interruzione dell'esecuzione delle VM dipende dal criterio di aggiornamento configurato. Puoi utilizzare questo metodo per aggiornare canary per i nuovi modelli di istanza. Per utilizzare questo metodo, imposta il tipo di aggiornamento del gruppo di istanze gestite su "proattivo".
• Selettivo (opportunistico): utilizza questo metodo se vuoi applicare l'aggiornamento manualmente o se vuoi aggiornare contemporaneamente tutte le VM esistenti nel gruppo. Puoi scegliere come target una o tutte le VM da aggiornare all'ultima configurazione. Per utilizzare questo metodo, imposta il tipo di aggiornamento del gruppo di istanze gestite su "opportunistico".
• Ricreazione di VM: quando ricrei una VM in un gruppo di istanze gestite, quest'ultimo applica qualsiasi configurazione aggiornata non ancora applicata alla VM. Per ulteriori informazioni, consulta Ricreare le VM in un gruppo di istanze gestite.

Automatico (proattivo)

Se vuoi applicare automaticamente una configurazione di tutte le istanze aggiornata a tutte le VM esistenti ogni volta che la modifichi, imposta il tipo di criterio di aggiornamento del gruppo su "proattivo". Per ulteriori informazioni, consulta la sezione Tipo di aggiornamento automatico (proattivo).

Puoi controllare la velocità dell'implementazione proattiva della configurazione utilizzando le impostazioni facoltative maxUnavailable, maxSurge e minReadySec.

Per utilizzare gli aggiornamenti proattivi, devi configurarli una sola volta. Successivamente, il gruppo di istanze gestite applica automaticamente tutte le modifiche future alla configurazione delle VM (ovvero le modifiche alla configurazione di tutte le istanze del gruppo, al modello di istanza e alle configurazioni per istanza) a tutte le VM nel gruppo in base alle impostazioni del criterio di aggiornamento del gruppo.

Per applicare automaticamente gli aggiornamenti della configurazione, utilizza gcloud CLI o REST.

gcloud

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

gcloud beta 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.
• (Facoltativo) MAX_UNAVAILABLE: numero massimo di istanze che possono non essere disponibili durante l'aggiornamento. Ad esempio, se imposti il flag update-minimal-action su restart, questo flag limita il numero di VM riavviate alla volta. Può essere un numero fisso (ad esempio 5) o una percentuale delle dimensioni per il gruppo di istanze gestite (ad esempio 10%).
• (Facoltativo) MAX_SURGE: numero massimo di istanze che è possibile creare durante l'aggiornamento. Può essere un numero fisso (ad esempio 5) o una percentuale delle dimensioni per il gruppo di istanze gestite (ad esempio 10%).
• MIN_READY (facoltativo): tempo minimo per il quale una VM riavviata o sostituita deve essere pronta per essere considerata disponibile. Ad esempio 10s per 10 secondi. Consulta gcloud topic datetimes per informazioni sui formati di durata.
• (Facoltativo) MINIMAL_ACTION: 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. Questa operazione è utile se l'app legge i metadati solo durante il riavvio.
  • replace: elimina le VM e creane di nuove a cui applicare la nuova configurazione.
• (Facoltativo) REPLACEMENT_METHOD: specifica l'azione utilizzata per sostituire un'istanza:
  • recreate: attende l'eliminazione della vecchia istanza, quindi crea una nuova istanza con lo stesso nome di quella precedente.
  • substitute: crea un'istanza con un nuovo nome mentre elimina l'istanza precedente

REST

Puoi configurare gli aggiornamenti automatici (proattivi) effettuando una richiesta PATCH su una zona o un MIG a livello di regione.

PATCH https://compute.googleapis.com/compute/beta/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: nome del gruppo di istanze gestite.
• (Facoltativo) MAX_UNAVAILABLE: numero massimo di istanze che possono non essere disponibili durante l'aggiornamento. Ad esempio, se imposti il flag update-minimal-action su RESTART, questo flag limita il numero di VM riavviate alla volta. Il valore può essere una percentuale (ad esempio, specifica "percent": 80 per 80%) o un numero fisso. Per specificare un numero fisso, sostituisci "percent": MAX_UNAVAILABLE con "fixed": MAX_UNAVAILABLE.
• (Facoltativo) MAX_SURGE: numero massimo di istanze che è possibile creare durante l'aggiornamento. Può essere una percentuale o un numero fisso.
• (Facoltativo) MINIMAL_ACTION: 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. Questa operazione è utile se l'app legge i metadati solo durante il riavvio.
  • REPLACE: elimina le VM e creane di nuove a cui applicare la nuova configurazione.
• (Facoltativo) REPLACEMENT_METHOD: specifica l'azione utilizzata per sostituire un'istanza:
  • RECREATE: attende l'eliminazione della vecchia istanza, quindi crea una nuova istanza con lo stesso nome di quella precedente.
  • SUBSTITUTE: crea un'istanza con un nuovo nome mentre elimina l'istanza precedente

Se i flag facoltativi vengono omessi, il gruppo utilizza i valori contenuti nel criterio di aggiornamento del gruppo. Puoi controllare il criterio di aggiornamento utilizzando gcloud CLI o REST.

Selettivo (opportunistico)

Se vuoi controllare quando e a quali VM applicare una nuova configurazione, imposta il tipo di criterio di aggiornamento del gruppo su "opportunistico". Per ulteriori informazioni, consulta la sezione Tipo di aggiornamento selettivo (opportunistico).

Quando scegli di applicare selettivamente gli aggiornamenti della configurazione, eventuali modifiche alla configurazione di tutte le istanze del gruppo, al modello di istanza o alle configurazioni per istanza non vengono applicate automaticamente alle VM esistenti. Devi applicare esplicitamente una configurazione aggiornata alle VM esistenti per aggiornarle.

Nota: quando abiliti gli aggiornamenti selettivi impostando il tipo di criterio di aggiornamento del gruppo su "opportunistico", devi avviare manualmente l'aggiornamento sulle VM esistenti ogni volta che apporti modifiche alla configurazione del gruppo.

Per applicare selettivamente gli aggiornamenti della configurazione delle VM alle VM in un gruppo di istanze gestite, utilizza gcloud CLI o REST.

gcloud

Puoi configurare aggiornamenti selettivi (opportunisti) utilizzando il comando update beta:

gcloud beta 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 comando seguente:

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

Applica la configurazione a tutte le VM

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

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: nome del gruppo di istanze gestite.
• INSTANCE_NAMES: un elenco di istanze a cui applicare il modello.
• (Facoltativo) MINIMAL_ACTION: azione da eseguire su ogni istanza durante l'aggiornamento della configurazione:
  • refresh (impostazione predefinita): applica la nuova configurazione alle istanze in esecuzione senza riavviarle.
  • restart: riavvia le VM durante l'aggiornamento. Questa operazione è utile se l'app legge i metadati solo durante il riavvio.
  • replace: elimina le VM e creane di nuove a cui applicare la nuova configurazione.
• (Facoltativo) MOST_DISRUPTIVE_ALLOWED_ACTION: 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 i dischi aggiuntivi.
  • restart: applica la nuova configurazione senza sostituire le istanze, se possibile. Ad esempio, arrestare le istanze e avviarle di nuovo è sufficiente per applicare modifiche al tipo di macchina.
  • replace: sostituisci le vecchie istanze in base al flag --replacement-method.

REST

Puoi configurare aggiornamenti selettivi (opportunistici) effettuando una richiesta PATCH su un MIG di zona o a livello di regione.

PATCH https://compute.googleapis.com/compute/beta/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 richiesta seguente:

POST https://compute.googleapis.com/compute/beta/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
}

Applica la configurazione a tutte le VM

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

POST https://compute.googleapis.com/compute/beta/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: nome del gruppo di istanze gestite.
• (Facoltativo) MINIMAL_ACTION: 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. Questa operazione è utile se l'app legge i metadati solo durante il riavvio.
  • REPLACE: elimina le VM e creane di nuove a cui applicare la nuova configurazione.
• (Facoltativo) MOST_DISRUPTIVE_ALLOWED_ACTION: 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 i dischi aggiuntivi.
  • RESTART: applica la nuova configurazione senza sostituire le istanze, se possibile. Ad esempio, arrestare le istanze e avviarle di nuovo è sufficiente per applicare modifiche al tipo di macchina.
  • REPLACE: sostituisci le vecchie istanze in base al campo updatePolicy.replacementMethod del gruppo.

Verifica se è stata applicata una configurazione di tutte le istanze aggiornata

Puoi verificare se la configurazione di tutte le istanze è stata applicata a tutte le VM nel gruppo utilizzando l'interfaccia alla gcloud CLI o REST.

gcloud

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

gcloud beta 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 è applicata la configurazione più recente. Il valore currentRevision mostra il timestamp dell'ultima modifica alla configurazione di tutte le istanze del gruppo.

Se il valore effective è impostato su false, la configurazione più recente non è ancora stata 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 beta:

gcloud beta 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 è applicata la configurazione più recente, confronta il timestamp revision su ogni VM con il timestamp currentRevision nel gruppo di istanze gestite.

REST

Effettua una richiesta GET su un MIG a livello di zona o regionale per verificare il valore del flag status.allInstancesConfig.effective.

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

Esempio di risposta:

{
  ...
  "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 dell'ultima modifica alla configurazione di tutte le istanze del gruppo.

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

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

GET https://compute.googleapis.com/compute/beta/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 è applicata la configurazione più recente, confronta il timestamp revision su ogni VM con il timestamp currentRevision nel gruppo di istanze gestite.

Elenca le proprietà in una configurazione di tutte le istanze

Una configurazione di tutte le istanze fa parte della configurazione del gruppo di istanze gestite. Per rivedere la configurazione di tutte le istanze, utilizza gcloud CLI o REST.

Nota: quando rivedi la configurazione di tutte le istanze del gruppo, assicurati di aver applicato la configurazione anche alle VM esistenti.

gcloud

Utilizza il comando describe e includi il flag --format per mostrare il valore di configurazione all-instances del gruppo.

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

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

REST

Effettua una richiesta GET su un MIG a livello di zona o regionale e cerca il campo allInstancesConfig.

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

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

Elimina proprietà dalla configurazione di tutte le istanze

Se elimini una proprietà dalla configurazione di tutte le istanze del gruppo di istanze gestite e la stessa proprietà esiste nel modello di istanza del gruppo di istanze gestite, le VM nel gruppo di istanze gestite erediteranno nuovamente la proprietà dal modello di istanza una volta applicata la configurazione più recente alle VM nel gruppo di istanze gestite. Per ulteriori informazioni sull'applicazione della configurazione più recente alle VM esistenti, consulta Applicare una configurazione di tutte le istanze alle VM esistenti.

Per eliminare le proprietà da una configurazione di tutte le istanze, utilizza gcloud CLI o REST.

gcloud

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

gcloud beta 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à, effettua una richiesta PATCH su un MIG di zona o a livello di regione e specifica un valore null come chiave per ogni proprietà da rimuovere.

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

Suggerimento avanzato: puoi creare, aggiornare ed eliminare più proprietà allInstancesConfig in una singola richiesta API.

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

Passaggi successivi

• Scopri di più sull'applicazione automatica di una configurazione aggiornata alle VM esistenti in un gruppo di istanze gestite.
• Scopri di più sull'applicazione selettiva degli aggiornamenti della configurazione alle VM esistenti in un gruppo di istanze gestite.
• Visualizza le informazioni sul gruppo di istanze gestite e sulle relative VM.