Configurazione dei metadati stateful nei MIG

gcloud

Per creare un'istanza gestita con un nome personalizzato e impostare metadati stateful sulla specifica 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:

• NAME: il nome del MIG in cui creare un'istanza
• INSTANCE_NAME: il nome dell'istanza da creare
• KEY e VALUE: 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 nel modello di istanza

Esempio

Devi eseguire il deployment di un cluster di nodi, example-cluster, che può funzionare in una delle due modalità: active o standby. Imposti la modalità singolarmente per ogni VM in un cluster utilizzando i metadati, ad esempio: mode:active. Inoltre, configuri il livello di dettaglio del logging per ogni nodo utilizzando una chiave di metadati logging che può essere impostata su basic o elaborate. 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 questo 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 MIG example-cluster e imposta due coppie chiave/valore dei metadati, mode:active e logging:elaborate, per la nuova istanza.

Terraform

Per creare un'istanza gestita con un nome personalizzato e impostare metadati stateful sulla specifica VM, utilizza la risorsa google_compute_per_instance_config.

L'esempio seguente utilizza un MIG a livello di zona. Se non hai ancora un MIG a livello di zona, creane uno con VM limitate a una singola zona.

resource "google_compute_per_instance_config" "default" {
  instance_group_manager = google_compute_instance_group_manager.default.name
  zone                   = google_compute_instance_group_manager.default.zone
  name                   = "node-12"
  preserved_state {
    metadata = {
      mode    = "active"
      logging = "elaborate"
    }
  }
}

Per scoprire come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base.

REST

Per creare una o più istanze gestite in un MIG con nomi VM personalizzati e impostare i metadati stateful singolarmente su queste VM, utilizza il metodo instanceGroupManagers.createInstances. Per un MIG a livello di regione, utilizza il metodo regionInstanceGroupManagers.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:

• PROJECT_ID: l'ID progetto per la richiesta
• ZONE: la zona in cui si trova il MIG (si applica a un MIG a livello di zona)
  • Per un MIG a livello di regione, sostituisci zones/ZONE con regions/REGION e specifica la regione del MIG
• NAME: il nome del MIG in cui creare un'istanza
• INSTANCE_NAME: il nome dell'istanza da creare
• KEY e VALUE: 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 nel modello di istanza

Esempio

Devi eseguire il deployment di un cluster di nodi, example-cluster, che può funzionare in una delle due modalità: active o standby. Imposti la modalità singolarmente per ogni VM in un cluster utilizzando i metadati, ad esempio: mode:active. Inoltre, configuri il livello di dettaglio del logging per ogni nodo utilizzando una chiave di metadati logging che può essere impostata su basic o elaborate. 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 questo 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 MIG example-cluster e imposta due coppie chiave/valore dei metadati, mode:active e logging:elaborate, per la nuova istanza.

gcloud

Per configurare i metadati stateful singolarmente per un'istanza VM in un MIG, imposta o rimuovi i metadati stateful nella configurazione per istanza associata. Se applichi la configurazione all'istanza contemporaneamente (--update-instance), puoi scegliere se mantenere l'istanza in esecuzione, riavviarla o ricrearla. Se non applichi la configurazione (--no-update-instance), le modifiche non vengono applicate finché non ricrei 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 comando gcloud compute instance-groups managed instance-configs update con:

• Il flag --stateful-metadata per impostare o modificare i metadati, oppure
• Il flag --remove-stateful-metadata per rimuovere i metadati stateful specifici dell'istanza.

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:

• NAME: il nome del gruppo di istanze gestite.
• INSTANCE_NAME: il nome dell'istanza per cui configurare i metadati stateful.
• KEY=VALUE: coppie chiave/valore dei metadati stateful 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 nel 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, all'applicazione della modifica la coppia chiave/valore viene rimossa completamente dall'istanza.
  • Se il modello di istanza definisce un valore per la chiave, all'applicazione della modifica sull'istanza viene impostato il valore del modello di istanza.

• MINIMAL_ACTION: esegue almeno l'azione specificata quando all'istanza viene applicato l'aggiornamento della configurazione per istanza. MINIMAL_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 arrestare l'istanza.
  • restart: arresta l'istanza e la riavvia.
  • replace: ricrea l'istanza.

  Se omesso, viene utilizzata l'azione meno invasiva richiesta dall'aggiornamento.

Esempio

Hai un cluster di nodi, example-cluster, che può funzionare in una tra due modalità: active o standby. Imposti la modalità singolarmente per ogni VM nel cluster utilizzando i metadati, ad esempio: mode:active. Inoltre, configuri il livello di dettaglio del logging per ogni nodo utilizzando una chiave di metadati logging che può essere impostata su basic o elaborate. L'applicazione su ogni nodo utilizza i valori dei metadati dell'istanza.

Il modello di istanza definisce i metadati mode:active e logging:basic da utilizzare come predefiniti per tutte le istanze. Hai impostato logging:elaborate in una configurazione per istanza per la VM node-12 nel cluster. Ora vuoi impostare node-12 in modalità standby e impostare il logging su basic per questa VM.

Per impostare l'istanza node-12 su standby e il relativo logging sul livello base, esegui questo 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 queste operazioni:

1. Imposta i metadati mode:standby nella configurazione per istanza associata alla VM, node-12, nel MIG example-cluster.
2. Rimuove i metadati logging:elaborate dalla configurazione per istanza dell'istanza node-12.
3. 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 chiave logging non è più definito dalla configurazione per istanza.
4. La modifica viene applicata immediatamente alla VM per impostazione predefinita perché il flag --no-update-instance viene omesso.
5. 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.

REST

Per configurare singolarmente i metadati stateful per le istanze VM esistenti in un MIG, imposta o rimuovi i metadati nelle configurazioni per istanza associate. Aggiorna quindi l'istanza per applicare la configurazione.

Se non esistono ancora configurazioni per istanza per le istanze specificate, utilizza il metodo instanceGroupManagers.updatePerInstanceConfigs 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:

• PROJECT_ID: l'ID progetto per la richiesta.
• ZONE: la zona in cui si trova il MIG (si applica a un MIG a livello di zona).
  • Per un MIG a livello di regione, sostituisci zones/ZONE con regions/REGION e specifica la regione del MIG.
• NAME: il nome del MIG.
• INSTANCE_NAME: il nome della VM per cui configurare i metadati stateful.
• KEY e VALUE: coppie chiave/valore dei metadati stateful da impostare singolarmente per le istanze, oltre ai metadati definiti nel modello di istanza.
  • I valori dei metadati stateful 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. Utilizzata per il blocco ottimistico.

I metodi updatePerInstanceConfigs e patchPerInstanceConfigs 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 aggiorni o ricrei l'istanza. Per applicare le modifiche a una VM, puoi applicare l'aggiornamento manualmente o utilizzare la funzionalità di aggiornamento in modalità proattiva o opportunistica.

Esempio

Hai un cluster di nodi, example-cluster, che può funzionare in una tra due modalità: active o standby. Imposti la modalità singolarmente per ogni VM nel cluster utilizzando i metadati, ad esempio: mode:active. Inoltre, configuri il livello di dettaglio del logging per ogni nodo utilizzando una chiave di metadati logging che può essere impostata su basic o elaborate. L'applicazione su ogni nodo utilizza i valori dei metadati dell'istanza.

Il modello di istanza definisce i metadati mode:active e logging:basic da utilizzare come predefiniti per tutte le istanze. Hai impostato logging:elaborate in una configurazione per istanza per la VM node-12 nel cluster. Ora vuoi impostare node-12 in modalità standby e impostare il logging su basic per questa istanza.

Per impostare la VM node-12 in standby e il relativo logging sul livello base, applica una patch alla configurazione per istanza associata utilizzando il metodo patchPerInstanceConfigs:

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 queste operazioni:

1. Imposta i metadati mode:standby nella configurazione per istanza associata alla VM, node-12, nel MIG example-cluster.
2. Rimuove i metadati logging:elaborate dalla configurazione per istanza perché il valore fornito è null.

L'aggiornamento della configurazione non è stato ancora applicato all'istanza VM node-12. L'aggiornamento della configurazione verrà applicato alla successiva ricreazione o al successivo aggiornamento dell'istanza, oppure se utilizzi l'aggiornamento automatico proattivo.

Per applicare l'aggiornamento della configurazione per istanza all'istanza VM node-12, chiama il metodo instanceGroupManagers.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:

1. Imposta i metadati mode:standby in base alla configurazione per istanza.
2. Imposta i metadati logging:basic dal modello di istanza perché il valore della chiave logging non è più definito dalla configurazione per istanza.
3. La VM continua a funzionare durante l'aggiornamento perché minimalAction è impostato su NONE, il che consente al MIG di utilizzare l'azione meno invasiva richiesta per l'aggiornamento. Un aggiornamento dei metadati di un'istanza richiede l'azione REFRESH, che non interrompe un'istanza in esecuzione.