Gérer les pools de nœuds

Partagé Standard

Lorsque vous créez un cluster Kubernetes Google Distributed Cloud (GDC) isolé, le nombre et le type de nœuds que vous spécifiez créent le premier pool de nœuds du cluster. Vous pouvez effectuer les tâches suivantes sur les pools de nœuds d'un cluster existant lorsque ses besoins de calcul évoluent :

• Ajouter un pool de nœuds : ajoutez des pools de nœuds à mesure que la demande pour les charges de travail de votre cluster augmente.

• Afficher un pool de nœuds : affichez les caractéristiques et l'état de vos pools de nœuds existants.

• Redimensionner un pool de nœuds : augmentez ou diminuez manuellement la taille de vos pools de nœuds pour vous adapter aux fluctuations du trafic des charges de travail.

• Supprimer un pool de nœuds : supprimez les pools de nœuds si la demande pour les charges de travail de votre cluster diminue ou si vous souhaitez supprimer des types de machines qui ne sont plus adaptés à vos opérations de conteneur.

Pour en savoir plus sur les pools de nœuds dans un cluster, consultez À propos des nœuds.

Ce document s'adresse aux développeurs d'applications du groupe d'opérateurs d'applications et aux administrateurs informatiques du groupe d'administrateurs de plate-forme, qui sont chargés de gérer les clusters Kubernetes dans leur organisation. Pour en savoir plus, consultez Audiences pour la documentation GDC sous air gap.

Avant de commencer

Pour effectuer les tâches décrites dans ce document, vous devez demander les autorisations nécessaires et préparer votre environnement.

Demander des rôles IAM

Vous devez disposer de rôles spécifiques pour obtenir les autorisations nécessaires à la gestion des pools de nœuds dans un cluster Kubernetes. Les rôles dont vous avez besoin dépendent du type de cluster que vous utilisez : cluster partagé à portée d'organisation ou cluster standard à portée de projet. Pour en savoir plus, consultez Configurations de clusters Kubernetes.

Rôles de cluster partagés

Pour créer, supprimer, modifier ou afficher les pools de nœuds d'un cluster partagé, contactez l'administrateur IAM de votre organisation pour demander le rôle Administrateur de cluster utilisateur (user-cluster-admin). Ce rôle n'est pas lié à un espace de noms.

Rôles de cluster standards

Contactez l'administrateur IAM de votre projet pour demander les rôles suivants :

• Administrateur de cluster Standard (standard-cluster-admin) : créez, supprimez, modifiez ou affichez les pools de nœuds d'un cluster Standard.

• Développeur de cluster (cluster-developer) : créez, supprimez, modifiez ou consultez un cluster standard. Ce rôle est nécessaire pour afficher les détails du pool de nœuds du cluster dans la console GDC.

Ces rôles sont liés à l'espace de noms de votre projet.

Préparer votre environnement

Pour exécuter des commandes sur un cluster Kubernetes à l'aide de l'API, assurez-vous de disposer des ressources suivantes :

• Recherchez le nom du cluster Kubernetes ou demandez-le à un membre du groupe d'administrateurs de la plate-forme.

• Utilisez le nom du cluster Kubernetes pour remplacer KUBERNETES_CLUSTER_NAME dans ces instructions.

• Connectez-vous et générez le fichier kubeconfig du serveur d'API de gestion pour le cluster Kubernetes.

• Utilisez le chemin kubeconfig du serveur d'API de gestion pour remplacer MANAGEMENT_API_SERVER dans ces instructions.

Ajouter un pool de nœuds

Pour ajouter un pool de nœuds à un cluster Kubernetes existant, procédez comme suit :

Console

1. Dans le sélecteur de projet, sélectionnez votre projet ou votre organisation.

   Les clusters standards sont limités au niveau du projet, tandis que les clusters partagés sont limités au niveau de l'organisation. Sélectionnez le champ d'application approprié pour afficher le type de cluster Kubernetes correspondant.

2. Dans le menu de navigation, sélectionnez Kubernetes Engine> Clusters.

3. Cliquez sur le cluster dans la liste des clusters. La page Détails du cluster s'affiche.

4. Sélectionnez Pools de nœuds> Ajouter un pool de nœuds.

5. Attribuez un nom au pool de nœuds. Vous ne pouvez pas modifier le nom après avoir créé le pool de nœuds.

6. Spécifiez le nombre de nœuds de calcul à créer dans le pool de nœuds.

7. Sélectionnez la classe de machine qui correspond le mieux aux exigences de votre charge de travail. Les classes de machines s'affichent dans les paramètres suivants :

   • Type de machine
   • vCPU
   • Mémoire

8. Cliquez sur Enregistrer.

API

1. Ouvrez la spécification de la ressource personnalisée Cluster avec la CLI kubectl à l'aide de l'éditeur interactif :

   kubectl edit clusters.cluster.gdc.goog/KUBERNETES_CLUSTER_NAME \
       -n KUBERNETES_CLUSTER_NAMESPACE \
       --kubeconfig MANAGEMENT_API_SERVER
   

   Remplacez les éléments suivants :

   • KUBERNETES_CLUSTER_NAME : nom du cluster.
   • KUBERNETES_CLUSTER_NAMESPACE : espace de noms du cluster. Pour les clusters partagés, utilisez l'espace de noms platform. Pour les clusters standards, utilisez l'espace de noms du projet du cluster.
   • MANAGEMENT_API_SERVER : chemin d'accès au fichier kubeconfig pour le serveur d'API zonal où est hébergé le cluster Kubernetes.

2. Ajoutez une entrée dans la section nodePools :

   nodePools:
   # Several lines of code are omitted here.
   - machineTypeName: MACHINE_TYPE
     name: NODE_POOL_NAME
     nodeCount: NUMBER_OF_WORKER_NODES
     taints: TAINTS
     labels: LABELS
     acceleratorOptions:
       gpuPartitionScheme: GPU_PARTITION_SCHEME
   

   Remplacez les éléments suivants :

   • MACHINE_TYPE : type de machine pour les nœuds de calcul du pool de nœuds. Consultez les types de machines disponibles pour connaître les configurations possibles.
   • NODE_POOL_NAME : nom du pool de nœuds.
   • NUMBER_OF_WORKER_NODES : nombre de nœuds de calcul à provisionner dans le pool de nœuds.
   • TAINTS : rejets à appliquer aux nœuds de ce pool de nœuds. Ce champ est facultatif.
   • LABELS : libellés à appliquer aux nœuds de ce pool de nœuds. Il contient une liste de paires clé/valeur. Ce champ est facultatif.
   • GPU_PARTITION_SCHEME : schéma de partitionnement du GPU, si vous exécutez des charges de travail GPU. Exemple :mixed-2 Le GPU n'est pas partitionné si ce champ n'est pas défini. Pour connaître les profils de GPU multi-instance (MIG) disponibles, consultez Profils MIG compatibles.
   Remarque : Vous ne pouvez pas modifier les configurations de nœuds, telles que le partitionnement de GPU, une fois le pool de nœuds créé.

3. Enregistrez le fichier et quittez l'éditeur.

Afficher les pools de nœuds

Pour afficher les pools de nœuds existants dans un cluster Kubernetes, procédez comme suit :

Console

1. Dans le sélecteur de projet, sélectionnez votre projet ou votre organisation.

   Les clusters standards sont limités au niveau du projet, tandis que les clusters partagés sont limités au niveau de l'organisation. Sélectionnez le champ d'application approprié pour afficher le type de cluster Kubernetes correspondant.

2. Dans le menu de navigation, sélectionnez Kubernetes Engine> Clusters.

3. Cliquez sur le cluster dans la liste des clusters. La page Détails du cluster s'affiche.

4. Sélectionnez Pools de nœuds.

La liste des pools de nœuds exécutés dans le cluster s'affiche. Vous pouvez gérer les pools de nœuds du cluster depuis cette page.

API

• Affichez les pools de nœuds d'un cluster Kubernetes spécifique :

  kubectl get clusters.cluster.gdc.goog/KUBERNETES_CLUSTER_NAME \
      -n KUBERNETES_CLUSTER_NAMESPACE \
      -o json --kubeconfig MANAGEMENT_API_SERVER | \
      jq .status.workerNodePoolStatuses
  

  Remplacez les éléments suivants :

  • KUBERNETES_CLUSTER_NAME : nom du cluster.
  • KUBERNETES_CLUSTER_NAMESPACE : espace de noms du cluster. Pour les clusters partagés, utilisez l'espace de noms platform. Pour les clusters standards, utilisez l'espace de noms du projet du cluster.

  Le résultat ressemble à ce qui suit :

  [
    {
      "conditions": [
        {
          "lastTransitionTime": "2023-08-31T22:16:17Z",
          "message": "",
          "observedGeneration": 2,
          "reason": "NodepoolReady",
          "status": "True",
          "type": "Ready"
        },
        {
          "lastTransitionTime": "2023-08-31T22:16:17Z",
          "message": "",
          "observedGeneration": 2,
          "reason": "ReconciliationCompleted",
          "status": "False",
          "type": "Reconciling"
        }
      ],
      "name": "worker-node-pool",
      "readyNodes": 3,
      "readyTimestamp": "2023-08-31T18:59:46Z",
      "reconcilingNodes": 0,
      "stalledNodes": 0,
      "unknownNodes": 0
    }
  ]
  

Redimensionner des pools de nœuds

Vous pouvez redimensionner manuellement les pools de nœuds d'un cluster Kubernetes en augmentant ou en diminuant leur taille. Vous ne pouvez pas sélectionner un nœud spécifique à supprimer lorsque vous réduisez un pool de nœuds.

Important : L'autoscaling de vos pools de nœuds de cluster Kubernetes n'est pas pris en charge.

Pour mettre à l'échelle un pool de nœuds dans un cluster existant, procédez comme suit :

Console

1. Dans le sélecteur de projet, sélectionnez votre projet ou votre organisation.

   Les clusters standards sont limités au niveau du projet, tandis que les clusters partagés sont limités au niveau de l'organisation. Sélectionnez le champ d'application approprié pour afficher le type de cluster Kubernetes correspondant.

2. Dans le tableau de bord, sélectionnez le projet dans lequel se trouve le cluster que vous souhaitez modifier.

3. Dans le menu de navigation, sélectionnez Kubernetes Engine> Clusters.

4. Sélectionnez le nom du cluster auquel le pool de nœuds est associé. La page Détails du cluster s'affiche.

5. Cliquez sur l'onglet Pools de nœuds.

6. Sélectionnez l'icône Modifier pour le pool de nœuds que vous souhaitez redimensionner. L'invite Modifier le pool de nœuds s'affiche.

7. Mettez à jour le champ Nombre de nœuds pour refléter le nouveau nombre de nœuds requis dans le pool de nœuds. Vous pouvez augmenter ou diminuer le nombre de nœuds pour répondre aux besoins de votre charge de travail.

   Remarque : La réduction de la taille de votre pool de nœuds peut entraîner des problèmes de ressources si les nœuds restants ne disposent pas de suffisamment de mémoire pour gérer vos charges de travail existantes.

8. Cliquez sur Enregistrer.

9. Revenez à l'onglet Pools de nœuds de votre cluster et vérifiez que le pool de nœuds redimensionné présente l'état Ready et le bon nombre de nœuds. La mise à l'échelle du pool de nœuds selon vos spécifications peut prendre quelques minutes.

   

API

1. Ouvrez la spécification de ressource personnalisée Cluster avec la kubectl CLI à l'aide de l'éditeur interactif :

   kubectl edit clusters.cluster.gdc.goog/KUBERNETES_CLUSTER_NAME \
       -n KUBERNETES_CLUSTER_NAMESPACE \
       --kubeconfig MANAGEMENT_API_SERVER
   

   Remplacez les éléments suivants :

   • KUBERNETES_CLUSTER_NAME : nom du cluster qui héberge le pool de nœuds.
   • KUBERNETES_CLUSTER_NAMESPACE : espace de noms du cluster. Pour les clusters partagés, utilisez l'espace de noms platform. Pour les clusters standards, utilisez l'espace de noms du projet du cluster.
   • MANAGEMENT_API_SERVER : chemin d'accès au fichier kubeconfig pour le serveur d'API zonal où est hébergé le cluster Kubernetes.

2. Mettez à jour le champ nodeCount du pool de nœuds à redimensionner :

   nodePools:
   # Several lines of code are omitted here.
   - machineTypeName: n2-standard-2-gdc
     name: nodepool-1
     nodeCount: NUMBER_OF_WORKER_NODES
   

   Remplacez NUMBER_OF_WORKER_NODES par le nombre mis à jour de nœuds de calcul à provisionner dans le pool de nœuds.

3. Enregistrez le fichier et quittez l'éditeur.

4. Vérifiez que la mise à l'échelle de vos nœuds est terminée en examinant la configuration du pool de nœuds :

   kubectl get clusters.cluster.gdc.goog/KUBERNETES_CLUSTER_NAME \
       -n KUBERNETES_CLUSTER_NAMESPACE -o json \
       --kubeconfig MANAGEMENT_API_SERVER | jq .status.workerNodePoolStatuses
   

   Vérifiez que le nombre readyNodes correspond au nombre de nœuds que vous avez défini pour le pool de nœuds. La mise à l'échelle du pool de nœuds selon vos spécifications peut prendre quelques minutes.

Supprimer un pool de nœuds

La suppression d'un pool de nœuds supprime aussi bien les nœuds que les routes qui les desservent. Ces nœuds évinceront et replanifieront tous les pods qui s'y exécutent. Si les pods présentent des sélecteurs de nœuds spécifiques, ils peuvent rester dans un état non planifiable si aucun autre nœud du cluster ne répond aux critères spécifiés.

Important : Les pools de nœuds de plan de contrôle et d'équilibreur de charge sont essentiels au bon fonctionnement d'un cluster et ne peuvent donc pas être supprimés d'un cluster. Vous ne pouvez supprimer que les pools de nœuds de calcul.

Assurez-vous d'avoir au moins trois nœuds de calcul avant de supprimer un pool de nœuds pour vous assurer que votre cluster dispose de suffisamment d'espace de calcul pour fonctionner efficacement.

Pour supprimer un pool de nœuds, procédez comme suit :

Console

1. Dans le sélecteur de projet, sélectionnez votre projet ou votre organisation.

   Les clusters standards sont limités au niveau du projet, tandis que les clusters partagés sont limités au niveau de l'organisation. Sélectionnez le champ d'application approprié pour afficher le type de cluster Kubernetes correspondant.

2. Dans le menu de navigation, sélectionnez Kubernetes Engine> Clusters.

3. Cliquez sur le cluster qui héberge le pool de nœuds que vous souhaitez supprimer.

4. Sélectionnez Pools de nœuds.

5. Cliquez sur Supprimer à côté du pool de nœuds à supprimer.

API

1. Ouvrez la spécification de ressource personnalisée Cluster avec la kubectl CLI à l'aide de l'éditeur interactif :

   kubectl edit clusters.cluster.gdc.goog/KUBERNETES_CLUSTER_NAME \
       -n KUBERNETES_CLUSTER_NAMESPACE \
       --kubeconfig MANAGEMENT_API_SERVER
   

   Remplacez les éléments suivants :

   • KUBERNETES_CLUSTER_NAME : nom du cluster.
   • KUBERNETES_CLUSTER_NAMESPACE : espace de noms du cluster. Pour les clusters partagés, utilisez l'espace de noms platform. Pour les clusters standards, utilisez l'espace de noms du projet du cluster.
   • MANAGEMENT_API_SERVER : chemin d'accès au fichier kubeconfig pour le serveur d'API zonal où est hébergé le cluster Kubernetes.

2. Supprimez l'entrée du pool de nœuds de la section nodePools. Par exemple, dans l'extrait suivant, vous devez supprimer les champs machineTypeName, name et nodeCount :

   nodePools:
   # Several lines of code are omitted here.
   - machineTypeName: n2-standard-2-gdc
     name: nodepool-1
     nodeCount: 3
   

   Veillez à supprimer tous les champs du pool de nœuds que vous supprimez.

3. Enregistrez le fichier et quittez l'éditeur.

Étapes suivantes

• Gérer les clusters Kubernetes
• Charges de travail de conteneur dans GDC
• Isoler les charges de travail des conteneurs