Mettre à jour le cluster existant vers la nouvelle version de Kubernetes - Amazon EKS
Considérations relatives au mode automatique d'Amazon EKSRécapitulatifÉtape 1 : Préparation de la mise à niveauÉtape 2 : examiner les considérations relatives à la mise à niveauÉtape 3 : Mettre à jour le plan de contrôle du clusterÉtape 4 : Mettre à jour les composants du clusterRétrograder la version Kubernetes pour un cluster Amazon EKS

Aidez à améliorer cette page

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Pour contribuer à ce guide de l'utilisateur, cliquez sur le GitHub lien Modifier cette page sur qui se trouve dans le volet droit de chaque page.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Mettre à jour le cluster existant vers la nouvelle version de Kubernetes

Dès qu'une nouvelle version Kubernetes est disponible dans Amazon EKS, vous pouvez mettre à jour votre cluster Amazon EKS.

Important

Une fois que vous avez mis à niveau un cluster, vous ne pouvez pas le rétrograder vers une version précédente. Avant de passer à une nouvelle version de Kubernetes, nous vous recommandons de consulter les informations Comprendre le cycle de vie des versions de Kubernetes sur EKS et les étapes de mise à jour décrites dans cette rubrique.

Les nouvelles versions de Kubernetes introduisent parfois des modifications importantes. Nous vous recommandons donc de comparer la version actuelle de vos applications à la toute nouvelle version Kubernetes avant de procéder à la mise à jour sur vos clusters de production. Pour ce faire, créez un flux d'intégration continue afin de tester le comportement de votre application avant de passer à une nouvelle version Kubernetes.

Dans le processus de mise à jour, Amazon EKS lance de nouveaux nœuds de serveur d'API avec la version de Kubernetes mise à jour pour remplacer les versions existantes. Amazon EKS effectue des vérifications standard de l'état de l'infrastructure et de l'état de préparation du trafic réseau sur ces nouveaux nœuds afin de vérifier qu'ils fonctionnent comme prévu. Cependant, une fois que vous avez commencé la mise à niveau du cluster, vous ne pouvez ni la suspendre ni l'arrêter. Si l'une de ces vérifications échoue, Amazon EKS annule le déploiement d'infrastructure, et votre cluster reste dans la version Kubernetes précédente. Les applications en cours d'exécution ne sont pas affectées et votre cluster n'est jamais laissé dans un état non déterministe ou irrécupérable. Amazon EKS sauvegarde régulièrement tous les clusters gérés, et des mécanismes existent pour récupérer des clusters si nécessaire. Nous évaluons et améliorons constamment nos processus de gestion de l'infrastructure Kubernetes.

Pour mettre à jour le cluster, Amazon EKS requiert jusqu'à cinq adresses IP disponibles correspondant aux sous-réseaux que vous avez spécifiés lors de la création de votre cluster. Amazon EKS crée de nouvelles interfaces réseau élastiques de cluster (interfaces réseau) dans l'un des sous-réseaux que vous avez spécifiés. Les interfaces réseau peuvent être créées dans des sous-réseaux différents de ceux dans lesquels se trouvent vos interfaces réseau existantes. Assurez-vous donc que les règles de votre groupe de sécurité autorisent la communication de cluster requise pour tous les sous-réseaux que vous avez spécifiés lors de la création de votre cluster. Si l'un des sous-réseaux que vous avez spécifiés lors de la création du cluster n'existe pas, s'il n'a pas suffisamment d'adresses IP disponibles ou s'il n'existe pas de règles de groupe de sécurité autorisant les communications nécessaires au cluster, la mise à jour peut échouer.

Pour garantir que le point de terminaison du serveur d'API de votre cluster est toujours accessible, Amazon EKS fournit un plan de contrôle Kubernetes à haute disponibilité et effectue des mises à jour continues des instances du serveur d'API pendant les opérations de mise à jour. Afin de prendre en compte les modifications des adresses IP des instances de serveur d'API prenant en charge le point de terminaison de votre serveur d'API Kubernetes, vous devez vous assurer que les clients de votre serveur d'API gèrent efficacement les reconnexions. Les versions récentes kubectl et les bibliothèques clientes de Kubernetes officiellement prises en charge exécutent ce processus de reconnexion de manière transparente.

Note

Pour en savoir plus sur le contenu d'une mise à jour de cluster, consultez les meilleures pratiques pour les mises à niveau de clusters dans le guide des meilleures pratiques d'EKS. Cette ressource vous aide à planifier une mise à niveau et à comprendre la stratégie de mise à niveau d'un cluster.

Considérations relatives au mode automatique d'Amazon EKS

  • La capacité de calcul du mode automatique d'Amazon EKS contrôle la version Kubernetes des nœuds. Après la mise à niveau du plan de contrôle, le mode automatique d'EKS commence à mettre à jour progressivement les nœuds gérés. Le mode automatique EKS respecte les budgets d'interruption des pods.

  • Il n'est pas nécessaire de mettre à niveau manuellement les fonctionnalités d'Amazon EKS Auto Mode, notamment les fonctionnalités de mise à l'échelle automatique du calcul, de stockage par blocs et d'équilibrage de charge.

Récapitulatif

Le résumé général du processus de mise à niveau du cluster Amazon EKS est le suivant :

  1. Assurez-vous que votre cluster est dans un état permettant une mise à niveau. Cela inclut la vérification des Kubernetes APIs utilisés par les ressources déployées dans le cluster, afin de s'assurer que le cluster ne présente aucun problème de santé. Vous devez utiliser les informations de mise à niveau d'Amazon EKS pour évaluer l'état de préparation de votre cluster à la mise à niveau.

  2. Mettez à niveau le plan de contrôle vers la version mineure suivante (par exemple, de la version 1.32 à la version 1.33).

  3. Mettez à niveau les nœuds du plan de données pour qu'ils correspondent à ceux du plan de contrôle.

  4. Mettez à niveau toutes les applications supplémentaires qui s'exécutent sur le cluster (par exemple,cluster-autoscaler).

  5. Mettez à niveau les modules complémentaires fournis par Amazon EKS, tels que ceux inclus par défaut :

  6. Mettez à niveau tous les clients qui communiquent avec le cluster (par exemple,kubectl).

Étape 1 : Préparation de la mise à niveau

Comparez la version Kubernetes de votre plan de contrôle de cluster à celle de vos nœuds.

  • Obtenez la version Kubernetes de votre plan de contrôle de cluster.

    kubectl version

  • Obtenez la version Kubernetes de vos nœuds. Cette commande renvoie tous les nœuds Amazon EC2, Fargate et hybrides autogérés et gérés. Chaque Fargate Pod est répertorié comme son propre nœud.

    kubectl get nodes

Avant de mettre à jour votre plan de contrôle vers une nouvelle version de Kubernetes, assurez-vous que la version mineure de Kubernetes des nœuds gérés et des nœuds Fargate de votre cluster est identique à la version de votre plan de contrôle. Par exemple, si votre plan de contrôle exécute la version 1.29 et que l'un de vos nœuds exécute la version1.28, vous devez mettre à jour vos nœuds vers la version 1.30 1.29 avant de mettre à jour votre plan de contrôle vers la version 1.30. Nous vous recommandons également de mettre à jour vos nœuds autogérés et vos nœuds hybrides vers la même version que votre plan de contrôle avant de mettre à jour le plan de contrôle. Pour plus d’informations, consultez Mettre à jour un groupe de nœuds gérés pour votre cluster, Mettez à jour les nœuds autogérés pour votre cluster et Mettez à niveau les nœuds hybrides pour votre cluster. Si vous avez des nœuds Fargate dont la version mineure est inférieure à la version du plan de contrôle, supprimez d'abord le pod représenté par le nœud. Mettez ensuite à jour votre plan de contrôle. Tous les pods restants seront mis à jour vers la nouvelle version une fois que vous les aurez redéployés.

Étape 2 : examiner les considérations relatives à la mise à niveau

Amazon EKS Cluster Insights analyse automatiquement les clusters par rapport à une liste de mises à niveau potentielles des versions de Kubernetes ayant un impact sur des problèmes tels que l'utilisation obsolète de l'API Kubernetes. Amazon EKS met régulièrement à jour la liste des vérifications d'informations à effectuer en fonction des évaluations des modifications apportées au projet Kubernetes. Amazon EKS met également à jour la liste de contrôle des informations au fur et à mesure que des modifications sont introduites dans le service Amazon EKS ainsi que des nouvelles versions. Pour de plus amples informations, veuillez consulter Préparez-vous aux mises à niveau des versions de Kubernetes et corrigez les erreurs de configuration grâce aux informations du cluster.

Consultez le guide de migration d'API obsolète dans la documentation de Kubernetes.

Évaluer Cluster Insights

Utilisez les informations du cluster Amazon EKS pour identifier les problèmes avec

  1. Ouvrez la console Amazon EKS.

  2. Dans la liste de clusters, choisissez le nom du cluster Amazon EKS pour lequel vous souhaitez obtenir des informations.

  3. Choisissez Afficher le tableau de bord.

  4. Choisissez l'onglet Cluster Insights.

  5. Dans le tableau Upgrade Insights, vous verrez les colonnes suivantes :

    • Nom : vérification effectuée par Amazon EKS par rapport au cluster.

    • État de l'aperçu : un aperçu dont le statut est « Erreur » signifie généralement que la version de Kubernetes affectée est N+1 de la version actuelle du cluster, tandis qu'un statut « Avertissement » signifie que l'aperçu s'applique à une future version de Kubernetes N+2 ou plus. Une information dont le statut est « Réussi » signifie qu'Amazon EKS n'a détecté aucun problème associé à cette vérification d'informations dans votre cluster. Une information dont le statut est « Inconnu » signifie qu'Amazon EKS n'est pas en mesure de déterminer si votre cluster est concerné par cette vérification des informations.

    • Version : version de Kubernetes pour laquelle l'analyse a vérifié l'absence de problèmes éventuels.

    • Heure de dernière actualisation : heure à laquelle le statut de l'aperçu a été actualisé pour la dernière fois pour ce cluster.

    • Heure de la dernière transition : heure à laquelle le statut de cet aperçu a été modifié pour la dernière fois.

    • Description : informations provenant de la vérification des informations, qui incluent l'alerte et les mesures correctives recommandées.

Considérations détaillées

  • Dans la mesure où Amazon EKS exécute un plan de contrôle hautement disponible, vous devez mettre à jour une seule version mineure à la fois. Pour plus d'informations sur cette exigence, consultez Kubernetes Version and Version Skew Support Policy (Politique de prise en charge des versions et versions asymétriques de Kubernetes). Supposez que la version actuelle de votre cluster soit la version 1.28 et que vous souhaitiez la mettre à jour vers la version 1.30. Vous devez d'abord mettre à jour la version 1.28 de votre cluster vers la version 1.29, puis mettre à jour la version 1.29 de votre cluster vers la version 1.30.

  • Vérifiez l'écart de version entre Kubernetes kube-apiserver et celui de vos nœuds. kubelet

    • À partir de la version Kubernetes1.28, il kubelet peut y avoir jusqu'à trois versions mineures plus anciennes que. kube-apiserver Voir la politique d'asymétrie des versions en amont de Kubernetes.

    • Si vos nœuds gérés et Fargate utilisent la kubelet version Kubernetes ou une 1.25 version plus récente, vous pouvez mettre à jour votre cluster jusqu'à trois versions à l'avance sans mettre à jour la version. kubelet Par exemple, si la version du kubelet est 1.25, vous pouvez mettre à jour la version de votre cluster Amazon EKS de 1.25 vers 1.26 ou vers 1.27 et vers 1.28 alors que le kubelet reste sur la version 1.25.

  • Avant de commencer une mise à jour, il est recommandé de s'assurer que la kubelet version de Kubernetes de vos nœuds est la même que celle de votre plan de contrôle.

  • Si votre cluster est configuré avec une version du plugin Amazon VPC CNI pour Kubernetes antérieure à1.8.0, nous vous recommandons de mettre à jour le plug-in avec la dernière version avant de mettre à jour votre cluster. Pour mettre à jour le plugin, consultez Attribuer IPs à des pods avec l'Amazon VPC CNI.

Étape 3 : Mettre à jour le plan de contrôle du cluster

Important

Amazon EKS a temporairement annulé une fonctionnalité qui vous obligeait à utiliser un --force indicateur pour mettre à niveau votre cluster en cas de problèmes d'analyse du cluster. Pour plus d'informations, voir Annulation temporaire de l'application des informations de mise à niveau lors de la mise à jour de la version du cluster sur. GitHub

Amazon EKS actualise un aperçu du cluster 24 heures après la « dernière actualisation ». Vous pouvez comparer l'heure à laquelle vous avez résolu un problème à la « date de dernière actualisation » de l'aperçu du cluster.

En outre, la mise à jour du statut d'aperçu peut prendre jusqu'à 30 jours après la résolution d'une utilisation obsolète de l'API. Upgrade Insights recherche toujours les utilisations déconseillées des API sur une période continue de 30 jours.

Vous pouvez soumettre la demande de mise à niveau de la version de votre plan de contrôle EKS en utilisant :

Mettre à jour le cluster - eksctl

Cette procédure nécessite eksctl version 0.210.0 ou ultérieure. Vous pouvez vérifier votre version avec la commande suivante :

eksctl version

Pour les instructions d'installation et de mise à jour de eksctl, consultez la rubrique Installation dans la documentation eksctl.

Mettez à jour la version Kubernetes de votre plan de contrôle Amazon EKS. Remplacez <cluster-name> par le nom de votre cluster. <version-number>Remplacez-le par le numéro de version pris en charge par Amazon EKS vers lequel vous souhaitez mettre à jour votre cluster. Pour obtenir une liste des numéros de version pris en charge, consultez Comprendre le cycle de vie des versions de Kubernetes sur EKS.

eksctl upgrade cluster --name <cluster-name> --version <version-number> --approve

Cette mise à jour peut prendre plusieurs minutes.

Passez au Étape 4 : Mettre à jour les composants du cluster.

Cluster de mise à jour - AWS console

  1. Ouvrez la console Amazon EKS.

  2. Choisissez Mettre à niveau maintenant pour le cluster que vous souhaitez mettre à niveau.

  3. Sélectionnez la version vers laquelle mettre à jour votre cluster et choisissez Mettre à niveau.

  4. Cette mise à jour peut prendre plusieurs minutes. Passez au Étape 4 : Mettre à jour les composants du cluster.

Mettre à jour le cluster - AWS CLI

  1. Vérifiez que la AWS CLI est installée et que vous êtes connecté. Pour plus d'informations, voir Installation ou mise à jour vers la dernière version de la AWS CLI.

  2. Mettez à jour votre cluster Amazon EKS à l'aide de la commande AWS CLI suivante. Remplacez <cluster-name> et <region-code> du cluster que vous souhaitez mettre à niveau. <version-number>Remplacez-le par le numéro de version pris en charge par Amazon EKS vers lequel vous souhaitez mettre à jour votre cluster. Pour obtenir une liste des numéros de version pris en charge, consultez Comprendre le cycle de vie des versions de Kubernetes sur EKS.

    aws eks update-cluster-version --name <cluster-name> \
  --kubernetes-version <verion-number> --region <region-code>

    L'exemple qui suit illustre un résultat.

    {
    "update": {
        "id": "<update-id>",
        "status": "InProgress",
        "type": "VersionUpdate",
        "params": [
            {
                "type": "Version",
                "value": "<version-number>"
            },
            {
                "type": "PlatformVersion",
                "value": "eks.1"
            }
        ],
[...]
        "errors": []
    }

  3. Cette mise à jour peut prendre plusieurs minutes. Contrôlez l'état de mise à jour de votre cluster avec la commande suivante. En plus d'utiliser le même <cluster-name> et<region-code>, utilisez <update-id> celui renvoyé par la commande précédente.

    aws eks describe-update --name <cluster-name> \
   --region <region-code> --update-id <update-id>

    Lorsqu'un état Successful s'affiche, la mise à jour est terminée.

  4. Passez au Étape 4 : Mettre à jour les composants du cluster.

Étape 4 : Mettre à jour les composants du cluster

  1. Une fois la mise à jour de votre cluster terminée, mettez à jour vos nœuds vers la même version Kubernetes que celle de votre cluster mis à jour. Pour plus d’informations, consultez Mettez à jour les nœuds autogérés pour votre cluster, Mettre à jour un groupe de nœuds gérés pour votre cluster et Mettez à niveau les nœuds hybrides pour votre cluster. Tous les nouveaux pods lancés sur Fargate ont kubelet une version qui correspond à la version de votre cluster. Les Fargate Pods existants ne sont pas modifiés.

  2. (Facultatif) Si vous avez déployé le composant Kubernetes Cluster Autoscaler sur votre cluster avant de mettre à jour le cluster, mettez ce composant à jour vers la version la plus récente correspondant à la version majeure et mineure de Kubernetes vers laquelle vous avez effectué la mise à jour.

    1. Ouvrez la page des versions de Cluster Autoscaler dans un navigateur Web et recherchez la dernière version de Cluster Autoscaler qui correspond aux versions majeure et mineure de Kubernetes de votre cluster. Par exemple, si la version Kubernetes de votre cluster est, 1.30 recherchez la dernière version de Cluster Autoscaler commençant par. 1.30 Enregistrez le numéro de version sémantique (1.30.n, par exemple) de cette version à utiliser à l'étape suivante.

    2. Identifiez l'image Cluster Autoscaler sur la version que vous avez enregistrée à l'étape précédente avec la commande suivante. Si nécessaire, remplacez X.XX.X par votre propre valeur.

      kubectl -n kube-system set image deployment.apps/cluster-autoscaler cluster-autoscaler=registry.k8s.io/autoscaling/cluster-autoscaler:vX.XX.X

  3. (Clusters dotés de nœuds GPU uniquement) Si votre cluster possède des groupes de nœuds compatibles avec le GPU (par exemple,p3.2xlarge), vous devez mettre à jour le plug-in d'appareil NVIDIA pour Kubernetes DaemonSet sur votre cluster. <vX.X.X>Remplacez-le par la s-device-plugin version Nvidia/K8 de votre choix avant d'exécuter la commande suivante.

    kubectl apply -f https://raw.githubusercontent.com/NVIDIA/k8s-device-plugin/<vX.X.X>/deployments/static/nvidia-device-plugin.yml

  4. Mettez à jour le plug-in Amazon VPC CNI pour Kubernetes, CoreDNS et les modules complémentaires. kube-proxy Nous vous recommandons de mettre à jour les modules complémentaires avec les versions minimales répertoriées dans les jetons de compte de service.

    • Si vous utilisez des modules complémentaires Amazon EKS, dans la console Amazon EKS, sélectionnez Clusters, puis le nom du cluster que vous avez mis à jour dans le volet gauche. Les notifications s'affichent dans la console. Elles vous informent qu'une nouvelle version est disponible pour chaque module complémentaire disposant d'une mise à jour disponible. Pour mettre à jour un module complémentaire, sélectionnez l'onglet Add-ons (Modules complémentaires). Dans l'une des zones d'un module complémentaire dont une mise à jour est disponible, sélectionnez Update now (Mettre à jour maintenant), sélectionnez une version disponible, puis cliquez sur Update (Mise à jour).

    • Vous pouvez également utiliser la AWS CLI ou mettre eksctl à jour des modules complémentaires. Pour de plus amples informations, veuillez consulter Mettre à jour un module complémentaire Amazon EKS.

  5. Si nécessaire, mettez à jour votre version de kubectl. Vous devez utiliser une version kubectl qui se situe à une différence de version mineure près du plan de contrôle de votre cluster Amazon EKS.

Rétrograder la version Kubernetes pour un cluster Amazon EKS

Vous ne pouvez pas rétrograder les Kubernetes d'un cluster Amazon EKS. Créez plutôt un nouveau cluster sur une version précédente d'Amazon EKS et migrez les charges de travail.