Tous les produits
Search
Centre de documentation

Container Service for Kubernetes:Manually upgrade an ACK cluster

Dernière mise à jour :Aug 11, 2026

Pour atténuer les risques de sécurité et de stabilité liés aux versions obsolètes, mettez à niveau votre cluster sans délai. Une mise à niveau de cluster implique la mise à niveau du plan de contrôle et des pools de nœuds.

Important

Avant de mettre à niveau le cluster, consultez la rubrique Mettre à niveau un cluster afin de comprendre le processus, les méthodes et les considérations importantes liées à la mise à niveau.

Point d'entrée de l'opération

Commencez par mettre à niveau le plan de contrôle, puis les pools de nœuds. Avant de mettre à niveau le plan de contrôle, assurez-vous que les versions de kubelet et du runtime de conteneur sur les nœuds correspondent à celle du plan de contrôle. Cette précaution évite les échecs de mise à niveau ou les interruptions de service. Par exemple, si le plan de contrôle est en version 1.32 et les nœuds en version 1.31, mettez à niveau les nœuds vers la version 1.32 avant de passer le plan de contrôle à la version 1.33.

  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 Operations > Upgrade Cluster.

  3. Sur la page Upgrade Cluster, sélectionnez une Destination Version disponible et suivez les instructions affichées à l'écran pour terminer le processus de mise à niveau.

Mettre à niveau le plan de contrôle

1. Pré-vérification

La pré-vérification de la mise à niveau du plan de contrôle analyse les API dépréciées, la compatibilité des composants et l'état général du cluster.

Pour les clusters exécutant la version 1.20 ou ultérieure, la pré-vérification détecte les API dépréciées . Les résultats de l'analyse n'affectent pas le processus de mise à niveau ; ils sont fournis à titre informatif uniquement. Résolvez les problèmes identifiés avant la mise à niveau afin de garantir le bon fonctionnement de la nouvelle version du cluster.

Sur la page Upgrade Cluster, cliquez sur Precheck pour identifier les risques potentiels avant la mise à niveau. Une fois l'analyse terminée, consultez les résultats dans la section Pre-check Results. L'illustration suivante montre un exemple.

image

  • Normal : la vérification de la mise à niveau a réussi. Vous pouvez procéder à la mise à niveau.

  • Anormal : le résultat n'affecte pas le fonctionnement ni l'état actuel du cluster. Résolvez les problèmes en appliquant les solutions fournies. Pour plus d'informations, consultez la rubrique Éléments de vérification du cluster et solutions.

2. Effectuer la mise à niveau

Durée : Pour les clusters ACK managés et les clusters ACK serverless, la mise à niveau est gérée par ACK et prend environ 5 minutes. Pour les clusters ACK dédiés, les nœuds master sont mis à niveau un par un, séquentiellement. Chaque nœud nécessite environ 8 minutes.

Après avoir résolu les problèmes détectés lors de la pré-vérification, cliquez sur Upgrade et suivez les instructions affichées à l'écran pour mettre à niveau le plan de contrôle.

Une fois le plan de contrôle mis à niveau, la version des nouveaux nœuds ajoutés lors du scale-out s'alignera également sur celle du plan de contrôle.

image

3. Validation post-mise à niveau

Après la mise à niveau du plan de contrôle, vérifiez les points suivants :

对 Le plan de contrôle a été mis à niveau avec succès. La version du cluster est actualisée sur la page Clusters.

对 L'API Server et les composants principaux sont dans un état Normal.

对 Les applications métier fonctionnent comme prévu.

对 Les pods peuvent être créés normalement.

对 Les nœuds peuvent être ajoutés normalement.

Mettre à niveau un pool de nœuds

Une fois le plan de contrôle mis à niveau, mettez à niveau le pool de nœuds dès que possible pendant les heures creuses. La mise à niveau du pool de nœuds implique la mise à jour de kubelet et du runtime de conteneur sur les nœuds.

1. Pré-vérification

La pré-vérification de la mise à niveau du pool de nœuds analyse l'état des nœuds, les ressources système, l'état des disques et l'environnement réseau.

Sur la page Node Pool Upgrade, localisez le pool de nœuds cible dans la liste et cliquez sur Upgrade dans la colonne Actions. Ensuite, en bas de la page, cliquez sur Precheck pour identifier les risques potentiels durant le processus de mise à niveau. Une fois l'analyse terminée, consultez les résultats dans la section Pre-check Results.

image

  • Normal : la vérification de la mise à niveau a réussi. Vous pouvez procéder à la mise à niveau.

  • Anormal : le résultat n'affecte pas le fonctionnement ni l'état actuel du cluster. Résolvez les problèmes en suivant les instructions de la console et en consultant la rubrique Éléments de vérification du cluster et solutions.

2. Configurer une politique de mise à niveau et effectuer la mise à niveau

Durée : La durée dépend du regroupement des nœuds en lots. Une mise à niveau sur place prend environ 5 à 10 minutes par lot. Une mise à niveau par remplacement du disque système sans snapshot prend environ 8 minutes. La durée exacte est influencée par le temps nécessaire au drainage des nœuds. Si des snapshots doivent être créés, la mise à niveau commence après leur création. Le temps requis pour créer les snapshots dépend du volume de données.

Configurez une politique de mise à niveau comme décrit dans le tableau suivant. Ensuite, cliquez sur Upgrade et suivez les instructions affichées à l'écran pour mettre à niveau le pool de nœuds.

Élément de configuration

Description

Informations sur la version

Les versions actuelles et disponibles de kubelet et du runtime de conteneur.

Update Nodes

Vous pouvez mettre à niveau tous les nœuds simultanément, ou mettre à niveau certains nœuds en premier, puis les autres après avoir confirmé que tout fonctionne correctement.

Méthode de mise à niveau

  • In-place Upgrade : les composants requis sont mis à jour et remplacés directement sur le nœud d'origine. Le disque système n'est pas remplacé et le nœud n'est pas réinitialisé. Les données présentes sur le nœud d'origine ne sont pas affectées.

  • Upgrade by Replacing System Disk : le nœud est réinitialisé en remplaçant son disque système. Les propriétés de l'instance du nœud, telles que le nom du nœud, l'ID d'instance et l'adresse IP, restent inchangées. Cependant, les données du disque système sont supprimées. Les données des disques de données attachés séparément au nœud ne sont pas affectées.

    Pour plus d'informations sur la logique et le processus de mise à niveau, consultez la rubrique Référence : Mise à niveau sur place et mise à niveau par remplacement de disque.

Batch Update Policy

  • Maximum Number of Nodes per Batch : ACK ne met à niveau qu'un seul pool de nœuds à la fois. Les nœuds au sein du pool de nœuds sont mis à niveau par lots selon ce paramètre. Si vous suspendez puis reprenez la mise à niveau, la politique de lot reste appliquée. Le nombre de nœuds par lot augmente progressivement : 1, 2, 4, 8, etc., jusqu'à atteindre le nombre maximal de nœuds traités simultanément. Ensuite, chaque lot contient ce nombre maximal de nœuds.

    Par exemple, si le nombre maximal de nœuds simultanés est de 4, le nombre de nœuds par lot sera de 1, 2, 4, 4, 4, etc. Pour plus d'informations, consultez la rubrique Référence : Mise à niveau sur place et mise à niveau par remplacement de disque.
  • Automatic Pause Policy : politique permettant de suspendre le processus de mise à niveau des nœuds. Si vous sélectionnez Automatic, vous pouvez également configurer l'Interval Between Batches. Il s'agit de la durée de l'intervalle, le cas échéant, entre les lots de mise à niveau (de 5 à 120 minutes).

  • Auto Snapshot : si les disques système de vos nœuds contiennent des données métier importantes, vous pouvez choisir de créer des snapshots pour les nœuds avant de mettre à niveau le pool de nœuds. Cela vous permet de sauvegarder et de restaurer les données des nœuds.

    Important

3. Validation post-mise à niveau

Après la mise à niveau du pool de nœuds, vérifiez les points suivants :

对 Les nœuds ont été mis à niveau avec succès. Les versions de kubelet et de containerd sont actualisées sur la page des détails du nœud.

对 La planification des pods fonctionne normalement.

对 Les applications métier fonctionnent comme prévu.

Références

  • Pour obtenir des réponses aux questions fréquentes que vous pourriez avoir avant et pendant la mise à niveau d'un cluster, consultez la rubrique FAQ.

  • Pour plus d'informations sur la politique de prise en charge des versions Kubernetes par ACK, consultez le Guide des versions.

  • À partir de la version 1.24, Docker n'est plus pris en charge en tant que runtime de conteneur intégré. Si vous effectuez une mise à niveau vers la version 1.24 ou ultérieure, vous devez migrer le runtime de conteneur des nœuds de Docker vers containerd.

  • À partir de la version 1.30, CentOS et Alibaba Cloud Linux 2 ne sont plus pris en charge. Vous pouvez utiliser d'autres systèmes d'exploitation pris en charge.

  • Vous pouvez également activer les mises à niveau automatiques des clusters pour réduire la charge de travail liée à la gestion des versions. Pour plus d'informations, consultez la rubrique Mettre à niveau automatiquement un cluster.