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 :

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 :

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 mise en place. 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.

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_FAILED : le programme d'installation a rencontré une erreur. Les causes courantes incluent :

Consultez la section sur l'état des fonctionnalités pour obtenir des informations spécifiques sur les erreurs.

UPDATE_FAILED : 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.

Créez des capacités

Pour créer une fonctionnalité sur votre cluster, consultez les rubriques suivantes :

Fonctionnalités de la liste

Vous pouvez répertorier toutes les ressources de capacité d'un cluster.

Console

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

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

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
         

Supprimer une fonctionnalité

Lorsque vous n'avez plus besoin d'une fonctionnalité sur votre cluster, vous pouvez supprimer la ressource de capacité.

Console

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