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:
-
Öffnen Sie die Amazon EKS-Konsole unter https://console.aws.amazon.com/eks/home#/clusters
. -
Wählen Sie Ihren Clusternamen aus.
-
Wählen Sie die Registerkarte Funktionen, um den Status aller Funktionen anzuzeigen.
-
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:
-
Problembehebung bei EKS-Funktionen- Allgemeine Problembehebung
-
Probleme mit ACK-Funktionen beheben- ACK-spezifische Probleme
-
Probleme mit den Funktionen von Argo CD beheben- CD-spezifische Probleme mit Argo
-
Probleme mit KRO-Funktionen beheben- Kro-spezifische Probleme
Fähigkeiten schaffen
Informationen zum Erstellen einer Funktion in Ihrem Cluster finden Sie in den folgenden Themen:
-
Erstellen Sie eine ACK-Fähigkeit— Erstellen Sie eine ACK-Fähigkeit zur Verwaltung von AWS Ressourcen mithilfe von Kubernetes APIs
-
Erstellen einer Argo CD-Funktion— Erstellen Sie eine Argo-CD-Funktion für kontinuierliche Bereitstellung GitOps
-
Eine Kro-Fähigkeit erstellen— Schaffen Sie eine Kro-Funktion für die Zusammenstellung und Orchestrierung von Ressourcen
Funktionen auflisten
Sie können alle Capability-Ressourcen in einem Cluster auflisten.
Konsole
-
Öffnen Sie die Amazon EKS-Konsole unter https://console.aws.amazon.com/eks/home#/clusters
. -
Wählen Sie Ihren Clusternamen aus, um die Cluster-Detailseite zu öffnen.
-
Wählen Sie die Registerkarte Funktionen.
-
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 \ --regionregion-code\ --cluster-namemy-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
-
Öffnen Sie die Amazon EKS-Konsole unter https://console.aws.amazon.com/eks/home#/clusters
. -
Wählen Sie Ihren Clusternamen aus, um die Cluster-Detailseite zu öffnen.
-
Wählen Sie die Registerkarte Funktionen.
-
Wählen Sie unter Verwaltete Funktionen die Funktion aus, die Sie anzeigen möchten.
-
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 \ --regionregion-code\ --cluster-namemy-cluster\ --capability-namecapability-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 \ --regionregion-code\ --cluster-namemy-cluster\ --capability-namecapability-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
-
Öffnen Sie die Amazon EKS-Konsole unter https://console.aws.amazon.com/eks/home#/clusters
. -
Wählen Sie Ihren Clusternamen aus, um die Cluster-Detailseite zu öffnen.
-
Wählen Sie die Registerkarte Funktionen.
-
Wählen Sie die Funktion, die Sie löschen möchten, aus der Liste der verwalteten Funktionen aus.
-
Wählen Sie „Funktion löschen“.
-
Geben Sie im Bestätigungsdialogfeld den Namen der Funktion ein, um das Löschen zu bestätigen.
-
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 \ --regionregion-code\ --cluster-namemy-cluster\ --capability-namecapability-name
Nächste Schritte
-
Fähigkeiten — Kubernetes-Ressourcen— Erfahren Sie mehr über die Kubernetes-Ressourcen, die von den einzelnen Funktionstypen bereitgestellt werden
-
ACK-Konzepte— Verstehen Sie die ACK-Konzepte und den Ressourcenlebenszyklus
-
Arbeiten mit Argo CD— Arbeiten mit den Funktionen von Argo CD für Workflows GitOps
-
Kro-Konzepte— Verstehen Sie die KRO-Konzepte und die Zusammensetzung der Ressourcen