Démarrer manuellement un événement de maintenance de l'hôte

Cette page explique comment démarrer manuellement un événement de maintenance de l'hôte sur les instances Compute Engine compatibles. Cette fonctionnalité vous permet de démarrer un événement de maintenance afin de contrôler la périodicité de la maintenance de votre instance. Cela s'avère utile pour les charges de travail susceptibles d'être affectées par une dégradation des performances ou un temps d'arrêt, pour lesquelles vous avez besoin que l'intervalle de maintenance commence à une heure spécifique.

Lorsque vous démarrez manuellement un événement de maintenance, la maintenance de l'hôte commence immédiatement. Vous ne pouvez pas spécifier de date ni d'heure de début pour l'événement de maintenance. Si vous n'utilisez pas cette fonctionnalité, l'événement de maintenance se produit à l'heure indiquée dans la notification de maintenance à venir.

Si vous souhaitez d'abord tester la façon dont vos applications gèrent un événement de maintenance, vous pouvez simuler un événement de maintenance.

Limites

Vous pouvez démarrer manuellement un événement de maintenance de l'hôte pour les instances qui utilisent les types de machines suivants :

• Familles de machines optimisées pour les accélérateurs :

  • Types de machines A3 Ultra avec huit GPU

  • Types de machines A3 Mega avec huit GPU

  • Types de machines A3 High avec huit GPU

  • Types de machines A3 Edge avec huit GPU

  • Types de machines A2 Ultra avec huit GPU

  • Types de machines A2 Standard avec 8 ou 16 GPU

  • Types de machines G2 avec huit GPU

• Familles de machines optimisées pour le calcul :

  • Types de machines H3 avec 88 vCPU

• Familles de machines à usage général :

  • Types de machines C4 avec 192 ou 288 processeurs virtuels, ou avec des disques SSD locaux associés (preview)

  • Instances Bare Metal C4 avec 288 processeurs virtuels (bêta)

  • Types de machines C4A avec des disques SSD locaux associés

  • Types de machines C4D avec 384 processeurs virtuels ou avec des disques SSD locaux associés

  • Instances bare metal C4D avec 384 vCPU (preview)

  • Types de machines C3 avec 176 vCPU ou avec des disques SSD locaux associés

  • Instances Bare Metal C3 avec 192 processeurs virtuels

  • Types de machines C3D avec 360 vCPU ou avec des disques SSD locaux associés

• Familles de machines à mémoire optimisée :

  • Types de machines X4

  • Types de machines M4

  • Types de machines M3

  • Types de machines M2

  • Types de machines M1

• Familles de machines optimisées pour le stockage :

  • Types de machines Z3

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 en sélectionnant l'une des options suivantes :
  

  Select the tab for how you plan to use the samples on this page:

  gcloud

  1. After installing the Google Cloud CLI, initialize it by running the following command:

     gcloud init

     If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  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.

  After installing the Google Cloud CLI, initialize it by running the following command:

  gcloud init

  If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

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

Rôles requis

Pour obtenir les autorisations nécessaires pour gérer la maintenance des VM, demandez à votre administrateur de vous accorder le rôle IAM Administrateur d'instances Compute (v1) (roles/compute.instanceAdmin.v1) sur le 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 gérer la maintenance des VM. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

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

Démarrer manuellement un événement de maintenance de l'hôte

Compute Engine envoie des notifications pour les événements de maintenance à venir via plusieurs méthodes. Les informations contenues dans les notifications vous permettent de déterminer le délai dans lequel vous pouvez démarrer manuellement un événement de maintenance.

Consulter les informations de la notification

Vous pouvez trouver vos notifications d'événement de maintenance de l'une des manières suivantes :

• Interroger vos instances de calcul ou votre serveur de métadonnées
• Utiliser Cloud Logging

Si la notification concernant un événement de maintenance de l'hôte contient canReschedule=True et maintenanceStatus=Pending, vous avez la possibilité de démarrer la maintenance à l'heure de votre choix ou d'attendre que l'événement de maintenance ait lieu à l'heure spécifiée par windowStartTime.

Si vous ne recevez aucune notification et que vous essayez de démarrer manuellement un événement de maintenance, le message suivant s'affiche :

There is no reschedulable upcoming maintenance.

Ce message indique qu'aucun événement de maintenance n'a été planifié et qu'aucune action n'est requise.

Démarrer l'événement de maintenance

Vous pouvez démarrer la maintenance de l'hôte à l'heure de votre choix, plutôt que d'attendre l'horodatage programmé. Utilisez la Google Cloud CLI ou REST pour déclencher l'événement de maintenance, qui démarre immédiatement.

gcloud compute instances perform-maintenance INSTANCE_NAME \
    --zone=ZONE

resourceStatus:
  upcomingMaintenance:
    canReschedule: false
    latestWindowStartTime: '2025-01-15T19:57:17Z'
    maintenanceStatus: ONGOING
    type: SCHEDULED
    windowEndTime: '2025-01-15T23:57:11Z'
    windowStartTime: '2025-01-15T19:57:16Z'

POST: https://compute.googleapis.com/compute/v1/projects/PROJECT_NAME/zones/ZONE/instances/INSTANCE_NAME/performMaintenance

upcomingMaintenance:{
  "canReschedule":false
  "latestWindowStartTime": "2023-12-01T19:00:01Z"
  "maintenanceStatus":"ONGOING"
  "type":"SCHEDULED"
  "windowEndTime": "2023-12-01T22:00:00Z"
  "windowStartTime": "2023-12-01T19:00:00Z"
}

Étapes suivantes

• Découvrez comment simuler un événement de maintenance de l'hôte.
• Découvrez comment recevoir des notifications de migration à chaud.
• Découvrez comment configurer des alertes pour les notifications de maintenance de l'hôte.