Application, affichage et suppression d'une configuration avec état dans les groupes d'instances gérés

Après avoir créé ou mis à jour une configuration avec état pour un groupe d'instances géré (MIG) avec état, vous pouvez :

• appliquer la configuration avec état pour qu'elle soit prise en compte ;
• afficher la configuration avec état, ainsi que l'état préservé effectif de vos instances gérées ;
• supprimer la configuration avec état.

Avant de commencer

• Revoyez les pages expliquant dans quels cas utiliser des MIG avec état et le fonctionnement des MIG avec état.
• Si ce n'est pas déjà fait, configurez l'authentification. L'authentification est le processus permettant de valider votre identité pour accéder aux services et aux API Google Cloud. Pour exécuter du code ou des exemples depuis un environnement de développement local, vous pouvez vous authentifier auprès de Compute Engine en sélectionnant l'une des options suivantes:
  

  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

  Pour utiliser les exemples d'API REST de cette page dans un environnement de développement local, vous devez utiliser les identifiants que vous fournissez à gcloud CLI.

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

  gcloud init

  Pour en savoir plus, consultez la section S'authentifier pour utiliser REST dans la documentation sur l'authentification Google Cloud.

Appliquer une configuration avec état aux instances gérées

Votre configuration avec état devient effective après que vous ou le MIG l'avez appliquée.

• Les modifications de configuration d'une règle avec état sont automatiquement appliquées à toutes les instances gérées.
• Les modifications d'une configuration par instance peuvent être appliquées manuellement ou automatiquement.

Pour obtenir plus d'informations conceptuelles, consultez la page Comment la configuration avec état est appliquée aux instances gérées.

Appliquer la configuration à partir d'une règle avec état

Toutes les modifications de configuration d'une règle avec état sont automatiquement appliquées à toutes les instances gérées. Les mises à jour d'une règle avec état n'interrompent pas l'exécution des instances de machine virtuelle (VM).

Vérifier si une règle avec état a été appliquée

Vérifier toutes les VM

Vérifiez si les modifications apportées à une règle avec état ont été appliquées à toutes les VM en vérifiant si le MIG est devenu stable après les modifications.

Vérifier des VM spécifiques

Vérifiez si les modifications apportées à la règle avec état ont été appliquées à une VM spécifique dans un MIG. Pour cela, affichez l'état préservé de l'instance gérée et vérifiez si tous les disques de la règle avec état sont présents dans preservedStateFromPolicy ou preservedStateFromConfig pour l'instance gérée.

Appliquer une configuration avec état à partir de configurations par instance

L'application de nouvelles configurations par instance, ou de configurations par instance mises à jour, peut s'effectuer manuellement ou automatiquement. Vous allez utiliser l'une des approches suivantes :

• Appliquer de manière sélective des configurations mises à jour à des instances spécifiques : cette approche permet de contrôler la perturbation, la planification et la séquence des mises à jour.
• Appliquer automatiquement les configurations mises à jour avec des mises à jour progressives : utilisez cette approche pour appliquer les modifications de configuration aux instances gérées de manière progressive et automatisée.

Ces deux méthodes appliquent les mises à jour en attente au niveau des configurations par instance et des champs versions ou instanceTemplate, le cas échéant.

Appliquer de manière sélective une configuration mise à jour à des instances spécifiques

Pour appliquer manuellement des configurations par instance à des instances spécifiques, procédez comme suit :

1. Configurez une règle de mise à jour opportuniste afin d'éviter tout conflit avec les mises à jour proactives automatiques.
2. Créer ou mettre à jour les configurations par instance
3. Appliquez les configurations mises à jour à des VM spécifiques en mettant à jour de manière sélective ces VM.

Vous pouvez également utiliser les approches suivantes :

• Lors de la création ou de la mise à jour d'une configuration par instance avec gcloud CLI, utilisez l'option --update-instance pour appliquer immédiatement la configuration à l'instance gérée associée.
• Lorsque vous créez manuellement des instances, spécifiez leurs noms et configurations par instance au moment de la création. Le MIG applique immédiatement les configurations lors de la création de la VM.

Appliquer automatiquement une configuration mise à jour avec des mises à jour progressives

Configurez des mises à jour progressives proactives pour que votre MIG applique automatiquement les mises à jour de configuration aux instances gérées correspondantes, de manière progressive.

Les MIG avec état nécessitent la configuration suivante pour une règle de mise à jour proactive :

• Vous devez définir la méthode de remplacement sur RECREATE.
• Vous devez définir la surutilisation maximale sur 0.
• Pour les MIG régionaux, vous devez désactiver la redistribution proactive des instances entre les zones.

Cette configuration garantit que le MIG recrée les instances avec état existantes et ne les remplace pas par des instances différentes.

Vous pouvez également vous assurer que les modifications apportées aux configurations par instance sont appliquées sans arrêter d'instances, si possible, en définissant l'action minimale sur REFRESH dans la stratégie de mise à jour du groupe.

Vérifier si des configurations par instance ont été appliquées

Vérifier toutes les configurations par instance

Pour vérifier si toutes les configurations par instance d'un MIG ont été appliquées, affichez l'état du MIG et vérifiez la définition du champ status.stateful.perInstanceConfigs.allEffective :

• true : toutes les configurations par instance du groupe ont été appliquées et sont effectives, ou le groupe ne dispose d'aucune configuration par instance.
• false : le groupe comporte au moins une configuration par instance qui n'est pas encore effective : vous ne l'avez pas encore appliquée ou elle est en cours d'application.

Vérifier une configuration par instance spécifique

Pour vérifier si les modifications d'une configuration par instance spécifique ont été appliquées à la VM correspondante, affichez toutes les configurations par instance et vérifiez le champ status de la configuration par instance concernée :

• UNAPPLIED : la configuration par instance a été créée ou mise à jour et vous devez l'appliquer à la VM avec une mise à jour manuelle de l'instance.
• APPLYING : le MIG applique actuellement à la VM la nouvelle configuration par instance, ou celle mise à jour.
• EFFECTIVE : la configuration par instance a bien été appliquée à la VM et est effective.
• UNAPPLIED_DELETION : la configuration par instance est définie pour être supprimée. Vous devez appliquer cette mise à jour à la VM avec une mise à jour manuelle de l'instance pour qu'elle soit prise en compte.
• DELETING : la configuration par instance est en cours de suppression et la modification est appliquée à la VM.

Afficher la configuration avec état et l'état préservé

Obtenez des informations sur vos MIG avec état pour les tâches suivantes :

• Vérifier si un MIG dispose d'une configuration avec état et si cette configuration est appliquée et efficace.
• Afficher la configuration avec état, commune à toutes les instances du MIG, stockée dans la règle avec état.
• Afficher la configuration avec état spécifique à des instances individuelles, stockée dans des configurations par instance, et vérifier si cette configuration est appliquée et efficace.
• Afficher l'état préservé effectif de chaque instance dans un MIG basé sur sa règle avec état et les configurations par instance appliquées.

Afficher l'état de la configuration avec état d'un MIG

Un MIG est considéré comme avec état s'il possède une configuration avec état, c'est-à-dire soit une règle avec état, soit au moins une configuration par instance non vide.

Si vous créez une règle avec état, le MIG l'applique automatiquement pour la rendre effective. Si vous créez des configurations par instance, vous pouvez décider de les appliquer ultérieurement.

Pour vérifier si un MIG dispose d'une configuration avec état et si toutes les configurations par instance sont appliquées, affichez l'état du MIG à l'aide de gcloud CLI ou de 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,
  ...
}

Afficher la règle avec état d'un MIG

Affichez les règles avec état d'un MIG en vérifiant les détails du groupe à l'aide de la console Google Cloud, de gcloud CLI ou de 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,
  ...
}

Afficher les configurations par instance d'un MIG

Affichez les configurations par instance en répertoriant toutes les configurations par instance d'un MIG. Utilisez gcloud CLI ou REST.

Si vous décidez d'appliquer manuellement des configurations par instance, certaines configurations par instance peuvent ne pas encore être appliquées aux instances associées. Par conséquent, les états préservés des instances peuvent ne pas refléter vos configurations par instance. Pour plus d'informations, consultez les sections Appliquer des configurations par instance et Vérifier si des configurations par instance ont été appliquées.

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" : {
        ...
      }
      ...
    },
    ...
  ]
}

Afficher les états préservés des instances gérées

Lorsque la configuration avec état est appliquée, le MIG génère et définit l'état préservé effectif de chaque instance gérée dans deux champs :

• preservedStateFromPolicy : contient l'état préservé généré sur la base d'une règle avec état, à l'exclusion de toute configuration avec état remplacée par des configurations par instance.
• preservedStateFromConfig : contient l'état préservé généré sur la base d'une configuration par instance déjà appliquée à l'instance gérée.

Pour voir l'état préservé effectif de chaque instance gérée dans un MIG, répertoriez les instances gérées en utilisant gcloud CLI ou de 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": {
        ...
      }
    },
    ...
  ]
}

Afficher les ressources d'adresse IP statique associées

Pour récupérer les adresses IP statiques (ressources Address) attribuées aux instances gérées d'un MIG, affichez les états préservés de ces instances. Vous pouvez afficher les adresses statiques dans les champs ipAddress.address.

Si un MIG ou les instances n'existent plus, mais que les réservations d'adresses IP existent toujours, vous pouvez répertorier les réservations d'adresses internes ou externes.

Supprimer la configuration avec état

La suppression de la configuration avec état est utile dans les scénarios suivants :

• Vous avez migré des VM autonomes vers un MIG avec état et souhaitez maintenant déplacer la configuration avec état des configurations par instance vers une règle avec état commune.
• Vous avez redéfini l'architecture de votre charge de travail et n'avez plus besoin de conserver un état sur les instances de VM.
• Vous avez créé une configuration avec état à des fins de test et vous souhaitez maintenant la nettoyer.

Cette section explique comment supprimer complètement une règle avec état sur une configuration par instance. Si vous ne devez supprimer qu'un sous-ensemble d'une règle avec état ou d'une configuration par instance, consultez les sections suivantes :

• Déclarer des disques persistants avec état comme étant sans état pour toutes les VM d'un MIG.
• Déclarer des interfaces réseau précédemment avec état comme étant sans état pour toutes les VM d'un MIG.
• Dissocier un disque avec état ou le déclarer sans état pour une VM spécifique dans un MIG.
• Supprimer des métadonnées avec état d'une VM spécifique dans un MIG
• Dissocier une adresse IP statique d'une VM spécifique dans un MIG.

Supprimer une règle avec état

Lorsque vous supprimez une règle avec état, vous affectez toutes les VM d'un MIG. Le MIG traite toutes les ressources avec état configurées dans la règle avec état comme étant sans état, sauf si elles sont également configurées dans des configurations par instance pour des instances individuelles. Lors d'opérations de recréation, d'autoréparation ou de mise à jour d'instances ultérieures, les ressources désormais sans état peuvent perdre leur état :

• Les disques peuvent être supprimés et recréés à partir de la source, qui est définie dans le modèle d'instance.
• Les adresses IP peuvent changer.

Pour en savoir plus, consultez la section Comment la suppression d'une ressource d'une règle avec état affecte l'état préservé.

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
}

Supprimer une configuration avec état pour une VM spécifique

La suppression de la configuration avec état pour une VM spécifique s'effectue en deux étapes :

1. Supprimer la configuration par instance associée.
2. Appliquer la modification à l'instance gérée. Vous pouvez choisir d'appliquer la modification manuellement ou automatiquement.

Une fois la modification appliquée, tous les éléments avec état précédemment configurés dans la configuration par instance sont désormais considérés comme sans état, sauf s'ils sont également configurés dans la règle avec état du groupe. Lorsque la VM est ensuite recréée ou mise à jour, l'état des éléments est perdu :

• Les disques peuvent être dissociés ou recréés à partir de leur source dans le modèle d'instance.
• Les métadonnées sont supprimées ou réinitialisées sur les valeurs définies dans le modèle d'instance.
• Les adresses IP peuvent changer.

Pour plus d'informations, consultez la section En quoi la suppression des éléments des configurations par instance affecte l'état préservé.

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"]
}

Votre avis

Nous souhaitons en savoir plus sur vos cas d'utilisation, les défis que vous rencontrez ou vos impressions sur les MIG avec état. Nous vous invitons à nous faire part de vos commentaires à l'adresse suivante : mig-discuss@google.com.

Étape suivante

• Configurez un MIG avec état.
• Obtenez des informations sur un MIG spécifique et ses instances gérées, y compris l'état et les propriétés de la VM.
• Apprenez-en plus sur les MIG avec état.
• Apprenez-en plus sur les MIG et l'utilisation d'instances gérées.