Comment mettre à niveau les modules complémentaires Amazon EKS ?

Résolution

Remarque : Si des erreurs surviennent lorsque vous exécutez des commandes de l'interface de la ligne de commande AWS (AWS CLI), consultez la section Résoudre des erreurs liées à l’AWS CLI. Vérifiez également que vous utilisez bien la version la plus récente de l’AWS CLI.

Vérifier les versions complémentaires que vous pouvez utiliser

Pour identifier les versions des modules complémentaires que vous pouvez utiliser pour votre version de cluster Amazon EKS, exécutez la commande describe-addon-versions de l'interface de ligne de commande AWS suivante :

aws eks describe-addon-versions --kubernetes-version=cluster-version --addon-name=addon-name --query='addons[].addonVersions[].addonVersion'

Remarque : Remplacez cluster-version par la version Kubernetes de votre cluster Amazon EKS. Remplacez également addon-name par le nom du module complémentaire, tel que vpc-cni ou coredns.

Effectuer une mise à niveau des modules complémentaires

Si vos modules complémentaires présentent des configurations personnalisées ou des ressources différentes des paramètres par défaut, vous risquez de rencontrer des conflits lors de la mise à niveau. Pour résoudre ces problèmes, utilisez l'interface de ligne de commande AWS et l'option --resolve-conflicts pour mettre à niveau vos modules complémentaires. Il est recommandé de tester le processus de mise à niveau dans un environnement hors production avant de l'appliquer à votre cluster de production. Pour plus d'informations, consultez la section Comment éviter les conflits de configuration lorsque je crée ou mets à jour mes modules complémentaires gérés par Amazon EKS ?

Pour effectuer une mise à niveau des modules complémentaires, utilisez eksctl, la console Amazon EKS ou l'AWS CLI.

Vérifier la mise à niveau

Utilisez la commande kubectl pour vérifier l'état de déploiement des modules complémentaires et vous assurer que les pods exécutent la nouvelle version. Pour les modules complémentaires daemonset, tels que vpc-cni et kube-proxy, vérifiez si le nombre de réplicas est égal au nombre de nœuds. Les modules complémentaires vpc-cni et kube-proxy ne s'exécutent pas sur les nœuds AWS Fargate ou Windows.

Par exemple, exécutez la commande suivante pour vérifier la version actuelle du déploiement CoreDNS :

kubectl describe deployment coredns -n kube-system | grep Image | cut -d ":" -f 3

Vous pouvez également suivre les étapes suivantes pour vérifier les détails des modules complémentaires dans la console Amazon EKS :

1. Ouvrez la console Amazon EKS.
2. Dans le volet de navigation, sélectionnez Clusters.
3. Choisissez votre cluster.
4. Choisissez l’onglet Modules complémentaires.
5. Pour afficher la nouvelle version, vérifiez la valeur dans la colonne Version du module complémentaire.

Pour vérifier que les journaux des pods de modules complémentaires ne contiennent pas d'erreurs ou de problèmes survenus au cours du processus de mise à niveau, exécutez la commande suivante :

kubectl logs -n kube-system -l k8s-app=kube-dns

Exécuter des tests supplémentaires

Pour déterminer si votre module complémentaire requiert des tests supplémentaires après une mise à niveau, consultez la documentation relative aux modules complémentaires pour connaître les bonnes pratiques. Il est également recommandé de tester des modules complémentaires qui gèrent des services de base tels que la mise en réseau ou la résolution DNS. Si vous avez ajouté des configurations personnalisées à votre module complémentaire, assurez-vous que vos paramètres fonctionnent toujours comme prévu après la mise à niveau.

Pour tester le module complémentaire Interface réseau de conteneur (CNI) Amazon Virtual Private Cloud (Amazon VPC), créez un nouveau pod pour valider l'attribution des adresses IP. Pour le module complémentaire CoreDNS, utilisez la commande exec pour accéder au pod, puis utilisez des outils tels que nslookup pour valider la résolution DNS.

Informations connexes

Mettre à jour le module complémentaire autogéré CoreDNS Amazon EKS

Mettre à jour CNI Amazon VPC (module complémentaire Amazon EKS)

Gérer CoreDNS pour DNS dans les clusters Amazon EKS