Mettre à niveau les nœuds hybrides pour votre cluster

Connectez vos nouveaux hôtes en tant que nœuds hybrides en suivant les étapes Connecter les nœuds hybrides. Lorsque vous exécutez la commande nodeadm install, utilisez votre version cible de Kubernetes.

Activez la communication entre les nouveaux nœuds hybrides sur la version Kubernetes cible et vos nœuds hybrides sur l’ancienne version Kubernetes. Cette configuration permet aux pods de communiquer entre eux pendant que vous migrez votre charge de travail vers les nœuds hybrides sur la version Kubernetes cible.

Vérifiez que vos nœuds hybrides sur votre version Kubernetes cible ont bien rejoint votre cluster et ont le statut Ready.

Utilisez la commande suivante pour marquer chacun des nœuds que vous souhaitez supprimer comme non planifiable. Cela permet d’éviter que de nouveaux pods ne soient planifiés ou replanifiés sur les nœuds que vous remplacez. Pour plus d’informations, consultez le cordon kubelet dans la documentation Kubernetes. Remplacez NODE_NAME par le nom des nœuds hybrides de l’ancienne version de Kubernetes.

kubectl cordon NODE_NAME
            

Vous pouvez identifier et isoler tous les nœuds d’une version particulière de Kubernetes (dans ce cas, 1.28) à l’aide de l’extrait de code suivant.

K8S_VERSION=1.28
for node in $(kubectl get nodes -o json | jq --arg K8S_VERSION "$K8S_VERSION" -r '.items[] | select(.status.nodeInfo.kubeletVersion | match("\($K8S_VERSION)")).metadata.name')
do
    echo "Cordoning $node"
    kubectl cordon $node
done

Si votre déploiement actuel exécute moins de deux réplicas CoreDNS sur vos nœuds hybrides, augmentez horizontalement la capacité du déploiement à au moins deux réplicas. Nous vous recommandons d’exécuter au moins deux réplicas CoreDNS sur des nœuds hybrides afin d’assurer la résilience pendant les opérations normales.

kubectl scale deployments/coredns --replicas=2 -n kube-system

Videz chacun des nœuds hybrides de l’ancienne version de Kubernetes que vous souhaitez supprimer de votre cluster à l’aide de la commande suivante. Pour plus d’informations sur la mise hors tension des nœuds, consultez la section Mettre hors tension un nœud en toute sécurité dans la documentation Kubernetes. Remplacez NODE_NAME par le nom des nœuds hybrides de l’ancienne version de Kubernetes.

kubectl drain NODE_NAME --ignore-daemonsets --delete-emptydir-data

Vous pouvez identifier et vider tous les nœuds d’une version particulière de Kubernetes (dans ce cas, 1.28) à l’aide de l’extrait de code suivant.

K8S_VERSION=1.28
for node in $(kubectl get nodes -o json | jq --arg K8S_VERSION "$K8S_VERSION" -r '.items[] | select(.status.nodeInfo.kubeletVersion | match("\($K8S_VERSION)")).metadata.name')
do
    echo "Draining $node"
    kubectl drain $node --ignore-daemonsets --delete-emptydir-data
done

Vous pouvez utiliser nodeadm pour arrêter et supprimer les artefacts des nœuds hybrides de l’hôte. Vous devez exécuter nodeadm avec un utilisateur disposant des privilèges root/sudo. Par défaut, nodeadm uninstall ne continuera pas s’il reste des pods sur le nœud. Pour plus d’informations, consultez Référence des nœuds hybrides nodeadm.

nodeadm uninstall

Une fois les artefacts des nœuds hybrides arrêtés et désinstallés, supprimez la ressource du nœud de votre cluster.

kubectl delete node node-name
            

Vous pouvez identifier et supprimer tous les nœuds d’une version particulière de Kubernetes (dans ce cas, 1.28) à l’aide de l’extrait de code suivant.

K8S_VERSION=1.28
for node in $(kubectl get nodes -o json | jq --arg K8S_VERSION "$K8S_VERSION" -r '.items[] | select(.status.nodeInfo.kubeletVersion | match("\($K8S_VERSION)")).metadata.name')
do
    echo "Deleting $node"
    kubectl delete node $node
done

Selon votre choix de CNI, il se peut que des artefacts subsistent sur vos nœuds hybrides après avoir exécuté les étapes ci-dessus. Pour plus d’informations, consultez Configurer CNI pour les nœuds hybrides.

Utilisez la commande suivante pour marquer le nœud que vous mettez à niveau comme non planifiable. Cela permet d’éviter que de nouveaux pods ne soient planifiés ou replanifiés sur le nœud que vous mettez à niveau. Pour plus d’informations, consultez kubectl cordon dans la documentation Kubernetes. Remplacer NODE_NAME par le nom du nœud hybride que vous mettez à niveau

kubectl cordon NODE_NAME

Videz le nœud que vous mettez à niveau à l’aide de la commande suivante. Pour plus d’informations sur la mise hors tension des nœuds, consultez la section Mettre hors tension un nœud en toute sécurité dans la documentation Kubernetes. Remplacez NODE_NAME par le nom du nœud hybride que vous mettez à niveau.

kubectl drain NODE_NAME --ignore-daemonsets --delete-emptydir-data

Exécutez nodeadm upgrade sur le nœud hybride que vous mettez à niveau. Vous devez exécuter nodeadm avec un utilisateur disposant des privilèges root/sudo. Le nom du nœud est conservé lors de la mise à niveau pour les fournisseurs d’informations d’identification AWS SSM et Rôles Anywhere IAM AWS. Vous ne pouvez pas changer de fournisseur d’informations d’identification pendant le processus de mise à niveau. Consultez Référence des nœuds hybrides nodeadm pour les valeurs de configuration de nodeConfig.yaml. Remplacez K8S_VERSION par la version cible de Kubernetes vers laquelle vous effectuez la mise à niveau.

nodeadm upgrade K8S_VERSION -c file://nodeConfig.yaml

Pour autoriser la planification des pods sur le nœud après la mise à niveau, tapez ce qui suit. Remplacez NODE_NAME par le nom du nœud.

kubectl uncordon NODE_NAME

Vérifiez le statut de vos nœuds hybrides et attendez que vos nœuds s’arrêtent et redémarrent sur la nouvelle version de Kubernetes avec le statut Ready.

kubectl get nodes -o wide -w