Activer le contrôle de maintenance avancé pour les nœuds à locataire unique

Linux Windows

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 6 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é.

Remarque : Pour un nouveau nœud à locataire unique créé dans un groupe de nœuds, aucun événement de maintenance n'est planifié pour les 28 premiers jours.
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 6 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 6 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.

Familles de machines compatibles

Le contrôle de maintenance avancé pour les nœuds à locataire unique est compatible avec les familles de machines suivantes:

Famille M2 en disponibilité générale
Familles M1, M3, C2 et N2 en version preview

Limites

Voici les limites du contrôle de maintenance avancé pour la fonctionnalité de location unique:

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). 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: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 :

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

When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
1. Install the Google Cloud CLI, then initialize it by running the following command:
  gcloud init
  Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
2. Set a default region and zone.

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 et disponible uniquement 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 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 un groupe de nœuds à locataire unique M2, utilisez la commande gcloud compute sole-tenancy node-groups create.

Pour créer un groupe de nœuds à locataire unique d'une autre famille de machines compatible, 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œuds
NODE_TEMPLATE_NAME : nom du modèle de nœud à utiliser pour créer le groupe
NODE_GROUP_SIZE : nombre de nœuds à créer dans le groupe
NODE_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 M2 basé sur un modèle de nœud créé précédemment, utilisez la méthode nodeGroups.insert.

Pour créer un groupe de nœuds à locataire unique basé sur un modèle de nœud créé précédemment pour tous les autres nœuds, 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/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 existe
NODE_GROUP_ZONE : zone du groupe de nœuds
NODE_GROUP_NAME : nom du groupe de nœuds
NODE_TEMPLATE_URL : URL du modèle de nœud à utiliser pour créer le groupe
NODE_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 pouvez vérifier l'événement de maintenance correspondant à un nœud 28 jours avant le début de l'intervalle de maintenance de 6 heures pendant lequel ce type de maintenance est programmé.

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.

Accéder à 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 M2 avec leurs informations de maintenance, utilisez la commande gcloud 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 M2 avec leurs informations de maintenance, utilisez la méthode nodeGroups.listNodes.

POST https://compute.googleapis.com/compute/v1/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 existe
NODE_GROUP_ZONE : zone du groupe de nœuds
NODE_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 6 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.

Accéder à 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 6 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.

Accéder à 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 6 heures suivant le déclenchement de la requête.

gcloud

Exécutez la commande gcloud compute sole-tenancy node-groups perform-maintenance pour démarrer ou planifier la maintenance pour un nœud à locataire unique M2.

gcloud 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œuds
NODE_GROUP_ZONE : zone du groupe de nœuds
NODE_NAMES : nom du nœud pour lequel vous souhaitez effectuer la maintenance
WINDOW_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 M2.

POST
https://compute.googleapis.com/compute/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 existe
NODE_GROUP_ZONE : zone du groupe de nœuds
NODE_GROUP_ID : ID du groupe de nœuds
NODE_NAMES : nom du nœud pour lequel vous souhaitez effectuer la maintenance
WINDOW_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 M2, utilisez la commande gcloud 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 upcomingMaintenance n'est plus présente pour le nœud.
Échec de maintenance : si la maintenance n'est pas terminée dans l'intervalle de 6 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.