

 **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
<a name="working-with-capabilities"></a>

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

## Ressourcen für EKS-Fähigkeiten
<a name="_eks_capability_resources"></a>

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
<a name="_understanding_capability_status"></a>

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\$1/clusters.

1. Wählen Sie Ihren Clusternamen aus.

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

1. 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
<a name="_capability_statuses"></a>

 **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](capabilities-troubleshooting.md).

 **AKTUALISIERUNG**: Die Konfigurationsänderungen werden übernommen. Warten Sie, bis der Status wieder angezeigt wird`ACTIVE`.

 **LÖSCHEN**: Die Fähigkeit wird aus dem Cluster entfernt.

 **CREATE\$1FAILED**: 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\$1FAILED: 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](capabilities-troubleshooting.md)- Allgemeine Problembehebung bei Funktionen
 [Probleme mit ACK-Funktionen beheben](ack-troubleshooting.md)- ACK-spezifische Probleme
 [Probleme mit den Funktionen von Argo CD beheben](argocd-troubleshooting.md)- CD-spezifische Probleme mit Argo
 [Probleme mit KRO-Funktionen beheben](kro-troubleshooting.md)- Kro-spezifische Probleme

## Fähigkeiten schaffen
<a name="_create_capabilities"></a>

Informationen zum Erstellen einer Funktion in Ihrem Cluster finden Sie in den folgenden Themen:
+  [Erstellen Sie eine ACK-Fähigkeit](create-ack-capability.md)— Erstellen Sie eine ACK-Fähigkeit zur Verwaltung von AWS Ressourcen mithilfe von Kubernetes APIs
+  [Erstellen einer Argo CD-Funktion](create-argocd-capability.md)— Erstellen Sie eine Argo-CD-Funktion für kontinuierliche Bereitstellung GitOps 
+  [Eine Kro-Fähigkeit erstellen](create-kro-capability.md)— Schaffen Sie eine Kro-Funktion für die Zusammenstellung und Orchestrierung von Ressourcen

## Funktionen auflisten
<a name="_list_capabilities"></a>

Sie können alle Capability-Ressourcen in einem Cluster auflisten.

### Konsole
<a name="_console"></a>

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

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

1. Wählen Sie die Registerkarte **Funktionen**.

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

### AWS CLI
<a name="shared_aws_cli"></a>

Verwenden Sie den `list-capabilities` Befehl, um alle Funktionen Ihres Clusters anzuzeigen. *region-code*Ersetzen 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
<a name="_describe_a_capability"></a>

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

### Konsole
<a name="_console_2"></a>

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

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

1. Wählen Sie die Registerkarte **Funktionen**.

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

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

### AWS CLI
<a name="shared_aws_cli"></a>

Verwenden Sie den `describe-capability` Befehl, um detaillierte Informationen anzuzeigen. *region-code*Ersetzen 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
<a name="_update_the_configuration_of_a_capability"></a>

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
<a name="shared_aws_cli"></a>

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
<a name="_delete_a_capability"></a>

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](ack-considerations.md) 

### Konsole
<a name="_console_3"></a>

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

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

1. Wählen Sie die Registerkarte **Funktionen**.

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

1. Wählen Sie „**Funktion löschen**“.

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

1. Wählen Sie **Löschen** aus.

### AWS CLI
<a name="shared_aws_cli"></a>

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

*region-code*Ersetzen 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
<a name="_next_steps"></a>
+  [Fähigkeiten — Kubernetes-Ressourcen](capability-kubernetes-resources.md)— Erfahren Sie mehr über die Kubernetes-Ressourcen, die von den einzelnen Funktionstypen bereitgestellt werden
+  [ACK-Konzepte](ack-concepts.md)— Verstehen Sie die ACK-Konzepte und den Ressourcenlebenszyklus
+  [Arbeiten mit Argo CD](working-with-argocd.md)— Arbeiten mit den Funktionen von Argo CD für Workflows GitOps 
+  [Kro-Konzepte](kro-concepts.md)— Verstehen Sie die KRO-Konzepte und die Zusammensetzung der Ressourcen