EKS 功能资源了解功能状态创建功能列出功能描述功能更新功能的配置删除功能后续步骤

使用功能资源

本主题介绍管理所有功能类型的功能资源的常见操作。

EKS 功能资源

EKS 功能是在 Amazon EKS 集群上启用托管功能的 Amazon 资源。各项功能在 EKS 中运行，无需在 Worker 节点上安装和维护控制器和其他操作组件。这些功能是为特定的 EKS 集群创建，并且在整个生命周期内都与该集群保持关联。

每种能力资源都有：

集群中的唯一名称
功能类型（ACK、ARGOCD 或 KRO）
Amazon 资源名称（ARN），同时指定名称和类型
功能 IAM 角色
表示当前状态的状态
配置，包括通用配置和特定于功能类型的配置

了解功能状态

功能资源的状态表示其当前状态。您可以在 EKS 控制台或使用 Amazon CLI 查看功能状态和运行状况。

控制台：

从以下位置打开 Amazon EKS 控制台：https://console.aws.amazon.com/eks/home#/clusters。
选择集群名称。
选择功能选项卡，查看所有功能的状态。
有关详细的运行状况信息，请选择可观测性选项卡，然后依次选择监控集群、功能选项卡。

AmazonCLI：


aws eks describe-capability \
  --region region-code \
  --cluster-name my-cluster \
  --capability-name my-capability-name

功能状态

CREATING：正在设置功能。您可以离开控制台，功能将继续在后台创建。

ACTIVE：功能正在运行中并可供使用。如果资源未按预期运行，请检查资源状态和 IAM 权限。请参阅 EKS 功能问题排查查看相关指南。

UPDATING：正在应用配置更改。等待状态恢复为 ACTIVE。

删除：正在从集群中删除功能。

CREATE_FAILED：设置时遇到了错误。常见原因包括：

IAM 角色信任策略不正确或缺失
IAM 角色不存在或无法访问
集群访问权限问题
无效的配置参数

有关具体错误的详细信息，请查看功能运行状况部分。

UPDATE_FAILED：配置更新失败。有关详细信息，请查看功能运行状况部分并验证 IAM 权限。

提示

有关详细的问题排查指导，请参阅：

EKS 功能问题排查：一般功能问题排查
排查 ACK 功能问题：ACK 特有的问题
排查 Argo CD 功能的问题：Argo CD 特有的问题
排查 kro 功能问题：kro 特有的问题

创建功能

要在集群上创建功能，请参阅以下主题：

创建 ACK 功能：创建 ACK 功能以使用 Kubernetes API 管理 Amazon 资源
创建 Argo CD 功能：创建用于 GitOps 持续交付的 Argo CD 功能
创建 kro 功能：创建用于资源组合与编排的 kro 功能

列出功能

您可以列出集群上的所有功能资源。

控制台

从以下位置打开 Amazon EKS 控制台：https://console.aws.amazon.com/eks/home#/clusters。
选择集群名称，打开集群详细信息页面。
选择功能选项卡。
在托管功能下查看功能资源。

Amazon CLI

使用 list-capabilities 命令查看集群上的所有功能。将 region-code 替换为您的集群所在的 Amazon 区域，并将 my-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"
        }
    ]
}

描述功能

获取有关特定功能的详细信息，包括其配置和状态。

控制台

从以下位置打开 Amazon EKS 控制台：https://console.aws.amazon.com/eks/home#/clusters。
选择集群名称，打开集群详细信息页面。
选择功能选项卡。
从托管功能中选择要查看的功能。
查看功能详细信息，包括状态、配置和创建时间。

Amazon CLI

使用 describe-capability 命令查看详细信息。将 region-code 替换为集群所在的 Amazon 区域，将 my-cluster 替换为集群的名称，将 capability-name 替换为功能名称（ack、argocd 或 kro）。


aws eks describe-capability \
  --region region-code \
  --cluster-name my-cluster \
  --capability-name capability-name

输出示例：


{
  "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"
  }
}

更新功能的配置

创建后，您可以更新功能配置的某些方面。具体的配置选项因功能类型而异。

注意

EKS 功能资源为完全托管，包括修补和版本更新。更新某项功能将更新资源配置，并且不会导致托管功能组件的版本更新。

Amazon CLI

使用 update-capability 命令修改功能：


aws eks update-capability \
  --region region-code \
  --cluster-name my-cluster \
  --capability-name capability-name \
  --role-arn arn:aws:iam::[.replaceable]111122223333:role/NewCapabilityRole

注意

并非所有功能属性在创建后都可以更新。有关可以修改的内容的详细信息，请参阅特定于功能的文档。

删除功能

如果不再需要集群上的某项功能，可以删除该功能资源。

重要

在删除功能之前，请先删除集群资源。

删除功能资源不会自动删除通过该功能创建的资源：

所有 Kubernetes 自定义资源定义（CRD）仍安装在您的集群中。
ACK 资源保留在您的集群中，相应的 Amazon 资源则保留在您的账户中
Argo CD 应用程序及其 Kubernetes 资源保留在您的集群中
kro ResourceGraphDefinitions 和实例保留在您的集群中

在删除功能之前，应删除这些资源，以避免存在孤立的资源。

您可以选择保留与 ACK Kubernetes 资源关联的 Amazon 资源。请参阅 ACK 注意事项

控制台

从以下位置打开 Amazon EKS 控制台：https://console.aws.amazon.com/eks/home#/clusters。
选择集群名称，打开集群详细信息页面。
选择功能选项卡。
从托管功能列表中选择要删除的功能。
选择删除功能。
在确认对话框中，输入功能名称以确认删除。
选择删除。

Amazon CLI

使用 delete-capability 命令删除功能资源：

将 region-code 替换为集群所在的 Amazon 区域，将 my-cluster 替换为集群的名称，并将 capability-name 替换为要删除的功能名称。


aws eks delete-capability \
  --region region-code \
  --cluster-name my-cluster \
  --capability-name capability-name

后续步骤

功能 Kubernetes 资源：了解每种功能类型提供的 Kubernetes 资源
ACK 概念：了解 ACK 概念和资源生命周期
使用 Argo CD：在 GitOps 工作流程中使用 Argo CD 功能
kro 概念：了解 kro 的基本概念及资源组合编排

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

EKS 功能

Kubernetes 资源