**Ajudar a melhorar esta página**
Para contribuir com este guia de usuário, escolha o link **Editar esta página no GitHub**, disponível no painel direito de cada página.
# Como trabalhar com recursos de funcionalidade
Este tópico descreve operações comuns para o gerenciamento de recursos de funcionalidade em todos os tipos de funcionalidades.
## Recursos de funcionalidade do EKS
As funcionalidades do EKS são recursos da AWS que permitem funcionalidades gerenciadas no cluster do Amazon EKS. As funcionalidades são executadas no EKS, eliminando a necessidade de instalar e manter controladores e outros componentes operacionais em seus nós de processamento. As funcionalidades são criadas para um cluster específico do EKS e permanecem vinculadas a esse cluster durante todo o ciclo de vida.
Cada recurso de funcionalidade conta com:
+ Um nome exclusivo em seu cluster
+ Um tipo de funcionalidade (ACK, ARGOCD ou KRO)
+ Um nome do recurso da Amazon (ARN), especificando o nome e o tipo
+ Um perfil do IAM da funcionalidade
+ Um status que indica seu estado atual
+ Configuração, tanto genérica quanto específica ao tipo de funcionalidade
## Noções básicas sobre o status da funcionalidade
Os recursos de funcionalidade contam com um status que indica o estado atual. É possível visualizar o status e a integridade da funcionalidade no console do EKS ou usando a AWS CLI.
**Console do**:
1. Abra o console do Amazon EKS em https://console.aws.amazon.com/eks/home\$1/clusters.
1. Selecione o nome do seu cluster.
1. Escolha a guia **Funcionalidades** para visualizar o status de todas as funcionalidades.
1. Para obter informações detalhadas sobre a integridade, escolha a guia **Observabilidade**, depois **Monitorar cluster** e, em seguida, a guia **Funcionalidades**.
** AWS CLI**:
```
aws eks describe-capability \
--region region-code \
--cluster-name my-cluster \
--capability-name my-capability-name
```
### Status da funcionalidade
**CREATING**: a funcionalidade está sendo configurada. É possível sair do console e a funcionalidade continuará sendo criada em segundo plano.
**ACTIVE**: a funcionalidade está em execução e pronta para uso. Se os recursos não estiverem funcionando conforme esperado, verifique o status do recurso e as permissões de IAM. Para obter orientações, consulte [Solução de problemas das funcionalidades do EKS](capabilities-troubleshooting.md).
**UPDATING**: as alterações de configuração estão sendo aplicadas. Aguarde até que o status retorne para `ACTIVE`.
**DELETING**: a funcionalidade está sendo removida do cluster.
**CREATE\$1FAILED**: a configuração encontrou um erro. As causas comuns incluem:
+ Política de confiança do perfil do IAM incorreta ou ausente
+ O perfil do IAM não existe ou não está acessível
+ Problemas de acesso ao cluster
+ Parâmetros de configuração inválidos
Verifique a seção de integridade da funcionalidade para obter detalhes específicos do erro.
**UPDATE\$1FAILED**: a atualização da configuração falhou. Verifique a seção de integridade da funcionalidade para obter detalhes e valide as permissões do IAM.
**dica**
Para obter orientações detalhadas sobre solução de problemas, consulte:
[Solução de problemas das funcionalidades do EKS](capabilities-troubleshooting.md): soluções de problemas gerais para problemas de funcionalidades
[Solução de problemas em funcionalidades do ACK](ack-troubleshooting.md): problemas específicos do ACK
[Solução de problemas em funcionalidades do Argo CD](argocd-troubleshooting.md): problemas específicos do Argo CD
[Solução de problemas em funcionalidades do kro](kro-troubleshooting.md): problemas específicos do kro
## Criação de funcionalidades
Para criar uma funcionalidade em seu cluster, consulte os seguintes tópicos:
+ [Criação de uma funcionalidade do ACK](create-ack-capability.md): crie uma funcionalidade do ACK para gerenciar recursos da AWS usando APIs do Kubernetes
+ [Criar um recurso Argo CD](create-argocd-capability.md): crie uma funcionalidade do Argo CD para entrega contínua de GitOps
+ [Criação de uma funcionalidade do kro](create-kro-capability.md): crie uma funcionalidade do kro para composição e orquestração de recursos
## Listagem de funcionalidades
É possível listar todos os recursos da funcionalidade de um cluster.
### Console
1. Abra o console do Amazon EKS em https://console.aws.amazon.com/eks/home\$1/clusters.
1. Selecione o nome do cluster para abrir a página de detalhes do cluster.
1. Escolha a guia **Funcionalidades**.
1. Visualize os recursos de funcionalidade em **Funcionalidades gerenciadas**.
### AWS CLI
Use o comando `list-capabilities` para visualizar todas as funcionalidades em seu cluster. Substitua *region-code* pela região AWS em que seu cluster se encontra e substitua *my-cluster* pelo nome do seu 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"
}
]
}
```
## Descrição de uma funcionalidade
Obtenha informações detalhadas sobre uma funcionalidade específica, incluindo a configuração e o status.
### Console
1. Abra o console do Amazon EKS em https://console.aws.amazon.com/eks/home\$1/clusters.
1. Selecione o nome do cluster para abrir a página de detalhes do cluster.
1. Escolha a guia **Funcionalidades**.
1. Em **Funcionalidades gerenciadas**, escolha a funcionalidade que deseja visualizar.
1. Visualize os detalhes da funcionalidade, incluindo o status, a configuração e o horário de criação.
### AWS CLI
Use o comando `describe-capability` para visualizar informações detalhadas. Substitua *region-code* pela região da AWS em que o seu cluster está, substitua *my-cluster* pelo nome do seu cluster e substitua *capability-name* pelo nome da funcionalidade (ack, argocd ou kro).
```
aws eks describe-capability \
--region region-code \
--cluster-name my-cluster \
--capability-name capability-name
```
**Resultado do exemplo:**
```
{
"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"
}
}
```
## Atualização da configuração de uma funcionalidade
É possível atualizar alguns aspectos da configuração de uma funcionalidade após ela ter sido criada. As opções de configuração específicas variam conforme o tipo de funcionalidade.
**nota**
Os recursos da funcionalidade do EKS são totalmente gerenciados, incluindo a aplicação de patches e as atualizações de versão. A atualização de uma funcionalidade atualizará a configuração do recurso e não resultará em atualizações de versão dos componentes da funcionalidade gerenciada.
### AWS CLI
Use o comando `update-capability` para modificar uma funcionalidade:
```
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**
Algumas propriedades de uma funcionalidade não permitem atualização após a sua criação. Consulte a documentação específica da funcionalidade para obter detalhes sobre o que pode ser modificado.
## Exclusão de uma funcionalidade
Se uma funcionalidade não for mais necessária no seu cluster, é possível realizar a exclusão do recurso da funcionalidade.
**Importante**
**Exclua os recursos do cluster antes de excluir a funcionalidade.**
A exclusão de um recurso da funcionalidade não exclui automaticamente os recursos criados por meio dessa funcionalidade:
Todas as definições de recursos personalizados (CRDs, na sigla em inglês) do Kubernetes permanecem instaladas em seu cluster.
Os recursos do ACK permanecem em seu cluster, e os recursos correspondentes da AWS permanecem em sua conta.
As Applications do Argo CD e seus recursos do Kubernetes permanecem em seu cluster.
As ResourceGraphDefinitions e instâncias do kro permanecem em seu cluster.
É necessário excluir esses recursos antes de excluir a funcionalidade para evitar recursos órfãos.
Opcionalmente, você pode optar por reter os recursos da AWS associados aos recursos do Kubernetes e do ACK. Consulte [Considerações sobre o ACK](ack-considerations.md).
### Console
1. Abra o console do Amazon EKS em https://console.aws.amazon.com/eks/home\$1/clusters.
1. Selecione o nome do cluster para abrir a página de detalhes do cluster.
1. Escolha a guia **Funcionalidades**.
1. Selecione a funcionalidade que deseja excluir na lista de **Funcionalidades gerenciadas**.
1. Escolha **Excluir funcionalidade**.
1. No diálogo de confirmação, digite o nome da funcionalidade para confirmar a exclusão.
1. Escolha **Excluir**.
### AWS CLI
Use o comando `delete-capability` para excluir um recurso de funcionalidade:
Substitua *region-code* pela região da AWS em que o seu cluster está, substitua *my-cluster* pelo nome do seu cluster e substitua *capability-name* pelo nome da funcionalidade que deseja excluir.
```
aws eks delete-capability \
--region region-code \
--cluster-name my-cluster \
--capability-name capability-name
```
## Próximas etapas
+ [Recursos da funcionalidade do Kubernetes](capability-kubernetes-resources.md): saiba mais sobre os recursos do Kubernetes fornecidos por cada tipo de funcionalidade
+ [Conceitos do ACK](ack-concepts.md): compreenda os conceitos do ACK e o ciclo de vida dos recursos
+ [Como trabalhar com o Argo CD](working-with-argocd.md): saiba como trabalhar com funcionalidades do Argo CD para fluxos de trabalho de GitOps
+ [Conceitos do kro](kro-concepts.md): compreenda os conceitos do kro e a composição de recursos