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

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

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.

Si la version de Kubernetes avec laquelle vous avez initialement déployé votre cluster était Kubernetes version 1.25 ou ultérieure, ignorez cette étape.

Par défaut, le contrôleur d'admission de la politique de sécurité du Pod est activé sur les clusters Amazon EKS. Avant de mettre à jour votre cluster, assurez-vous que les politiques de sécurité appropriées sont en place pour le Pod. Il s'agit ainsi d'éviter les problèmes de sécurité potentiels. Vous pouvez vérifier la politique par défaut à l'aide de la commande kubectl get psp eks.privileged.

kubectl get psp eks.privileged

Si vous recevez l'erreur suivante, veuillez consulter Politique de sécurité par défaut d'Amazon EKS pour Pod avant de continuer.

Error from server (NotFound): podsecuritypolicies.extensions "eks.privileged" not found

Si la version de Kubernetes avec laquelle vous avez initialement déployé votre cluster était Kubernetes version 1.18 ou ultérieure, ignorez cette étape.

Vous devrez peut-être supprimer un terme abandonné de votre manifeste CoreDNS.

Ouvrez la console Amazon EKS.

Sélectionnez le nom du cluster Amazon EKS à mettre à jour, puis choisissez Update cluster version (Mettre à jour la version du cluster).

Dans Version Kubernetes, sélectionnez la version vers laquelle mettre à jour votre cluster, puis sélectionnez Update (Mettre à jour).

Dans Cluster name (Nom du cluster), saisissez le nom de votre cluster, puis sélectionnez Confirm (Confirmer).

Cette mise à jour peut prendre plusieurs minutes.

Continuez vers Étape 4 : Mettre à jour les composants du cluster

Mettez à jour votre cluster Amazon EKS à l'aide de la commande AWS CLI suivante. Remplacez les example values par vos propres valeurs. 1.30Remplacez-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 --region region-code --name my-cluster --kubernetes-version 1.30

L'exemple qui suit illustre un résultat.

{
    "update": {
        "id": "b5f0ba18-9a87-4450-b5a0-825e6e84496f",
        "status": "InProgress",
        "type": "VersionUpdate",
        "params": [
            {
                "type": "Version",
                "value": "1.30"
            },
            {
                "type": "PlatformVersion",
                "value": "eks.1"
            }
        ],
[...]
        "errors": []
    }

Contrôlez l'état de mise à jour de votre cluster avec la commande suivante. Utilisez le nom de cluster et l'ID de mise à jour renvoyé par la commande précédente. Lorsqu'un état Successful s'affiche, la mise à jour est terminée. Cette mise à jour peut prendre plusieurs minutes.

aws eks describe-update --region region-code --name my-cluster --update-id b5f0ba18-9a87-4450-b5a0-825e6e84496f

L'exemple qui suit illustre un résultat.

{
    "update": {
        "id": "b5f0ba18-9a87-4450-b5a0-825e6e84496f",
        "status": "Successful",
        "type": "VersionUpdate",
        "params": [
            {
                "type": "Version",
                "value": "1.30"
            },
            {
                "type": "PlatformVersion",
                "value": "eks.1"
            }
        ],
[...]
        "errors": []
    }

Continuez vers Étape 4 : Mettre à jour les composants du cluster

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.

(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.

(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.XRemplacez-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

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 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.