Tous les produits
Search

Ce produit

    Container Service for Kubernetes:Upgrade an edge node

    Centre de documentation

    Container Service for Kubernetes:Upgrade an edge node

    Dernière mise à jour :Aug 11, 2026

    Après la mise à niveau du plan de contrôle, exécutez manuellement la commande de mise à niveau sur chaque nœud de périphérie.

    Prérequis

    Avant de commencer :

    • Le plan de contrôle du cluster ACK Edge est mis à niveau. Consultez la rubrique Mettre à niveau un cluster ACK Edge.

    • Le mode d'interconnexion des nœuds de périphérie est identifié : basic (réseau public) ou private (circuits Express Connect).

    Limites

    Contrainte Détails
    Plages de versions prises en charge Versions 1,18 à 1,24 : suivez ces étapes. Versions 1,26 à 1,30 : soumettez un ticket pour contacter l'équipe Container Service. Autres versions : non prises en charge.
    Mises à niveau séquentielles des versions mineures Chaque mise à niveau ne fait avancer que d'une version mineure. Pour passer de la version 1,18 à la version 1,22, effectuez deux mises à niveau : 1,18 → 1,20, puis 1,20 → 1,22.
    Écart de version entre le plan de contrôle et les nœuds de périphérie Le plan de contrôle et les nœuds de périphérie peuvent présenter un écart maximal de deux versions mineures. Par exemple, si le plan de contrôle exécute la version 1,22, les nœuds de périphérie doivent exécuter au minimum la version 1,20. Synchronisez les versions dans la mesure du possible.
    Taille du lot Mettez à niveau au maximum 20 nœuds par lot afin de limiter l'impact.
    Nœuds cloud Consultez la rubrique Mettre à niveau un pool de nœuds sur le cloud.

    Mettre à niveau les nœuds de périphérie

    Suivez les étapes correspondant à votre runtime de conteneur.

    Si le runtime est Docker (mise à niveau vers la version 1,24)

    Kubernetes 1,24 a abandonné la prise en charge du runtime Docker. Migrez de Docker vers containerd avant d'effectuer la mise à niveau vers la version 1,24.

    Option 1 (recommandée) : Migration progressive vers un nouveau pool de nœuds

    1. Créez un pool de nœuds containerd. Consultez la documentation Gestion des pools de nœuds de périphérie.

    2. Migrez les charges de travail vers le nouveau pool de nœuds :

      • Définissez l'ancien pool de nœuds comme non planifiable. Consultez la documentation Drainage des nœuds et statut de planification.

      • Mettez à jour les sélecteurs de nœuds des charges de travail pour utiliser les libellés du nouveau pool de nœuds.

    3. Mettez hors ligne l'ancien pool de nœuds une fois toutes les charges de travail migrées.

    Option 2 : Mise à jour sur place

    Redémarre tous les conteneurs sur le nœud.

    1. Remplacez le runtime de conteneur Docker par containerd.

    2. Drainez le nœud avant la mise à niveau. Consultez la documentation Drainage des nœuds et statut de planification.

    3. Mettez à niveau chaque nœud individuellement :

      Paramètre Description Exemple
      TARGET_CLUSTER_VERSION La version Kubernetes du plan de contrôle mis à jour 1.24.6-aliyunedge.1 — consultez les Notes de version des versions Kubernetes prises en charge
      REGION L'ID de région du cluster cn-hangzhou — consultez les Régions prises en charge
      INTERCONNECT_MODE Le type de réseau : basic pour le réseau public, private pour les circuits Express Connect basic 
      export REGION="" INTERCONNECT_MODE="" TARGET_CLUSTER_VERSION=""; export ARCH=$(uname -m | awk '{print ($1 == "x86_64") ? "amd64" : (($1 == "aarch64") ? "arm64" : "amd64")}') INTERNAL=$( [ "$INTERCONNECT_MODE" = "private" ] && echo "-internal" || echo "" ); wget http://aliacs-k8s-${REGION}.oss-${REGION}${INTERNAL}.aliyuncs.com/public/pkg/run/attach/${TARGET_CLUSTER_VERSION}/${ARCH}/edgeadm -O edgeadm; chmod u+x edgeadm;./edgeadm upgrade --interconnect-mode=${INTERCONNECT_MODE} --region=${REGION}

      Définissez ces paramètres avant d'exécuter la commande :

    4. Vérifiez que la mise à niveau a réussi. La sortie affiche :

      This node has been upgraded successfully

      Upgrade success output

    Si le runtime n'est pas Docker

    Mettez à niveau chaque nœud individuellement :

    export REGION="" INTERCONNECT_MODE="" TARGET_CLUSTER_VERSION=""; export ARCH=$(uname -m | awk '{print ($1 == "x86_64") ? "amd64" : (($1 == "aarch64") ? "arm64" : "amd64")}') INTERNAL=$( [ "$INTERCONNECT_MODE" = "private" ] && echo "-internal" || echo "" ); wget http://aliacs-k8s-${REGION}.oss-${REGION}${INTERNAL}.aliyuncs.com/public/pkg/run/attach/${TARGET_CLUSTER_VERSION}/${ARCH}/edgeadm -O edgeadm; chmod u+x edgeadm;./edgeadm upgrade --interconnect-mode=${INTERCONNECT_MODE} --region=${REGION}

    Définissez ces paramètres avant d'exécuter la commande :

    Paramètre Description Exemple
    TARGET_CLUSTER_VERSION La version Kubernetes du plan de contrôle mis à jour 1.24.6-aliyunedge.1 — consultez les Notes de version des versions Kubernetes prises en charge
    REGION L'ID de région du cluster cn-hangzhou — consultez les Régions prises en charge
    INTERCONNECT_MODE Le type de réseau : basic pour le réseau public, private pour les circuits Express Connect basic

    Vérifiez que la mise à niveau a réussi. La sortie affiche :

    This node has been upgraded successfully

    Upgrade success output

    FAQ

    Que faire en cas d'échec de la mise à niveau d'un nœud de périphérie ?

    Si la sortie n'inclut pas This node has been upgraded successfully, consultez la rubrique Que faire en cas d'échec de la mise à niveau d'un nœud de périphérie lors de la mise à niveau d'un cluster ACK Edge ?.

    Étapes suivantes