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

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.

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

Vous pouvez supprimer un module complémentaire Amazon EKS de votre cluster à l'aide eksctl de la AWS Management Console CLI ou de la 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 qu'un rôle IAM est associé au module complémentaire, celui-ci n'est pas supprimé.

  • Si vous utilisez Pod Identities, toutes les associations d'identité de pod détenues par le module complémentaire sont supprimées. Si vous spécifiez l'--preserveoption dans la AWS CLI, les associations sont préservé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 d' AWS outils ou APIs.

  • 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.204.0 ou ultérieure de l'outil de ligne de commande eksctl installée sur votre appareil ou AWS CloudShell. Pour effectuer une installation ou une mise à joureksctl, consultez la section Installation dans la eksctl documentation.

Procédure

Deux options s'offrent à vous lorsque vous supprimez 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 aucun temps d'arrêt 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 eksctl de l'interface de AWS Management Console ligne de commande ou de la 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. Supprimez 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 souhaitez supprimer. Si vous supprimez --preserve cette option, en plus du fait qu'Amazon EKS ne gère plus le module complémentaire, le logiciel complémentaire est 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 la section Suppression des modules complémentaires dans la eksctl documentation.

Supprimer le module complémentaire (AWS console)

  1. Ouvrez la console Amazon EKS.

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

  3. Choisissez le nom du cluster pour lequel vous souhaitez supprimer le module complémentaire Amazon EKS.

  4. Choisissez l'onglet Modules complémentaires.

  5. Choisissez le module complémentaire que vous souhaitez supprimer.

  6. Sélectionnez Remove (Supprimer).

  7. Dans la boîte de dialogue Supprimer : name of addon confirmation, 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. Entrez le nom du module complémentaire.

    3. Sélectionnez Remove (Supprimer).

Supprimer le module complémentaire (AWS CLI)

  1. Vous avez besoin d'0.204.0une version ou d'une version ultérieure de l'outil de ligne de eksctl commande installée sur votre appareil ou 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 souhaitez supprimer. La suppression --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. my-clusterRemplacez-le 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