Supprimer un module complémentaire Amazon EKS d’un cluster - Amazon EKS
PrérequisProcédure

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.

Supprimer un module complémentaire Amazon EKS d’un cluster

Vous pouvez supprimer un module complémentaire Amazon EKS de votre cluster à l’aide de eksctl, de la AWS Management Console ou de l’AWS CLI.

Lorsque vous supprimez un module complémentaire Amazon EKS d’un cluster :

  • Il n'y a pas de temps d'arrêt pour les fonctionnalités fournies par le module complémentaire.

  • Si vous utilisez des rôles IAM pour les comptes de service (IRSA) et que le module complémentaire est associé à un rôle IAM, ce dernier n’est pas supprimé.

  • Si vous utilisez des identités du pod, toutes les associations d’identités du pod appartenant au module complémentaire sont supprimées. Si vous spécifiez l’option --preserve à l’interface AWS CLI, les associations sont conservées.

  • Amazon EKS cesse de gérer les paramètres du module complémentaire.

  • La console cesse de vous avertir lorsque de nouvelles versions sont disponibles.

  • Vous ne pouvez pas mettre à jour le module complémentaire à l’aide des outils ou des API AWS.

  • Vous pouvez choisir de laisser le module complémentaire sur votre cluster afin de pouvoir le gérer automatiquement, ou le supprimer de votre cluster. Vous ne devez supprimer le module complémentaire de votre cluster que si aucune ressource sur votre cluster ne dépend de la fonctionnalité fournie par ce module complémentaire.

Prérequis

Avant de créer un module complémentaire, procédez comme suit :

  • Un cluster Amazon EKS existant. Pour en déployer un, consultez Mise en route avec Amazon EKS.

  • Vérifiez si votre module complémentaire nécessite un rôle IAM. Pour plus d'informations, veuillez consulter la rubrique

  • Version 0.214.0 ou ultérieure de l’outil de ligne de commande eksctl installée sur votre appareil ou AWS CloudShell. Pour installer ou mettre à jour eksctl, consultez Installation dans la documentation eksctl.

Procédure

Vous disposez de deux options pour supprimer un module complémentaire Amazon EKS.

  • Conserver le logiciel complémentaire sur votre cluster : cette option supprime la gestion de tous les paramètres par Amazon EKS. Elle supprime également la possibilité pour Amazon EKS de vous informer des mises à jour et de mettre automatiquement à jour le module complémentaire Amazon EKS après le lancement d'une mise à jour. Toutefois, elle préserve le logiciel complémentaire sur votre cluster. Cette option fait du module complémentaire une installation autogérée plutôt qu'un module complémentaire Amazon EKS. Avec cette option, il n’y a pas de durée d’indisponibilité pour le module complémentaire.

  • Supprimer entièrement le logiciel complémentaire de votre cluster : nous vous recommandons de supprimer le module complémentaire Amazon EKS de votre cluster uniquement si aucune ressource de votre cluster n'en dépend.

Vous pouvez supprimer un module complémentaire Amazon EKS à l’aide de eksctl, de la AWS Management Console ou de l’AWS CLI.

Supprimer le module complémentaire (eksctl)

  1. Déterminez les modules complémentaires actuellement installés sur votre cluster. Remplacez my-cluster par le nom de votre cluster.

    eksctl get addon --cluster my-cluster

    L'exemple qui suit illustre un résultat.

    NAME        VERSION              STATUS  ISSUES  IAMROLE  UPDATE AVAILABLE
coredns     v1.8.7-eksbuild.2    ACTIVE  0
kube-proxy  v1.23.7-eksbuild.1   ACTIVE  0
vpc-cni     v1.10.4-eksbuild.1   ACTIVE  0
[...]

    Votre sortie peut être différente, en fonction des modules complémentaires et des versions dont vous disposez sur votre cluster.

  2. Supprimer le module complémentaire. Remplacez my-cluster par le nom de votre cluster et name-of-add-on par le nom du module complémentaire renvoyé dans la sortie de l’étape précédente que vous voulez supprimer. Si vous supprimez l’option --preserve, non seulement Amazon EKS ne gère plus le module complémentaire, mais le logiciel du module complémentaire est également supprimé de votre cluster.

    eksctl delete addon --cluster my-cluster --name name-of-addon --preserve

    Pour plus d’informations sur la suppression des modules complémentaires, consultez Suppression de modules complémentaires dans la documentation eksctl.

Supprimer un module complémentaire (console AWS)

  1. Ouvrez la console Amazon EKS.

  2. Dans le volet de navigation de gauche, choisissez Clusters.

  3. Sélectionnez le nom du cluster pour lequel vous voulez supprimer le module complémentaire Amazon EKS.

  4. Choisissez l'onglet Modules complémentaires.

  5. Sélectionnez le module complémentaire que vous voulez supprimer.

  6. Sélectionnez Remove (Supprimer).

  7. Dans la boîte de dialogue de confirmation Supprimer : nom du module complémentaire , procédez comme suit :

    1. Si vous voulez qu'Amazon EKS cesse de gérer les paramètres du module complémentaire, sélectionnez Conserver sur le cluster. Faites ceci si vous voulez retenir le logiciel du module complémentaire sur votre cluster. Ceci afin que vous puissiez gérer vous-même tous les paramètres du module complémentaire.

    2. Saisissez le nom du module complémentaire.

    3. Sélectionnez Remove (Supprimer).

Supprimer un module complémentaire (AWS CLI)

  1. Vous devez installer la version 0.214.0 ou ultérieure de l’outil de ligne de commande eksctl sur votre appareil ou dans AWS CloudShell. Pour installer ou mettre à jour eksctl, veuillez consulter Installation dans la documentation de eksctl.

  2. Consultez la liste des modules complémentaires installés. Remplacez my-cluster par le nom de votre cluster.

    aws eks list-addons --cluster-name my-cluster

    L'exemple qui suit illustre un résultat.

    {
    "addons": [
        "coredns",
        "kube-proxy",
        "vpc-cni",
        "name-of-addon"
    ]
}

  3. Supprimez le module complémentaire installé. Remplacez my-cluster par le nom de votre cluster et name-of-add-on par le nom du module complémentaire que vous voulez supprimer. La suppression de --preserve supprime le logiciel complémentaire de votre cluster.

    aws eks delete-addon --cluster-name my-cluster --addon-name name-of-addon --preserve

    L'exemple suivant illustre le résultat abrégé.

    {
    "addon": {
        "addonName": "name-of-add-on",
        "clusterName": "my-cluster",
        "status": "DELETING",
    }
}

  4. Vérifiez l’état de la suppression. Remplacez my-cluster par le nom de votre cluster et name-of-addon par le nom du module complémentaire que vous supprimez.

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

    Une fois le module complémentaire supprimé, l’exemple de sortie est le suivant.

    An error occurred (ResourceNotFoundException) when calling the DescribeAddon operation: No addon: name-of-addon found in cluster: my-cluster