**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:
+ Un nombre único dentro de su clúster
+ Un tipo de capacidad (ACK, ARGOCD o KRO)
+ Un nombre de recurso de Amazon (ARN), que especifica tanto el nombre como el tipo
+ Un rol de IAM de capacidad
+ Un estado que indica su estado actual
+ Configuración, tanto genérica como específica del tipo de capacidad
## 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**:
1. Abra la consola de Amazon EKS en https://console.aws.amazon.com/eks/home\$1/clusters.
1. Seleccione el nombre del clúster.
1. Seleccione la pestaña **Capacidades** para ver el estado de todas las capacidades.
1. Para obtener información detallada sobre el estado, seleccione la pestaña **Observabilidad**, luego **Supervisar clúster** y, por último, la pestaña **Capacidades**.
** 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](capabilities-troubleshooting.md).
**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\$1FAILED**: la configuración detectó un error. Entre las causas comunes, se incluyen las siguientes:
+ Falta la política de confianza del rol de IAM o no se encuentra
+ El rol de IAM no existe o no se puede acceder a él
+ Problemas de acceso al clúster
+ Parámetros de configuración no válidos
Consulte la sección de estado de la capacidad para obtener detalles específicos sobre los errores.
**UPDATE\$1FAILED**: 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.
**sugerencia**
Para obtener ayuda sobre la solución de problemas, consulte:
[Solución de problemas de capacidades de EKS](capabilities-troubleshooting.md): solución de problemas general de la capacidad
[Solución de problemas con capacidades de ACK](ack-troubleshooting.md): problemas específicos de ACK
[Solución de problemas con capacidades de Argo CD](argocd-troubleshooting.md): problemas específicos de Argo CD
[Solución de problemas con capacidades de kro](kro-troubleshooting.md): problemas específicos de kro
## Creación de capacidades
Para crear una capacidad en el clúster, consulte los temas siguientes:
+ [Creación de una capacidad de ACK](create-ack-capability.md): creación de una capacidad de ACK para administrar los recursos de AWS mediante las API de Kubernetes
+ [Creación de una capacidad de Argo CD](create-argocd-capability.md): creación de una capacidad de Argo CD para la entrega continua de GitOps
+ [Creación de una capacidad de kro](create-kro-capability.md): creación de una capacidad de kro para la composición y orquestación de los recursos
## Enumeración de capacidades
Puede enumerar todos los recursos de capacidades de un clúster.
### Consola
1. Abra la consola de Amazon EKS en https://console.aws.amazon.com/eks/home\$1/clusters.
1. Seleccione el nombre del clúster para abrir la página de detalles del clúster.
1. Elija la pestaña **Capacidades**.
1. Consulte los recursos de capacidades en **Capacidades administradas**.
### 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
1. Abra la consola de Amazon EKS en https://console.aws.amazon.com/eks/home\$1/clusters.
1. Seleccione el nombre del clúster para abrir la página de detalles del clúster.
1. Elija la pestaña **Capacidades**.
1. Elija la capacidad que desee ver en **Capacidades administradas**.
1. Vea los detalles de la capacidad, lo que incluye el estado, la configuración y la hora de creación.
### 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.
**nota**
Los recursos de capacidades de EKS se administran completamente, lo que incluye las actualizaciones de versiones y los parches. Al actualizar una capacidad, se actualizará la configuración de los recursos y no se actualizarán las versiones de los componentes de la capacidad administrada.
### 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
```
**nota**
No todas las propiedades de capacidades se pueden actualizar después de su creación. Consulte la documentación específica de la capacidad para obtener detalles sobre lo que se puede modificar.
## Eliminación de una capacidad
Cuando ya no necesite una capacidad del clúster, puede eliminar el recurso de la capacidad.
**importante**
**Elimine los recursos del clúster antes de eliminar la capacidad.**
La eliminación de un recurso de la capacidad no elimina automáticamente los recursos creados a través de esa capacidad:
Todas las definiciones de recursos personalizados (CRD) de Kubernetes permanecen instaladas en el clúster.
Los recursos de ACK permanecen en el clúster, mientras que los recursos de AWS correspondientes permanecen en la cuenta.
Las aplicaciones de Argo CD y sus recursos de Kubernetes permanecen en el clúster.
Las instancias y ResourceGraphDefinitions de kro permanecen en el clúster.
Debe eliminar estos recursos antes de eliminar la capacidad para evitar recursos huérfanos.
Si lo desea, puede optar por retener los recursos de AWS asociados a los recursos de Kubernetes de ACK. Consulte [Consideraciones sobre ACK](ack-considerations.md).
### Consola
1. Abra la consola de Amazon EKS en https://console.aws.amazon.com/eks/home\$1/clusters.
1. Seleccione el nombre del clúster para abrir la página de detalles del clúster.
1. Elija la pestaña **Capacidades**.
1. Seleccione en la lista **Capacidades administradas** la capacidad que desea eliminar.
1. Elija **Eliminar capacidad**.
1. En el cuadro de diálogo de confirmación, ingrese el nombre de la capacidad para confirmar la eliminación.
1. Elija **Eliminar**.
### 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
+ [Recursos de Kubernetes de las capacidades](capability-kubernetes-resources.md): más información sobre los recursos de Kubernetes que proporciona cada tipo de capacidad
+ [Conceptos de ACK](ack-concepts.md): descripción de los conceptos de ACK y el ciclo de vida de los recursos
+ [Uso de Argo CD](working-with-argocd.md): uso de las capacidades de Argo CD para flujos de trabajo de GitOps
+ [Conceptos de kro](kro-concepts.md): descripción de los conceptos de kro y la composición de recursos