Créer des groupes de nœuds à locataire unique

Ce document explique comment créer et supprimer des groupes de nœuds à locataire unique. Si vous n'avez pas encore créé de modèle de nœud à locataire unique, vous devez le faire avant de pouvoir créer un groupe de nœuds.

Les groupes de nœuds sont des ressources zonales qui héritent des propriétés du modèle de nœud sur lequel ils sont basés. Lorsque vous créez un groupe de nœuds, vous devez spécifier une configuration, comme le nombre de nœuds et les paramètres de maintenance.

Créer un groupe de nœuds à locataire unique

Pour créer un groupe de nœuds à locataire unique, utilisez l'une des méthodes suivantes :

Console

  1. Dans la console Google Cloud , accédez à la page Nœuds à locataire unique.

    Accéder à la page Nœuds à locataire unique

  2. Cliquez sur Créer un groupe de nœuds pour commencer la création.

  3. Spécifiez un nom pour le groupe de nœuds.

  4. Spécifiez la région du groupe de nœuds pour afficher les modèles de nœud disponibles dans cette région.

  5. Spécifiez la zone de la région où vous souhaitez créer le groupe de nœuds.

  6. Spécifiez le Modèle de nœud pour créer le groupe de nœuds ou cliquez sur Créer un modèle de nœud afin de créer un modèle de nœud à locataire unique. Le modèle de nœud sélectionné est appliqué au groupe de nœuds.

  7. Choisissez l'une des options suivantes pour le Mode d'autoscaling de l'autoscaler du groupe de nœuds :

    • Désactivé : gérez manuellement la taille du groupe de nœuds.

    • Activé : les nœuds sont automatiquement ajoutés au groupe de nœuds ou supprimés de celui-ci.

    • Scaling horizontal uniquement : ajoutez des nœuds au groupe de nœuds en cas de besoin de capacité supplémentaire.

  8. Spécifiez le nombre de nœuds pour le groupe. Si vous activez l'autoscaler de groupe de nœuds, spécifiez une plage pour la taille du groupe de nœuds. Vous pouvez modifier les valeurs manuellement.

  9. Définissez la règle de maintenance du groupe de nœuds à locataire unique dans la section Configurer les paramètres de maintenance sur l'une des valeurs suivantes. La règle de maintenance vous permet de configurer le comportement des VM sur le groupe de nœuds lors des événements de maintenance de l'hôte. Pour en savoir plus, consultez les Règles de maintenance :

    • Par défaut
    • Redémarrer sur place
    • Migrer dans le groupe de nœuds

  10. Vous pouvez choisir entre les intervalles de maintenance standards et les contrôles de maintenance avancés pour gérer la maintenance de votre groupe de nœuds à locataire unique, comme suit :

    • Intervalle de maintenance : sélectionnez la période pendant laquelle vous souhaitez que les événements de maintenance planifiés se produisent pour les nœuds des groupes de nœuds à locataire unique.

    • Activer le contrôle de maintenance avancé pour la location unique : le contrôle de maintenance avancé pour la location unique 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. Pour activer le contrôle de maintenance avancé, faites passer le bouton Activer le contrôle de maintenance avancé pour la location unique en mode activé Si vous choisissez d'utiliser cette option pour la maintenance des nœuds, le champ Intervalle de maintenance est désactivé et la maintenance a lieu comme configuré dans le contrôle de maintenance avancé.

    Notez que le contrôle de maintenance avancée n'est compatible qu'avec la règle de maintenance Par défaut.

  11. Configurez les paramètres de partage en spécifiant l'un des éléments suivants dans la section Configurer les paramètres de partage :

    • Pour partager le groupe de nœuds avec tous les projets de votre organisation, sélectionnez Partager ce groupe de nœuds avec tous les projets de l'organisation.
    • Pour partager le groupe de nœuds avec des projets spécifiques de votre organisation, sélectionnez Partager ce groupe de nœuds avec les projets sélectionnés au sein de l'organisation.

    Si vous ne souhaitez pas partager le groupe de nœuds, sélectionnez Ne pas partager ce groupe de nœuds avec d'autres projets. Pour en savoir plus sur le partage de groupes de nœuds, consultez la section Partager des groupes de nœuds à locataire unique.

  12. Cliquez sur Créer pour terminer la création du groupe de nœuds.

gcloud

Exécutez la commande gcloud compute sole-tenancy node-groups create pour créer un groupe de nœuds basé sur un modèle de nœud créé précédemment :

gcloud compute sole-tenancy node-groups create GROUP_NAME \
  --node-template=TEMPLATE_NAME \
  --target-size=TARGET_SIZE \
  [--zone=ZONE \]
  [--maintenance-policy=MAINTENANCE_POLICY \]
  [--maintenance-window-start-time=START_TIME \]
  [--autoscaler-mode=AUTOSCALER_MODE \
  --min-nodes=MIN_NODES \
  --max-nodes=MAX_NODES]

Remplacez les éléments suivants :

  • GROUP_NAME : nom du nouveau groupe de nœuds.
  • TEMPLATE_NAME : nom du modèle de nœud à utiliser pour créer le groupe.
  • TARGET_SIZE : nombre de nœuds à créer dans le groupe.
  • ZONE : zone dans laquelle créer le groupe de nœuds. Cette zone doit être située dans la même région que le modèle de nœud sur lequel vous basez le groupe de nœuds.

  • MAINTENANCE_POLICY : règle de maintenance du groupe de nœuds. Pour en savoir plus, consultez Règles de maintenance. Il doit s'agir de l'une des valeurs suivantes :

    • default
    • restart-in-place
    • migrate-within-node-group

    Vous pouvez également activer le contrôle de maintenance avancée pour le groupe de nœuds à locataire unique à l'aide de l'option --maintenance-interval. Pour en savoir plus, consultez l'article Activer le contrôle de maintenance avancée sur un nœud à locataire unique.

  • START_TIME : heure GMT de début pour l'intervalle de maintenance des VM dans ce groupe de nœuds. Définissez ce paramètre sur 00:00, 04:00, 08:00, 12:00, 16:00 ou 20:00. Si ce champ n'est pas défini, le groupe de nœuds n'a pas d'intervalle de maintenance défini.

  • AUTOSCALER_MODE : règle d'autoscaler pour le groupe de nœuds. Il doit s'agir de l'un des éléments suivants :

    • off : pour gérer manuellement la taille du groupe de nœuds.
    • on : les nœuds sont automatiquement ajoutés ou supprimés du groupe de nœuds.
    • only-scale-out : ajoute des nœuds au groupe de nœuds lorsque la capacité supplémentaire est requise.

  • MIN_NODES : taille minimale du groupe de nœuds. La valeur par défaut est 0 et doit être un nombre entier inférieur ou égal à MAX_NODES.

  • MAX_NODES : taille maximale du groupe de nœuds. Cette valeur doit être inférieure ou égale à 100 et supérieure ou égale à MIN_NODES. Obligatoire si AUTOSCALER_MODE n'est pas défini sur off.

REST

Utilisez la méthode nodeGroups.insert pour créer un groupe de nœuds à partir d'un modèle de nœud précédemment créé :

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/nodeGroups?initialNodeCount=TARGET_SIZE
{
  "nodeTemplate": "regions/REGION/nodeTemplates/TEMPLATE_NAME",
  "name": "GROUP_NAME",
  "maintenancePolicy": MAINTENANCE_POLICY,
  "maintenanceWindow": {
      "startTime": "START_TIME"
  },
  "autoscalingPolicy": {
      "mode": AUTOSCALER_MODE,
      "minNodes": MIN_NODES,
      "maxNodes": MAX_NODES
  },
}

Remplacez l'élément suivant :

  • PROJECT_ID : ID du projet.

  • ZONE : zone dans laquelle créer le groupe de nœuds. Cette zone doit être située dans la même région que le modèle de nœud sur lequel vous basez le groupe de nœuds.

  • TARGET_SIZE : nombre de nœuds à créer dans le groupe.

  • REGION : région dans laquelle créer le groupe de nœuds. Vous devez disposer d'un modèle de nœud dans la région sélectionnée.

  • TEMPLATE_NAME : nom du modèle de nœud à utiliser pour créer le groupe.

  • GROUP_NAME : nom du nouveau groupe de nœuds.

  • MAINTENANCE_POLICY : règle de maintenance du groupe de nœuds. Il doit s'agir de l'une des valeurs suivantes :

    • DEFAULT
    • RESTART_IN_PLACE
    • MIGRATE_WITHIN_NODE_GROUP

    Vous pouvez également activer le contrôle de maintenance avancé pour le groupe de nœuds à locataire unique à l'aide du champ maintenanceInterval. Pour en savoir plus, consultez l'article Activer le contrôle de maintenance avancée sur un nœud à locataire unique.

  • START_TIME : heure GMT de début pour l'intervalle de maintenance des VM dans ce groupe de nœuds. Définissez ce paramètre sur 00:00, 04:00, 08:00, 12:00, 16:00 ou 20:00. Si ce champ n'est pas défini, le groupe de nœuds n'a pas d'intervalle de maintenance défini.

  • AUTOSCALER_MODE : règle d'autoscaler pour le groupe de nœuds. Il doit s'agir de l'une des valeurs suivantes :

    • OFF : gérer manuellement la taille du groupe de nœuds.
    • ON : les nœuds sont automatiquement ajoutés ou supprimés du groupe de nœuds.
    • ONLY_SCALE_OUT : ajoute des nœuds au groupe de nœuds lorsque la capacité supplémentaire est requise.

  • MIN_NODES : taille minimale du groupe de nœuds. La valeur par défaut est 0 et doit être un nombre entier inférieur ou égal à MAX_NODES.

  • MAX_NODES : taille maximale du groupe de nœuds. Cette valeur doit être inférieure ou égale à 100 et supérieure ou égale à MIN_NODES. Obligatoire si AUTOSCALER_MODE n'est pas défini sur OFF.

Supprimer un groupe de nœuds

Si vous devez supprimer un groupe de nœuds à locataire unique, supprimez d'abord les VM du groupe de nœuds.

Console

  1. Accédez à la page Nœuds à locataire unique.

    Accéder à la page Nœuds à locataire unique

  2. Cliquez sur le nom du groupe de nœuds à supprimer.

  3. Pour chaque nœud du groupe de nœuds, cliquez sur son nom et supprimez les instances de VM individuelles sur la page des détails du nœud, ou suivez la procédure standard pour supprimer une VM individuelle. Pour supprimer des VM d'un groupe d'instances géré, supprimez le groupe d'instances géré.

  4. Après avoir supprimé toutes les instances de VM exécutées sur tous les nœuds du groupe, revenez à la page Nœuds à locataire unique.

    Accéder à la page Nœuds à locataire unique

  5. Cliquez sur Groupes de nœuds.

  6. Sélectionnez le nom du groupe de nœuds à supprimer.

  7. Cliquez sur Supprimer.

gcloud

  1. Répertoriez les instances de VM en cours d'exécution sur les nœuds du groupe de nœuds à l'aide de la commande gcloud compute sole-tenancy node-groups list-nodes :

    gcloud compute sole-tenancy node-groups list-nodes GROUP_NAME \
  --zone=ZONE

    Remplacez les éléments suivants :

    • GROUP_NAME : nom du groupe de nœuds
    • ZONE : zone du groupe de nœuds

  2. Si des VM s'exécutent sur le groupe de nœuds, suivez la procédure permettant de supprimer une VM individuelle ou la procédure de suppression d'un groupe d'instances géré.

  3. Après avoir supprimé toutes les VM s'exécutant sur tous les nœuds du groupe de nœuds, supprimez le groupe de nœuds à l'aide de la commande gcloud compute sole-tenancy node-groups delete :

    gcloud compute sole-tenancy node-groups delete GROUP_NAME \
    --zone=ZONE

    Remplacez l'élément suivant :

    • GROUP_NAME : nom du groupe de nœuds
    • ZONE : zone du groupe de nœuds

REST

  1. Répertoriez les instances de VM en cours d'exécution sur les nœuds du groupe de nœuds à l'aide de la méthode nodeGroups.listNodes :

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/nodeGroups/GROUP_NAME/listNodes

    Remplacez l'élément suivant :

    • PROJECT_ID : ID du projet
    • ZONE : zone du groupe de nœuds
    • GROUP_NAME : groupe pour lequel répertorier les VM

  2. Si des VM s'exécutent sur le groupe de nœuds, suivez la procédure permettant de supprimer une VM individuelle ou la procédure de suppression d'un groupe d'instances géré.

  3. Après avoir supprimé toutes les VM en cours d'exécution sur tous les nœuds du groupe de nœuds, supprimez le groupe à l'aide de la méthode nodeGroups.delete :

    DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/nodeGroups/GROUP_NAME

    Remplacez l'élément suivant :

    • PROJECT_ID : ID du projet
    • ZONE : zone du groupe de nœuds
    • GROUP_NAME : nom du groupe de nœuds à supprimer

Étapes suivantes