Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

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

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

Puoi continuare a utilizzare i template di istanza per impostare le proprietà delle istanze nel MIG. Tuttavia, l'utilizzo della configurazione di tutte le istanze di un MIG è più semplice in alcuni scenari, ad esempio:

Devi aggiornare i metadati o le etichette delle istanze di frequente e senza l'overhead della creazione di nuovi template ogni volta. Ricorda che i template di istanza sono immutabili, il che significa che non possono essere modificati dopo la creazione.
Vuoi avere più MIG basati su un template di istanza, ma devi configurare etichette o metadati in modo diverso per ogni MIG. Ad esempio, se hai un'app, ma vuoi supportare ambienti diversi per lo sviluppo, i test e la produzione. Puoi creare un singolo template di istanza e riutilizzarlo per tutti gli ambienti impostando metadati diversi con una configurazione all-instances diversa per ogni ambiente.
Un team è responsabile dell'infrastruttura e delle immagini, mentre un altro team esegue le app che richiedono la configurazione. Puoi fare in modo che un team esegua il provisioning dell'infrastruttura con un template di istanza, mentre il team dell'app può gestire le configurazioni dell'app con le 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 template di istanza del gruppo. Utilizza il template 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 template di istanza del MIG sia la relativa configurazione di tutte le istanze, il MIG dà la priorità al valore della configurazione di tutte le istanze. Ad esempio, se i metadati per enable-guest-attributes sono impostati su FALSE nel template di istanza del MIG e su TRUE nella configurazione di tutte le istanze del MIG, Compute Engine applica TRUE a tutte le istanze del gruppo. In questo modo, puoi utilizzare una configurazione di tutte le istanze per eseguire l'override delle proprietà definite nel template di istanza.

Prima di iniziare

Crea un gruppo di istanze gestite.
Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione verifica la tua identità per l'accesso ad API e servizi Google Cloud . Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti su Compute Engine selezionando una delle seguenti opzioni:
Seleziona la scheda relativa al modo in cui prevedi di utilizzare gli esempi in questa pagina:
Console

Quando utilizzi la console Google Cloud per accedere ai servizi e alle API Google Cloud , non devi configurare l'autenticazione.
gcloud
1. Installa Google Cloud CLI, quindi accedi a gcloud CLI con la tua identità federata. Dopo aver eseguito l'accesso, inizializza Google Cloud CLI eseguendo il comando seguente:
  gcloud init
  Nota: se hai installato gcloud CLI in precedenza, assicurati di avere l'ultima versione eseguendo gcloud components update.
Imposta una regione e una zona predefinite.

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.

Installa Google Cloud CLI, quindi accedi a gcloud CLI con la tua identità federata.

Per saperne di più, consulta Autenticati per usare REST nella documentazione sull'autenticazione di Google Cloud .

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per impostare e applicare una configurazione di tutte le istanze, chiedi all'amministratore di concederti il ruolo IAM Compute Instance Admin (v1) (roles/compute.instanceAdmin.v1) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene le autorizzazioni necessarie per impostare e applicare una configurazione per tutte le istanze. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per impostare e applicare una configurazione per tutte le istanze sono necessarie le seguenti autorizzazioni:

Per ottenere il MIG: compute.instanceGroupManagers.get sul progetto
Per aggiornare la configurazione di tutte le istanze del MIG: compute.instanceGroupManagers.update sul progetto
Per utilizzare un template di istanza durante l'aggiornamento del MIG: compute.instanceTemplates.get sul progetto
Per creare istanze con le proprietà specificate: compute.instances.create sul progetto
Per applicare i metadati alle VM esistenti: compute.instances.setMetadata sul progetto
Per applicare etichette alle VM esistenti: compute.instances.setLabels sul progetto

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Limitazioni

Puoi eseguire l'override solo delle seguenti proprietà del template di istanza con una configurazione per tutte le istanze:
- Metadati
- Etichette
Non puoi eseguire l'aggiornamento canary di una configurazione per 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 alla tua policy di aggiornamento. Se vuoi controllare quali istanze esistenti vengono aggiornate e quando, puoi utilizzare gli aggiornamenti selettivi.
Se utilizzi la configurazione stateful nel MIG, non puoi impostare la stessa proprietà in una configurazione per istanza e contemporaneamente nella configurazione di tutte le istanze del gruppo.

Imposta le proprietà in una configurazione per tutte le istanze

Crea e aggiorna la configurazione di tutte le istanze di un MIG utilizzando gcloud CLI o REST.

Console

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

Vai a Gruppi di istanze
Seleziona il MIG per cui vuoi impostare la configurazione di tutte le istanze.
Fai clic su Modifica.
Fai clic su Template di istanza e override per espandere la sezione.
Nella sezione Configurazione di tutte le istanze, segui questi passaggi:
- 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.
Al termine della configurazione delle proprietà nella configurazione di tutte le istanze, fai clic su Salva.

Se il tipo di aggiornamento del MIG è impostato su Automatico, la configurazione di tutte le istanze impostata viene applicata immediatamente a tutte le VM esistenti. Se il tipo di aggiornamento è Selettivo, devi applicare la configurazione alle VM esistenti in modo selettivo. Per saperne di più, consulta Applica 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 MIG.
KEYS e VALUES: coppie chiave-valore per etichette o metadati. Se la chiave non esiste, il comando update la aggiunge. Per le chiavi esistenti, i valori vengono aggiornati.

Ricorda di applicare la configurazione aggiornata alle VM esistenti nel MIG.

REST

Aggiungi o aggiorna una configurazione di tutte le istanze inviando una richiesta PATCH a un MIG a livello di zona o di regione.

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 MIG.
REGION: la regione in cui si trova il MIG. Per un MIG a livello di zona, sostituisci regions/REGION con zones/ZONE.
INSTANCE_GROUP_NAME: il nome del MIG.
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.

Ricorda di applicare la configurazione aggiornata alle VM esistenti nel MIG.

Applica una configurazione per tutte le istanze alle VM esistenti

La configurazione delle VM che specifichi per le VM in un MIG viene applicata automaticamente alle nuove VM aggiunte al gruppo.

Per applicare una configurazione delle 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 MIG applichi automaticamente nuove configurazioni a tutte o a un sottoinsieme di VM esistenti nel gruppo. Il livello di interruzione delle VM in esecuzione dipende dalla policy di aggiornamento configurata. Puoi utilizzare questo metodo per eseguire l'aggiornamento canary di nuovi template di istanza. Per utilizzare questo metodo, imposta il tipo di aggiornamento del MIG su "proattivo".
Selettivo (opportunistico): utilizza questo metodo se vuoi applicare l'aggiornamento manualmente o se vuoi aggiornare contemporaneamente tutte le VM esistenti nel gruppo. Scegli come destinazione una o tutte le VM da aggiornare all'ultima configurazione. Per utilizzare questo metodo, imposta il tipo di aggiornamento del MIG su "opportunistico".
Ricreazione delle VM: quando ricrei una VM in un MIG, quest'ultimo applica qualsiasi configurazione aggiornata che non è stata ancora applicata alla VM. Per saperne di più, consulta Ricrea le VM in un MIG.

Automatico (proattivo)

Se vuoi applicare automaticamente una configurazione di tutte le istanze aggiornata a tutte le VM esistenti ogni volta che apporti una modifica, imposta il tipo di policy di aggiornamento del gruppo su "proattivo". Per saperne di più, consulta Tipo di aggiornamento automatico (proattivo).

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

Per utilizzare gli aggiornamenti proattivi, devi configurarli una sola volta. Successivamente, il MIG applica automaticamente tutte le modifiche future alla configurazione delle VM (ovvero le modifiche alla configurazione di tutte le istanze, al template di istanza e alle configurazioni per istanza del gruppo) a tutte le VM del gruppo in base alle impostazioni della policy 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.

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 MIG.
MAX_UNAVAILABLE (facoltativo): il 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 della dimensione del gruppo di istanze gestite (ad esempio 10%).
MAX_SURGE (facoltativo): il numero massimo di istanze aggiuntive che è consentito creare durante l'aggiornamento. Può essere un numero fisso (ad esempio 5) o una percentuale della dimensione 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 gcloud topic datetimes per informazioni sui formati di durata.
MINIMAL_ACTION (facoltativo): l'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 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 ne crea una nuova con lo stesso nome della precedente.
- substitute: crea un'istanza con un nuovo nome ed elimina l'istanza precedente

REST

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

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 MIG.
REGION: la regione in cui si trova il MIG. Per un MIG a livello di zona, sostituisci regions/REGION con zones/ZONE.
INSTANCE_GROUP_NAME: il nome del MIG.
MAX_UNAVAILABLE (facoltativo): il 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 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): il numero massimo di istanze aggiuntive che è consentito creare durante l'aggiornamento. Può essere una percentuale o un numero fisso.
MINIMAL_ACTION (facoltativo): l'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 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 ne crea una nuova con lo stesso nome della precedente.
- SUBSTITUTE: crea un'istanza con un nuovo nome ed elimina l'istanza precedente

Se i flag facoltativi vengono omessi, il gruppo utilizza i valori della policy di aggiornamento del gruppo. Puoi controllare la policy 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 policy di aggiornamento del gruppo su "opportunistico". Per saperne di più, consulta Tipo di aggiornamento selettivo (opportunistico).

Se scegli di applicare in modo selettivo gli aggiornamenti della configurazione, le modifiche alla configurazione di tutte le istanze, al template di istanza o alle configurazioni per istanza del gruppo non vengono applicate automaticamente alle VM esistenti. Devi applicare esplicitamente una configurazione aggiornata alle VM esistenti per aggiornarle.

Per applicare in modo selettivo gli aggiornamenti della configurazione alle VM in un MIG, utilizza gcloud CLI 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.

Applica 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

Applica 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 MIG.
INSTANCE_NAMES: un elenco di istanze a cui applicare il template.
MINIMAL_ACTION (facoltativo): l'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 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): 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, per applicare le modifiche al tipo di macchina è sufficiente arrestare le istanze e avviarle di nuovo.
- replace: sostituisce le istanze precedenti in base al flag --replacement-method.

REST

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

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
}

Applica 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 MIG.
REGION: la regione in cui si trova il MIG. Per un MIG a livello di zona, sostituisci regions/REGION con zones/ZONE.
INSTANCE_GROUP_NAME: il nome del MIG.
MINIMAL_ACTION (facoltativo): l'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 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): 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, per applicare le modifiche al tipo di macchina è sufficiente arrestare le istanze e avviarle di nuovo.
- REPLACE: sostituisce le istanze precedenti in base al campo updatePolicy.replacementMethod del gruppo.

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

Puoi verificare se la configurazione più recente per tutte le istanze è stata applicata a tutte le VM del gruppo utilizzando uno dei seguenti metodi.

Console

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

Vai a Gruppi di istanze
Seleziona il MIG di cui vuoi visualizzare la configurazione per tutte le istanze.
Vai alla scheda Dettagli.
Se l'ultima configurazione 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 seguenti valori:
- Ultima modifica: mostra l'ora in cui hai applicato la configurazione di tutte le istanze a tutte le VM.
- Stato: mostra Applicato a tutte le VM. Se la configurazione per tutte le istanze non viene applicata a tutte le VM, lo stato viene visualizzato come 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 dell'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 MIG 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 l'ultima configurazione, confronta il timestamp revision su ogni VM con il timestamp currentRevision sul MIG.

REST

Invia una richiesta GET a un MIG a livello di zona o 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

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, l'ultima configurazione non è ancora applicata a tutte le VM.

Per controllare lo stato di ogni istanza, elenca le istanze gestite per il MIG a livello di zona o 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 l'ultima configurazione, confronta il timestamp revision su ogni VM con il timestamp currentRevision sul MIG.

Elenca le proprietà in una configurazione per tutte le istanze

Una configurazione per tutte le istanze fa parte della configurazione del MIG. Per esaminare la configurazione di tutte le istanze, utilizza uno dei seguenti metodi.

Console

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

Vai a Gruppi di istanze
Seleziona il MIG di cui vuoi visualizzare la configurazione per tutte le istanze.
Vai alla scheda Dettagli.
Consulta la sezione Configurazione di tutte le istanze.

gcloud

Utilizza il comando describe e includi il flag --format per visualizzare il valore di configurazione all-instances 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 esiste.

REST

Invia una richiesta GET a un MIG a livello di zona o di regione 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 una configurazione per tutte le istanze.

Elimina le proprietà dalla configurazione di tutte le istanze

Se elimini una proprietà dalla configurazione di tutte le istanze del MIG e la stessa proprietà esiste nel template di istanza del MIG, le VM nel MIG erediteranno nuovamente la proprietà dal template di istanza una volta applicata l'ultima configurazione alle VM nel MIG. Per saperne di più sull'applicazione della configurazione più recente alle VM esistenti, consulta Applica una configurazione per tutte le istanze alle VM esistenti.

Per eliminare le proprietà da una configurazione per tutte le istanze, utilizza uno dei seguenti metodi.

Console

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

Vai a Gruppi di istanze
Seleziona il MIG da cui vuoi eliminare la configurazione di tutte le istanze.
Fai clic su Modifica.
Fai clic su Template di istanza e override per espandere la sezione.
Nella sezione Configurazione di tutte le istanze, segui questi passaggi:
1. A seconda della proprietà che vuoi eliminare, fai clic su Gestisci metadati o Gestisci etichette.
2. Nel riquadro Gestisci metadati o Gestisci etichette, tieni il puntatore su un'impostazione per attivare l'opzione di eliminazione, quindi fai clic su Elimina elemento.
3. Fai clic su Salva.
Fai clic su Salva per applicare le modifiche al MIG.

Se il tipo di aggiornamento del MIG è 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 alle VM esistenti in modo selettivo. Per saperne di più, consulta Applica 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à che vuoi eliminare.

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

Ricorda di applicare la configurazione aggiornata alle VM esistenti nel MIG.

REST

Per eliminare le proprietà, invia una richiesta PATCH a un MIG a livello di zona o di regione 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,
        ...
      }
    }
  }
}

Ricorda di applicare la configurazione aggiornata alle VM esistenti nel MIG.

Passaggi successivi

Scopri di più su come applicare automaticamente una configurazione aggiornata alle VM esistenti in un MIG.
Scopri di più sull'applicazione selettiva degli aggiornamenti della configurazione alle VM esistenti in un MIG.
Visualizza le informazioni sul MIG e sulle relative VM.

Sostituisci le proprietà del modello di istanza con una configurazione per tutte le istanze Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Prima di iniziare

Console

gcloud

REST

Ruoli obbligatori

Autorizzazioni obbligatorie

Limitazioni

Imposta le proprietà in una configurazione per tutte le istanze

Console

gcloud

REST

Applica una configurazione per tutte le istanze alle VM esistenti

Automatico (proattivo)

gcloud

REST

Selettivo (opportunistico)

gcloud

REST

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

Console

gcloud

REST

Elenca le proprietà in una configurazione per tutte le istanze

Console

gcloud

REST

Elimina le proprietà dalla configurazione di tutte le istanze

Console

gcloud

REST

Passaggi successivi

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