I metadati dell'istanza sono utili per impostare le proprietà e comunicare con le applicazioni tramite il server metadati. Ad esempio, puoi utilizzare i metadati per configurare l'identità dell'istanza della macchina virtuale (VM), le variabili di ambiente, le informazioni sull'architettura del cluster o l'intervallo di dati di cui è responsabile una VM.
Configurando i metadati stateful in un gruppo di istanze gestite, assicurati che i metadati specifici dell'istanza vengano conservati negli eventi di riparazione automatica, aggiornamento e ricreazione della istanza gestita.
Configura i metadati stateful singolarmente per le istanze VM in un gruppo di istanze gestite impostandoli nelle configurazioni per istanza e applicando la configurazione. Puoi impostare una configurazione per istanza al momento della creazione dell'istanza o in base alle istanze gestite esistenti. Dopo l'applicazione della configurazione per istanza, il gruppo MIG memorizza i metadati stateful nel campo stato conservato dalla configurazione (preservedStateFromConfig
) di un'istanza gestita.
Prima di iniziare
- Scopri quando utilizzare i gruppi di istanze gestite stateful e come funzionano i gruppi di istanze gestite stateful.
-
Se non l'hai ancora fatto, configura l'autenticazione.
L'autenticazione è la procedura mediante la quale la tua identità viene verificata per l'accesso alle API e ai servizi Google Cloud.
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:
gcloud
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
- Non puoi utilizzare la scalabilità automatica se il gruppo di istanze gestite ha una configurazione stateful.
- Se vuoi utilizzare gli aggiornamenti incrementali automatici, devi impostare il metodo di sostituzione su
RECREATE
. - Per i gruppi di istanze gestite regionali stateful, devi
disattivare la ridistribuzione proattiva
(imposta il tipo di ridistribuzione su
NONE
) per impedire l'eliminazione delle istanze stateful tramite la ridistribuzione automatica tra zone. Se utilizzi una configurazione per tutte le istanze per eseguire l'override delle proprietà del modello di istanza, non puoi specificarle in nessuna configurazione per istanza e contemporaneamente nella configurazione per tutte le istanze del gruppo.
Quando elimini definitivamente un'istanza (manualmente o modificandone le dimensioni), il gruppo di istanze gestite non conserva i metadati stateful dell'istanza.
- Crea un'istanza gestita dal modello di istanza utilizzando il nome dell'istanza fornito.
- Crea una configurazione per istanza con i metadati stateful forniti e imposta questi metadati sull'istanza.
- Memorizza i metadati stateful nello stato conservato dalla configurazione
(
preservedStateFromConfig
) dell'istanza gestita associata. NAME
: il nome del gruppo di istanze gestite in cui creare un'istanzaINSTANCE_NAME
: il nome dell'istanza da creareKEY
eVALUE
: coppie chiave-valore dei metadati stateful da impostare singolarmente per le istanze, oltre ai metadati definiti nel modello di istanza- I valori chiave impostati qui hanno la precedenza su eventuali valori chiave in conflitto del modello di istanza
PROJECT_ID
: l'ID progetto per la richiestaZONE
: la zona in cui si trova il gruppo di istanze gestite (si applica a un gruppo di istanze gestite a livello di zona)- Per un gruppo di istanze gestite a livello di regione, sostituisci
zones/ZONE
conregions/REGION
e specifica la regione del gruppo di istanze gestite
- Per un gruppo di istanze gestite a livello di regione, sostituisci
NAME
: il nome del gruppo di istanze gestite in cui creare un'istanzaINSTANCE_NAME
: il nome dell'istanza da creareKEY
eVALUE
: coppie chiave-valore dei metadati stateful da impostare singolarmente per le istanze, oltre ai metadati definiti nel modello di istanza- I valori chiave impostati qui hanno la precedenza su eventuali valori chiave in conflitto del modello di istanza
- Il flag
--stateful-metadata
per impostare o modificare i metadati oppure - Il flag
--remove-stateful-metadata
per la rimozione di metadati stateful specifici dell'istanza. NAME
: il nome del gruppo di istanze gestite.INSTANCE_NAME
: il nome dell'istanza per la quale configurare i metadati stateful.KEY=VALUE
: coppie chiave-valore dei metadati con stato da impostare singolarmente per l'istanza, oltre ai metadati definiti nel modello di istanza. I valori chiave impostati qui hanno la precedenza su eventuali valori chiave in conflitto del modello di istanza.KEY
: chiavi dei metadati stateful specifici dell'istanza da rimuovere dalla configurazione per istanza.- Se il modello di istanza non definisce un valore per la chiave, la coppia chiave-valore viene rimossa completamente dall'istanza quando viene applicata la modifica.
- Se un valore per la chiave è definito dal modello di istanza, il valore del modello di istanza viene impostato sull'istanza quando viene applicata la modifica.
MINIMAL_ACTION
: esegui almeno l'azione specificata quando applichi l'aggiornamento della configurazione per istanza all'istanza. UnMINIMAL_ACTION
può essere impostato solo quando viene utilizzato il flag--update-instance
. Il valore deve essere uno dei seguenti:none
: nessuna azione.refresh
: applica gli aggiornamenti che è possibile applicare senza interrompere l'istanza.restart
: arresta l'istanza e riavviala.replace
: ricrea l'istanza.
Se omesso, viene utilizzata l'azione meno invasiva richiesta dall'aggiornamento.
- Imposta i metadati
mode:standby
nella configurazione per istanza associata alla VMnode-12
nel gruppo di istanze gestiteexample-cluster
. - Rimuove i metadati
logging:elaborate
dalla configurazione per istanza per l'istanzanode-12
. - Applica la modifica della configurazione per istanza alla VM
node-12
:- Imposta i metadati
mode:standby
in base alla configurazione. - Imposta i metadati
logging:basic
dal modello di istanza perché il valore della chiavelogging
non è più definito dalla configurazione per istanza.
- Imposta i metadati
- La modifica viene applicata immediatamente alla VM per impostazione predefinita perché il flag
--no-update-instance
viene omesso. - La VM continua a funzionare durante l'aggiornamento perché il flag
--instance-update-minimal-action
viene omesso e per impostazione predefinita viene scelta l'azione meno invasiva per l'aggiornamento, in questo caso:refresh
. PROJECT_ID
: l'ID progetto per la richiesta.ZONE
: la zona in cui si trova il gruppo di istanze gestite (si applica a un gruppo di istanze gestite a livello di zona).- Per un gruppo di istanze gestite a livello di regione, sostituisci
zones/ZONE
conregions/REGION
e specifica la regione del gruppo di istanze gestite.
- Per un gruppo di istanze gestite a livello di regione, sostituisci
NAME
: il nome del gruppo di istanze gestite.INSTANCE_NAME
: il nome della VM per cui configurare i metadati stateful.KEY
eVALUE
: coppie chiave/valore dei metadati stateful da impostare singolarmente per le istanze, oltre a eventuali metadati definiti nel modello di istanza.- I valori dei metadati con stato definiti per le chiavi già esistenti nel modello di istanza sostituiscono i valori del modello di istanza.
- Le altre voci dei metadati del modello di istanza rimangono invariate e disponibili.
- Se fornisci
null
come valore, la chiave viene rimossa dalla configurazione per istanza.
FINGERPRINT
: (facoltativo). L'impronta per la configurazione specificata, se esistente. Utilizzato per il blocco ottimistico.- Imposta i metadati
mode:standby
nella configurazione per istanza associata alla VMnode-12
nel gruppo di istanze gestiteexample-cluster
. - Rimuove i metadati
logging:elaborate
dalla configurazione per istanza perché il valore fornito ènull
. - Imposta i metadati
mode:standby
in base alla configurazione per istanza. - Imposta i metadati
logging:basic
dal modello di istanza perché il valore della chiavelogging
non è più definito dalla configurazione per istanza. - La VM continua a funzionare durante l'aggiornamento perché
minimalAction
è impostato suNONE
, il che consente al gruppo di istanze gestite di utilizzare l'azione meno invasiva richiesta per l'aggiornamento. Un aggiornamento dei metadati di un'istanza richiede l'azioneREFRESH
, che non interrompe un'istanza in esecuzione. - Scopri di più sull'archiviazione e il recupero dei metadati delle istanze.
- Configura i dischi permanenti stateful per le VM in un gruppo di istanze gestite.
- Scopri di più su come applicare, visualizzare e rimuovere la configurazione stateful.
- Scopri di più sulle MIG e sull'utilizzo delle istanze gestite.
Terraform
Per utilizzare gli esempi di Terraform in questa pagina in un ambiente di sviluppo locale, installa e inizializza gcloud CLI, quindi configura le Credenziali predefinite dell'applicazione con le tue credenziali utente.
Per ulteriori informazioni, consulta Set up authentication for a local development environment.
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, consulta Eseguire l'autenticazione per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud.
Limitazioni
Un MIG con metadati stateful presenta le seguenti limitazioni:
Un gruppo di istanze gestite con configurazione stateful, ovvero un gruppo di istanze gestite stateful, presenta le seguenti limitazioni:
Impostazione dei metadati stateful al momento della creazione dell'istanza
Imposta i metadati stateful quando crei manualmente le istanze in un MIG. Ciò è utile per eseguire la migrazione di un'applicazione stateful su VM autonome a un gruppo di istanze gestite stateful e per la creazione di istanze stateful.
Quando crei manualmente un'istanza in un gruppo di istanze gestite e fornisci metadati stateful, il gruppo di istanze gestite esegue le seguenti attività:
gcloud
Per creare un'istanza gestita con un nome personalizzato e impostare metadati stateful su quella VM, utilizza il comando
gcloud compute instance-groups managed create-instance
con il flag--stateful-metadata
.gcloud compute instance-groups managed create-instance NAME \ --instance INSTANCE_NAME \ --stateful-metadata KEY=VALUE[,KEY=VALUE,...]
Sostituisci quanto segue:
Esempio
Devi eseguire il deployment di un cluster di nodi,
example-cluster
, che può operare in una delle due modalità:active
ostandby
. Imposti la modalità singolarmente per ogni VM in un cluster utilizzando i metadati, ad esempio:mode:active
. Inoltre, configuri il livello di dettaglio della registrazione per ogni nodo utilizzando una chiave di metadatilogging
che può essere impostata subasic
oelaborate
. L'applicazione sul nodo viene configurata utilizzando i valori dei metadati dell'istanza.Per creare un nodo attivo,
node-12
, con un logging elaborato, esegui il seguente comando:gcloud compute instance-groups managed create-instance example-cluster \ --instance node-12 \ --stateful-metadata mode=active,logging=elaborate
Il comando crea una VM,
node-12
, nel gruppo di istanze gestiteexample-cluster
e imposta due coppie chiave-valore dei metadati,mode:active
elogging:elaborate
, per la nuova istanza.Terraform
Per creare un'istanza gestita con un nome personalizzato e impostare metadati stateful su quella VM, utilizza la risorsa
google_compute_per_instance_config
.L'esempio seguente utilizza un gruppo di istanze gestite a livello di zona. Se non hai ancora un gruppo di istanze gestite a livello di zona, creane uno con VM limitate a una singola zona.
Per scoprire come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base.
REST
Per creare una o più istanze gestite in un gruppo di istanze gestite con nomi VM personalizzati e per impostare i metadati stateful singolarmente su queste VM, utilizza il metodo
instanceGroupManagers.createInstances
. Per un gruppo di istanze gestite a livello di regione, utilizza il metodoregionInstanceGroupManagers.createInstances
.POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/NAME/createInstances { "perInstanceConfigs": [ { "name": "INSTANCE_NAME", "preservedState" : { "metadata": { "KEY" : "VALUE", ... } } }, ... ] }
Sostituisci quanto segue:
Esempio
Devi eseguire il deployment di un cluster di nodi,
example-cluster
, che può operare in una delle due modalità:active
ostandby
. Imposti la modalità singolarmente per ogni VM in un cluster utilizzando i metadati, ad esempio:mode:active
. Inoltre, configuri il livello di dettaglio della registrazione per ogni nodo utilizzando una chiave di metadatilogging
che può essere impostata subasic
oelaborate
. L'applicazione sul nodo viene configurata utilizzando i valori dei metadati dell'istanza.Per creare un nodo attivo,
node-12
, con un logging elaborato, esegui il seguente metodo:POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-east1-c/instanceGroupManagers/example-cluster/createInstances { "instance": [ { "name": "node-12", "preservedState" : { "metadata": { "mode":"active", "logging":"elaborate" } } } ] }
Il metodo crea una VM,
node-12
, nel gruppo di istanze gestiteexample-cluster
e imposta due coppie chiave-valore dei metadati,mode:active
elogging:elaborate
, per la nuova istanza.Impostazione, modifica e rimozione dei metadati con stato per le istanze VM esistenti
Imposta, modifica o rimuovi i metadati stateful per un'istanza esistente in un gruppo MIG impostandoli in una configurazione per istanza associata e poi applicando la configurazione aggiornando l'istanza.
gcloud
Per configurare i metadati stateful singolarmente per un'istanza VM in un gruppo di istanze gestite, imposta o rimuovi i metadati stateful nella configurazione per istanza associata. Se applichi la configurazione all'istanza contemporaneamente (
--update-instance
), puoi scegliere se mantenerla in esecuzione, riavviare o ricrearla. Se non applichi la configurazione (--no-update-instance
), le modifiche non vengono applicate finché non ri crei o aggiorni l'istanza.Se per una determinata istanza non esiste una configurazione per istanza, utilizza il comando
gcloud compute instance-groups managed instance-configs create
con uno dei seguenti flag:gcloud compute instance-groups managed instance-configs create NAME \ --instance INSTANCE_NAME \ --stateful-metadata KEY=VALUE[,KEY=VALUE,...] \ [--no-update-instance | --update-instance] \ [--instance-update-minimal-action MINIMAL_ACTION]
Se per una determinata istanza esiste già una configurazione per istanza, utilizza il
gcloud compute instance-groups managed instance-configs update
comando con:gcloud compute instance-groups managed instance-configs update NAME \ --instance INSTANCE_NAME \ [--stateful-metadata KEY=VALUE[,KEY=VALUE,...]] \ [--remove-stateful-metadata KEY[,KEY,...]] \ [--no-update-instance | --update-instance] \ [--instance-update-minimal-action MINIMAL_ACTION]
Sostituisci quanto segue:
Esempio
Hai un cluster di nodi,
example-cluster
, che può funzionare in una di due modalità:active
ostandby
. Imposti la modalità singolarmente per ogni VM del cluster utilizzando i metadati, ad esempio:mode:active
. Inoltre, configura il livello di dettaglio della registrazione per ogni nodo utilizzando una chiave di metadatilogging
che può essere impostata subasic
oelaborate
. L'applicazione su ogni nodo utilizza i valori dei metadati dell'istanza.Il modello di istanza definisce i metadati
mode:active
elogging:basic
da utilizzare come predefiniti per tutte le istanze. Hai impostatologging:elaborate
in una configurazione per istanza per la VMnode-12
nel cluster. Ora vuoi impostarenode-12
in modalità standby e impostare la registrazione subasic
per questa VM.Per impostare l'istanza
node-12
su standby e la relativa registrazione su di base, esegui il seguente comando:gcloud compute instance-groups managed instance-configs update example-cluster \ --instance node-12 \ --stateful-metadata mode=standby \ --remove-stateful-metadata logging
Il comando esegue le seguenti operazioni:
REST
Per configurare singolarmente i metadati stateful per le istanze VM esistenti in un gruppo di istanze gestite, imposta o rimuovi i metadati nelle configurazioni per istanza associate. Aggiorna l'istanza per applicare la configurazione.
Se non esistono ancora configurazioni per istanza per le istanze specificate, utilizza il
instanceGroupManagers.updatePerInstanceConfigs
metodo con metadati stateful:POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/NAME/updatePerInstanceConfigs { "perInstanceConfigs": [ { "name": "INSTANCE_NAME", "preservedState" : { "metadata": { "KEY": "VALUE", ... } }, "fingerprint: "FINGERPRINT" }, ... ] }
Se esistono già configurazioni per istanza per le istanze specificate, utilizza il metodo
instanceGroupManagers.patchPerInstanceConfigs
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/NAME/patchPerInstanceConfigs { "perInstanceConfigs": [ { "name": "INSTANCE_NAME", "preservedState" : { "metadata": { "KEY": "VALUE", ... } }, "fingerprint: "FINGERPRINT" }, ... ] }
Sostituisci quanto segue:
I metodi
updatePerInstanceConfigs
epatchPerInstanceConfigs
aggiornano le configurazioni per istanza specificate, ma non applicano gli aggiornamenti della configurazione alle istanze VM associate. Le modifiche vengono applicate a una VM quando aggiornate o ricrei l'istanza. Per applicare le modifiche a una VM, puoi applicare l'aggiornamento manualmente o utilizzare l'aggiornamento in modalità proattiva o opportunistica.Esempio
Hai un cluster di nodi,
example-cluster
, che può funzionare in una di due modalità:active
ostandby
. Imposti la modalità singolarmente per ogni VM del cluster utilizzando i metadati, ad esempio:mode:active
. Inoltre, configura il livello di dettaglio della registrazione per ogni nodo utilizzando una chiave di metadatilogging
che può essere impostata subasic
oelaborate
. L'applicazione su ogni nodo utilizza i valori dei metadati dell'istanza.Il modello di istanza definisce i metadati
mode:active
elogging:basic
da utilizzare come predefiniti per tutte le istanze. Hai impostatologging:elaborate
in una configurazione per istanza per la VMnode-12
nel cluster. Ora vuoi impostarenode-12
in modalità standby e impostare il logging subasic
per questa istanza.Per impostare la VM
node-12
su standby e il relativo logging su di base, esegui la patch della configurazione per istanza associata utilizzando il metodopatchPerInstanceConfigs
:POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-east1-c/instanceGroupManagers/example-cluster/patchPerInstanceConfigs { "perInstanceConfigs": [ { "name": "node-12", "preservedState" : { "metadata": { "mode": "standby", "logging": null } } } ] }
Il metodo esegue le seguenti operazioni:
L'aggiornamento della configurazione non è ancora stato applicato all'istanza VM
node-12
. L'aggiornamento della configurazione verrà applicato alla successiva ricreazione o aggiornamento dell'istanza o se utilizzi l'aggiornamento automatico proattivo.Per applicare l'aggiornamento della configurazione per istanza all'istanza VM
node-12
, chiama il metodoinstanceGroupManagers.applyUpdatesToInstances
per l'istanza:POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-east1-c/instanceGroupManagers/example-cluster/applyUpdatesToInstances { "instances": ["/zones/us-east1-c/instances/node-12"], "minimalAction": "NONE" }
Il metodo applica la configurazione per istanza aggiornata alla VM
node-12
:Feedback
Vorremmo conoscere i tuoi casi d'uso, le tue sfide e i tuoi feedback sulle MIG stateful. Condividi il tuo feedback con il nostro team all'indirizzo mig-discuss@google.com.
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 2024-12-22 UTC.
-