Le contrôle de maintenance avancé pour la location unique vous permet de contrôler les événements de maintenance planifiés pour les groupes de nœuds à locataire unique et de minimiser les interruptions liées à la maintenance. Cette fonctionnalité n'est disponible que pour les groupes de nœuds à locataire unique. Pour utiliser cette fonctionnalité avec vos machines virtuelles existantes, vous devez d'abord déplacer vos VM vers des groupes de nœuds à locataire unique sur lesquels le contrôle de maintenance avancé est activé.
Le contrôle de maintenance avancé pour la fonctionnalité de location unique vous permet d'effectuer les opérations suivantes :
- Rechercher les événements de maintenance programmés pour un nœud à locataire unique 28 jours à l'avance.
- Déclencher la maintenance immédiatement ou planifier son exécution ultérieure. Notez que si vous déclenchez la maintenance immédiatement, celle-ci a lieu dans les 24 heures suivant le déclenchement de la requête.
Voici le processus de création d'un groupe de nœuds à locataire unique avec un contrôle de maintenance avancé :
Activez le contrôle de maintenance avancé sur les groupes de nœuds à locataire unique compatibles. Cette fonctionnalité n'est disponible que pour les groupes de nœuds à locataire unique. Pour utiliser cette fonctionnalité avec vos VM ou charges de travail à locataire unique existantes, vous devez d'abord déplacer vos VM vers des groupes de nœuds à locataire unique avec le contrôle de maintenance avancé activé.
Vérifiez les opérations de maintenance à venir pour vos nœuds à locataire unique. La maintenance d'un nœud à locataire unique ne peut être effectuée que tous les 28 jours au minimum. Vous pouvez vérifier l'événement de maintenance correspondant à un nœud 28 jours avant le début de l'intervalle de maintenance de 24 heures pendant lequel ce type de maintenance est programmé.
Si la maintenance est planifiée pour un nœud à locataire unique, avant le début de l'intervalle de maintenance programmé, vous pouvez :
Déclencher la maintenance immédiatement ou planifier son utilisation ultérieure. Si vous choisissez de déclencher la maintenance immédiatement, la maintenance a lieu dans les 24 heures suivant le déclenchement de la requête. Notez que la date et l'heure programmées doivent être antérieures à l'heure de début de l'intervalle de maintenance initial.
Si vous ne déclenchez pas la maintenance immédiatement ou ne la planifiez pas ultérieurement, la maintenance aura lieu dans le délai indiqué dans l'intervalle de maintenance initial.
Vous pouvez choisir d'effectuer l'autoscaling des groupes de nœuds à locataire unique avec le contrôle de maintenance avancé activé. Les journaux d'audit sont générés dans tous les cas.
Limites
Voici les limites du contrôle de maintenance avancé pour la fonctionnalité de location unique en Bêta :
- Familles de machines : Cette fonctionnalité n'est compatible qu'avec les familles de VM M1, M2, M3, C2 et N2. Elle n'est pas compatible avec les familles de VM N1 et N2D.
- Disques SSD locaux et GPU : les disques SSD locaux et les GPU ne sont pas compatibles avec cette fonctionnalité.
- Stratégies de maintenance : cette fonctionnalité est compatible avec la stratégie de maintenance par défaut (migration à chaud) en version bêta. Les autres stratégies de maintenance, telles que le redémarrage sur place (BYOLv1) et la migration au sein du groupe de nœuds (BYOLv2) ne sont pas compatibles.
- Nœuds : Cette fonctionnalité peut accepter un maximum de 20 nœuds par projet et par zone.
- Contrôle avancé de maintenance pour les groupes de nœuds à locataire unique existants : en phase de bêta, vous ne pouvez pas activer le contrôle de maintenance avancé sur les groupes de nœuds à locataire unique existants. Si vous souhaitez exécuter vos charges de travail existantes sur des groupes de nœuds à locataire unique avec le contrôle de maintenance avancé activé, vous devez d'abord créer un nouveau groupe de nœuds avec le contrôle de maintenance avancé activé, puis migrer votre charge de travail vers ce groupe. De même, pour désactiver le contrôle de maintenance avancé, vous devez migrer vos nœuds à locataire unique vers des groupes de nœuds à locataire unique sur lesquels le contrôle de maintenance avancé n'est pas activé.
- Impact sur les règles de maintenance actuelles : lorsque vous activez cette fonctionnalité, elle remplace les intervalles de maintenance existants associés aux nœuds à locataire unique.
Coûts
L'utilisation du contrôle de maintenance avancé n'entraîne aucun coût supplémentaire pour les nœuds à locataire unique.
Avant de commencer
- Avant de provisionner des VM sur un nœud à locataire unique, vérifiez votre quota. Selon le nombre et la taille des nœuds que vous réservez, vous devrez peut-être demander un quota supplémentaire.
-
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
-
Installez Google Cloud CLI, puis initialisez-la en exécutant la commande suivante :
gcloud init
- 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.
Installez Google Cloud CLI, puis initialisez-la en exécutant la commande suivante :
gcloud init
-
Activer le contrôle de maintenance avancé sur un nœud à locataire unique
Le contrôle de maintenance avancé pour la location unique est une fonctionnalité à activer pendant la phase de bêta. Cette fonctionnalité n'est disponible que pour les groupes de nœuds à locataire unique. Pour utiliser cette fonctionnalité avec vos VM ou charges de travail à locataire unique, vous devez d'abord déplacer vos VM vers des groupes de nœuds à locataire unique sur lesquels le contrôle de maintenance avancé est activé.
Console
Vous pouvez activer le contrôle de maintenance avancé lorsque vous créez un groupe de nœuds en sélectionnant l'option Activer la maintenance avancée pour la location unique dans Configurer les paramètres de maintenance. Pour plus d'informations, consultez la section Créer un groupe de nœuds à locataire unique.
gcloud
Pour créer une VM sur un groupe de nœuds à locataire unique, utilisez la commande gcloud beta compute sole-tenancy node-groups create.
L'option --maintenance-interval=RECURRENT dans la commande suivante spécifie que le nœud à locataire unique est activé pour le contrôle de maintenance avancé.
gcloud compute sole-tenancy node-groups create NODE_GROUP_NAME \ --node-template=NODE_TEMPLATE_NAME \ --zone=NODE_GROUP_ZONE \ --target-size=NODE_GROUP_SIZE \ --maintenance-interval=RECURRENT
Remplacez les éléments suivants :
NODE_GROUP_NAME: nom du groupe de nœudsNODE_TEMPLATE_NAME: nom du modèle de nœud à utiliser pour créer le groupeNODE_GROUP_SIZE: nombre de nœuds à créer dans le groupeNODE_GROUP_ZONE: zone dans laquelle créer le groupe de nœuds Il doit s'agir de la même région que celle du modèle de nœud sur lequel vous basez le groupe de nœuds.
REST
Pour créer un groupe de nœuds à locataire unique basé sur un modèle de nœud créé précédemment, utilisez la méthode nodeGroups.insert.
Le paramètre maintenanceInterval de la commande suivante spécifie que le contrôle de maintenance avancé est activé sur le nœud à locataire unique.
POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/NODE_GROUP_ZONE/nodeGroups
{
"name": "NODE_GROUP_NAME",
"nodeTemplate": "NODE_TEMPLATE_URL",
"zone": "NODE_GROUP_ZONE",
"size": "NODE_GROUP_SIZE",
"maintenanceInterval": "RECURRENT"
}
Remplacez les éléments suivants :
PROJECT_ID: nom du projet dans lequel le groupe de nœuds existeNODE_GROUP_ZONE: zone du groupe de nœudsNODE_GROUP_NAME: nom du groupe de nœudsNODE_TEMPLATE_URL: URL du modèle de nœud à utiliser pour créer le groupeNODE_GROUP_SIZE: nombre de nœuds à créer dans le groupe
L'option au niveau du nœud remplace toutes les options de VM précédemment attribuées. Par conséquent, l'activation du contrôle de maintenance avancé remplace toutes les options de maintenance précédentes.
Rechercher les opérations de maintenance à venir
La maintenance d'un nœud à locataire unique ne peut être effectuée que tous les 28 jours au minimum. Vous pourrez vérifier l'événement de maintenance d'un nœud 28 jours avant le début de l'intervalle de maintenance de 24 heures dans lequel la maintenance est planifiée.
Console
Une fois que vous avez activé le contrôle de maintenance avancé sur un groupe de nœuds à locataire unique, les événements de maintenance à venir s'affichent comme suit :
Dans Google Cloud Console, accédez à la page Nœuds à locataire unique.
Cliquez sur Groupes de nœuds pour afficher la liste des groupes de nœuds à locataire unique.
Pour chaque groupe de nœuds à locataire unique, vous pouvez consulter les colonnes État de maintenance et Heure de maintenance dans le tableau pour la maintenance à venir. Étant donné que la maintenance est définie au niveau du nœud, les informations de maintenance que vous voyez ici représentent la prochaine maintenance planifiée pour n'importe quel nœud du groupe.
Pour afficher les informations de maintenance de chaque nœud d'un groupe de nœuds à locataire unique, cliquez sur le nom du groupe de nœuds pour ouvrir la page d'informations. Pour chaque nœud du groupe de nœuds, les colonnes État de maintenance et Heure de maintenance du tableau affichent les informations de maintenance à venir.
gcloud
Pour répertorier les nœuds d'un groupe de nœuds à locataire unique avec leurs informations de maintenance, utilisez la commande gcloud beta compute sole-tenancy node-groups list-nodes.
gcloud compute sole-tenancy node-groups list-nodes NODE_GROUP_NAME \ --format "table(name, status, node_type, instances, server_id, upcoming_maintenance)"
Remplacez NODE_GROUP_NAME par le nom du groupe de nœuds.
REST
Pour répertorier les nœuds d'un groupe de nœuds à locataire unique avec leurs informations de maintenance, utilisez la méthode nodeGroups.listNodes.
POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/NODE_GROUP_ZONE/nodeGroups/NODE_GROUP_ID/listNodes
Remplacez les éléments suivants :
PROJECT_ID: nom du projet dans lequel le groupe de nœuds existeNODE_GROUP_ZONE: zone du groupe de nœudsNODE_GROUP_ID: ID du groupe de nœuds
Voici la réponse de la méthode nodeGroups.listNodes :
{
…
"items": [
…
{
"name": string,
"status": string,
…
"upcomingMaintenance": {
"canReschedule": boolean,
"maintenanceType": enum, // SCHEDULED | UNSCHEDULED
"windowStartTime": string, // RFC 3339 timestamp string
"windowEndTime": string, // RFC 3339 timestamp string
"latestWindowStartTime": string, // RFC 3339 timestamp string
"maintenanceStatus": enum // PENDING | ONGOING
},
…
},
…
],
…
}
Voici les détails de l'événement de maintenance pour le groupe de nœuds :
| Nom du paramètre | Description |
|---|---|
windowStartTime |
Heure de début de l'intervalle de maintenance. |
windowEndTime |
Heure de fin de l'intervalle de maintenance. |
latestWindowStartTime |
Heure de début de l'intervalle de maintenance initial. Vous pouvez choisir de déclencher la maintenance immédiatement ou de la planifier pour une date et une heure ultérieures uniquement avant le latestWindowStartTime.
|
maintenanceType |
Type de maintenance qui sera effectuée : - Planifiée : la maintenance est planifiée pour ce nœud. - Non planifiée : la maintenance inclut des mises à jour critiques qui ne sont pas annoncées aussi longtemps à l'avance. |
canReschedule |
Indique si la maintenance peut être reprogrammée. |
maintenanceStatus |
État de l'opération de maintenance actuelle : - En attente : l'opération de maintenance n'a pas encore démarré, mais elle est planifiée. - En cours : l'intervalle de maintenance a commencé. |
Si vous ne voyez aucun événement de maintenance, cela signifie qu'il n'y aura aucune maintenance à venir pour les nœuds du groupe de nœuds.
Déclencher la maintenance immédiatement ou planifier la maintenance pour un nœud
Après avoir identifié les nœuds d'un groupe de nœuds à locataire unique dont la maintenance est planifiée, vous pouvez effectuer l'une des opérations suivantes :
Déclencher la maintenance immédiatement. Si vous choisissez de déclencher la maintenance immédiatement, la maintenance a lieu dans les 24 heures suivant le déclenchement de la requête.
Planifier la maintenance pour plus tard en fonction de vos besoins.
Si vous ne déclenchez pas la maintenance immédiatement et que vous ne la planifiez pas à une date et une heure ultérieures, la maintenance aura lieu dans l'intervalle de maintenance initial. Une fois que la maintenance d'un nœud commence, vous ne pouvez pas la mettre en pause ou la reprogrammer.
Console
Pour déclencher la maintenance d'un nœud immédiatement, procédez comme suit :
Dans Google Cloud Console, accédez à la page Nœuds à locataire unique.
Cliquez sur Groupes de nœuds.
Cliquez sur le nom du groupe de nœuds pour ouvrir la page d'informations.
Sélectionnez le nœud pour lequel vous souhaitez déclencher la maintenance immédiatement, puis cliquez sur Démarrer maintenant.
Un message de confirmation s'affiche et la maintenance a lieu dans les 24 heures suivant le déclenchement de la requête.
Pour planifier la maintenance d'un nœud, procédez comme suit :
Dans Google Cloud Console, accédez à la page Nœuds à locataire unique.
Cliquez sur Groupes de nœuds pour afficher la liste des groupes de nœuds à locataire unique.
Cliquez sur le nom du groupe de nœuds pour ouvrir la page d'informations.
Sélectionnez le nœud pour lequel vous souhaitez planifier la maintenance, puis cliquez sur Planifier la maintenance.
Dans le volet Planifier la maintenance qui s'affiche, sélectionnez la date et l'heure de votre choix pour la maintenance. Notez que vous pouvez planifier la maintenance d'un nœud à tout moment avant l'heure de début de l'intervalle de maintenance initial.
Un message de confirmation s'affiche et la maintenance a lieu dans les 24 heures suivant le déclenchement de la requête.
gcloud
Exécutez la commande gcloud beta compute sole-tenancy node-groups perform-maintenance pour démarrer ou planifier la maintenance pour un nœud à locataire unique :
gcloud beta compute sole-tenancy node-groups perform-maintenance NODE_GROUP_NAME \ --zone=NODE_GROUP_ZONE \ --nodes=NODE_NAMES \ --window-start-time=WINDOW_START_TIME
Remplacez les éléments suivants :
NODE_GROUP_NAME: nom du groupe de nœudsNODE_GROUP_ZONE: zone du groupe de nœudsNODE_NAMES: nom du nœud pour lequel vous souhaitez effectuer la maintenanceWINDOW_START_TIME: date et heure de début de la maintenance Si vous souhaitez que la maintenance démarre le plus rapidement possible, omettez cette option.
REST
Utilisez la méthode nodeGroups.performMaintenance pour démarrer ou planifier la maintenance pour un nœud à locataire unique :
POST
https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/NODE_GROUP_ZONE/nodeGroups/NODE_GROUP_ID/performMaintenance
{
"nodes": "NODE_NAMES" // [Required] The user needs to list at least 1 node
"windowStartTime": "WINDOW_START_TIME" // [Optional] RFC 3339 timestamp string
}
Remplacez les éléments suivants :
PROJECT_ID: nom du projet dans lequel le groupe de nœuds existeNODE_GROUP_ZONE: zone du groupe de nœudsNODE_GROUP_ID: ID du groupe de nœudsNODE_NAMES: nom du nœud pour lequel vous souhaitez effectuer la maintenanceWINDOW_START_TIME: date et heure de début de la maintenance Omettez ce champ si vous souhaitez que la maintenance démarre dès que possible.
Le champ État de maintenance d'un nœud affiche l'état suivant pendant le processus de maintenance :
- En attente : l'opération de maintenance n'a pas encore commencé, mais elle est planifiée.
- En cours : l'intervalle de maintenance a commencé. L'événement de maintenance reste en cours jusqu'à ce que la maintenance du nœud soit terminée.
Vérifier si la maintenance est terminée
Pour interroger l'état de maintenance d'un nœud, utilisez la commande gcloud beta compute sole-tenancy node-groups list-nodes ou la méthode nodeGroups.listNodes. Pour en savoir plus, consultez la page Vérifier l'état de maintenance.
- Maintenance réussie : si la maintenance d'un nœud à locataire unique réussit, la notification de maintenance est supprimée. Lorsque vous interrogez le nom du groupe de nœuds, la section
upcomingMaintenancen'est plus présente pour le nœud. Vous pouvez consulter un journal des événements système dans Cloud Logging. - Échec de maintenance : si la maintenance n'est pas terminée dans l'intervalle de 24 heures, l'événement de maintenance reste En cours jusqu'à ce que la maintenance soit terminée pour le nœud. Une fois l'opération terminée, la notification de maintenance est supprimée.
Parfois, la requête de déclencheur de maintenance pour la date et l'heure de votre choix peut être refusée si les limites internes de Google Cloud sur le contrôle de maintenance avancé pour les nœuds à locataire unique ont été dépassées pour la date et l'heure spécifiées. Dans ce cas, vous devez sélectionner une autre date et une autre heure pour la maintenance du nœud. L'état de maintenance de ce nœud est en cours et le reste jusqu'à la fin de la maintenance.
Modifier la date et l'heure de maintenance planifiée
Vous pouvez modifier la date et l'heure de maintenance planifiées d'un nœud à locataire unique en suivant la même procédure que celle utilisée pour déclencher ou planifier la maintenance pour un nœud.