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

Questa pagina spiega come utilizzare una configurazione di tutte le istanze per impostare etichette e metadata per tutte le proprietà 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 della configurazione di tutte le istanze di un gruppo di istanze gestite è più semplice in alcuni scenari, ad esempio i 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 istanze sono immutabili, il che significa che non possono essere modificati dopo la loro 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 in modo diverso. Ad esempio, se un'unica app, ma vuoi supportare diversi ambienti per lo sviluppo, test e produzione. Puoi creare un singolo modello di istanza e riutilizzarlo per tutti gli ambienti impostando metadati diversi con configurazione di tutte le istanze per ogni ambiente.

  • Un team è proprietario dell'infrastruttura e delle immagini, mentre un altro team esegue le app che richiedono la configurazione. Un team può eseguire il provisioning dell'infrastruttura con un modello di istanze, mentre il team delle app può gestire le configurazioni delle app con configurazioni per 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 persista anche dopo la modifica del modello di istanza del gruppo. Utilizza il modello di istanza per controllare la versione dell'app e configurare l'agente VM utilizzando una configurazione per tutte le istanze.

Se imposti la stessa proprietà utilizzando sia il modello di istanza del gruppo di istanze gestite sia la configurazione per tutte le istanze, il gruppo di istanze gestite dà la priorità al valore della configurazione per 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 su TRUE nella configurazione per tutte le istanze del gruppo di istanze gestite, Compute Engine applica TRUE a tutte le istanze del gruppo. In questo modo, puoi utilizzare una configurazione per tutte le istanze per sostituire le proprietà definite nel modello di istanza.

Prima di iniziare

  • Crea un gruppo di istanze gestite.
  • Se non l'hai ancora fatto, configura l'autenticazione. Autenticazione è Il processo di verifica dell'identità per l'accesso ai servizi e alle API di Google Cloud. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti su Compute Engine come segue.

    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. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

      3. REST

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

        Install the Google Cloud CLI, then initialize it by running the following command: 

        gcloud init

      Per ulteriori informazioni, vedi Esegui l'autenticazione per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud.

Limitazioni

  • Puoi sostituire le seguenti proprietà del modello di istanza solo con una configurazione per tutte le istanze:

    • Metadati
    • Etichette

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

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

Imposta 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 il con gcloud CLI o REST.

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. Completata Configurazione e fai clic su Salva.
    • Per aggiungere o aggiornare le etichette, fai clic su Gestisci etichette. Completata Configurazione e fai clic su Salva.

  5. Dopo aver configurato le proprietà in tutte le istanze configurazione, 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, vedi Applica una configurazione di tutte le istanze alle VM esistenti.

gcloud

Aggiungi o aggiorna una configurazione di tutte le istanze utilizzando il metodo 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. Per le chiavi esistenti, i relativi valori vengono aggiornati.

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

REST

Aggiungi o aggiorna una configurazione di tutte le istanze effettuando una richiesta PATCH in una zona o regionale gruppo di istanze gestite

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: 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 in il gruppo di istanze gestite.

Applica una configurazione di tutte le istanze alle VM esistenti

La Configurazione VM che specifichi per le VM in un gruppo di istanze gestite, viene applicata automaticamente alle nuove VM aggiunto al gruppo.

Per applicare una configurazione VM aggiornata, inclusa una configurazione aggiornata per tutte le istanze, 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 nuove configurazioni a tutte o a un sottoinsieme di VM esistenti nel gruppo. Il livello di interruzione delle VM in esecuzione dipende il criterio di aggiornamento che hai configurato. Puoi utilizzare questo metodo per eseguire l'aggiornamento canary di nuovi modelli di istanze. Per utilizzare questo metodo, imposta il tipo di aggiornamento del gruppo di istanze gestite su "proattiva".
  • Selettivo (opportunistico): utilizza questo metodo se vuoi applicare la aggiornare manualmente o se vuoi aggiornare tutte le VM esistenti nel gruppo una volta sola. Scegli 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 delle VM: quando ricrei una VM in un gruppo di istanze gestite, il gruppo di istanze gestite applica qualsiasi configurazione aggiornata che non è ancora stata applicata alla VM. Per ulteriori informazioni, consulta la pagina Ri creare le VM in un gruppo di istanze gestite.

Automatica (proattiva)

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

Puoi controllare la velocità di un'implementazione proattiva della configurazione utilizzando il facoltativo maxUnavailable, maxSurge, e minReadySec impostazioni.

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

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

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 Imposta il flag update-minimal-action su restart, quindi questo flag limita e il numero di VM riavviate contemporaneamente. Può essere un numero fisso (ad esempio 5) o una percentuale della dimensione del gruppo di istanze gestite (ad esempio 10%).
  • MAX_SURGE (facoltativo): numero massimo di istanze aggiuntive che possono essere create durante l'aggiornamento. Può trattarsi di una correzione numero (ad esempio, 5) o una percentuale delle dimensioni per l'istanza gestita (ad es. 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: gcloud topic datetimes per informazioni sui formati di 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 riavviandoli.
    • 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 per 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 durante l'eliminazione vecchia istanza

REST

Puoi configurare gli aggiornamenti automatici (proattivi) effettuando una richiesta PATCH su un a livello di zona o regionale gruppo di istanze gestite

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: nome del gruppo di istanze gestite.
  • (Facoltativo) MAX_UNAVAILABLE: numero massimo di che potrebbero non essere disponibili durante l'aggiornamento. Ad esempio, se Imposta il flag update-minimal-action su RESTART, quindi questo flag limita e 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 un 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. 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.
  • REPLACEMENT_METHOD (facoltativo): 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 durante l'eliminazione vecchia istanza

Quando i flag facoltativi vengono omessi, il gruppo utilizza i valori del criterio di aggiornamento del gruppo. Puoi consulta le norme di aggiornamento utilizzando gcloud CLI o REST.

Selettivo (opportunistico)

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

Se scegli di applicare selettivamente gli aggiornamenti di configurazione, eventuali modifiche la configurazione di tutte le istanze, il modello di istanza o la configurazione per istanza del gruppo non vengono applicate automaticamente alle VM esistenti. Devi applicare esplicitamente una configurazione aggiornata alle VM esistenti per aggiornare che li rappresentano.

Per applicare in modo selettivo gli aggiornamenti della configurazione delle VM alle VM in un gruppo di istanze gestite, utilizza l'interfaccia a riga di comando gcloud o REST.

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 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 modello.
  • (Facoltativo) MINIMAL_ACTION: azione su cui eseguire l'operazione 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 per 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 sui metadati o sui dischi aggiuntivi.
    • restart: applica la nuova configurazione senza sostituire le istanze, se possibile. Ad esempio, arrestando e riavviando le istanze per applicare modifiche al tipo di macchina.
    • replace: sostituisci le istanze precedenti in base alla Flag --replacement-method.

REST

Puoi configurare gli aggiornamenti selettivi (opportunistici) inviando una PATCH richiesta su un gruppo di istanze gestite di zona 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.

Applica 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 richiesta seguente:

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. 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.
  • MOST_DISRUPTIVE_ALLOWED_ACTION (facoltativo): eseguire 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 sui metadati o sui 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 campo updatePolicy.replacementMethod del gruppo.

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

Puoi verificare se l'ultima configurazione per tutte le istanze è stata applicata a tutte le VM del gruppo utilizzando uno dei seguenti metodi.

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 di effective è impostato su false, l'ultima configurazione sarà non ancora applicato a tutte le VM.

Per controllare lo stato di ogni VM, puoi elencare tutte le VM del gruppo di istanze gestite o controlla ogni VM singolarmente 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 sapere 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

Effettua una richiesta GET su a livello di zona o regionale Gruppo di istanze gestite 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

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 l'ultima modifica 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 è applicata la configurazione più recente, confronta Timestamp revision su ogni VM con il timestamp currentRevision nella gruppo di istanze gestite

Elenca le proprietà in una configurazione di tutte le istanze

Una configurazione per tutte le istanze fa parte della configurazione del gruppo di istanze gestite. Per rivedere la configurazione di tutte le istanze, utilizza uno dei seguenti modi.

Console

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

    Vai a Gruppi di istanze

  2. Seleziona il gruppo di istanze gestite di cui vuoi visualizzare tutte le istanze configurazione.

  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 di tutte le istanze.

Eliminare le proprietà dalla configurazione di tutte le istanze

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

Per eliminare le proprietà da una configurazione di tutte le istanze, utilizza una delle in molti modi diversi.

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, segui questi passaggi:

    • 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 puntatore su un'impostazione per attivare l'opzione di eliminazione e quindi fai clic su 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 viene applicata immediatamente a tutte le VM esistenti. Se il tipo di aggiornamento è Selettivo, devi applicare selettivamente la configurazione alle VM esistenti. Per ulteriori informazioni, consulta Applicare una configurazione per tutte le istanze alle VM esistenti.

gcloud

Per eliminare le proprietà, utilizza Comando all-instances-configuration delete e specificare 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 in il gruppo di istanze gestite.

REST

Per eliminare le proprietà, effettua una richiesta PATCH su un a livello di zona o regionale gruppo di istanze gestite e specifica un valore null come chiave per ogni proprietà a cui vuoi applicare 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.

Passaggi successivi