Questa pagina spiega come utilizzare una configurazione per 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 (MIG) senza dover creare un nuovo modello di istanza.
Puoi continuare a utilizzare i modelli di istanza per impostare le proprietà delle istanze nel MIG. Tuttavia, l'utilizzo della configurazione per tutte le istanze di un MIG è più semplice in alcuni scenari, ad esempio i seguenti:
Devi aggiornare spesso i metadati o le etichette delle istanze e senza l'overhead della 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ù MIG basati su un modello di istanza, ma devi configurare etichette o metadati per ogni MIG in modo diverso. Ad esempio, se hai un'app, ma vuoi supportare ambienti diversi per lo sviluppo, i test e la produzione. Puoi creare un singolo modello di istanza e riutilizzarlo per tutti gli ambienti impostando metadati diversi con una configurazione per tutte le istanze diversa per ogni ambiente.
Un team possiede l'infrastruttura e le immagini, mentre un altro esegue app che richiedono la configurazione. Un team può eseguire il provisioning dell'infrastruttura con un modello di istanza, mentre il team dell'app può gestire le configurazioni dell'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 venga mantenuta 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 MIG sia la relativa configurazione di tutte le istanze, il MIG 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 MIG e su TRUE
nella configurazione per tutte le istanze del MIG, Compute Engine applica TRUE
a tutte le istanze del gruppo. Ciò ti consente di utilizzare una configurazione di tutte le istanze per eseguire l'override delle proprietà definite nel modello di istanza.
Prima di iniziare
- Crea un gruppo di istanze gestite.
-
Se non l'hai ancora fatto, configura l'autenticazione.
L'autenticazione è
il processo mediante il quale la tua identità viene verificata per l'accesso ai Google Cloud servizi e alle API.
Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti su
Compute Engine selezionando una delle seguenti opzioni:
Select the tab for how you plan to use the samples on this page:
Console
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
-
After installing the Google Cloud CLI, initialize it by running the following command:
gcloud init
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
- Set a default region and zone.
Puoi sostituire solo le seguenti proprietà del modello di istanza con una configurazione per tutte le istanze:
- Metadati
- Etichette
Non puoi aggiornare in modalità canary 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 alle norme 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.
Nella console Google Cloud , vai alla pagina Gruppi di istanze.
Seleziona il MIG di cui vuoi impostare la configurazione per tutte le istanze.
Fai clic su Aggiorna VM.
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.
Dopo aver completato la configurazione delle proprietà in tutte le istanze, fai clic su Aggiorna VM.
Se il tipo di aggiornamento del MIG è impostato su Automatico, la configurazione di tutte le istanze che hai impostato viene applicata immediatamente a tutte le VM esistenti. Se il tipo di aggiornamento è Selettivo, devi applicare in modo selettivo la configurazione alle VM esistenti. Per ulteriori informazioni, consulta Applicare una configurazione per tutte le istanze alle VM esistenti.
INSTANCE_GROUP_NAME
: il nome del MIG.KEYS
eVALUES
: coppie chiave/valore per etichette o metadati. Se la chiave non esiste, il comando di aggiornamento la aggiunge. Per le chiavi esistenti, i valori vengono aggiornati.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, sostituisciregions/REGION
conzones/ZONE
.INSTANCE_GROUP_NAME
: il nome del MIG.KEYS
eVALUES
: coppie chiave/valore per etichette o metadati. Se la chiave non esiste, la richiesta la aggiunge. Per le chiavi esistenti, il valore viene aggiornato.- Automatico (proattivo): utilizza questo metodo se vuoi che il MIG applichi automaticamente le nuove configurazioni a tutte le VM esistenti nel gruppo o a un sottoinsieme. Il livello di interruzione delle VM in esecuzione dipende dal criterio di aggiornamento che configuri. Puoi utilizzare questo metodo per l'aggiornamento canary di nuovi modelli 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 tutte le VM esistenti nel gruppo contemporaneamente. Puoi scegliere come target una o tutte le VM da aggiornare alla configurazione più recente. Per utilizzare questo metodo, imposta il tipo di aggiornamento del MIG su "opportunistico".
- Ricreazione delle VM: quando ricrei una VM in un MIG, il MIG applica qualsiasi configurazione aggiornata che non è ancora stata applicata a quella VM. Per saperne di più, consulta Ricrea le VM in un MIG.
INSTANCE_GROUP_NAME
: il nome del MIG.MAX_UNAVAILABLE
(facoltativo): numero massimo di istanze che possono non essere disponibili durante l'aggiornamento. Ad esempio, se imposti il flagupdate-minimal-action
surestart
, questo flag limita il numero di VM riavviate contemporaneamente. Può essere un numero fisso (ad esempio5
) o una percentuale della dimensione del gruppo di istanze gestite (ad esempio10%
).MAX_SURGE
(facoltativo): numero aggiuntivo massimo di istanze che possono essere create durante l'aggiornamento. Può essere un numero fisso (ad esempio5
) o una percentuale delle dimensioni del gruppo di istanze gestite (ad esempio10%
).MIN_READY
(facoltativo): 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 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.
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.substitute
: crea un'istanza con un nuovo nome ed elimina quella precedente
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, sostituisciregions/REGION
conzones/ZONE
.INSTANCE_GROUP_NAME
: il nome del MIG.MAX_UNAVAILABLE
(facoltativo): numero massimo di istanze che possono non essere disponibili durante l'aggiornamento. Ad esempio, se imposti il flagupdate-minimal-action
suRESTART
, questo flag 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 aggiuntivo massimo di istanze 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 per 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.SUBSTITUTE
: crea un'istanza con un nuovo nome ed elimina quella precedente
INSTANCE_GROUP_NAME
: il nome del MIG.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
(impostazione predefinita): 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ù distruttiva di quella specificata qui, l'aggiornamento non va a buon fine e non vengono apportate modifiche.none
: nessuna azionerefresh
: applica la nuova configurazione senza arrestare le istanze, se possibile. Ad esempio, utilizzarefresh
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, l'arresto e il riavvio delle istanze sono sufficienti per applicare le modifiche al tipo di macchina.replace
: sostituisci le vecchie istanze in base al flag--replacement-method
.
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, sostituisciregions/REGION
conzones/ZONE
.INSTANCE_GROUP_NAME
: il nome del MIG.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 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ù distruttiva di quella specificata qui, l'aggiornamento non va a buon fine e non vengono apportate modifiche.NONE
: nessuna azioneREFRESH
: applica la nuova configurazione senza arrestare le istanze, se possibile. Ad esempio, utilizzaREFRESH
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, l'arresto e il riavvio delle istanze sono sufficienti per applicare le modifiche al tipo di macchina.REPLACE
: sostituisci le istanze precedenti in base al campoupdatePolicy.replacementMethod
del gruppo.
Nella console Google Cloud , vai alla pagina 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 valori come segue:
- Ultima modifica: mostra l'ora in cui hai applicato la configurazione per tutte le istanze a tutte le VM.
- Stato: mostra Applicato a tutte le VM. Se all-instances non viene applicato a tutte le VM, lo stato viene visualizzato come Aggiornamento VM in attesa.
Nella console Google Cloud , vai alla pagina 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.
Nella console Google Cloud , vai alla pagina Gruppi di istanze.
Seleziona il MIG da cui vuoi eliminare la configurazione di tutte le istanze.
Fai clic su Aggiorna VM.
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.
Nel riquadro Gestisci metadati o Gestisci etichette, segui questi passaggi:
- Tieni il puntatore sopra un'impostazione per attivare l'opzione di eliminazione, quindi fai clic su Elimina elemento.
- Fai clic su Salva.
Al termine dell'eliminazione, fai clic su Aggiorna VM.
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 in modo selettivo la configurazione alle VM esistenti. Per ulteriori informazioni, consulta Applicare una configurazione per tutte le istanze alle VM esistenti.
- Scopri di più sull'applicazione automatica di 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 tuo MIG e sulle relative VM.
REST
Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, utilizzi le credenziali che fornisci a gcloud CLI.
After installing the Google Cloud CLI, initialize it by running the following command:
gcloud init
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
Per saperne di più, consulta la sezione Autenticarsi per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud .
Limitazioni
Imposta le proprietà in una configurazione per tutte le istanze
Crea e aggiorna la configurazione per tutte le istanze di un MIG utilizzando gcloud CLI o REST.
Console
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:
Ricorda 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 MIG 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:
Ricorda di applicare la configurazione aggiornata alle VM esistenti nel gruppo di istanze gestite.
Applica una configurazione per tutte le istanze alle VM esistenti
La configurazione VM che specifichi per le VM in un MIG viene applicata automaticamente alle nuove VM aggiunte al gruppo.
Per applicare una configurazione VM aggiornata, inclusa una configurazione per tutte le istanze aggiornata, alle VM esistenti nel gruppo, utilizza uno dei seguenti metodi:
Automatica (proattiva)
Se vuoi applicare automaticamente una configurazione aggiornata di tutte le istanze a tutte le VM esistenti ogni volta che la modifichi, 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 implementazione di una configurazione proattiva utilizzando le impostazioni facoltative maxUnavailable, maxSurge e minReadySec.
Per utilizzare gli aggiornamenti proattivi, devi configurarlo una sola volta. Dopodiché, il gruppo di istanze gestite applica automaticamente tutte le modifiche future alla configurazione delle VM (ovvero le modifiche alla configurazione di tutte le istanze, al modello di istanza e alle configurazioni per istanza del gruppo) a tutte le VM del gruppo in base alle impostazioni nella policy di aggiornamento del gruppo.
Per applicare automaticamente gli aggiornamenti alla 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:
REST
Puoi configurare gli aggiornamenti automatici (proattivi) effettuando una richiesta
PATCH
su un MIG zonale 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:
Quando i flag facoltativi vengono omessi, il gruppo utilizza i valori nella policy di aggiornamento del gruppo. Puoi controllare il criterio di aggiornamento utilizzando gcloud CLI o REST.
Selettiva (opportunistica)
Se vuoi controllare quando e a quali VM applicare una nuova configurazione, imposta il tipo di criterio di aggiornamento del gruppo su "opportunistico". Per saperne di più, consulta Tipo di aggiornamento selettivo (opportunistico).
Quando scegli di applicare in modo selettivo gli aggiornamenti della configurazione, le modifiche alla configurazione di tutte le istanze, al modello di istanza o alle configurazioni per istanza del gruppo non vengono applicate automaticamente alle VM esistenti. Per aggiornare le VM esistenti, devi applicare esplicitamente una configurazione aggiornata.
Per applicare in modo selettivo gli aggiornamenti della configurazione delle VM 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 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 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:
REST
Puoi configurare gli aggiornamenti selettivi (opportunistici) effettuando una richiesta
PATCH
su un MIG zonale 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 }
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:
Verificare 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
gcloud
Utilizza il comando
describe
e includi il flag--format
per cercare il valorestatus.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 di
effective
è impostato sutrue
, a tutte le VM viene applicata la configurazione più recente. Il valorecurrentRevision
mostra il timestamp dell'ultima modifica alla configurazione di tutte le istanze del gruppo.Se il valore di
effective
è impostato sufalse
, 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 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 la configurazione più recente, confronta il timestamp
revision
di ogni VM con il timestampcurrentRevision
del gruppo di istanze gestite.REST
Invia una richiesta
GET
a un MIG a livello di zona o regionale per verificare il valore del flagstatus.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 sutrue
, a tutte le VM viene applicata la configurazione più recente. Il campocurrentRevision
mostra il timestamp dell'ultima modifica alla configurazione di tutte le istanze del gruppo.Se il campo
effective
è impostato sufalse
, 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 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
di ogni VM con il timestampcurrentRevision
del gruppo di istanze gestite.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
gcloud
Utilizza il comando
describe
e includi il flag--format
per mostrare il valore della configurazione di 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 MIG a livello di zona o regionale e cerca il campoallInstancesConfig
.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 per tutte le istanze
Se elimini una proprietà dalla configurazione per tutte le istanze del MIG e la stessa proprietà esiste nel modello di istanza del MIG, le VM nel MIG erediteranno nuovamente la proprietà dal modello di istanza una volta applicata l'ultima configurazione alle VM nel MIG. Per ulteriori informazioni 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
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]
Ricorda 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 zonale o regionale e specifica un valorenull
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 gruppo di istanze gestite.
Passaggi successivi
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-11 UTC.
-