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

Aidez à améliorer cette page

Vous souhaitez contribuer à ce guide de l'utilisateur ? Faites défiler cette page vers le bas et sélectionnez Modifier cette page sur GitHub. Vos contributions aideront à améliorer notre guide de l'utilisateur pour tous.

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 EKS module complémentaire Amazon d'un cluster

Vous pouvez supprimer un EKS module complémentaire Amazon de votre cluster en utilisant le eksctl AWS Management Console, ou le AWS CLI.

Lorsque vous supprimez un EKS module complémentaire Amazon 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 IAM des rôles pour les comptes de service (IRSA) et qu'un IAM rôle est associé au module complémentaire, celui-ci n'est pas supprimé. IAM

  • 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 sur AWS CLI, les associations sont préservées.

  • Amazon EKS arrête 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 ouAPIs.

  • 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 EKS cluster Amazon existant. Pour en déployer un, consultez Commencez avec Amazon EKS.

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

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

Procédure

Vous pouvez supprimer un EKS module complémentaire Amazon à l'aide du eksctl AWS Management Console, ou du AWS CLI. Si le module complémentaire nécessite un IAM rôle, consultez les détails du module complémentaire spécifique dans EKSModules complémentaires Amazon disponibles auprès de AWS pour plus de détails sur la création du rôle.

Deux options s'offrent à vous lorsque vous supprimez un EKS module complémentaire Amazon.

  • Conservez les logiciels complémentaires sur votre cluster : cette option supprime EKS la gestion de tous les paramètres par Amazon. Cela empêche également Amazon de vous informer des mises EKS à jour et de mettre automatiquement à jour le EKS module complémentaire Amazon une fois que vous avez lancé 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 EKS module complémentaire Amazon. Avec cette option, il n'y a pas de temps d'arrêt pour le module complémentaire.

  • Supprimer complètement le logiciel complémentaire de votre cluster — Nous vous recommandons de supprimer le EKS module complémentaire Amazon de votre cluster uniquement si aucune ressource de votre cluster n'en dépend.

eksctl
Pour supprimer un EKS module complémentaire Amazon à l'aide de 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 mon-cluster avec le nom de votre cluster et name-of-add-on le nom du module complémentaire renvoyés dans le résultat de l'étape précédente que vous souhaitez supprimer. Si vous supprimez --preserve cette option, Amazon EKS ne gère plus le module complémentaire, mais 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.

AWS Management Console
Pour supprimer un EKS module complémentaire Amazon à l'aide du AWS Management Console

  1. Ouvrez la EKS console Amazon à l'adresse https://console.aws.amazon.com/eks/home#/clusters.

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

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

  4. Choisissez l'onglet Modules complémentaires.

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

  6. Sélectionnez Remove (Supprimer).

  7. Dans le menu Supprimer : name of addonboîte de dialogue de confirmation, procédez comme suit :

    1. Si vous souhaitez qu'Amazon arrête EKS 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).

AWS CLI
Prérequis

Version 0.191.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, veuillez consulter Installation dans la documentation de eksctl.

Pour supprimer un EKS module complémentaire Amazon à l'aide du AWS CLI

  1. 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"
    ]
}

  2. 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",
[...]

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