Entfernung eines Amazon-EKS-Add-Ons aus einem Cluster - Amazon EKS
VoraussetzungenVerfahren

Unterstützung für die Verbesserung dieser Seite beitragen

Um zu diesem Benutzerhandbuch beizutragen, klicken Sie auf den Link Diese Seite auf GitHub bearbeiten, der sich im rechten Bereich jeder Seite befindet.

Entfernung eines Amazon-EKS-Add-Ons aus einem Cluster

Sie können ein Amazon-EKS-Add-On mit eksctl, AWS-Managementkonsole oder der AWS-CLI aus Ihrem Cluster entfernen.

Wenn Sie ein Amazon-EKS-Add-On aus einem Cluster entfernen:

  • Es gibt keine Ausfallzeit für die Funktionalität, die das Add-On bereitstellt.

  • Wenn Sie IAM-Rollen für Servicekonten (IRSA) verwenden und das Add-On einer IAM-Rolle zugeordnet ist, wird die IAM-Rolle nicht entfernt.

  • Wenn Sie Pod Identities verwenden, werden alle Pod-Identity-Zuordnungen, die dem Add-On gehören, entfernt. Wenn Sie die --preserve-Option für die AWS-CLI angeben, bleiben die Zuordnungen erhalten.

  • Amazon EKS beendet die Verwaltung der Einstellungen für das Add-On.

  • Die Konsole benachrichtigt Sie nicht mehr, wenn neue Versionen verfügbar sind.

  • Sie können das Add-On nicht mit AWS-Tools oder APIs aktualisieren.

  • Sie können die Add-On-Software auf Ihrem Cluster beibehalten, damit Sie sie selbst verwalten können, oder Sie können die Add-On-Software aus Ihrem Cluster entfernen. Sie sollten die Add-On-Software nur dann aus Ihrem Cluster entfernen, wenn keine Ressourcen in Ihrem Cluster von der Funktionalität abhängen, die das Add-On bereitstellt.

Voraussetzungen

Führen Sie Folgendes aus, bevor Sie ein Add-On erstellen:

  • Ein vorhandener Amazon-EKS-Cluster. Informationen zum Bereitstellen finden Sie unter Erste Schritte mit Amazon EKS.

  • Überprüfen Sie, ob Ihr Add-On eine IAM-Rolle erfordert. Weitere Informationen finden Sie unter

  • Version 0.214.0 oder höher des auf Ihrem Gerät oder in AWS CloudShell installierten eksctl-Befehlszeilen-Tools. Informationen zum Installieren und Aktualisieren von eksctl finden Sie in der Dokumentation zu eksctl unter Installation.

Verfahren

Beim Entfernen eines Amazon-EKS-Add-Ons stehen Ihnen zwei Optionen zur Verfügung:

  • Beibehalten von Add-on-Software auf Ihrem Cluster - Diese Option entfernt die Amazon-EKS-Verwaltung aller Einstellungen. Amazon EKS wird außerdem die Möglichkeit aufgehoben, Sie über Updates zu informieren und das Amazon-EKS-Add-on automatisch zu aktualisieren, nachdem Sie ein Update eingeleitet haben. Es behält jedoch die Add-on-Software auf Ihrem Cluster bei. Diese Option macht das Add-on zu einem selbstverwalteten Add-on statt einem Amazon-EKS-Add-on. Bei dieser Option gibt es keine Ausfallzeiten für das Add-On.

  • Entfernen Sie die Add-on-Software vollständig aus Ihrem Cluster – Wir empfehlen, dass Sie das Amazon-EKS-Add-on nur aus Ihrem Cluster entfernen, wenn auf Ihrem Cluster keine Ressourcen vorhanden sind, die davon abhängig sind.

Sie können das Amazon-EKS-Add-On mit eksctl, dem AWS-Managementkonsole, oder der AWS-CLI entfernen.

Add-on entfernen (eksctl)

  1. Bestimmen Sie die aktuell auf Ihrem Cluster installierten Add-Ons. Ersetzen Sie my-cluster durch den Namen Ihres Clusters.

    eksctl get addon --cluster my-cluster

    Eine Beispielausgabe sieht wie folgt aus.

    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
[...]

    IIhre Ausgabe sieht möglicherweise anders aus, je nachdem, welche Add-Ons und Versionen Sie auf Ihrem Cluster haben.

  2. Entfernen Sie das Add-On. Ersetzen Sie my-cluster durch den Namen Ihres Clusters und name-of-add-on durch den Namen des Add-Ons, das Sie entfernen möchten und das in der Ausgabe des vorherigen Schritts angezeigt wurde. Wenn Sie die --preserve-Option entfernen, wird zusätzlich dazu, dass Amazon EKS das Add-On nicht mehr verwaltet, die Add-On-Software aus Ihrem Cluster entfernt.

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

    Weitere Informationen zum Entfernen von Add-Ons finden Sie unter Entfernung von Add-Ons in der eksctl-Dokumentation.

Add-On entfernen (AWS-Konsole)

  1. Öffnen Sie die Amazon-EKS-Konsole.

  2. Wählen Sie im linken Navigationsbereich Cluster aus.

  3. Wählen Sie den Namen des Clusters aus, für den Sie das Amazon-EKS-Add-On entfernen möchten.

  4. Wählen Sie die Registerkarte Add-ons.

  5. Wählen Sie das Add-On aus, das Sie entfernen möchten.

  6. Wählen Sie Remove (Entfernen) aus.

  7. Führen Sie im Bestätigungsdialogfeld Entfernen: Name des Add-Ons die folgenden Schritte aus:

    1. Wenn Amazon EKS die Verwaltung von Einstellungen für das Add-on einstellen soll, wählen Sie Auf dem Cluster beibehalten. Tun Sie dies, wenn Sie die Add-on-Software auf Ihrem Cluster behalten möchten. Auf diese Weise können Sie alle Einstellungen des Add-ons selbst verwalten.

    2. Geben Sie den Add-On-Namen ein.

    3. Wählen Sie Remove (Entfernen) aus.

Add-On entfernen (AWS-CLI)

  1. Sie benötigen Version 0.214.0 oder höher des eksctl-Befehlszeilen-Tools, das auf Ihrem Computer oder in der AWS CloudShell installiert ist. Informationen zum Installieren und Aktualisieren von eksctl finden Sie in der Dokumentation zu eksctl unter Installation.

  2. Hier finden Sie eine Liste der installierten Add-Ons. Ersetzen Sie my-cluster durch den Namen Ihres Clusters.

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

    Eine Beispielausgabe sieht wie folgt aus.

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

  3. Entfernen Sie das installierte Add-On. Ersetzen Sie my-cluster durch den Namen Ihres Clusters und name-of-add-on durch den Namen des Add-Ons, das Sie entfernen möchten. Durch Entfernen von --preserve wird die Add-On-Software aus Ihrem Cluster gelöscht.

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

    Die gekürzte Beispielausgabe lautet wie folgt.

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

  4. Überprüfen Sie den Status der Entfernung. Ersetzen Sie my-cluster durch den Namen Ihres Clusters und name-of-addon durch den Namen des Add-Ons, das Sie entfernen.

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

    Nachdem das Add-On entfernt wurde, sieht die Beispielausgabe wie folgt aus.

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