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 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 capacitaires

Répertoriez, décrivez, mettez à jour et supprimez les ressources de fonctionnalités de vos clusters Amazon EKS.

Ressources relatives aux capacités EKS

Les fonctionnalités EKS sont AWS des ressources qui activent des 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 leur cycle de vie.

Chaque ressource capacitaire possède :

Comprendre l'état des capacités

Les ressources capacitaires ont un statut qui indique leur état actuel. Vous pouvez consulter l'état des capacités et l'état de santé dans la console EKS ou à l'aide de l' AWS interface de ligne de commande.

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 à être créée en arrière-plan.

ACTIF  : La fonctionnalité est en cours d'exécution et 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  : Des modifications de configuration sont en cours d'application. Attendez que le statut revienne àACTIVE.

SUPPRESSION  : la fonctionnalité est en cours de suppression du cluster.

CREATE_FAILED  : le programme d'installation a rencontré une erreur. Les causes courantes incluent :

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

UPDATE_FAILED  : échec de la mise à jour de la configuration. Consultez la section relative à l'état des fonctionnalités pour plus de détails et vérifiez les autorisations IAM.

Créez des fonctionnalités

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

Lister les fonctionnalités

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

Console

AWS INTERFACE DE LIGNE DE COMMANDE (CLI)

Utilisez la list-capabilities commande pour afficher toutes les fonctionnalités de votre cluster. region-codeRemplacez-la par la AWS région dans laquelle se trouve votre cluster et my-cluster remplacez-la 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 capacité

Obtenez des informations détaillées sur une fonctionnalité spécifique, notamment sa configuration et son état.

Console

AWS INTERFACE DE LIGNE DE COMMANDE (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-le my-cluster par le nom de votre cluster et remplacez-le capability-name par le nom que vous avez attribué à votre fonctionnalité lors de sa création (par exemple my-ackmy-argocd,, oumy-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 selon le type de fonctionnalité.

AWS INTERFACE DE LIGNE DE COMMANDE (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::111122223333:role/NewCapabilityRole
         

Supprimer une capacité

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

Console

AWS INTERFACE DE LIGNE DE COMMANDE (CLI)

Utilisez la delete-capability commande pour supprimer une ressource de fonctionnalités :

Remplacez region-code par la AWS région dans laquelle se trouve votre cluster, remplacez-le my-cluster par le nom de votre cluster et remplacez-le 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