Mit Capability-Ressourcen arbeiten - 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 auf, 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.

Mit Capability-Ressourcen arbeiten

In diesem Thema werden allgemeine Verfahren zur Verwaltung von Fähigkeitsressourcen für alle Fähigkeitstypen beschrieben.

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-Knoten installieren und warten müssen. Funktionen werden für einen bestimmten EKS-Cluster erstellt und bleiben während ihres gesamten Lebenszyklus diesem Cluster zugeordnet.

Jede Capability-Ressource hat:

  • Ein eindeutiger Name innerhalb Ihres Clusters

  • Ein Fähigkeitstyp (ACK, ARGOCD oder KRO)

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

  • Eine IAM-Rolle für Fähigkeiten

  • Ein Status, der den aktuellen Status angibt

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

Den Status der Fähigkeit verstehen

Fähigkeitsressourcen haben einen Status, der ihren aktuellen Status angibt. Sie können den Status und den Zustand der Funktionen in der EKS-Konsole oder über die 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 Clusternamen aus.

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

  4. Für detaillierte Gesundheitsinformationen wählen Sie die Registerkarte Observability, dann Monitor cluster und dann die Registerkarte Capabilities.

AWS CLI:

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

Status der Fähigkeiten

ERSTELLUNG: Die Fähigkeit wird eingerichtet. Sie können von der Konsole weg navigieren — die Funktion erstellt weiterhin im Hintergrund.

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 Problembehebung bei EKS-Funktionen.

AKTUALISIERUNG: Die Konfigurationsänderungen werden übernommen. Warten Sie, bis der Status wieder angezeigt wirdACTIVE.

LÖSCHEN: Die Fähigkeit 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 Clusterzugriff

  • Ungültige Konfigurationsparameter

Spezifische Fehlerdetails finden Sie im Abschnitt zur Funktionsintegrität.

UPDATE_FAILED: Das Konfigurationsupdate ist fehlgeschlagen. Einzelheiten finden Sie im Abschnitt zur Funktionsintegrität und überprüfen Sie die IAM-Berechtigungen.

Tipp

Eine ausführliche Anleitung zur Fehlerbehebung finden Sie unter:

Fähigkeiten schaffen

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

Funktionen auflisten

Sie können alle Capability-Ressourcen 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 Clusternamen aus, um die Cluster-Detailseite zu öffnen.

  3. Wählen Sie die Registerkarte Funktionen.

  4. Sehen Sie sich die Ressourcen zu den Funktionen unter Verwaltete Funktionen an.

AWS CLI

Verwenden Sie den list-capabilities Befehl, um alle Funktionen Ihres Clusters anzuzeigen. region-codeErsetzen Sie es 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

Erhalten Sie 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 Clusternamen 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 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 Fähigkeit (ack, argocd oder 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 Ressourcen der EKS-Funktionen werden vollständig verwaltet, einschließlich Patches und Versionsupdates. Die Aktualisierung einer Funktion aktualisiert die Ressourcenkonfiguration und führt nicht zu Versionsupdates der verwalteten Funktionskomponenten.

AWS CLI

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

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

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

Löschen Sie eine Funktion

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

Wichtig

Löschen Sie die Clusterressourcen, bevor Sie die Funktion löschen.

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

  • Alle benutzerdefinierten Kubernetes-Ressourcendefinitionen (CRDs) bleiben in Ihrem Cluster installiert.

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

  • Argo CD-Anwendungen und ihre Kubernetes-Ressourcen verbleiben in Ihrem Cluster

  • Kro ResourceGraphDefinitions und Instanzen verbleiben 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

Konsole

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

  2. Wählen Sie Ihren Clusternamen 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 „Funktion löschen“.

  6. Geben Sie im Bestätigungsdialogfeld den Namen der Funktion ein, um das Löschen zu bestätigen.

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

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

Nächste Schritte