Ayude a mejorar esta página

Para contribuir a esta guía del usuario, elija el enlace Edit this page on GitHub que se encuentra en el panel derecho de cada página.

Uso de recursos de capacidades

En este tema, se describen las operaciones comunes para administrar los recursos de capacidades en todos los tipos de capacidades.

Recursos de capacidades de EKS

Las capacidades de EKS son recursos de AWS que permiten la funcionalidad administrada de su clúster de Amazon EKS. Las capacidades se ejecutan en EKS, lo que elimina la necesidad de instalar y mantener controladores y otros componentes operativos en los nodos de trabajo. Las capacidades se crean para un clúster de EKS específico y permanecen asociadas a ese clúster durante todo su ciclo de vida.

Cada recurso de capacidad tiene lo siguiente:

Descripción de los estados de las capacidades

Los recursos de las capacidades tienen un estado que indica su estado actual. Puede ver el estado de la capacidad en la consola de EKS o mediante la AWS CLI.

Consola:

AWS CLI:

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

Estados de las capacidades

CREANDO: Se está configurando la capacidad. Puede salir de la consola, ya que la capacidad se continuará creando en segundo plano.

ACTIVA: la capacidad está en ejecución y lista para usarse. Si los recursos no funcionan según lo esperado, compruebe el estado de los recursos y los permisos de IAM. Para obtener orientación, consulte Solución de problemas de capacidades de EKS.

ACTUALIZANDO: se están aplicando cambios en la configuración. Espere a que el estado vuelva a ser ACTIVE.

ELIMINANDO: se está eliminando la capacidad del clúster.

CREATE_FAILED: la configuración detectó un error. Entre las causas comunes, se incluyen las siguientes:

Consulte la sección de estado de la capacidad para obtener detalles específicos sobre los errores.

UPDATE_FAILED: no se pudo actualizar la configuración. Consulte la sección de estado de la capacidad para obtener más información y compruebe los permisos de IAM.

Creación de capacidades

Para crear una capacidad en el clúster, consulte los temas siguientes:

Enumeración de capacidades

Puede enumerar todos los recursos de capacidades de un clúster.

Consola

AWS CLI

Use el comando list-capabilities para ver todas las capacidades del clúster. Reemplace region-code por la región de AWS donde creó el clúster y my-cluster por el nombre de su clúster.

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

Descripción de una capacidad

Obtenga información detallada sobre una capacidad específica, lo que incluye su configuración y estado.

Consola

AWS CLI

Utilice el comando describe-capability para ver información detallada. Sustituya region-code por la región de AWS en la que se encuentra el clúster, my-cluster por el nombre del clúster y capability-name por el nombre de la capacidad (ack, argocd o kro).

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

Ejemplo de código de salida:

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

Actualización de la configuración de una capacidad

Puede actualizar ciertos aspectos de la configuración de una capacidad después de su creación. Las opciones de configuración específicas varían según el tipo de capacidad.

AWS CLI

Utilice el comando update-capability para modificar una capacidad:

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

Eliminación de una capacidad

Cuando ya no necesite una capacidad del clúster, puede eliminar el recurso de la capacidad.

Consola

AWS CLI

Utilice el comando delete-capability para eliminar un recurso de la capacidad:

Sustituya region-code por la región de AWS en la que se encuentra el clúster, my-cluster por el nombre del clúster y capability-name por el nombre de la capacidad que desea eliminar.

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

Siguientes pasos