Ce document explique comment configurer votre MIG pour appliquer le dernier modèle d'instance et les configurations par instance lors de la recréation d'une VM pendant des opérations de réparation. L'application de la dernière configuration disponible lors d'une opération de réparation est également appelée mise à jour lors des réparations. Ce document explique également comment vérifier si la mise à jour lors des réparations est activée dans votre MIG et comment la désactiver.
Par défaut, lors d'une réparation, un MIG recrée une VM à l'aide de la même configuration d'instance que celle utilisée initialement pour créer la VM. Si des mises à jour du modèle d'instance du groupe ou des configurations par instance sont disponibles, vous avez la possibilité d'appliquer ces modifications à une VM en cours de réparation.
Si vous souhaitez appliquer automatiquement des mises à jour de configuration à toutes les VM ou à un ensemble de VM (PROACTIVE
), ou mettre à jour de manière sélective des instances spécifiques (OPPORTUNISTIC
), consultez la section Appliquer de nouvelles configurations aux VM dans un MIG.
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 Trusted Cloud by S3NS .
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 Trusted Cloud console to access Trusted Cloud by S3NS services and APIs, you don't need to set up authentication.
gcloud
-
Installez la Google Cloud CLI, puis connectez-vous-y avec votre identité fédérée. Après vous être connecté, initialisez la Google Cloud CLI en exécutant la commande suivante :
gcloud init
- Set a default region and zone.
REST
Pour utiliser les exemples API REST de cette page dans un environnement de développement local, vous devez utiliser les identifiants que vous fournissez à la gcloud CLI.
Installez la Google Cloud CLI, puis connectez-vous-y avec votre identité fédérée. Après vous être connecté, initialisez la Google Cloud CLI en exécutant la commande suivante :
gcloud init
Pour en savoir plus, consultez la section S'authentifier pour utiliser REST dans la documentation sur l'authentification Trusted Cloud .
Configurer la mise à jour lors de la réparation
Pour configurer la mise à jour lors de la réparation, utilisez la console Trusted Cloud , gcloud CLI ou REST.
Console
Dans la console Trusted Cloud , accédez à la page Groupes d'instances.
Cliquez sur le nom du MIG pour lequel vous souhaitez configurer la mise à jour lors de la réparation.
Cliquez sur Modifier pour modifier le MIG.
Cliquez sur Cycle de vie et autoréparation des instances pour développer la section.
Dans la section Mises à jour lors de la réparation des instances de VM, sélectionnez Mettre à jour la configuration de l'instance.
Cliquez sur Enregistrer.
gcloud
Pour un MIG existant, utilisez la commande
update
:gcloud compute instance-groups managed update MIG_NAME \ --force-update-on-repair
Pour un nouveau MIG, utilisez la commande
create
:gcloud compute instance-groups managed create MIG_NAME \ --template INSTANCE_TEMPLATE_URL_ \ --size SIZE \ --force-update-on-repair
Remplacez les éléments suivants :
MIG_NAME
: nom du groupe d'instances.INSTANCE_TEMPLATE_URL
: URL du modèle d'instance que vous souhaitez utiliser pour créer des VM dans le MIG. L'URL peut contenir l'ID ou le nom du modèle d'instance. Spécifiez l'une des valeurs suivantes :- Pour un modèle d'instance régional :
projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_ID
- Pour un modèle d'instance global :
INSTANCE_TEMPLATE_ID
- Pour un modèle d'instance régional :
SIZE
: taille cible du groupe d'instances.
REST
Pour un MIG zonal existant, utilisez la méthode
instanceGroupManagers.patch
ou, pour un MIG régional existant, la méthoderegionInstanceGroupManagers.patch
.Effectuez l'appel suivant pour configurer la mise à jour lors de la réparation dans un MIG zonal existant :
PATCH https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME { "instanceLifecyclePolicy": { "forceUpdateOnRepair": YES } }
Pour un nouveau MIG zonal, utilisez la méthode
instanceGroupManagers.insert
ou, pour un nouveau MIG régional, la méthoderegionInstanceGroupManagers.insert
.Effectuez l'appel suivant pour configurer la mise à jour lors de la réparation lorsque vous créez un MIG zonal :
POST https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers { "name": "MIG_NAME", "instanceTemplate": "INSTANCE_TEMPLATE_URL", "targetSize": SIZE, "instanceLifecyclePolicy": { "forceUpdateOnRepair": YES } }
Remplacez les éléments suivants :
PROJECT_ID
: l'ID de votre projet.ZONE
: zone où se trouve le MIG.MIG_NAME
: nom du groupe d'instances.INSTANCE_TEMPLATE_URL
: URL du modèle d'instance que vous souhaitez utiliser pour créer des VM dans le MIG. L'URL peut contenir l'ID ou le nom du modèle d'instance. Spécifiez l'une des valeurs suivantes :- Pour un modèle d'instance régional :
projects/PROJECT_ID/regions/REGION/instanceTemplates/INSTANCE_TEMPLATE_ID
- Pour un modèle d'instance global :
INSTANCE_TEMPLATE_ID
- Pour un modèle d'instance régional :
SIZE
: taille cible du groupe d'instances.
Vérifier si la mise à jour lors de la réparation est activée
Par défaut, un MIG ne met pas à jour une VM lors d'une réparation. Pour vérifier si la mise à jour lors de la réparation est activée pour votre MIG, utilisez la console Trusted Cloud , gcloud CLI ou REST pour afficher la configuration de la mise à jour lors de la réparation.
Console
Dans la console Trusted Cloud , accédez à la page Groupes d'instances.
Cliquez sur le nom du MIG dont vous souhaitez vérifier la configuration.
Cliquez sur l'onglet Détails.
Dans la section Cycle de vie des instances de VM, cochez l'option Mises à jour lors de la réparation de l'instance de VM. Si le champ affiche Mettre à jour la configuration de l'instance, la mise à jour lors de la réparation est activée.
gcloud
Utilisez la commande commande
describe
comme suit :gcloud compute instance-groups managed describe MIG_NAME \ --format="(instanceLifecyclePolicy)"
Dans le corps de la réponse, recherchez le champ
forceUpdateOnRepair
, qui possède l'une des valeurs suivantes :NO
: valeur par défaut. Le MIG ne met pas à jour les VM lors de leur réparation.YES
: le MIG met à jour les VM lors de leur réparation.
Voici un exemple de résultat :
instanceLifecyclePolicy: forceUpdateOnRepair: YES
REST
Pour un MIG zonal, utilisez la méthode
instanceGroupManagers.get
ou, pour un MIG régional, la méthoderegionInstanceGroupManagers.get
.Par exemple, dans un MIG zonal, exécutez la commande suivante :
GET https://compute.s3nsapis.fr/compute/v1/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME
Dans le corps de la réponse, recherchez le champ
instanceLifecyclePolicy.forceUpdateOnRepair
, qui contient l'une des valeurs suivantes :NO
: valeur par défaut. Le MIG ne met pas à jour les VM lors de leur réparation.YES
: le MIG met à jour les VM lors de leur réparation.
Voici un exemple de réponse :
{ ... "name": "example-mig", "targetSize": 12, ... "instanceLifecyclePolicy": { "forceUpdateOnRepair": "YES" }, ... }
Remplacez les éléments suivants :
PROJECT_ID
: l'ID de votre projet.ZONE
: zone où se trouve le MIG.MIG_NAME
: nom du groupe d'instances.
Désactiver la mise à jour lors de la réparation
Lorsque votre MIG répare une VM, si vous souhaitez qu'il utilise le modèle d'instance d'origine ou les configurations par instance utilisées pour créer la VM, vous devez désactiver la mise à jour lors de la réparation. Par défaut, la mise à jour lors de la réparation est désactivée pour un MIG.
Utilisez la console Trusted Cloud , gcloud CLI ou REST pour désactiver la mise à jour lors de la réparation.
Console
Dans la console Trusted Cloud , accédez à la page Groupes d'instances.
Cliquez sur le nom du MIG pour lequel vous souhaitez désactiver la mise à jour lors de la réparation.
Cliquez sur Modifier pour modifier le MIG.
Cliquez sur Cycle de vie et autoréparation des instances pour développer la section.
Dans la section Mises à jour lors de la réparation des instances de VM, sélectionnez Conserver la même configuration d'instance.
Cliquez sur Enregistrer.
gcloud
Exécutez la commande
update
pour définir l'option--no-force-update-on-repair
comme suit :gcloud compute instance-groups managed update MIG_NAME \ --no-force-update-on-repair
REST
Pour un MIG zonal, utilisez la méthode
instanceGroupManagers.patch
ou, pour un MIG régional, la méthoderegionInstanceGroupManagers.patch
.Par exemple, pour désactiver la mise à jour lors de la réparation d'un MIG zonal, exécutez la commande suivante :
PATCH https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME { "instanceLifecyclePolicy": { "forceUpdateOnRepair": NO } }
Remplacez les éléments suivants :
PROJECT_ID
: l'ID de votre projet.ZONE
: zone où se trouve le MIG.MIG_NAME
: nom du groupe d'instances.
Étapes suivantes
- Configurez la vérification d'état et l'autoréparation d'une application.
- Si vous avez configuré une vérification d'état basée sur l'application pour votre MIG, surveillez les changements d'état des VM.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/19 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/08/19 (UTC)."],[[["\u003cp\u003eThis document explains how to configure and manage "update on repair" for Managed Instance Groups (MIGs), which allows applying the latest instance template and per-instance configurations when a VM is recreated during repair operations.\u003c/p\u003e\n"],["\u003cp\u003eBy default, MIGs use the original instance configuration during VM repair, but "update on repair" allows you to apply available updates to the instance template or per-instance configurations.\u003c/p\u003e\n"],["\u003cp\u003eYou can enable or disable "update on repair" for a MIG using the Google Cloud console, gcloud CLI, or REST API, with gcloud commands and REST calls provided for both new and existing MIGs.\u003c/p\u003e\n"],["\u003cp\u003eThe document provides detailed instructions on how to check whether "update on repair" is enabled, using the console, gcloud CLI (with the \u003ccode\u003edescribe\u003c/code\u003e command), and REST API, with examples of the expected output.\u003c/p\u003e\n"],["\u003cp\u003eIf "update on repair" is enabled and the MIG update policy is \u003ccode\u003ePROACTIVE\u003c/code\u003e, then the \u003ccode\u003emaxUnavailable\u003c/code\u003e setting will be disregarded during update on repair.\u003c/p\u003e\n"]]],[],null,[]] -