Activer l'arrêt élégant dans une instance Compute Engine

Ce document explique comment activer l'arrêt progressif dans une instance Compute Engine nouvelle ou existante. Pour en savoir plus sur l'arrêt progressif, consultez Présentation de l'arrêt progressif.

Lorsque vous activez l'arrêt progressif dans une instance, vous pouvez accorder à son système d'exploitation invité jusqu'à une heure pour s'arrêter proprement lorsque vous arrêtez ou supprimez l'instance. Cela permet d'éviter toute perte de données ou tout système de fichiers corrompu.

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

    1. Installez la Google Cloud CLI, puis connectez-vous à la gcloud CLI avec votre identité fédérée. Après vous être connecté, initialisez Google Cloud CLI en exécutant la commande suivante : 

      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.

      Installez la Google Cloud CLI, puis connectez-vous à la gcloud CLI avec votre identité fédérée. Après vous être connecté, initialisez 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 .

Rôles requis

Pour obtenir les autorisations nécessaires pour activer l'arrêt progressif dans une instance de calcul, demandez à votre administrateur de vous accorder le rôle IAM Administrateur d'instances Compute (v1) (roles/compute.instanceAdmin.v1) sur votre projet. Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.

Ce rôle prédéfini contient les autorisations requises pour activer l'arrêt progressif dans une instance de calcul. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Les autorisations suivantes sont requises pour activer l'arrêt progressif dans une instance de calcul :

  • Pour créer des instances :
    • compute.instances.create sur le projet
    • Pour créer la VM à l'aide d'une image personnalisée : compute.images.useReadOnly sur l'image
    • Pour créer la VM à l'aide d'un instantané : compute.snapshots.useReadOnly sur l'instantané
    • Pour créer la VM à l'aide d'un modèle d'instance : compute.instanceTemplates.useReadOnly sur le modèle d'instance
    • Pour attribuer un ancien réseau à la VM : compute.networks.use sur le projet
    • Pour spécifier une adresse IP statique pour la VM : compute.addresses.use sur le projet
    • Pour attribuer une adresse IP externe à la VM, en cas d'utilisation d'un ancien réseau : compute.networks.useExternalIp sur le projet
    • Pour spécifier un sous-réseau pour la VM : compute.subnetworks.use sur le projet ou sur le sous-réseau choisi
    • Pour attribuer une adresse IP externe à la VM, en cas d'utilisation d'un réseau VPC : compute.subnetworks.useExternalIp sur le projet ou sur le sous-réseau choisi
    • Pour définir les métadonnées d'instance de VM pour la VM : compute.instances.setMetadata sur le projet
    • Pour définir des tags pour la VM : compute.instances.setTags sur la VM
    • Pour définir des libellés pour la VM : compute.instances.setLabels sur la VM
    • Pour définir un compte de service à utiliser avec la VM : compute.instances.setServiceAccount sur la VM
    • Pour créer un disque pour la VM : compute.disks.create sur le projet
    • Pour associer un disque existant en mode lecture seule ou en mode lecture-écriture : compute.disks.use sur le disque
    • Pour associer un disque existant en mode lecture seule : compute.disks.useReadOnly sur le disque
  • Pour créer un modèle d'instance : compute.instanceTemplates.create sur le projet.
  • Pour activer l'arrêt progressif dans une instance existante : compute.instances.update sur l'instance

Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.

Activer l'arrêt progressif

Pour activer l'arrêt progressif dans une instance de calcul, utilisez l'une des méthodes suivantes :

Activer l'arrêt progressif dans une instance existante

Vous pouvez activer l'arrêt progressif dans une instance de calcul existante sans l'arrêter ni la redémarrer. La période d'arrêt progressif par défaut est de 10 minutes, mais vous pouvez spécifier une période d'arrêt personnalisée comprise entre une seconde et une heure.

Pour activer l'arrêt progressif dans une instance existante, sélectionnez l'une des options suivantes :

Console

  1. Dans la console Trusted 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 dans laquelle vous souhaitez activer l'arrêt progressif.

    La page d'informations de l'instance s'affiche.

  3. Cliquez sur Modifier.

  4. Dans la section Gestion, procédez comme suit :

    1. Cochez la case Arrêter progressivement la VM.

    2. Facultatif : Pour spécifier une période d'arrêt progressif personnalisée, indiquez une durée dans le champ Durée maximale.

  5. Cliquez sur Enregistrer.

gcloud

Pour activer l'arrêt progressif dans une instance existante, utilisez la commande gcloud beta compute instances update avec l'option --graceful-shutdown :

gcloud beta compute instances update INSTANCE_NAME \
    --graceful-shutdown \
    --zone=ZONE

Remplacez les éléments suivants :

  • INSTANCE_NAME : nom de l'instance.

  • ZONE : zone où se trouve l'instance

Si vous le souhaitez, vous pouvez spécifier une période d'arrêt progressif personnalisée en incluant l'option --graceful-shutdown-max-duration :

gcloud beta compute instances update INSTANCE_NAME \
    --graceful-shutdown \
    --graceful-shutdown-max-duration=MAX_DURATION \
    --zone=ZONE

Remplacez MAX_DURATION par une durée pour la période d'arrêt. La valeur doit être formatée en nombre d'heures, de minutes ou de secondes, suivies respectivement de h, m et s. Par exemple, spécifiez 1h pour une heure ou 20m10s pour 20 minutes et 10 secondes.

REST

  1. Créez un fichier JSON vide.

  2. Pour afficher les propriétés d'une instance existante, envoyez une requête GET à la méthode instances.get bêta :

    GET https://compute.s3nsapis.fr/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME

    Remplacez les éléments suivants :

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

    • ZONE : zone où se trouve l'instance

    • INSTANCE_NAME : nom d'une instance existante.

  3. Dans le fichier JSON vide que vous avez créé lors des étapes précédentes, procédez comme suit :

    1. Saisissez les informations de configuration de l'instance à partir de la sortie de la requête GET.

    2. Dans le champ scheduling, ajoutez le champ gracefulShutdown comme suit :

      {
  ...
  "scheduling": {
    ...
    "gracefulShutdown": {
      "enabled": true
    }
  },
  ...
}

      Si vous le souhaitez, vous pouvez spécifier une période d'arrêt progressif personnalisée en incluant le champ maxDuration :

      {
  ...
  "scheduling": {
    ...
    "gracefulShutdown": {
      ...
      "enabled": true,
      "maxDuration": {
        "seconds": "MAX_DURATION"
      }
    }
  },
  ...
}

      Remplacez MAX_DURATION par une durée en secondes pour la période d'arrêt progressif. La valeur doit être comprise entre 1 et 3600, soit 3 600 secondes (une heure).

  4. Pour mettre à jour l'instance et la redémarrer, envoyez une requête PUT à la méthode instances.update en version bêta. Dans la requête, procédez comme suit :

    • Dans l'URL de la requête, incluez le paramètre de requête mostDisruptiveAllowedAction défini sur RESTART.

    • Dans le corps de la requête, incluez les propriétés de l'instance du fichier JSON que vous avez créé et mis à jour aux étapes précédentes.

    La requête PUT permettant de mettre à jour l'instance ressemble à ce qui suit :

    PUT https://compute.s3nsapis.fr/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME?mostDisruptiveAllowedAction=RESTART

{
  ...
  "scheduling": {
    ...
    "gracefulShutdown": {
      "enabled": true
    }
  },
  ...
}

Pour en savoir plus sur la mise à jour des propriétés d'une instance, consultez Mettre à jour les propriétés d'une instance.

Activer l'arrêt progressif lors de la création d'une instance

Lorsque vous créez une instance de calcul pour laquelle l'arrêt progressif est activé, la période d'arrêt par défaut est de 10 minutes. Vous pouvez également spécifier une période d'arrêt personnalisée comprise entre une seconde et une heure.

Pour créer une instance avec l'arrêt progressif activé, sélectionnez l'une des options suivantes :

Console

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

    Accéder à la page Instances de VM

  2. Cliquez sur Créer une instance.

    La page Créer une instance s'ouvre.

  3. Renseignez un nom pour l'instance.

  4. Spécifiez la région et la zone dans lesquelles créer l'instance.

  5. Spécifiez un type de machine pour l'instance.

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

  7. Développez la section Paramètres avancés du modèle de provisionnement de la VM, puis procédez comme suit :

    1. Cochez la case Arrêter progressivement la VM.

    2. Facultatif : Pour spécifier une période d'arrêt progressif personnalisée, indiquez une durée dans le champ Durée maximale.

  8. Cliquez sur Créer.

gcloud

Pour créer une instance avec l'arrêt progressif activé, utilisez la commande gcloud beta compute instances create avec l'option --graceful-shutdown :

gcloud beta compute instances create INSTANCE_NAME \
    --graceful-shutdown \
    --machine-type=MACHINE_TYPE \
    --zone=ZONE

Remplacez les éléments suivants :

  • INSTANCE_NAME : nom de l'instance.

  • MACHINE_TYPE : type de machine à utiliser pour l'instance.

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

Si vous le souhaitez, vous pouvez spécifier une période d'arrêt progressif personnalisée en incluant l'option --graceful-shutdown-max-duration :

gcloud beta compute instances create INSTANCE_NAME \
    --graceful-shutdown \
    --graceful-shutdown-max-duration=MAX_DURATION \
    --machine-type=MACHINE_TYPE \
    --zone=ZONE

Remplacez MAX_DURATION par une durée pour la période d'arrêt progressif. La valeur doit être formatée en nombre d'heures, de minutes ou de secondes, suivis respectivement de h, m et s. Par exemple, spécifiez 1h pour une heure ou 20m10s pour 20 minutes et 10 secondes.

REST

Pour créer une instance avec l'arrêt progressif activé, envoyez une requête POST à la méthode beta.instances.insert. Dans le corps de la requête, incluez le champ gracefulShutdown :

POST https://compute.s3nsapis.fr/compute/beta/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": {
    "gracefulShutdown": {
      "enabled": true
    }
  }
}

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 de l'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. Ce format spécifie 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.

Vous pouvez également spécifier une période d'arrêt progressif personnalisée en incluant le champ maxDuration dans le corps de la requête :

POST https://compute.s3nsapis.fr/compute/beta/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": {
    "gracefulShutdown": {
      "enabled": true,
      "maxDuration": {
        "seconds": "MAX_DURATION"
      }
    }
  }
}

Remplacez MAX_DURATION par une durée en secondes pour la période d'arrêt progressif. La valeur doit être comprise entre 1 et 3600, soit 3 600 secondes (une heure).

Pour davantage d'options de configuration lorsque vous créez une instance, consultez la section Créer et démarrer une instance Compute Engine.

Activer l'arrêt progressif lors de la création d'un modèle d'instance

Lorsque vous créez un modèle d'instance pour lequel l'arrêt progressif est activé, la période d'arrêt par défaut est de 10 minutes. Vous pouvez également spécifier une période d'arrêt personnalisée comprise entre une seconde et une heure.

L'arrêt progressif est activé pour toutes les instances de calcul créées à l'aide du modèle d'instance.

Pour créer un modèle d'instance avec l'arrêt progressif activé, sélectionnez l'une des options suivantes :

Console

  1. Dans la console Trusted 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'ouvre.

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

  4. Sélectionnez l'emplacement comme suit :

    • Pour réduire la dépendance interrégionale en créant un modèle d'instance régional, procédez comme suit :

      1. Sélectionnez Régional, si ce n'est pas déjà fait.

      2. Dans le champ Région, sélectionnez la région dans laquelle créer le modèle d'instance.

    • Sinon, pour utiliser le modèle d'instance dans plusieurs régions, sélectionnez Global.

  5. Dans la section Configuration de la machine, spécifiez un type de machine.

  6. Développez la section Paramètres avancés du modèle de provisionnement de la VM, puis procédez comme suit :

    1. Cochez la case Arrêter progressivement la VM.

    2. Facultatif : Pour spécifier une période d'arrêt progressif personnalisée, indiquez une durée dans le champ Durée maximale.

  7. Cliquez sur Créer.

gcloud

Pour créer un modèle d'instance avec l'arrêt progressif activé, utilisez la commande gcloud beta compute instance-templates create avec l'indicateur --graceful-shutdown.

Par exemple, pour créer un modèle d'instance régional avec l'arrêt progressif activé, exécutez la commande suivante :

gcloud beta compute instance-templates create INSTANCE_TEMPLATE_NAME \
    --graceful-shutdown \
    --instance-template-region=REGION \
    --machine-type=MACHINE_TYPE

Remplacez les éléments suivants :

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

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

  • MACHINE_TYPE : type de machine des instances créées à l'aide du modèle d'instance.

Vous pouvez également inclure l'option --graceful-shutdown-max-duration pour spécifier une période d'arrêt progressif personnalisée.

gcloud beta compute instance-templates create INSTANCE_TEMPLATE_NAME \
    --graceful-shutdown \
    --graceful-shutdown-max-duration=MAX_DURATION \
    --instance-template-region=REGION \
    --machine-type=MACHINE_TYPE

Remplacez MAX_DURATION par une durée pour la période d'arrêt. La valeur doit être formatée en nombre d'heures, de minutes ou de secondes, suivies respectivement de h, m et s. Par exemple, spécifiez 1h pour une heure ou 20m10s pour 20 minutes et 10 secondes.

REST

Pour créer un modèle d'instance avec l'arrêt progressif activé, envoyez une requête POST à l'une des méthodes suivantes :

Par exemple, pour créer un modèle d'instance régional avec l'arrêt progressif activé, envoyez une requête POST comme suit :

POST https://compute.s3nsapis.fr/compute/beta/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": {
      "gracefulShutdown": {
        "enabled": true
      }
    }
  }
}

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. Ce format spécifie 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 des instances créées à l'aide du modèle d'instance.

Vous pouvez également spécifier une période d'arrêt progressif personnalisée en incluant le champ maxDuration dans le corps de la requête.

POST https://compute.s3nsapis.fr/compute/beta/projects/PROJECT_ID/global/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": {
      "gracefulShutdown": {
        "enabled": true,
        "maxDuration": {
          "seconds": "MAX_DURATION"
        }
      }
    }
  }
}

Remplacez MAX_DURATION par une durée en secondes pour la période d'arrêt. La valeur doit être comprise entre 1 et 3600, soit 3 600 secondes (une heure).

Pour plus d'options de configuration lors de la création d'un modèle d'instance, consultez Créer des modèles d'instance.

Étapes suivantes