**Aidez à améliorer cette page**
Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Pour contribuer à ce guide de l'utilisateur, cliquez sur le GitHub lien **Modifier cette page sur** qui se trouve dans le volet droit de chaque page.
Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Utilisation des ressources en matière de capacités
Cette rubrique décrit les opérations courantes de gestion des ressources de capacité pour tous les types de capacités.
## Ressources relatives aux fonctionnalités d'EKS
Les fonctionnalités EKS sont AWS des ressources qui activent les fonctionnalités gérées sur votre cluster Amazon EKS. Les fonctionnalités sont exécutées dans EKS, ce qui élimine le besoin d'installer et de maintenir des contrôleurs et d'autres composants opérationnels sur vos nœuds de travail. Les fonctionnalités sont créées pour un cluster EKS spécifique et restent affiliées à ce cluster pendant tout son cycle de vie.
Chaque ressource de capacité possède :
+ Un nom unique au sein de votre cluster
+ Un type de capacité (ACK, ARGOCD ou KRO)
+ Un Amazon Resource Name (ARN), spécifiant à la fois le nom et le type
+ Un rôle IAM axé sur les capacités
+ Un statut qui indique son état actuel
+ Configuration, à la fois générique et spécifique au type de fonctionnalité
## Comprendre l'état des capacités
Les ressources de capacité ont un statut qui indique leur état actuel. Vous pouvez consulter l'état des fonctionnalités et l'état de santé dans la console EKS ou à l'aide de la AWS CLI.
**Console** :
1. Ouvrez la console Amazon EKS à l'adresse https://console.aws.amazon.com/eks/ home\$1/clusters.
1. Sélectionnez le nom de votre cluster.
1. Choisissez l'onglet **Fonctionnalités** pour afficher l'état de toutes les fonctionnalités.
1. Pour obtenir des informations détaillées sur l'état de santé, cliquez sur l'onglet **Observabilité**, puis sur **Surveiller le cluster**, puis sur l'onglet **Fonctionnalités**.
** AWS CLI** :
```
aws eks describe-capability \
--region region-code \
--cluster-name my-cluster \
--capability-name my-capability-name
```
### Statuts des capacités
**CRÉATION** : La capacité est en cours de configuration. Vous pouvez quitter la console : la fonctionnalité continuera de se créer en arrière-plan.
**ACTIF** : La fonctionnalité fonctionne et est prête à être utilisée. Si les ressources ne fonctionnent pas comme prévu, vérifiez l'état des ressources et les autorisations IAM. Pour obtenir des conseils, veuillez consulter [Dépannage des fonctionnalités EKS](capabilities-troubleshooting.md).
**MISE À JOUR** : Les modifications de configuration sont en cours d'application. Attendez que le statut revienne à`ACTIVE`.
**SUPPRESSION** : la fonctionnalité est supprimée du cluster.
**CREATE\$1FAILED** : le programme d'installation a rencontré une erreur. Les causes courantes incluent :
+ Politique de confiance des rôles IAM incorrecte ou manquante
+ Le rôle IAM n'existe pas ou n'est pas accessible
+ Problèmes d'accès au cluster
+ Paramètres de configuration non valides
Consultez la section sur l'état des fonctionnalités pour obtenir des informations spécifiques sur les erreurs.
**UPDATE\$1FAILED : La mise à jour de configuration a échoué**. Consultez la section sur l'état des fonctionnalités pour plus de détails et vérifiez les autorisations IAM.
**Astuce**
Pour obtenir des conseils de dépannage détaillés, voir :
[Dépannage des fonctionnalités EKS](capabilities-troubleshooting.md)- Résolution des problèmes généraux liés aux fonctionnalités
[Résoudre les problèmes liés aux fonctionnalités ACK](ack-troubleshooting.md)- Problèmes spécifiques à ACK
[Résoudre les problèmes liés aux fonctionnalités d'Argo CD](argocd-troubleshooting.md)- Problèmes spécifiques à Argo CD
[Résoudre les problèmes liés aux fonctionnalités Kro](kro-troubleshooting.md)- problèmes spécifiques à Kro
## Créez des capacités
Pour créer une fonctionnalité sur votre cluster, consultez les rubriques suivantes :
+ [Création d'une fonctionnalité ACK](create-ack-capability.md)— Créez une fonctionnalité ACK pour gérer les AWS ressources à l'aide de Kubernetes APIs
+ [Création d’une fonctionnalité Argo CD](create-argocd-capability.md)— Création d'une fonctionnalité Argo CD pour GitOps une livraison continue
+ [Création d'une fonctionnalité Kro](create-kro-capability.md)— Créez une capacité KRO pour la composition et l'orchestration des ressources
## Fonctionnalités de la liste
Vous pouvez répertorier toutes les ressources de capacité d'un cluster.
### Console
1. Ouvrez la console Amazon EKS à l'adresse https://console.aws.amazon.com/eks/ home\$1/clusters.
1. Sélectionnez le nom de votre cluster pour ouvrir la page détaillée du cluster.
1. Choisissez l'onglet **Fonctionnalités**.
1. Consultez les ressources relatives aux **capacités sous Fonctionnalités gérées**.
### AWS CLI
Utilisez la `list-capabilities` commande pour afficher toutes les fonctionnalités de votre cluster. Remplacez *region-code* par la AWS région dans laquelle se trouve votre cluster et remplacez *my-cluster* par le nom de votre cluster.
```
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"
}
]
}
```
## Décrire une fonctionnalité
Obtenez des informations détaillées sur une fonctionnalité spécifique, notamment sa configuration et son état.
### Console
1. Ouvrez la console Amazon EKS à l'adresse https://console.aws.amazon.com/eks/ home\$1/clusters.
1. Sélectionnez le nom de votre cluster pour ouvrir la page détaillée du cluster.
1. Choisissez l'onglet **Fonctionnalités**.
1. Choisissez la fonctionnalité que vous souhaitez afficher dans la section **Fonctionnalités gérées**.
1. Consultez les détails des fonctionnalités, notamment l'état, la configuration et l'heure de création.
### AWS CLI
Utilisez la `describe-capability` commande pour afficher des informations détaillées. Remplacez *region-code* par la AWS région dans laquelle se trouve votre cluster, remplacez *my-cluster* par le nom de votre cluster et remplacez par *capability-name* le nom de la fonctionnalité (ack, argocd ou kro).
```
aws eks describe-capability \
--region region-code \
--cluster-name my-cluster \
--capability-name capability-name
```
**Exemple de sortie :**
```
{
"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"
}
}
```
## Mettre à jour la configuration d'une fonctionnalité
Vous pouvez mettre à jour certains aspects de la configuration d'une fonctionnalité après sa création. Les options de configuration spécifiques varient en fonction du type de fonctionnalité.
**Note**
Les ressources des fonctionnalités d'EKS sont entièrement gérées, y compris les correctifs et les mises à jour de version. La mise à jour d'une fonctionnalité met à jour la configuration des ressources et n'entraîne pas de mise à jour de version des composants de la fonctionnalité gérée.
### AWS CLI
Utilisez la `update-capability` commande pour modifier une fonctionnalité :
```
aws eks update-capability \
--region region-code \
--cluster-name my-cluster \
--capability-name capability-name \
--role-arn arn:aws:iam::[.replaceable]111122223333:role/NewCapabilityRole
```
**Note**
Les propriétés des fonctionnalités ne peuvent pas toutes être mises à jour après leur création. Reportez-vous à la documentation spécifique aux fonctionnalités pour plus de détails sur ce qui peut être modifié.
## Supprimer une fonctionnalité
Lorsque vous n'avez plus besoin d'une fonctionnalité sur votre cluster, vous pouvez supprimer la ressource de capacité.
**Important**
**Supprimez les ressources du cluster avant de supprimer la fonctionnalité.**
La suppression d'une ressource de capacité ne supprime pas automatiquement les ressources créées par le biais de cette fonctionnalité :
Toutes les définitions de ressources personnalisées Kubernetes (CRDs) restent installées dans votre cluster.
Les ressources ACK restent dans votre cluster et les AWS ressources correspondantes restent dans votre compte
Les applications Argo CD et leurs ressources Kubernetes restent dans votre cluster
kro ResourceGraphDefinitions et les instances restent dans votre cluster
Vous devez supprimer ces ressources avant de supprimer la fonctionnalité afin d'éviter les ressources orphelines.
Vous pouvez éventuellement choisir de conserver les AWS ressources associées aux ressources ACK Kubernetes. Voir les [considérations relatives à l'ACK](ack-considerations.md)
### Console
1. Ouvrez la console Amazon EKS à l'adresse https://console.aws.amazon.com/eks/ home\$1/clusters.
1. Sélectionnez le nom de votre cluster pour ouvrir la page détaillée du cluster.
1. Choisissez l'onglet **Fonctionnalités**.
1. Sélectionnez la fonctionnalité que vous souhaitez supprimer dans la liste des **fonctionnalités gérées**.
1. Choisissez la **fonctionnalité Supprimer**.
1. Dans la boîte de dialogue de confirmation, tapez le nom de la fonctionnalité pour confirmer la suppression.
1. Sélectionnez **Delete (Supprimer)**.
### AWS CLI
Utilisez la `delete-capability` commande pour supprimer une ressource de capacité :
Remplacez *region-code* par la AWS région dans laquelle se trouve votre cluster, remplacez *my-cluster* par le nom de votre cluster et remplacez *capability-name* par le nom de la fonctionnalité à supprimer.
```
aws eks delete-capability \
--region region-code \
--cluster-name my-cluster \
--capability-name capability-name
```
## Étapes suivantes
+ [Capacités : ressources Kubernetes](capability-kubernetes-resources.md)— Découvrez les ressources Kubernetes fournies par chaque type de fonctionnalité
+ [Concepts d'ACK](ack-concepts.md)— Comprendre les concepts ACK et le cycle de vie des ressources
+ [Travailler avec Argo CD](working-with-argocd.md)— Utilisation des fonctionnalités d'Argo CD pour GitOps les flux de travail
+ [concepts kro](kro-concepts.md)— Comprendre les concepts Kro et la composition des ressources