Mettre à jour le module complémentaire CoreDNS Amazon EKS - Amazon EKS

Aidez à améliorer cette page

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

Mettre à jour le module complémentaire CoreDNS Amazon EKS

Mettez à jour le type de module complémentaire Amazon EKS. Si vous n’avez pas ajouté le module complémentaire Amazon EKS à votre cluster, ajoutez-le ou consultez Mettre à jour le module complémentaire CoreDNS Amazon EKS autogéré.

Avant de commencer, consultez les considérations relatives à la mise à niveau. Pour de plus amples informations, consultez Considérations importantes concernant la mise à niveau de CoreDNS.

  1. Déterminez la version du module complémentaire actuellement installée sur votre cluster. Remplacez my-cluster par le nom de votre cluster.

    aws eks describe-addon --cluster-name my-cluster --addon-name coredns --query "addon.addonVersion" --output text

    L'exemple qui suit illustre un résultat.

    v1.10.1-eksbuild.13

    Si la version renvoyée correspond à la version Kubernetes de votre cluster dans le tableau des dernières versions, cela signifie que vous disposez déjà de la dernière version installée sur votre cluster et que vous n’avez pas besoin de suivre le reste de cette procédure. Si vous recevez une erreur au lieu d’un numéro de version dans votre sortie, cela signifie que le type de module complémentaire Amazon EKS n’est pas installé sur votre cluster. Vous devez créer le module complémentaire avant de pouvoir le mettre à jour à l'aide de cette procédure.

  2. Enregistrez la configuration du module complémentaire actuellement installé.

    kubectl get deployment coredns -n kube-system -o yaml > aws-k8s-coredns-old.yaml
  3. Mettez à jour votre module complémentaire à l’aide de l’AWS CLI. Si vous souhaitez utiliser la AWS Management Console ou eksctl pour mettre à jour le module complémentaire, consultez la rubrique Mettre à jour un module complémentaire Amazon EKS. Copiez la commande qui suit sur votre appareil. Si nécessaire, apportez les modifications suivantes à la commande, puis exécutez la commande modifiée.

    • Remplacez my-cluster par le nom de votre cluster.

    • Remplacez v1.11.3-eksbuild.1 par la dernière version répertoriée dans le tableau des dernières versions pour votre version de cluster.

    • Cette option --resolve-conflictsPRESERVE conserve les valeurs de configuration existantes pour le module complémentaire. Si vous avez défini des valeurs personnalisées pour les paramètres des modules complémentaires et que vous n’utilisez pas cette option, Amazon EKS remplace vos valeurs par ses valeurs par défaut. Si vous utilisez cette option, nous vous recommandons de tester les modifications de champ et de valeur sur un cluster hors production avant de mettre à jour le module complémentaire sur votre cluster de production. Si vous remplacez cette valeur par OVERWRITE, tous les paramètres sont remplacés par les valeurs par défaut d'Amazon EKS. Si vous avez défini des valeurs personnalisées pour certains paramètres, il est possible qu’elles soient remplacées par les valeurs par défaut d’Amazon EKS. Si vous remplacez cette valeur par none, Amazon EKS ne modifie la valeur d’aucun paramètre, mais la mise à jour risque d’échouer. Si la mise à jour échoue, vous recevez un message d'erreur pour vous aider à résoudre le conflit.

    • Si vous ne mettez à jour aucun paramètre de configuration, supprimez --configuration-values '{"replicaCount":3}' de la commande. Si vous mettez à jour un paramètre de configuration, remplacez "replicaCount":3 par le paramètre que vous voulez définir. Dans cet exemple, le nombre de réplicas de CoreDNS est défini sur 3. La valeur que vous spécifiez doit être valide pour le schéma de configuration. Si vous ne connaissez pas le schéma de configuration, exécutez aws eks describe-addon-configuration --addon-name coredns --addon-version v1.11.3-eksbuild.1 , en remplaçant v1.11.3-eksbuild.1 par le numéro de version du module complémentaire dont vous souhaitez voir la configuration. Le schéma est renvoyé dans la sortie. Si vous disposez déjà d'une configuration personnalisée et vous voulez la supprimer et rétablir les valeurs par défaut d'Amazon EKS pour tous les paramètres, supprimez "replicaCount":3 de la commande, de sorte que le champ {} soit vide. Pour plus d’informations sur les paramètres CoreDNS, consultez la section Personnalisation du service DNS dans la documentation Kubernetes.

      aws eks update-addon --cluster-name my-cluster --addon-name coredns --addon-version v1.11.3-eksbuild.1 \ --resolve-conflicts PRESERVE --configuration-values '{"replicaCount":3}'

      La mise à jour peut prendre plusieurs secondes.

  4. Assurez-vous que la version du module complémentaire a été mise à jour. Remplacez my-cluster par le nom de votre cluster.

    aws eks describe-addon --cluster-name my-cluster --addon-name coredns

    La mise à jour peut prendre plusieurs secondes.

    L'exemple qui suit illustre un résultat.

    { "addon": { "addonName": "coredns", "clusterName": "my-cluster", "status": "ACTIVE", "addonVersion": "v1.11.3-eksbuild.1", "health": { "issues": [] }, "addonArn": "arn:aws:eks:region:111122223333:addon/my-cluster/coredns/d2c34f06-1111-2222-1eb0-24f64ce37fa4", "createdAt": "2023-03-01T16:41:32.442000+00:00", "modifiedAt": "2023-03-01T18:16:54.332000+00:00", "tags": {}, "configurationValues": "{\"replicaCount\":3}" } }