Créer 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.

Créer le module complémentaire CoreDNS Amazon EKS

Créer le module complémentaire CoreDNS Amazon EKS. Vous devez disposer d’un cluster avant de créer le module complémentaire. Pour de plus amples informations, consultez Création d’un cluster Amazon EKS.

  1. Déterminez la version du module complémentaire actuellement installée sur votre cluster.

    kubectl describe deployment coredns --namespace kube-system | grep coredns: | cut -d : -f 3

    L'exemple qui suit illustre un résultat.

    v1.10.1-eksbuild.13

  2. Déterminez le type de module complémentaire installé sur votre cluster. Selon l'outil avec lequel vous avez créé votre cluster, le type de module complémentaire Amazon EKS peut ne pas être actuellement installé 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

    Si un numéro de version est renvoyé, le type de module complémentaire Amazon EKS est installé sur votre cluster, et vous n’avez donc pas besoin de suivre les étapes restantes de cette procédure. Si une erreur est renvoyée, cela signifie que le type de module complémentaire Amazon EKS n’est pas installé sur votre cluster. Suivez les étapes restantes de cette procédure pour l'installer.

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

    kubectl get deployment coredns -n kube-system -o yaml > aws-k8s-coredns-old.yaml

  4. Créez le module complémentaire à l’aide de l’AWS CLI. Si vous souhaitez utiliser la AWS Management Console ou eksctl pour créer le module complémentaire, consultez la rubrique Créer un module complémentaire Amazon EKS et spécifiez coredns pour le nom du module complémentaire. 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.

      aws eks create-addon --cluster-name my-cluster --addon-name coredns --addon-version v1.11.3-eksbuild.1

      Si vous avez appliqué à votre module complémentaire actuel des paramètres personnalisés qui entrent en conflit avec les paramètres par défaut du module complémentaire Amazon EKS, la création peut échouer. Si la création échoue, vous recevez un message d'erreur qui peut vous aider à résoudre le problème. Vous pouvez également ajouter --resolve-conflicts OVERWRITE à la commande précédente. Cela permet au module complémentaire de remplacer les paramètres personnalisés existants. Une fois que vous avez créé le module complémentaire, vous pouvez le mettre à jour avec vos paramètres personnalisés.

  5. Vérifiez que la dernière version du module complémentaire pour la version Kubernetes de votre cluster a bien été ajoutée à 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

    La création du module complémentaire peut prendre plusieurs secondes.

    L'exemple qui suit illustre un résultat.

    v1.11.3-eksbuild.1

  6. Si vous avez personnalisé les paramètres du module complémentaire, avant de créer le module complémentaire Amazon EKS, utilisez la configuration que vous avez enregistrée lors d'une étape précédente pour mettre à jour le module complémentaire Amazon EKS avec vos paramètres personnalisés. Pour obtenir des instructions sur la mise à jour du module complémentaire, consultez Mettre à jour le module complémentaire CoreDNS Amazon EKS.