Applicazione, visualizzazione e rimozione della configurazione stateful nei gruppi di istanze gestite

Dopo aver creato o aggiornato una configurazione stateful per un gruppo di istanze gestite stateful (MIG), puoi:

• Applica della configurazione stateful per applicare il filtro.
• Visualizza lo stato così come lo stato conservato effettivo delle istanze gestite.
• Rimuovi la configurazione stateful.

Prima di iniziare

• Rivedi quando utilizzare i MIG stateful e come funzionano i MIG stateful.
• Se non l'hai già fatto, configura l'autenticazione. Autenticazione è Il processo di verifica dell'identità per l'accesso ai servizi e alle API di Google Cloud. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi eseguire l'autenticazione Compute Engine come segue.
  

  Select the tab for how you plan to use the samples on this page:

  Console

  When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

  gcloud

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

     gcloud init

  2. Set a default region and zone.

  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.

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

  gcloud init

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

Applicazione della configurazione stateful alle istanze gestite

La configurazione stateful diventa effettiva dopo l'applicazione da parte tua o del gruppo di istanze gestite.

• Le modifiche alla configurazione in un criterio stateful vengono applicate automaticamente a tutte le istanze gestite.
• Le modifiche alla configurazione in una configurazione per istanza possono essere applicate manualmente o automaticamente.

Per informazioni più concettuali, leggi Modalità di applicazione della configurazione stateful alle istanze gestite.

Applicazione della configurazione da un criterio stateful

Tutte le modifiche alla configurazione in un criterio stateful vengono applicate automaticamente tutte le istanze gestite. Gli aggiornamenti a un criterio stateful non interrompono l'esecuzione di macchine virtuali (VM).

Verifica dell'applicazione di un criterio stateful

Verifica di tutte le VM

Verifica se le modifiche a un criterio stateful sono state applicate a tutti VM controllando se il gruppo di istanze gestite è diventato stabile dopo le modifiche.

Verifica di VM specifiche

Verificare se le modifiche a un criterio stateful sono state applicate a una specifica VM in un gruppo di istanze gestite visualizzare lo stato conservato dell'istanza gestita e controllare se tutti i dischi del criterio stateful sono presenti in preservedStateFromPolicy o preservedStateFromConfig per l'istanza gestita.

Applicazione della configurazione stateful dalle configurazioni per istanza

Puoi applicare configurazioni per istanza nuove o aggiornate in modo manuale o automaticamente. Utilizza uno dei seguenti approcci:

• Applica le configurazioni aggiornate selettivamente a istanze specifiche: utilizza questa opzione per controllare l'interruzione, la tempistica e la sequenza delle aggiornamenti.
• Applica automaticamente le configurazioni aggiornate con gli aggiornamenti in sequenza: utilizza questo approccio per applicare modifiche alla configurazione automatizzata e continuativa.

Entrambi i metodi applicano aggiornamenti in sospeso da entrambi i metodi per istanza configurazioni e versioni o un modello di istanza, se pertinente.

Applicare la configurazione aggiornata in modo selettivo a istanze specifiche

Per applicare manualmente le configurazioni per istanza a istanze specifiche, utilizza seguenti passaggi:

1. Configura un norme relative all'aggiornamento opportunità grazie agli aggiornamenti proattivi automatici.
2. Crea o aggiorna le configurazioni per istanza.
3. Applica le configurazioni aggiornate a VM specifiche aggiornando in modo selettivo queste VM.

In alternativa, puoi utilizzare i seguenti approcci:

• Quando crei o aggiorni una configurazione per istanza con gcloud CLI, utilizza il flag --update-instance per applicare immediatamente la configurazione all'istanza gestita associata.
• Quando crea manualmente le nuove istanze, specifica dei nomi e delle configurazioni per istanza al momento della creazione. Il gruppo di istanze gestite si applica immediatamente al momento della creazione della VM.

Applica automaticamente la configurazione aggiornata con gli aggiornamenti in sequenza

Configura aggiornamenti in sequenza proattivi affinché il gruppo di istanze gestite applichi automaticamente gli aggiornamenti della configurazione le istanze gestite in modo continuativo.

I MIG stateful richiedono la seguente configurazione per un criterio di aggiornamento proattivo:

• Devi impostare il parametro metodo di sostituzione a RECREATE.
• Devi impostare Incremento massimo a 0.
• Per i gruppi di istanze gestite a livello di regione, devi disattivare la ridistribuzione proattiva delle istanze tra le zone.

Questa configurazione assicura che il gruppo di istanze gestite ricrea le istanze stateful esistenti e non li sostituisce con altri.

Puoi anche fare in modo che le modifiche alle configurazioni per istanza vengano applicate senza arrestare le istanze, se possibile, impostando minima azione a REFRESH nel criterio di aggiornamento del gruppo.

Verifica dell'applicazione delle configurazioni per istanza in corso...

Verifica di tutte le configurazioni per istanza

Per verificare se tutte le configurazioni per istanza in un gruppo di istanze gestite sono state applicate, visualizza lo stato stateful del gruppo di istanze gestite e controlla status.stateful.perInstanceConfigs.allEffective:

• true: tutte le configurazioni per istanza nel gruppo sono state applicate e sono efficace oppure il gruppo non ha configurazioni per istanza.
• false: il gruppo ha almeno una configurazione per istanza che non è ancora efficace: non ancora applicata o in fase di in fase di applicazione.

Verifica di una configurazione per istanza specifica

Per verificare se le modifiche a una configurazione per istanza specifica sono state applicate la VM corrispondente, visualizza tutte le configurazioni per istanza e controlla il campo status della configurazione per istanza specifica:

• UNAPPLIED: la configurazione per istanza è stata creata o aggiornata. Devi eseguire e applicarla alla VM con un aggiornamento manuale dell'istanza.
• APPLYING: il gruppo di istanze gestite al momento sta applicando il nuovo o aggiornato per istanza configurazione alla VM.
• EFFECTIVE: la configurazione per istanza è stata applicata correttamente all'account una VM ed è efficace.
• UNAPPLIED_DELETION: la configurazione per istanza è impostata per essere eliminata. Tu devi applicare questo aggiornamento alla VM con un aggiornamento manuale dell'istanza hanno effetto.
• DELETING: la configurazione per istanza viene eliminata e la modifica viene applicata alla VM.

Visualizzazione della configurazione stateful e dello stato conservato

Visualizza informazioni sui tuoi gruppi di istanze gestite stateful per le seguenti attività:

• Verificare se un gruppo di istanze gestite ha configurazione stateful e se questa configurazione è applicata ed efficace.
• Visualizzazione della configurazione stateful comune a tutte le istanze nel gruppo di istanze gestite, archiviato nel criterio stateful.
• Visualizzazione della configurazione stateful specifica per le singole istanze, memorizzata nelle configurazioni per istanza, e verifica dell'applicazione e dell'efficacia di questa configurazione.
• Visualizzazione dell'effetto stato di conservazione per ogni istanza in un gruppo di istanze gestite in base al criterio stateful e configurazioni per istanza.

Visualizzazione dello stato della configurazione stateful di un gruppo di istanze gestite

Un gruppo di istanze gestite è considerato stateful se presenta configurazione stateful, cioè un criterio stateful o almeno una configurazione per istanza non vuota.

Se crei un criterio stateful, il gruppo di istanze gestite lo applica automaticamente per renderlo efficace. Se crei configurazioni per istanza, decidere per applicarli in un secondo momento.

a verificare se un gruppo di istanze gestite ha una configurazione stateful e che tutto questo per istanza vengono applicate, visualizza lo stato stateful del gruppo di istanze gestite utilizzando con gcloud CLI o REST.

gcloud compute instance-groups managed describe NAME

baseInstanceName node
...
name example-group
...
status:
  isStable: true
  stateful:
    hasStatefulConfig: true
    perInstanceConfigs:
      allEffective: true
  versionTarget:
    isReached: true
targetSize: 3
...

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/NAME

{
  "name": "example-group",
  "baseInstanceName": "node",
  ...
  "status": {
    "isStable": true,
    "stateful": {
      "hasStatefulConfig": true,
      "perInstanceConfigs": {
        "allEffective": true
      }
    },
    "versionTarget": {
      "isReached": true
    }
  },
  "targetSize": 3,
  ...
}

Visualizzazione del criterio stateful di un gruppo di istanze gestite

Visualizza un gruppo di istanze gestite norme stateful controllando i dettagli del gruppo con la console Google Cloud, gcloud CLI o REST.

gcloud compute instance-groups managed describe NAME

baseInstanceName node
...
name example-group
...
statefulPolicy:
  preservedState:
    disks:
      data-disk:
        autoDelete: NEVER
      logs-disk:
        autoDelete: ON_PERMANENT_INSTANCE_DELETION
    internalIPs:
      nic0:
        autoDelete: ON_PERMANENT_INSTANCE_DELETION
    externalIPs:
      nic0:
        autoDelete: NEVER
status:
  isStable: true
  stateful:
    hasStatefulConfig: true
    perInstanceConfigs:
      allEffective: true
  versionTarget:
    isReached: true
targetSize: 3
...

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/NAME

{
  "name": "example-group",
  "baseInstanceName": "node",
  ...
  "status": {
      "isStable": true,
      "versionTarget": {
        "isReached": true
      },
      "stateful": {
        "hasStatefulConfig": true,
        "perInstanceConfigs": {
          "allEffective": true
        }
      }
  ...
  "statefulPolicy": {
    "preservedState": {
      "disks": {
        "data-disk": { "autoDelete": "NEVER" },
        "logs-disk": { "autoDelete": "ON_PERMANENT_INSTANCE_DELETION" }
      },
      "internalIPs": {
         "nic0" : { "autoDelete": "ON_PERMANENT_INSTANCE_DELETION"}
      },
      "externalIPs": {
         "nic0" : { "autoDelete": "NEVER"}
      },
    }
  },
  "targetSize": 3,
  ...
}

Visualizzazione delle configurazioni per istanza di un gruppo di istanze gestite

Visualizza le configurazioni per istanza elencando tutte le configurazioni per istanza in un gruppo di istanze gestite Utilizza gcloud CLI o REST.

Se decidi di applicare manualmente le configurazioni per istanza, alcune configurazioni per istanza potrebbero non essere ancora alle istanze associate e, di conseguenza, lo stato conservato potrebbero non riflettere ancora le tue configurazioni per istanza. Per ulteriori informazioni, consulta Applicare configurazioni per istanza e Verificare se sono state applicate configurazioni per istanza.

gcloud compute instance-groups managed instance-configs list NAME

gcloud compute instance-groups managed instance-configs list example-group
---
fingerprint: JxPvsKOywuY=
name: node-1
preservedState:
  disks:
    data-disk:
      autoDelete: NEVER
      mode: rw
      source: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-east1-c/disks/data-disk-1
  metadata:
    role: primary
  internalIPs:
    nic0:
      ipAddress:
        address: /projects/example-project/regions/us-east1/addresses/node-1-int-ip
      autoDelete: ON_PERMANENT_INSTANCE_DELETION
  externalIPs:
    nic0:
      ipAddress:
        literal: 130.211.181.55
      autoDelete: NEVER
status: EFFECTIVE
---
fingerprint: IbGmJBqqEkk=
name: node-2
preservedState:
...

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/NAME/listPerInstanceConfigs

POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-east1-c/instanceGroupManagers/example-group/listPerInstanceConfigs

{
  "items": [
    {
      "fingerprint": "JxPvsKOywuY=",
      "name": "node-1",
      "preservedState" : {
        "disks": {
          "data-disk" : {
            "source": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-east1-c/disks/data-disk-1",
            "mode": "READ_WRITE",
            "autoDelete": "NEVER"
          }
        },
        "metadata": {
          "role": "primary"
        },
        "internalIPs": {
         "nic0" : {
           "ipAddress" : {
             "address":  "/projects/example-project/regions/us-east1/addresses/node-1-int-ip"
           },
           "autoDelete": "ON_PERMANENT_INSTANCE_DELETION"
         }
        },
        "externalIPs": {
         "nic0": {
           "ipAddress" : {
             "literal": "54.2.3.4"
           },
           "autoDelete": "NEVER"
         }
        }
      },
      "status": "EFFECTIVE"
    },
    {
      "fingerprint": "IbGmJBqqEkk=",
      "name": "node-2",
      "preservedState" : {
        ...
      }
      ...
    },
    ...
  ]
}

Visualizzazione degli stati preservati delle istanze gestite

Se la configurazione stateful è applicato, il gruppo di istanze gestite genera e imposta l'effettivo stato di conservazione di ogni in due campi:

• preservedStateFromPolicy: contiene lo stato conservato generato in base a un criterio stateful, esclusa qualsiasi configurazione stateful sostituita dalle configurazioni per istanza.
• preservedStateFromConfig: contiene lo stato conservato generato in base a una configurazione per istanza già applicata all'istanza gestita.

Per vedere l'efficacia stato di conservazione di ciascuna istanza gestita in un gruppo di istanze gestite, elenca le istanze gestite utilizzando con gcloud CLI o REST.

gcloud compute instance-groups managed list-instances NAME

NAME    ZONE        STATUS   HEALTH_STATE  ACTION  PRESERVED_STATE  INSTANCE_TEMPLATE  ...
node-1  us-east1-c  RUNNING                NONE    POLICY,CONFIG    example-template
node-2  us-east1-c  RUNNING                NONE    POLICY,CONFIG    example-template

gcloud compute instance-groups managed describe-instance INSTANCE_GROUP_NAME \
  --instance INSTANCE_NAME

gcloud compute instance-groups managed describe-instance example-group \
  --instance node-1
instance: .../example-project/zones/us-east1-c/instances/node-1
instanceStatus: RUNNING
currentAction: NONE
id: 123456789012345678
version:
  instanceTemplate: .../example-project/global/instanceTemplates/example-template
preservedStateFromPolicy:
  disks:
    data-disk:
      autoDelete: NEVER
      mode: rw
      source: .../example-project/zones/us-east1-c/disks/data-disk-1
    internalIPs:
      nic0:
        ipAddress:
          literal: 10.0.0.1
          address: .../example-project/regions/us-east1/addresses/node-1-int-ip
        autoDelete: ON_PERMANENT_INSTANCE_DELETION
preservedStateFromConfig:
  metadata:
    role: primary
    my-key: my-value
  externalIPs:
    nic0:
      ipAddress:
        literal: 130.211.181.55
        address: .../example-project/regions/us-east1/addresses/node-1-nat-ip
      autoDelete: NEVER

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/NAME/listManagedInstances

{
  "managedInstances": [
    {
      "instance": ".../example-project/zones/us-east1-c/instances/node-1",
      "instanceStatus": "RUNNING",
      "currentAction": "NONE",
      "id": "123456789012345678",
      "version": {
         "instanceTemplate":".../example-project/global/instanceTemplates/example-template"
      },
      "preservedStateFromPolicy": {
        "disks": {
          "data-disk" : {
            "source": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-east1-c/disks/data-disk-1",
            "mode": "rw",
            "autoDelete": "NEVER"
          },
        },
        "internalIPs": {
          "nic0" : {
            "ipAddress": {
              "literal": "10.0.0.1",
              "address":  "/projects/example-project/regions/us-east1/addresses/node-1-int-ip"
            },
            "autoDelete": "ON_PERMANENT_INSTANCE_DELETION"
          }
        },
      },
      "preservedStateFromConfig": {
        "metadata": {
          "role": "primary",
          "my-key": "my-value"
        },
        "externalIPs": {
          "nic0": {
            "ipAddress": {
              "literal": "130.211.181.55",
              "address":  "/projects/example-project/regions/us-east1/addresses/node-1-nat-ip"
            },
            "autoDelete": "NEVER"
          }
        },
      }
    },
    {
      "instance": ".../example-project/zones/us-east1-c/instances/node-2",
      "instanceStatus": "RUNNING",
      ...
      "preservedStateFromPolicy": {
        ...
      },
      "preservedStateFromConfig": {
        ...
      }
    },
    ...
  ]
}

Visualizzazione delle risorse degli indirizzi IP statici associati

Per recuperare gli indirizzi IP statici (Address risorse) assegnate a istanze gestite in un gruppo di istanze gestite, visualizzare gli stati conservati di queste istanze. Puoi vedere gli indirizzi statici in ipAddress.address campi.

Se un gruppo di istanze gestite o le istanze non esistono più, ma le prenotazioni degli indirizzi IP esiste ancora, puoi elencare le interno o prenotazioni di indirizzi esterni.

Rimozione della configurazione stateful in corso...

La rimozione della configurazione stateful è utile nei seguenti scenari:

• Hai migrato delle VM autonome in un gruppo di istanze gestite stateful e ora vogliono spostare configurazione per istanza a un criterio stateful comune.
• Hai riprogettato l'architettura del tuo carico di lavoro e non devi più mantenere alcuno stato sulle istanze VM.
• Hai creato una configurazione stateful a scopo di test e ora vuoi per ripulirla.

Questa sezione descrive come rimuovere completamente un criterio con stato in una configurazione per istanza. Se devi solo rimuovere un sottoinsieme di un criterio stateful o di un'istanza configurazione, consulta le sezioni seguenti:

• Dichiarazione di dischi permanenti stateful precedentemente stateful come stateless per tutte le VM in un gruppo di istanze gestite.
• Dichiarare come stateless le interfacce di rete precedentemente stateful per tutte le VM in un gruppo di istanze gestite.
• Scollegare un disco stateful o dichiararlo stateless per una VM specifica in un gruppo di istanze gestite.
• Rimozione dei metadati stateful da una VM specifica in un MIG
• Disassociazione di un indirizzo IP statico da una VM specifica in un gruppo di istanze gestite.

Rimozione di un criterio stateful

La rimozione di un criterio stateful influisce su tutte le VM in un gruppo di istanze gestite. Il MIG tratta tutte le risorse stateful configurate nel criterio stateful come stateless, a meno che queste risorse non siano anche configurate in configurazioni per istanza le singole istanze. Nelle successive ricreazione, riparazione automatica o aggiornamento delle istanze operazioni, le risorse ora stateless possono perdere il proprio stato:

• I dischi possono essere eliminati e ricreati dall'origine, definita nel modello di istanza.
• Gli indirizzi IP potrebbero cambiare.

Per informazioni concettuali, vedi come la rimozione di una risorsa dal criterio stateful influisce sullo stato conservato.

gcloud compute instance-groups managed update example-group \
    --zone us-east1-c \
    --remove-stateful-disks data-disk,logs-disk \
    --remove-stateful-internal-ips nic0 \
    --remove-stateful-external-ips nic0

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/NAME

{
  "statefulPolicy": null
}

Rimozione della configurazione stateful per una VM specifica

La rimozione della configurazione stateful per una VM specifica viene eseguita in due passaggi:

1. Elimina la configurazione per istanza associata.
2. Applica la modifica all'istanza gestita. Puoi scegliere se utilizzare la modifica deve essere applicata manualmente o automaticamente.

Una volta applicata la modifica, tutti gli elementi stateful configurati in precedenza nella configurazione per istanza vengono ora trattati come stateless, a meno che non configurato nel criterio stateful del gruppo. Quando la VM viene successivamente rielaborata o aggiornata, lo stato degli elementi viene perso:

• I dischi possono essere scollegati o ricreati dalla loro origine nell'istanza modello.
• I metadati vengono rimossi o reimpostati sui valori definiti nel modello di istanza.
• Gli indirizzi IP potrebbero cambiare.

Per ulteriori informazioni, consulta in che modo la rimozione di elementi dalle configurazioni per istanza influisce sullo stato preservato.

gcloud compute instance-groups managed instance-configs delete INSTANCE_GROUP_NAME \
  --instances INSTANCE_NAME[,INSTANCE_NAME,...] \
  [--no-update-instance | --update-instance] \
  [--instance-update-minimal-action MINIMAL_ACTION]

gcloud compute instance-groups managed instance-configs delete example-group \
  --instances node-1 \
  --update-instance

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME/deletePerInstanceConfigs

{
  "names": ["INSTANCE_NAME",...]
}

POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-east1-c/instanceGroupManagers/example-group/deletePerInstanceConfigs

{
  "names": ["node-1"]
}

POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-east1-c/instanceGroupManagers/example-group/applyUpdatesToInstances

{
  "instances": ["/zones/us-east1-c/instances/node-1"]
}

Feedback

Vogliamo conoscere i tuoi casi d'uso, le sfide e il feedback sulla gruppi di istanze gestite. Condividi il tuo feedback con il nostro team all'indirizzo [email protected].

Passaggi successivi

• Configura un gruppo di istanze gestite stateful.
• Ottieni informazioni su di un gruppo di istanze gestite specifico e delle relative istanze gestite, inclusi stato e proprietà della VM.
• Scopri di più sui MIG stateful.
• Scopri di più sui MIG e sull'utilizzo di istanze gestite.