Container Service for Kubernetes:Mettre à niveau un pool de nœuds

Considérations

• Vérifications préalables à la mise à niveau

  • Les mises à niveau de cluster utilisent yum pour télécharger les packages logiciels requis. Si vous avez modifié manuellement les configurations réseau des nœuds ou utilisé une image de système d'exploitation (OS) personnalisée, assurez-vous que yum fonctionne correctement sur vos nœuds. Exécutez yum makecache pour le vérifier.

  • ACK ne valide pas strictement les images OS personnalisées. Par conséquent, nous ne pouvons pas garantir le succès de la mise à niveau.

  • Si vous avez apporté des modifications de configuration au cluster, telles que l'activation de la partition SWAP ou la modification des configurations de kubelet ou du runtime via des opérations en ligne de commande, la mise à niveau du cluster peut échouer ou vos configurations personnalisées peuvent être écrasées.

  • Après la mise à niveau d'un cluster vers la version 1.18, ACK configure par défaut la politique de réservation des ressources des nœuds. Si aucune réservation de ressources n'est configurée et que l'utilisation des ressources des nœuds est élevée, les pods risquent de ne pas être ordonnancés rapidement après leur éviction. Réservez des ressources pour vos nœuds. Maintenez l'utilisation du CPU à 50 % ou moins et celle de la mémoire à 70 % ou moins.

  • Dans les clusters exécutant la version 1.24 ou antérieure, si les pods d'une charge de travail sont configurés uniquement avec une sonde de démarrage (Startup Probe), les pods passent brièvement à l'état NotReady après le redémarrage de kubelet. Déployez les charges de travail avec plusieurs réplicas sur différents nœuds. Cela garantit qu'un nombre suffisant de pods reste disponible si un nœud redémarre.

  • Gardez au moins 20 % d'espace disque libre. Cela permet d'éviter l'éviction des pods due à une capacité disque insuffisante pendant une mise à niveau.

• Contraintes de mise à niveau du pool de nœuds

  • Les mises à niveau des pools de nœuds prennent uniquement en charge les opérations de scale-out. Les opérations de scale-in ne sont pas prises en charge.

  • Si vous disposez de nœuds de calcul non gérés qui n'appartiennent à aucun pool de nœuds, migrez-les. Pour plus d'informations, consultez Migrer des nœuds non gérés vers un pool de nœuds.

  • La mise à niveau des pools de nœuds Lingjun n'est pas prise en charge lors de la mise à niveau d'un cluster ACK.

  • Lorsque vous mettez à niveau les nœuds en remplaçant leurs disques, ACK les réinitialise en fonction de la configuration actuelle du pool de nœuds. Cela inclut la méthode de connexion, les libellés, les taints, l'image OS et la version du runtime. Pour mettre à jour les configurations du pool de nœuds, consultez Modifier un pool de nœuds. Si vous avez modifié les nœuds d'une autre manière, la mise à niveau écrasera vos modifications.

  • Si un pod sur un nœud référence un HostPath pointant vers le disque système, les données du répertoire HostPath seront perdues après une mise à niveau par remplacement de disque.

  • Lors de la mise à niveau d'un pool de nœuds dans un cluster de version 1.31 ou antérieure, le processus met également à niveau le plug-in NVIDIA Device et réinitialise toutes ses configurations non standard.

• mise à l'échelle des nœuds et ordonnancement

  • Si la fonctionnalité de mise à l'échelle des nœuds est activée sur le cluster, cluster-autoscaler est automatiquement mis à jour vers la dernière version après une mise à niveau réussie afin de garantir que la fonctionnalité de mise à l'échelle automatique ne soit pas affectée. Après la mise à niveau du cluster, confirmez que la version de cluster-autoscaler est correcte. Pour plus d'informations, consultez Activer la mise à l'échelle automatique des nœuds.

  • Lors d'une mise à niveau de cluster, les nœuds dont le Scaling Mode est défini sur Swift peuvent échouer à la mise à niveau car ils sont arrêtés. Si des nœuds ne sont pas mis à niveau en raison du mode Swift une fois la mise à niveau terminée, nous vous recommandons de les supprimer manuellement.

• Réseau et disponibilité des services

  • Si un pod utilise l'adresse SLB d'un service LoadBalancer pour accéder à un autre pod sur le même nœud, et que la propriété externalTrafficPolicy du service est définie sur Local, les deux pods peuvent ne plus se trouver sur le même nœud après la rotation des nœuds. Cela peut entraîner l'échec de la connexion réseau.

  • Lorsque vous mettez à niveau les nœuds en remplaçant leurs disques, ACK draine les nœuds. Ce processus évince les pods vers d'autres nœuds actifs tout en respectant le Pod Disruption Budget (PDB). Pour garantir une haute disponibilité, déployez les charges de travail avec plusieurs réplicas sur différents nœuds. Configurez également un PDB pour les services critiques afin de contrôler le nombre de pods pouvant être perturbés simultanément.

    Le délai d'attente par défaut pour le drainage d'un nœud est de 30 minutes. Si la migration des pods n'est pas terminée dans ce délai, ACK interrompt la mise à niveau pour assurer la stabilité du service.

Fonctionnalités

Une mise à niveau de pool de nœuds inclut la mise à niveau de kubelet et du runtime de conteneur.

• Mise à niveau de kubelet : le kubelet sur chaque nœud du pool est mis à niveau pour correspondre à la version du plan de contrôle. Méthode par défaut : mise à niveau sur place.

• Mise à niveau du runtime de conteneur : mettez à niveau le runtime de conteneur sur les nœuds lorsqu'une nouvelle version est disponible.

  • La migration de Docker vers containerd remplace le disque système des nœuds du pool, effaçant toutes les données du disque système. Sauvegardez les données critiques avant la mise à niveau. Consultez Migrer le runtime de conteneur des nœuds de Docker vers containerd.

  • À l'exception des nœuds ContainerOS, la mise à niveau d'une version de containerd vers une version plus récente effectue par défaut une mise à niveau sur place. Le fichier /etc/containerd/config.toml sur le nœud est remplacé par la nouvelle version fournie par ACK.

    Important

    • Les nœuds ContainerOS ne prennent en charge que le remplacement du disque système pour les mises à niveau de containerd. Consultez Mettre à niveau les versions de ContainerOS antérieures à 3,4 vers la dernière version.

    • Lors d'une mise à niveau du runtime de conteneur, les sondes de pod et les hooks de cycle de vie peuvent échouer, et les pods peuvent redémarrer sur place.

  • Dans les clusters exécutant Kubernetes 1.24 ou une version antérieure, la mise à niveau de Docker remplace par défaut le disque système des nœuds du pool, effaçant toutes les données du disque système. Sauvegardez les données critiques avant la mise à niveau.

Procédure

1. Connectez-vous à la console ACK. Dans le volet de navigation de gauche, cliquez sur Clusters.

2. Sur la page Clusters, cliquez sur le nom de votre cluster. Dans le volet de navigation de gauche, cliquez sur Nodes > Node Pools.

3. Sur la page Node Pools, localisez le pool de nœuds cible, cliquez sur l'icône dans la colonne Actions, puis sélectionnez Kubelet Update. Configurez les paramètres suivants.

   Paramètre		Description
   Kubelet Update Information		Affichez la version actuelle de kubelet et sélectionnez la version cible.
   Runtime Update Information		Affichez la version actuelle du runtime de conteneur et sélectionnez la version cible. La migration de Docker vers containerd remplace le disque système des nœuds du pool, effaçant tout le contenu du disque système. Consultez Migrer le runtime de conteneur des nœuds de Docker vers containerd. Les clusters en version 1.22 avec containerd 1.6.34 ne prennent pas en charge les mises à niveau du runtime.
   Update Nodes		Sélectionnez les nœuds à mettre à niveau : tous ou des nœuds spécifiques.
   Méthode de mise à niveau		Sélectionnez In-place Upgrade ou Upgrade by Replacing System Disk. Consultez Référence : Mise à niveau sur place et mise à niveau par remplacement du disque système. In-place Upgrade : ACK met à jour les composants directement sur les nœuds existants. Une mise à niveau sur place ne remplace pas le disque système ni ne réinitialise le nœud, et les données ne sont pas affectées. Upgrade by Replacing System Disk : ACK réinitialise les nœuds en remplaçant leur disque système. Les attributs de l'instance tels que le nom, l'ID et l'adresse IP restent inchangés, mais les données du disque système sont supprimées. Les disques de données attachés ne sont pas affectés.
   Ignore Warnings		Indique s'il faut poursuivre si la vérification préalable signale des avertissements. Par exemple, si un pod utilise un hostPath pointant vers le disque système.
   Batch Update Policy	Maximum Number of Nodes per Batch	Les nœuds sont mis à niveau par lots jusqu'à ce maximum. Consultez Référence : Mise à niveau sur place et mise à niveau par remplacement du disque système.
   	Automatic Pause Policy	La politique de pause pour le processus de mise à niveau.
   	Interval Between Batches	Intervalle entre les lots lorsqu'aucune pause automatique n'est configurée. Valeurs valides : 5 à 120 minutes.
   	Auto Snapshot	Si le disque système d'un nœud contient des données importantes, créez des snapshots avant de mettre à niveau le pool de nœuds. Les snapshots entraînent des frais (voir Facturation des snapshots) et la progression de la création change dynamiquement. Après la mise à niveau, supprimez les snapshots inutiles. Remarque Si vous sélectionnez Upgrade by replacing system disk, activez la création automatique de snapshots. Les snapshots engendrent des coûts. Consultez Facturation des snapshots.

4. Cliquez sur Precheck. Une fois la vérification préalable réussie, suivez les instructions à l'écran pour démarrer la mise à niveau.

   Remarque

   Si la vérification préalable échoue ou renvoie des avertissements, consultez Correctifs pour les éléments de vérification ayant échoué ou affichez le Check Report pour résoudre les problèmes.

   Pendant la mise à niveau, vous pouvez :

   • Pause : place le pool de nœuds dans un état intermédiaire. Évitez d'autres opérations sur le cluster et terminez la mise à niveau rapidement. Les mises à niveau en pause depuis plus de sept jours sont automatiquement interrompues, et les événements et journaux associés sont effacés.

     Vous ne pouvez pas revenir aux versions précédentes de kubelet ou du runtime de conteneur sur les nœuds déjà mis à niveau.

   • Cancel : annule la mise à niveau. Après avoir cliqué sur Cancel, vous ne pouvez pas revenir aux versions précédentes de kubelet ou du runtime de conteneur sur les nœuds déjà mis à niveau.

   Pour vérifier, accédez à la page Nodes, cliquez sur le nom d'un nœud et vérifiez les versions de kubelet et du runtime de conteneur dans l'onglet Basic Information.

Mises à niveau sur place et par remplacement

Processus de mise à niveau

La mise à niveau sur place et la mise à niveau par remplacement du disque système suivent ce processus. La mise à niveau du pool de nœuds traite les nœuds par lots, en commençant par 1 et en doublant (1, 2, 4, 8...) jusqu'à atteindre le nombre maximal de traitements simultanés. Par exemple, avec un maximum de 4 : le lot 1 met à niveau 1 nœud, le lot 2 met à niveau 2 nœuds, puis tous les lots suivants mettent à niveau 4 nœuds.

La figure suivante montre l'exécution par lots avec N nœuds simultanés maximum. Les tailles des lots sont 1, 2, 4, 8... jusqu'à atteindre N.

FAQ

echo 2 > /proc/sys/vm/drop_caches

Références

• Activez les mises à niveau automatiques du cluster pour réduire la charge de maintenance.

• Pour l'historique des versions de containerd, consultez Notes de version du runtime containerd.

• Les pools de nœuds gérés par ACK prennent en charge le patching automatique des CVE de l'OS.

• À partir de Kubernetes 1.24, Docker n'est plus un runtime de conteneur pris en charge. Vous devez migrer le runtime de conteneur des nœuds de Docker vers containerd. Consultez Migrer le runtime de conteneur des nœuds de Docker vers containerd.

  Docker et containerd utilisent des outils en ligne de commande différents. Consultez Comparaison des commandes courantes pour Docker et containerd.

• Maintenez les images OS à jour. Consultez Changer le système d'exploitation.