View a markdown version of this page

Arbeiten mit Kapazitätsressourcen - Amazon EKS

Unterstützung für die Verbesserung dieser Seite beitragen

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Um zu diesem Benutzerhandbuch beizutragen, wählen Sie den GitHub Link Diese Seite bearbeiten unter, der sich im rechten Bereich jeder Seite befindet.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Arbeiten mit Kapazitätsressourcen

Listen Sie die Funktionsressourcen in Ihren Amazon EKS-Clustern auf, beschreiben Sie sie, aktualisieren Sie sie und löschen Sie sie.

Ressourcen für EKS-Fähigkeiten

EKS-Funktionen sind AWS Ressourcen, die verwaltete Funktionen in Ihrem Amazon EKS-Cluster ermöglichen. Die Funktionen werden in EKS ausgeführt, sodass Sie keine Controller und andere Betriebskomponenten auf Ihren Worker-Nodes installieren und warten müssen. Funktionen werden für einen bestimmten EKS-Cluster erstellt und bleiben während ihres gesamten Lebenszyklus mit diesem Cluster verbunden.

Jede Kapazitätsressource hat:

  • Ein eindeutiger Name innerhalb Ihres Clusters

  • Ein Funktionstyp (ACK, ARGOCD oder KRO)

  • Ein Amazon-Ressourcenname (ARN), der sowohl den Namen als auch den Typ angibt

  • Eine Capability IAM-Rolle

  • Ein Status, der den aktuellen Status angibt

  • Konfiguration, sowohl generisch als auch spezifisch für den Funktionstyp

Grundlegendes zum Fähigkeitsstatus

Kapazitätsressourcen haben einen Status, der ihren aktuellen Status angibt. Sie können den Status und den Zustand der Fähigkeiten in der EKS-Konsole oder mithilfe der AWS CLI anzeigen.

Konsole:

  1. Öffnen Sie die Amazon EKS-Konsole unter https://console.aws.amazon.com/eks/home #/clusters.

  2. Wählen Sie Ihren Cluster-Namen aus.

  3. Wählen Sie die Registerkarte „Funktionen“, um den Status aller Funktionen anzuzeigen.

  4. Ausführliche Informationen zum Systemzustand finden Sie auf der Registerkarte „Beobachtbarkeit“, dann auf „Cluster überwachen“ und anschließend auf der Registerkarte „Funktionen“.

AWS CLI:

aws eks describe-capability \ --region region-code \ --cluster-name my-cluster \ --capability-name my-capability-name

Status der Fähigkeiten

WIRD ERSTELLT: Die Fähigkeit wird eingerichtet. Sie können die Konsole verlassen — die Funktion wird im Hintergrund weiter erstellt.

AKTIV: Die Funktion wird ausgeführt und ist einsatzbereit. Wenn Ressourcen nicht wie erwartet funktionieren, überprüfen Sie den Ressourcenstatus und die IAM-Berechtigungen. Anleitungen finden Sie unter Fehlerbehebung bei EKS-Funktionen.

AKTUALISIERUNG: Konfigurationsänderungen werden angewendet. Warten Sie, bis der Status wieder erreicht istACTIVE.

LÖSCHEN: Die Funktion wird aus dem Cluster entfernt.

CREATE_FAILED: Beim Setup ist ein Fehler aufgetreten. Zu den häufigsten Ursachen gehören:

  • Die Vertrauensrichtlinie für IAM-Rollen ist falsch oder fehlt

  • Die IAM-Rolle ist nicht vorhanden oder es kann nicht darauf zugegriffen werden

  • Probleme mit dem Cluster-Zugriff

  • Ungültige Konfigurationsparameter

Spezifische Fehlerdetails finden Sie im Abschnitt zum Funktionsstatus.

UPDATE_FAILED: Das Konfigurationsupdate ist fehlgeschlagen. Weitere Informationen finden Sie im Abschnitt zum Status der Funktionen und überprüfen Sie die IAM-Berechtigungen.

Tipp

Eine ausführliche Anleitung zur Fehlerbehebung finden Sie unter:

Fähigkeiten erstellen

Informationen zum Erstellen einer Funktion in Ihrem Cluster finden Sie in den folgenden Themen:

Funktionen auflisten

Sie können alle Kapazitätsressourcen in einem Cluster auflisten.

Konsole

  1. Öffnen Sie die Amazon EKS-Konsole unter https://console.aws.amazon.com/eks/home #/clusters.

  2. Wählen Sie Ihren Cluster-Namen aus, um die Cluster-Detailseite zu öffnen.

  3. Wählen Sie die Registerkarte „Funktionen“.

  4. Funktionsressourcen finden Sie unter Verwaltete Funktionen.

AWS CLI

Verwenden Sie den list-capabilities Befehl, um alle Funktionen in Ihrem Cluster anzuzeigen. region-codeErsetzen Sie durch die AWS Region, in der sich Ihr Cluster befindet, und my-cluster ersetzen Sie es durch den Namen Ihres Clusters.

aws eks list-capabilities \ --region region-code \ --cluster-name my-cluster
{ "capabilities": [ { "capabilityName": "my-ack", "arn": "arn:aws:eks:us-west-2:111122223333:capability/my-cluster/ack/my-ack/abc123", "type": "ACK", "status": "ACTIVE", "createdAt": "2025-11-02T10:30:00.000000-07:00", "modifiedAt": "2025-11-02T10:32:15.000000-07:00" }, { "capabilityName": "my-kro", "arn": "arn:aws:eks:us-west-2:111122223333:capability/my-cluster/kro/my-kro/abc123", "type": "KRO", "status": "ACTIVE", "version": "v0.6.3", "createdAt": "2025-11-02T10:30:00.000000-07:00", "modifiedAt": "2025-11-02T10:32:15.000000-07:00" }, { "capabilityName": "my-argocd", "arn": "arn:aws:eks:us-west-2:111122223333:capability/my-cluster/argocd/my-argocd/abc123", "type": "ARGOCD", "status": "ACTIVE", "version": "3.1.8-eks-1", "createdAt": "2025-11-21T08:22:28.486000-05:00", "modifiedAt": "2025-11-21T08:22:28.486000-05:00" } ] }

Beschreiben Sie eine Fähigkeit

Holen Sie sich detaillierte Informationen zu einer bestimmten Funktion, einschließlich ihrer Konfiguration und ihres Status.

Konsole

  1. Öffnen Sie die Amazon EKS-Konsole unter https://console.aws.amazon.com/eks/home #/clusters.

  2. Wählen Sie Ihren Cluster-Namen aus, um die Cluster-Detailseite zu öffnen.

  3. Wählen Sie die Registerkarte „Funktionen“.

  4. Wählen Sie unter Verwaltete Funktionen die Funktion aus, die Sie anzeigen möchten.

  5. Sehen Sie sich die Funktionsdetails an, einschließlich Status, Konfiguration und Erstellungszeit.

AWS CLI

Verwenden Sie den describe-capability Befehl, um detaillierte Informationen anzuzeigen. region-codeErsetzen Sie durch die AWS Region, in der sich Ihr Cluster befindet, my-cluster ersetzen Sie es durch den Namen Ihres Clusters und capability-name ersetzen Sie es durch den Namen, den Sie Ihrer Fähigkeit bei der Erstellung gegeben haben (z. B. my-ackmy-argocd,, odermy-kro).

aws eks describe-capability \ --region region-code \ --cluster-name my-cluster \ --capability-name capability-name

Beispielausgabe:

{ "capability": { "capabilityName": "my-ack", "capabilityArn": "arn:aws:eks:us-west-2:111122223333:capability/my-cluster/ack/my-ack/abc123", "clusterName": "my-cluster", "type": "ACK", "roleArn": "arn:aws:iam::111122223333:role/AmazonEKSCapabilityACKRole", "status": "ACTIVE", "configuration": {}, "tags": {}, "health": { "issues": [] }, "createdAt": "2025-11-19T17:11:30.242000-05:00", "modifiedAt": "2025-11-19T17:11:30.242000-05:00", "deletePropagationPolicy": "RETAIN" } }

Aktualisieren Sie die Konfiguration einer Funktion

Sie können bestimmte Aspekte der Konfiguration einer Funktion nach der Erstellung aktualisieren. Die spezifischen Konfigurationsoptionen variieren je nach Funktionstyp.

Anmerkung

Die EKS-Funktionsressourcen werden vollständig verwaltet, einschließlich Patches und Versionsupdates. Das Aktualisieren einer Funktion aktualisiert die Ressourcenkonfiguration und führt nicht zu Versionsupdates der verwalteten Funktionskomponenten.

AWS CLI

Verwenden Sie den update-capability Befehl, um eine Fähigkeit zu ändern:

aws eks update-capability \ --region region-code \ --cluster-name my-cluster \ --capability-name capability-name \ --role-arn arn:aws:iam::111122223333:role/NewCapabilityRole
Anmerkung

Nicht alle Capability-Eigenschaften können nach der Erstellung aktualisiert werden. Einzelheiten dazu, was geändert werden kann, finden Sie in der funktionsspezifischen Dokumentation.

Löschen Sie eine Fähigkeit

Wenn Sie eine Funktion in Ihrem Cluster nicht mehr benötigen, können Sie die Kapazitätsressource löschen.

Wichtig

Löschen Sie Cluster-Ressourcen, bevor Sie die Fähigkeit löschen.

Durch das Löschen einer Funktionsressource werden Ressourcen, die mit dieser Fähigkeit erstellt wurden, nicht automatisch gelöscht:

  • Alle Custom Resource Definitions (CRDs) von Kubernetes bleiben in Ihrem Cluster installiert.

  • ACK-Ressourcen verbleiben in Ihrem Cluster und die entsprechenden AWS Ressourcen verbleiben in Ihrem Konto

  • Argo CD Applications und ihre Kubernetes-Ressourcen bleiben in Ihrem Cluster

  • Kro ResourceGraphDefinitions und Instances bleiben in Ihrem Cluster

Sie sollten diese Ressourcen löschen, bevor Sie die Funktion löschen, um verwaiste Ressourcen zu vermeiden.

Sie können sich optional dafür entscheiden, AWS Ressourcen beizubehalten, die mit ACK Kubernetes-Ressourcen verknüpft sind. Siehe Überlegungen zu ACK ACK-Überlegungen für EKS

Konsole

  1. Öffnen Sie die Amazon EKS-Konsole unter https://console.aws.amazon.com/eks/home #/clusters.

  2. Wählen Sie Ihren Cluster-Namen aus, um die Cluster-Detailseite zu öffnen.

  3. Wählen Sie die Registerkarte „Funktionen“.

  4. Wählen Sie die Funktion, die Sie löschen möchten, aus der Liste der verwalteten Funktionen aus.

  5. Wählen Sie Fähigkeit löschen aus.

  6. Geben Sie im Bestätigungsdialogfeld den Namen der Funktion ein, mit der das Löschen bestätigt werden soll.

  7. Wählen Sie Löschen aus.

AWS CLI

Verwenden Sie den delete-capability Befehl, um eine Capability-Ressource zu löschen:

region-codeErsetzen Sie es durch die AWS Region, in der sich Ihr Cluster befindet, my-cluster ersetzen Sie es durch den Namen Ihres Clusters und capability-name ersetzen Sie es durch den Namen der zu löschenden Fähigkeit.

aws eks delete-capability \ --region region-code \ --cluster-name my-cluster \ --capability-name capability-name

Nächste Schritte