Définir la stratégie de maintenance de l'hôte pour une instance Compute

Console

1. Dans la console Google Cloud , accédez à la page Instances de VM.

   Accéder à la page Instances de VM

2. Dans la colonne Nom, cliquez sur le nom de l'instance que vous souhaitez mettre à jour. Une page contenant les détails de l'instance s'affiche.

3. Cliquez sur edit Modifier. Une page vous permettant de modifier les propriétés de l'instance s'affiche.

4. Dans la section Gestion, vous pouvez effectuer l'une ou plusieurs des opérations suivantes:

   • Pour modifier le comportement lors des événements de maintenance, sélectionnez une autre option dans la liste Pendant la maintenance de l'hôte.

   • Pour modifier la période d'expiration avant le redémarrage d'une instance qui ne répond pas, sélectionnez une autre option dans la liste Délai avant expiration de l'erreur de l'hôte.

   • Pour choisir de redémarrer ou non l'instance après des erreurs d'hôte ou des arrêts programmés, sélectionnez une autre option dans la liste Redémarrage automatique.

5. Cliquez sur Enregistrer.

gcloud

Pour modifier la stratégie de maintenance de l'hôte dans une instance existante, exécutez la commande gcloud compute instances set-scheduling avec une ou plusieurs des options suivantes:

• Pour modifier le comportement de maintenance de l'hôte, incluez l'option --maintenance-policy.

• Pour modifier le comportement de redémarrage automatique, effectuez l'une des opérations suivantes:

  • Pour redémarrer automatiquement l'instance, incluez l'option --restart-on-failure.

  • Pour empêcher la réinitialisation automatique de l'instance, incluez l'indicateur --no-restart-on-failure.

• Pour modifier le délai avant expiration de la récupération des données du disque SSD local si des disques SSD locaux sont associés à votre instance, incluez l'indicateur --local-ssd-recovery-timeout.

• Pour modifier le délai avant expiration de l'erreur de l'hôte, incluez l'option --host-error-timeout-seconds.

Par exemple, pour modifier le comportement de maintenance de l'hôte, redémarrer automatiquement l'instance après des erreurs d'hôte ou des arrêts programmés, modifier le délai avant expiration de la récupération des données des SSD locaux et modifier le délai avant expiration de l'erreur de l'hôte, exécutez la commande suivante:

gcloud compute instances set-scheduling INSTANCE_NAME \
    --host-error-timeout-seconds=ERROR_DETECTION_TIMEOUT \
    --local-ssd-recovery-timeout=LOCAL_SSD_RECOVERY_TIMEOUT \
    --maintenance-policy=MAINTENANCE_POLICY \
    --restart-on-failure \
    --zone=ZONE

Remplacez les éléments suivants :

• INSTANCE_NAME : nom de votre instance.

• ERROR_DETECTION_TIMEOUT: nombre de secondes avant que Compute Engine ne redémarre une instance qui ne répond pas. La valeur doit être comprise entre 90 (90 secondes) et 330 (330 secondes, soit 5 minutes et 30 secondes). Seuls les incréments de 30 secondes sont autorisés.

• MAINTENANCE_POLICY: comportement de maintenance de l'instance. La valeur peut être TERMINATE ou MIGRATE.

• LOCAL_SSD_RECOVERY_TIMEOUT: nombre d'heures à consacrer à la récupération des données des disques SSD locaux associés. La valeur doit être comprise entre 0 (0 heures) et 168 (168 heures, soit 7 jours). Si vous définissez ce champ sur 0, Compute Engine ne récupère pas les données des disques SSD locaux.

• ZONE: zone où se trouve votre instance.

REST

Pour modifier la stratégie de maintenance de l'hôte dans une instance existante, envoyez une requête POST à la méthode instances.setScheduling. Dans le corps de la requête, incluez un ou plusieurs des champs suivants:

• Pour modifier le comportement de maintenance de l'hôte, incluez le champ onHostMaintenance.

• Pour modifier le comportement de redémarrage automatique, effectuez l'une des opérations suivantes:

  • Pour redémarrer automatiquement l'instance, incluez le champ automaticRestart.

  • Pour empêcher la réinitialisation automatique de l'instance, incluez le champ automaticRestart.

• Pour modifier le délai avant expiration de la récupération des données de disque SSD local si des disques SSD locaux sont associés à votre instance, incluez le champ localSsdRecoveryTimeout.

• Pour modifier le délai avant expiration des erreurs de l'hôte, incluez le champ hostErrorTimeoutSeconds.

Par exemple, pour modifier le comportement de maintenance de l'hôte, redémarrer automatiquement l'instance après des erreurs d'hôte ou des arrêts programmés, modifier le délai avant expiration de récupération des données SSD locales et modifier le délai avant expiration d'erreur de l'hôte, effectuez une requête comme suit:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/setScheduling

{
  "automaticRestart": AUTOMATIC_RESTART,
  "hostErrorTimeoutSeconds": ERROR_DETECTION_TIMEOUT,
  "localSsdRecoveryTimeout": LOCAL_SSD_RECOVERY_TIMEOUT,
  "onHostMaintenance": "MAINTENANCE_POLICY"
}

Remplacez les éléments suivants :

• PROJECT_ID: ID du projet dans lequel se trouve votre instance.

• ZONE: zone où se trouve votre instance.

• INSTANCE_NAME : nom de votre instance.

• AUTOMATIC_RESTART: comportement de redémarrage automatique de l'instance en cas de plantage ou d'arrêt programmé par Compute Engine. Spécifiez une des valeurs suivantes :

  • Pour permettre à Compute Engine de redémarrer automatiquement votre instance : true

  • Pour empêcher les redémarrages automatiques: false

• ERROR_DETECTION_TIMEOUT: nombre de secondes avant le redémarrage d'une instance qui ne répond pas. La valeur doit être comprise entre 90 (90 secondes) et 330 (330 secondes, soit 5 minutes et 30 secondes). Seuls les incréments de 30 secondes sont autorisés.

• LOCAL_SSD_RECOVERY_TIMEOUT: nombre d'heures à consacrer à la récupération des données des disques SSD locaux associés. La valeur doit être comprise entre 0 (0 heures) et 168 (168 heures, soit 7 jours). Si vous définissez ce champ sur 0, Compute Engine ne récupère pas les données des disques SSD locaux.

• MAINTENANCE_POLICY: comportement de maintenance de l'instance. La valeur peut être TERMINATE ou MIGRATE.

Console

1. Dans la console Google Cloud , accédez à la page Créer une instance.

   Accéder à la page Créer une instance

2. Dans le champ Nom, saisissez un nom pour l'instance.

3. Dans les champs Région et Zone, indiquez la région et la zone dans lesquelles créer l'instance.

4. Spécifiez le type de machine pour l'instance.

5. Dans le menu de navigation, cliquez sur Avancé.

6. Dans la section Modèle de provisionnement, développez Paramètres avancés du modèle de provisionnement de VM, puis effectuez une ou plusieurs des opérations suivantes:

   • Pour définir le comportement pendant les événements de maintenance, dans la liste Pendant la maintenance de l'hôte, sélectionnez l'une des options suivantes:

     • Pour migrer l'instance lors des événements de maintenance de l'hôte, sélectionnez Migrer l'instance de VM (recommandé).

     • Pour arrêter l'instance lors des événements de maintenance de l'hôte, sélectionnez Arrêter l'instance de VM.

   • Pour définir la période avant le redémarrage d'une instance qui ne répond pas, dans la liste Délai avant expiration de l'erreur de l'hôte, sélectionnez l'une des options suivantes:

     • Pour ne pas spécifier de délai avant expiration d'erreur de l'hôte, sélectionnez Non spécifié (par défaut).

     • Pour spécifier un délai avant expiration d'erreur de l'hôte, sélectionnez l'une des options disponibles, jusqu'à 5 minutes et 30 secondes.

   • Pour définir si l'instance doit redémarrer en cas de plantage ou d'arrêt, dans la liste Redémarrage automatique, sélectionnez l'une des options suivantes:

     • Pour redémarrer automatiquement l'instance après des erreurs d'hôte ou des arrêts programmés, sélectionnez Activé (recommandé).

     • Pour empêcher l'instance de redémarrer automatiquement après des erreurs d'hôte ou des arrêts programmés, sélectionnez Désactivé.

7. Cliquez sur Créer.

gcloud

Pour définir la stratégie de maintenance de l'hôte d'une instance lors de sa création, exécutez la commande gcloud compute instances create avec une ou plusieurs des options suivantes:

• Pour définir le comportement de maintenance de l'hôte, incluez l'option --maintenance-policy.

• Pour définir le comportement de redémarrage automatique, procédez comme suit:

  • Pour redémarrer automatiquement l'instance, incluez l'option --restart-on-failure.

  • Pour empêcher la réinitialisation automatique de l'instance, incluez l'indicateur --no-restart-on-failure.

• Pour définir un délai avant expiration de la récupération des données de SSD locaux si des disques SSD locaux sont associés à votre instance, incluez l'indicateur --local-ssd-recovery-timeout.

• Pour définir un délai avant expiration d'erreur de l'hôte, incluez l'indicateur --host-error-timeout-seconds.

Par exemple, pour définir le comportement de maintenance de l'hôte, redémarrer automatiquement l'instance après des erreurs d'hôte ou des arrêts programmés, définir un délai avant expiration de récupération des données SSD locales et définir un délai avant expiration d'erreur d'hôte, exécutez la commande suivante:

gcloud compute instances create INSTANCE_NAME \
    --host-error-timeout-seconds=ERROR_DETECTION_TIMEOUT \
    --local-ssd-recovery-timeout=LOCAL_SSD_RECOVERY_TIMEOUT \
    --machine-type=MACHINE_TYPE \
    --maintenance-policy=MAINTENANCE_POLICY \
    --restart-on-failure \
    --zone=ZONE

Remplacez les éléments suivants :

• INSTANCE_NAME : nom de l'instance.

• ERROR_DETECTION_TIMEOUT: nombre de secondes avant le redémarrage d'une instance qui ne répond pas. La valeur doit être comprise entre 90 (90 secondes) et 330 (330 secondes, soit 5 minutes et 30 secondes). Seuls les incréments de 30 secondes sont autorisés.

• LOCAL_SSD_RECOVERY_TIMEOUT: nombre d'heures à consacrer à la récupération des données des disques SSD locaux associés. La valeur doit être comprise entre 0 (0 heures) et 168 (168 heures, soit 7 jours). Si vous définissez ce champ sur 0, Compute Engine ne récupère pas les données des disques SSD locaux.

• MACHINE_TYPE : type de machine à utiliser.

• MAINTENANCE_POLICY: comportement de maintenance de l'instance. La valeur peut être TERMINATE ou MIGRATE. Si vous créez une VM Spot, une VM préemptive ou une instance qui n'est pas compatible avec la migration à chaud, vous ne pouvez utiliser que TERMINATE.

• ZONE: zone dans laquelle créer l'instance.

REST

Pour définir la stratégie de maintenance de l'hôte d'une instance lors de sa création, envoyez une requête POST à la méthode instances.insert. Dans le corps de la requête, incluez un ou plusieurs des champs suivants dans le champ scheduling:

• Pour définir le comportement de maintenance de l'hôte, incluez le champ onHostMaintenance.

• Pour définir le comportement de redémarrage automatique, procédez comme suit:

  • Pour redémarrer automatiquement l'instance, incluez le champ automaticRestart.

  • Pour empêcher la réinitialisation automatique de l'instance, incluez le champ automaticRestart.

• Pour définir un délai avant expiration de la récupération des données de SSD locaux si des disques SSD locaux sont associés à votre instance, incluez le champ localSsdRecoveryTimeout.

• Pour définir un délai avant expiration d'erreur de l'hôte, incluez le champ hostErrorTimeoutSeconds.

Par exemple, pour définir le comportement de maintenance de l'hôte, redémarrer automatiquement l'instance après des erreurs d'hôte ou des arrêts programmés, définir un délai avant expiration de récupération de données SSD local et définir un délai avant expiration d'erreur d'hôte, envoyez une requête comme suit:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances

{
  "name": "INSTANCE_NAME",
  "machineType": "zones/ZONE/machineTypes/MACHINE_TYPE",
  "disks": [
    {
      "boot": true,
      "initializeParams": {
        "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
      }
    }
  ],
  "networkInterfaces": [
    {
      "network": "global/networks/default"
    }
  ],
  "scheduling": {
    "automaticRestart": AUTOMATIC_RESTART,
    "hostErrorTimeoutSeconds": ERROR_DETECTION_TIMEOUT,
    "localSsdRecoveryTimeout": LOCAL_SSD_RECOVERY_TIMEOUT,
    "onHostMaintenance": "MAINTENANCE_POLICY"
  }
}

Remplacez les éléments suivants :

• PROJECT_ID: ID du projet dans lequel créer l'instance.

• ZONE: zone dans laquelle créer l'instance.

• INSTANCE_NAME : nom de l'instance.

• MACHINE_TYPE : type de machine à utiliser.

• IMAGE_PROJECT : projet contenant l'image, par exemple, debian-cloud. Pour en savoir plus sur les projets d'image compatibles, consultez la page Images publiques.

• IMAGE : spécifiez l'une des options suivantes :

  • Version spécifique de l'image de l'OS. Exemple : debian-12-bookworm-v20240617

  • Une famille d'images, qui doit être au format family/IMAGE_FAMILY. Cela permet de spécifier l'image d'OS non obsolète la plus récente. Par exemple, si vous spécifiez family/debian-12, la dernière version de la famille d'images Debian 12 est utilisée. Pour en savoir plus sur l'utilisation des familles d'images, consultez la page Bonnes pratiques concernant les familles d'images.

• AUTOMATIC_RESTART: comportement de redémarrage automatique de l'instance en cas de plantage ou d'arrêt programmé par Compute Engine. Spécifiez une des valeurs suivantes :

  • Pour permettre à Compute Engine de redémarrer automatiquement votre instance : true

  • Pour empêcher les redémarrages automatiques: false

• ERROR_DETECTION_TIMEOUT: nombre de secondes avant le redémarrage d'une instance qui ne répond pas. La valeur doit être comprise entre 90 (90 secondes) et 330 (330 secondes, soit 5 minutes et 30 secondes). Seuls les incréments de 30 secondes sont autorisés.

• LOCAL_SSD_RECOVERY_TIMEOUT: nombre d'heures à consacrer à la récupération des données à partir des disques SSD locaux associés. La valeur doit être comprise entre 0 (0 heure) et 168 (168 heures, soit 7 jours). Si vous définissez ce champ sur 0, Compute Engine ne récupère pas les données des disques SSD locaux.

• MAINTENANCE_POLICY: comportement de maintenance de l'instance. La valeur peut être TERMINATE ou MIGRATE. Si vous créez une VM spot ou une instance qui n'est pas compatible avec la migration à chaud, vous ne pouvez utiliser que TERMINATE.

gcloud

Pour définir la stratégie de maintenance de l'hôte lors de la création d'instances groupées, exécutez la commande gcloud compute instances bulk create avec une ou plusieurs des options suivantes:

• Pour définir le comportement de maintenance de l'hôte, incluez l'option --maintenance-policy.

• Pour définir le comportement de redémarrage automatique, procédez comme suit:

  • Pour redémarrer automatiquement l'instance, incluez l'option --restart-on-failure.

  • Pour empêcher la réinitialisation automatique de l'instance, incluez l'indicateur --no-restart-on-failure.

• Pour définir un délai avant expiration de la récupération des données de SSD locaux si des disques SSD locaux sont associés à votre instance, incluez l'indicateur --local-ssd-recovery-timeout.

• Pour définir un délai avant expiration d'erreur de l'hôte, incluez l'indicateur --host-error-timeout-seconds.

Par exemple, pour définir le comportement de maintenance de l'hôte, redémarrer automatiquement l'instance après des erreurs d'hôte ou des arrêts programmés, définir un délai avant expiration de récupération de données SSD local et définir un délai avant expiration d'erreur d'hôte, exécutez la commande suivante. L'exemple suivant crée également des instances dans une seule zone et spécifie un format de nom pour les instances:

gcloud compute instances bulk create \
    --count=COUNT \
    --host-error-timeout-seconds=ERROR_DETECTION_TIMEOUT \
    --local-ssd-recovery-timeout=LOCAL_SSD_RECOVERY_TIMEOUT \
    --machine-type=MACHINE_TYPE \
    --maintenance-policy=MAINTENANCE_POLICY \
    --name-pattern=NAME_PATTERN \
    --restart-on-failure \
    --zone=ZONE

Remplacez les éléments suivants :

• COUNT: nombre d'instances à créer.

• ERROR_DETECTION_TIMEOUT: nombre de secondes avant le redémarrage d'une instance qui ne répond pas. La valeur doit être comprise entre 90 (90 secondes) et 330 (330 secondes, soit 5 minutes et 30 secondes). Seuls les incréments de 30 secondes sont autorisés.

• LOCAL_SSD_RECOVERY_TIMEOUT: nombre d'heures à consacrer à la récupération des données des disques SSD locaux associés. La valeur doit être comprise entre 0 (0 heures) et 168 (168 heures, soit 7 jours). Si vous définissez ce champ sur 0, Compute Engine ne récupère pas les données des disques SSD locaux.

• MACHINE_TYPE : type de machine à utiliser.

• MAINTENANCE_POLICY: comportement de maintenance des instances. La valeur peut être TERMINATE ou MIGRATE. Si vous créez des VM Spot, des VM préemptives ou des instances qui ne sont pas compatibles avec la migration à chaud, vous ne pouvez utiliser que TERMINATE.

• NAME_PATTERN: modèle de nom des instances. Pour remplacer une séquence de nombres dans un nom d'instance, utilisez une séquence de caractères de hachage (#). Par exemple, le modèle de nom instance-# génère des instances dont les noms commencent par instance-1, instance-2, etc., jusqu'au nombre d'instances spécifié par COUNT.

• ZONE: zone dans laquelle créer les instances.

REST

Pour définir la stratégie de maintenance de l'hôte lors de la création d'instances de manière groupée, envoyez une requête POST à la méthode instances.bulkInsert. Dans le corps de la requête, incluez un ou plusieurs des champs suivants dans le champ scheduling:

• Pour définir le comportement de maintenance de l'hôte, incluez le champ onHostMaintenance.

• Pour définir le comportement de redémarrage automatique, procédez comme suit:

  • Pour redémarrer automatiquement l'instance, incluez le champ automaticRestart.

  • Pour empêcher la réinitialisation automatique de l'instance, incluez le champ automaticRestart.

• Pour définir un délai avant expiration de la récupération des données de SSD locaux si des disques SSD locaux sont associés à votre instance, incluez le champ localSsdRecoveryTimeout.

• Pour définir un délai avant expiration d'erreur de l'hôte, incluez le champ hostErrorTimeoutSeconds.

Par exemple, pour définir le comportement de maintenance de l'hôte, redémarrer automatiquement l'instance après des erreurs d'hôte ou des arrêts programmés, définir un délai avant expiration de récupération des données des SSD locaux et définir un délai avant expiration d'erreur de l'hôte, envoyez une requête comme suit. L'exemple suivant crée également des instances dans une seule zone et spécifie un format de nom pour les instances:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/bulkInsert

{
  "count": COUNT,
  "namePattern": "NAME_PATTERN",
  "instanceProperties": {
    "machineType": "MACHINE_TYPE",
    "disks": [
      {
        "boot": true,
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        }
      }
    ],
    "networkInterfaces": [
      {
        "network": "global/networks/default"
      }
    ],
    "scheduling": {
      "automaticRestart": AUTOMATIC_RESTART,
      "hostErrorTimeoutSeconds": ERROR_DETECTION_TIMEOUT,
      "localSsdRecoveryTimeout": LOCAL_SSD_RECOVERY_TIMEOUT,
      "onHostMaintenance": "MAINTENANCE_POLICY"
    }
  }
}

Remplacez les éléments suivants :

• PROJECT_ID: ID du projet dans lequel créer les instances.

• ZONE: zone dans laquelle créer les instances.

• COUNT: nombre d'instances à créer.

• NAME_PATTERN: modèle de nom des instances. Pour remplacer une séquence de nombres dans un nom d'instance, utilisez une séquence de caractères de hachage (#). Par exemple, le modèle de nom instance-# génère des instances dont les noms commencent par instance-1, instance-2, etc., jusqu'au nombre d'instances spécifié par COUNT.

• MACHINE_TYPE : type de machine à utiliser.

• IMAGE_PROJECT : projet contenant l'image, par exemple, debian-cloud. Pour en savoir plus sur les projets d'image compatibles, consultez la page Images publiques.

• IMAGE : spécifiez l'une des options suivantes :

  • Version spécifique de l'image de l'OS. Exemple : debian-12-bookworm-v20240617

  • Une famille d'images, qui doit être au format family/IMAGE_FAMILY. Cela permet de spécifier l'image d'OS non obsolète la plus récente. Par exemple, si vous spécifiez family/debian-12, la dernière version de la famille d'images Debian 12 est utilisée. Pour en savoir plus sur l'utilisation des familles d'images, consultez la page Bonnes pratiques concernant les familles d'images.

• AUTOMATIC_RESTART: comportement de redémarrage automatique de l'instance en cas de plantage ou d'arrêt programmé par Compute Engine. Spécifiez une des valeurs suivantes :

  • Pour permettre à Compute Engine de redémarrer automatiquement votre instance : true

  • Pour empêcher les redémarrages automatiques: false

• ERROR_DETECTION_TIMEOUT: nombre de secondes avant le redémarrage d'une instance qui ne répond pas. La valeur doit être comprise entre 90 (90 secondes) et 330 (330 secondes, soit 5 minutes et 30 secondes). Seuls les incréments de 30 secondes sont autorisés.

• LOCAL_SSD_RECOVERY_TIMEOUT: nombre d'heures à consacrer à la récupération des données à partir des disques SSD locaux associés. La valeur doit être comprise entre 0 (0 heure) et 168 (168 heures, soit 7 jours). Si vous définissez ce champ sur 0, Compute Engine ne récupère pas les données des disques SSD locaux.

• MAINTENANCE_POLICY: comportement de maintenance des instances. La valeur peut être TERMINATE ou MIGRATE. Si vous créez des VM Spot, des VM préemptives ou des instances qui ne sont pas compatibles avec la migration à chaud, vous ne pouvez utiliser que TERMINATE.

Console

1. Dans la console Google Cloud , accédez à la page Modèles d'instances.

   Accéder à la page "Modèles d'instances"

2. Cliquez sur Créer un modèle d'instance. La page Créer un modèle d'instance s'affiche.

3. Dans le champ Nom, saisissez un nom pour le modèle d'instance.

4. Dans la section Emplacement, sélectionnez l'une des options suivantes :

   • Pour créer un modèle d'instance régional, sélectionnez Régional (recommandé), puis sélectionnez la région dans laquelle créer le modèle.

   • Pour créer un modèle d'instance global, sélectionnez Global.

5. Dans la section Configuration de la machine, spécifiez le type de machine pour le modèle d'instance.

6. Dans la section Modèle de provisionnement, développez Paramètres avancés du modèle de provisionnement de VM, puis effectuez une ou plusieurs des opérations suivantes:

   • Pour modifier le comportement lors des événements de maintenance, dans la liste Pendant la maintenance de l'hôte, sélectionnez l'une des options suivantes:

     • Pour migrer l'instance lors des événements de maintenance de l'hôte, sélectionnez Migrer l'instance de VM (recommandé).

     • Pour arrêter l'instance lors des événements de maintenance de l'hôte, sélectionnez Arrêter l'instance de VM.

   • Pour modifier la période avant le redémarrage d'une instance qui ne répond pas, dans la liste Host error timeout (Délai avant expiration de l'erreur de l'hôte), sélectionnez l'une des options suivantes:

     • Pour ne pas spécifier de délai avant expiration d'erreur de l'hôte, sélectionnez Non spécifié (par défaut).

     • Pour spécifier un délai avant expiration d'erreur de l'hôte, sélectionnez l'une des options disponibles, jusqu'à 5 minutes et 30 secondes.

   • Pour indiquer si l'instance doit redémarrer en cas de plantage ou d'arrêt, dans la liste Redémarrage automatique, sélectionnez l'une des options suivantes:

     • Pour redémarrer automatiquement l'instance après des erreurs d'hôte ou des arrêts programmés, sélectionnez Activé (recommandé).

     • Pour empêcher l'instance de redémarrer automatiquement après des erreurs d'hôte ou des arrêts programmés, sélectionnez Désactivé.

7. Cliquez sur Créer.

gcloud

Pour définir la stratégie de maintenance de l'hôte lors de la création d'un modèle d'instance, exécutez la commande gcloud compute instance-templates create avec une ou plusieurs des options suivantes:

• Pour définir le comportement de maintenance de l'hôte, incluez le champ onHostMaintenance.

• Pour définir le comportement de redémarrage automatique, procédez comme suit:

  • Pour redémarrer automatiquement l'instance, incluez le champ automaticRestart.

  • Pour empêcher la réinitialisation automatique de l'instance, incluez le champ automaticRestart.

• Pour définir un délai avant expiration de la récupération des données de SSD locaux si des disques SSD locaux sont associés à votre instance, incluez le champ localSsdRecoveryTimeout.

• Pour définir un délai avant expiration d'erreur de l'hôte, incluez le champ hostErrorTimeoutSeconds.

Par exemple, pour définir le comportement de maintenance de l'hôte, redémarrer automatiquement l'instance après des erreurs d'hôte ou des arrêts programmés, définir un délai avant expiration de récupération de données SSD local et définir un délai avant expiration d'erreur d'hôte, exécutez la commande suivante. L'exemple suivant crée également un modèle d'instance régional. Pour créer un modèle d'instance global, utilisez la même commande sans l'option --instance-template-region.

gcloud compute instance-templates create INSTANCE_TEMPLATE_NAME \
    --host-error-timeout-seconds=ERROR_DETECTION_TIMEOUT \
    --instance-template-region=REGION \
    --local-ssd-recovery-timeout=LOCAL_SSD_RECOVERY_TIMEOUT \
    --machine-type=MACHINE_TYPE \
    --maintenance-policy=MAINTENANCE_POLICY \
    --restart-on-failure

Remplacez les éléments suivants :

• INSTANCE_TEMPLATE_NAME : nom du modèle d'instance.

• ERROR_DETECTION_TIMEOUT: nombre de secondes avant le redémarrage d'une instance qui ne répond pas. La valeur doit être comprise entre 90 (90 secondes) et 330 (330 secondes, soit 5 minutes et 30 secondes). Seuls les incréments de 30 secondes sont autorisés.

• REGION: région dans laquelle créer le modèle d'instance.

• LOCAL_SSD_RECOVERY_TIMEOUT: nombre d'heures à consacrer à la récupération des données des disques SSD locaux associés. La valeur doit être comprise entre 0 (0 heures) et 168 (168 heures, soit 7 jours). Si vous définissez ce champ sur 0, Compute Engine ne récupère pas les données des disques SSD locaux.

• MACHINE_TYPE : type de machine à utiliser.

• MAINTENANCE_POLICY: comportement de maintenance des instances. La valeur peut être TERMINATE ou MIGRATE. Si vous spécifiez une VM Spot, une VM préemptive ou un type d'instance qui n'est pas compatible avec la migration à chaud dans le modèle d'instance, vous ne pouvez utiliser que TERMINATE.

REST

Pour définir la stratégie de maintenance de l'hôte lors de la création d'un modèle d'instance, envoyez une requête POST à l'une des méthodes suivantes:

• Pour créer un modèle d'instance régional : méthode regionInstanceTemplates.insert

• Pour créer un modèle d'instance global : méthode instanceTemplates.insert

Dans le corps de la requête, incluez un ou plusieurs des champs suivants dans le champ scheduling:

• Pour définir le comportement de maintenance de l'hôte, incluez le champ onHostMaintenance.

• Pour définir le comportement de redémarrage automatique, procédez comme suit:

  • Pour redémarrer automatiquement l'instance, incluez le champ automaticRestart.

  • Pour empêcher la réinitialisation automatique de l'instance, incluez le champ automaticRestart.

• Pour définir un délai avant expiration de la récupération des données de SSD locaux si des disques SSD locaux sont associés à votre instance, incluez le champ localSsdRecoveryTimeout.

• Pour définir un délai avant expiration d'erreur de l'hôte, incluez le champ hostErrorTimeoutSeconds.

Par exemple, pour définir le comportement de maintenance de l'hôte, redémarrer automatiquement l'instance après des erreurs d'hôte ou des arrêts programmés, définir un délai avant expiration de récupération des données de SSD local et définir un délai avant expiration d'erreur d'hôte, envoyez une requête comme suit. L'exemple suivant crée également un modèle d'instance régional.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceTemplates

{
  "name": "INSTANCE_TEMPLATE_NAME",
  "properties": {
    "disks": [
      {
        "boot": true,
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        }
      }
    ],
    "machineType": "MACHINE_TYPE",
    "networkInterfaces": [
      {
        "network": "global/networks/default"
      }
    ],
    "scheduling": {
      "automaticRestart": AUTOMATIC_RESTART,
      "hostErrorTimeoutSeconds": ERROR_DETECTION_TIMEOUT,
      "localSsdRecoveryTimeout": LOCAL_SSD_RECOVERY_TIMEOUT,
      "onHostMaintenance": "MAINTENANCE_POLICY"
    }
  }
}

Remplacez les éléments suivants :

• PROJECT_ID : ID du projet dans lequel créer le modèle d'instance.

• REGION: région dans laquelle créer le modèle d'instance.

• INSTANCE_TEMPLATE_NAME : nom du modèle d'instance.

• IMAGE_PROJECT : projet contenant l'image, par exemple, debian-cloud. Pour en savoir plus sur les projets d'image compatibles, consultez la page Images publiques.

• IMAGE : spécifiez l'une des options suivantes :

  • Version spécifique de l'image de l'OS. Exemple : debian-12-bookworm-v20240617

  • Une famille d'images, qui doit être au format family/IMAGE_FAMILY. Cela permet de spécifier l'image d'OS non obsolète la plus récente. Par exemple, si vous spécifiez family/debian-12, la dernière version de la famille d'images Debian 12 est utilisée. Pour en savoir plus sur l'utilisation des familles d'images, consultez la page Bonnes pratiques concernant les familles d'images.

• MACHINE_TYPE : type de machine à utiliser.

• AUTOMATIC_RESTART: comportement de redémarrage automatique de l'instance en cas de plantage ou d'arrêt programmé par Compute Engine. Spécifiez une des valeurs suivantes :

  • Pour permettre à Compute Engine de redémarrer automatiquement votre instance : true

  • Pour empêcher les redémarrages automatiques: false

• ERROR_DETECTION_TIMEOUT: nombre de secondes avant le redémarrage d'une instance qui ne répond pas. La valeur doit être comprise entre 90 (90 secondes) et 330 (330 secondes, soit 5 minutes et 30 secondes). Seuls les incréments de 30 secondes sont autorisés.

• LOCAL_SSD_RECOVERY_TIMEOUT: nombre d'heures à consacrer à la récupération des données des disques SSD locaux associés. La valeur doit être comprise entre 0 (0 heures) et 168 (168 heures, soit 7 jours). Si vous définissez ce champ sur 0, Compute Engine ne récupère pas les données des disques SSD locaux.

• MAINTENANCE_POLICY: comportement de maintenance des instances. La valeur peut être TERMINATE ou MIGRATE. Si vous spécifiez une VM Spot, une VM préemptive ou un type d'instance qui n'est pas compatible avec la migration à chaud dans le modèle d'instance, vous ne pouvez utiliser que TERMINATE.

Console

1. Dans la console Google Cloud , accédez à la page Instances de VM.

   Accéder à la page Instances de VM

2. Dans la colonne Nom, cliquez sur l'instance que vous souhaitez afficher. Une page contenant les détails de l'instance s'affiche.

3. Dans l'onglet Détails, dans la section Gestion, dans la section Règles de disponibilité, vous pouvez consulter les informations suivantes:

   • Dans le champ On host maintenance (En cas de maintenance de l'hôte), vous pouvez voir les événements de comportement de maintenance de l'hôte de l'instance.

   • Dans le champ Délai avant expiration d'erreur de l'hôte, vous pouvez voir le délai d'attente de l'instance avant son redémarrage ou son arrêt après avoir détecté qu'elle ne répondait pas. Si la valeur n'est pas définie (—), le temps d'attente par défaut est de cinq minutes et 30 secondes.

   • Dans le champ Redémarrage automatique, vous pouvez voir si l'instance redémarre automatiquement après un plantage ou si Compute Engine l'arrête pour un arrêt programmé.

gcloud

Pour afficher la stratégie de maintenance de l'hôte d'une instance, utilisez la commande gcloud compute instances describe avec l'option --flatten définie sur scheduling:

 gcloud compute instances describe INSTANCE_NAME \
    --flatten=scheduling \
    --zone=ZONE

Remplacez les éléments suivants :

• INSTANCE_NAME : nom de l'instance.

• ZONE : zone où se trouve l'instance

Le résultat ressemble à ce qui suit :

---
scheduling:
  automaticRestart: true
  hostErrorTimeoutSeconds: 120
  localSsdRecoveryTimeout:
    nanos: 0
    seconds: '10800'
  onHostMaintenance: MIGRATE
  preemptible: false
  provisioningModel: STANDARD

REST

Pour afficher la stratégie de maintenance de l'hôte d'une instance, envoyez une requête GET à la méthode instances.get. Dans l'URL de la requête, incluez le paramètre de requête fields et définissez-le sur scheduling:

  GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME?fields=scheduling

Remplacez les éléments suivants :

• PROJECT_ID: projet contenant l'instance.

• ZONE: zone où se trouve l'instance.

• INSTANCE_NAME : nom de l'instance.

Le résultat ressemble à ce qui suit :

{
  "scheduling": {
    "onHostMaintenance": "MIGRATE",
    "automaticRestart": true,
    "preemptible": false,
    "provisioningModel": "STANDARD",
    "localSsdRecoveryTimeout": {
      "seconds": "10800",
      "nanos": 0
    }
  }
}