Appliquer de manière sélective les mises à jour de configuration de VM dans un MIG

Ce document explique comment appliquer de manière sélective des mises à jour de configuration aux instances de machine virtuelle (VM) d'un groupe d'instances géré (MIG).

Compute Engine gère les VM d'un MIG en fonction des composants de configuration que vous utilisez : modèle d'instance, configuration facultative sur toutes les instances et configuration avec état facultative.

Chaque fois que vous mettez à jour la configuration des VM d'un MIG en modifiant ces composants, Compute Engine applique automatiquement votre configuration mise à jour aux nouvelles VM ajoutées au groupe.

Pour appliquer une nouvelle configuration aux VM existantes, vous pouvez configurer une mise à jour sélective, également appelée "mise à jour opportuniste". Ce type de mise à jour offre les avantages suivants :

• Vous pouvez choisir les VM que vous souhaitez mettre à jour.
• Vous pouvez contrôler la planification et la séquence des mises à jour.
• Vous pouvez utiliser la gcloud CLI ou REST pour mettre à jour immédiatement toutes les VM.

Si vous souhaitez automatiser le déploiement d'une nouvelle configuration sur l'ensemble des VM d'un MIG ou sur un sous-ensemble aléatoire, consultez la page Appliquer automatiquement les mises à jour de configuration de VM dans un MIG. Pour vous aider à faire votre choix, consultez la section Méthodes pour appliquer une nouvelle configuration aux VM existantes.

Avant de commencer

• 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 comme suit :
  

  Sélectionnez l'onglet correspondant à la façon dont vous prévoyez d'utiliser les exemples de cette page :

  Console

  Lorsque vous utilisez la console Google Cloud pour accéder aux services et aux API Google Cloud, vous n'avez pas besoin de configurer l'authentification.

  gcloud

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

     gcloud init

  2. Définissez une région et une zone par défaut.

  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

Appliquer une nouvelle configuration à des VM sélectionnées

Assurez-vous que le type de règle de mise à jour de votre groupe est défini sur "Quand l'occasion se présente" pour empêcher le MIG d'appliquer automatiquement une nouvelle configuration de VM aux VM existantes. Pour en savoir plus, consultez la section Vérifier le type de règle de mise à jour de votre groupe.

Utilisez ensuite la gcloud CLI ou REST pour mettre à jour la configuration de votre MIG et appliquer la configuration la plus récente à des VM spécifiques ou à l'ensemble des VM du groupe.

gcloud compute instance-groups managed set-instance-template INSTANCE_GROUP_NAME \
    --template=INSTANCE_TEMPLATE

gcloud compute instance-groups managed update-instances INSTANCE_GROUP_NAME \
    --instances INSTANCE_NAMES \
    --most-disruptive-allowed-action DISRUPTION_LEVEL \
    --minimal-action DISRUPTION_LEVEL

gcloud compute instance-groups managed update-instances INSTANCE_GROUP_NAME \
    --all-instances \
    --most-disruptive-allowed-action DISRUPTION_LEVEL \
    --minimal-action DISRUPTION_LEVEL

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME

{
  "updatePolicy": {
    "type": "OPPORTUNISTIC"
  },
  "versions": [{
    "instanceTemplate": "global/instanceTemplates/NEW_TEMPLATE",
  }]
}

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": DISRUPTION_LEVEL,
  "mostDisruptiveAllowedAction": DISRUPTION_LEVEL
}

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME/applyUpdatesToInstances
{
  "allInstances": true,
  "minimalAction": DISRUPTION_LEVEL,
  "mostDisruptiveAllowedAction": DISRUPTION_LEVEL
}

Après avoir effectué une requête, vous pouvez en vérifier l'état pour savoir si la mise à jour est terminée.

Contrôler le niveau de perturbation lors des mises à jour sélectives

Selon la nature de la mise à jour, l'état d'une instance peut être perturbé. Par exemple, la modification du disque de démarrage d'une instance nécessite le remplacement de l'instance. Vous pouvez contrôler le niveau de perturbation pendant une mise à jour sélective en définissant les options suivantes :

• Action minimale : utilisez cette option pour minimiser autant d'interruptions que possible ou appliquer une action plus perturbatrice que nécessaire.

  • Pour limiter autant les interruptions que possible, définissez l'action minimale sur NONE. Si votre mise à jour nécessite une action plus perturbatrice, Compute Engine effectue l'action nécessaire à l'exécution de la mise à jour.
  • Pour appliquer une action plus perturbatrice que nécessaire, définissez l'action minimale sur RESTART ou REPLACE. Par exemple, Compute Engine n'a pas besoin de redémarrer une VM pour modifier ses métadonnées. Toutefois, si votre application ne lit les métadonnées d'instance que lorsqu'une VM redémarre, vous pouvez définir l'action minimale sur RESTART afin de récupérer les modifications de métadonnées.

• Action la plus perturbatrice autorisée : utilisez cette option pour empêcher une mise à jour si elle nécessite plus de perturbations que ce que vous pouvez vous permettre. Si votre mise à jour nécessite une action plus perturbatrice que celle définie à l'aide de cet indicateur, la demande de mise à jour échoue. Par exemple, si vous définissez l'action la plus perturbatrice autorisée sur RESTART, la tentative de mise à jour de l'image de disque de démarrage échoue, car cette mise à jour nécessite une recréation de l'instance, une action plus perturbatrice qu'un redémarrage.

Lors de la mise à jour des VM sélectionnées, ces deux options acceptent les valeurs suivantes :

Remarque : L'action autorisée la plus perturbatrice ne peut pas entraîner moins de perturbations que l'action minimale.

Lorsque vous mettez à jour des VM de manière sélective, les valeurs par défaut suivantes s'appliquent :

• L'action minimale par défaut est NONE, ce qui limite le moins possible les interruptions.
• L'action la plus perturbatrice autorisée par défaut est REPLACE. Si vous ne pouvez pas tolérer de telles perturbations, définissez l'action la plus perturbatrice autorisée pour qu'elle soit moins perturbatrice.

Étapes suivantes

• Pour en savoir plus, consultez la page Afficher les informations sur les MIG et les VM gérées.
• Découvrez comment créer des modèles d'instance.
• Découvrez comment utiliser les familles d'images et un remplacement progressif pour mettre à jour l'image du système d'exploitation sur toutes les VM d'un MIG.