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:

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:

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.

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_FAILED: a configuração encontrou um erro. As causas comuns incluem:

Verifique a seção de integridade da funcionalidade para obter detalhes específicos do erro.

UPDATE_FAILED: 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.

Criação de funcionalidades

Para criar uma funcionalidade em seu cluster, consulte os seguintes tópicos:

Listagem de funcionalidades

É possível listar todos os recursos da funcionalidade de um cluster.

Console

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

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.

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
         

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.

Console

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