Usar funções para conectar um cluster do Kubernetes ao Amazon EKS

O Amazon EKS usa funções vinculadas ao serviço do AWS Identity and Access Management IAM. A função vinculada ao serviço é um tipo exclusivo de função do IAM vinculada diretamente ao Amazon EKS. As funções vinculadas a serviços são predefinidas pelo Amazon EKS e incluem todas as permissões que o serviço requer para chamar outros serviços da AWS em seu nome.

Uma função vinculada ao serviço facilita a configuração do Amazon EKS porque você não precisa adicionar as permissões necessárias manualmente. O Amazon EKS define as permissões das funções vinculadas ao serviço e, exceto se definido de outra forma, somente o Amazon EKS pode assumir suas funções. As permissões definidas incluem a política de confiança e a política de permissões, e essa política não pode ser anexada a nenhuma outra entidade do IAM.

Uma função vinculada ao serviço poderá ser excluída somente após excluir seus recursos relacionados. Isso protege seus recursos do Amazon EKS, pois você não pode remover por engano as permissões para acessar os recursos.

Para obter informações sobre outros produtos que oferecem suporte às funções vinculadas a serviços, consulte Produtos da AWS compatíveis com o IAM e procure os produtos que apresentam Yes (Sim) na coluna Service-linked role (Função vinculada a serviço). Escolha um Sim com um link para visualizar a documentação do perfil vinculado a esse serviço.

Permissões de função vinculada ao serviço para o Amazon EKS

O Amazon EKS usa a função vinculada ao serviço denominada AWSServiceRoleForAmazonEKSConnector: a função permite que o Amazon EKS se conecte com os clusters do Kubernetes. As políticas anexadas permitem que a função gerencie os recursos necessários para se conectar ao seu cluster do Kubernetes registrado.

A função vinculada ao serviço AWSServiceRoleForAmazonEKSConnector confia nos seguintes serviços para aceitar a função:

• eks-connector.amazonaws.com

A política de permissões da função permite que o Amazon EKS conclua as seguintes ações nos recursos especificados:

• AmazonEKSConnectorServiceRolePolicy

Você deve configurar permissões para que uma entidade do IAM (por exemplo, um usuário, grupo ou função) crie, edite ou exclua uma função vinculada a serviço. Para obter mais informações, consulte Permissões de função vinculada a serviços no Guia do Usuário do IAM.

Criar uma função vinculada ao serviço para o Amazon EKS

Você não precisa criar manualmente uma função vinculada a serviço para se conectar a um cluster. Quando você conecta um cluster ao AWS Management Console, à AWS CLI, ao eksctl ou à API da AWS, o Amazon EKS cria a função vinculada a serviço para você.

Se excluir essa função vinculada ao serviço e precisar criá-la novamente, você poderá usar esse mesmo processo para recriar a função em sua conta. Quando você conecta um cluster, o Amazon EKS cria uma função vinculada a serviço para você novamente.

Editar uma função vinculada ao serviço do Amazon EKS

O Amazon EKS não permite que você edite a função vinculada ao serviço do AWSServiceRoleForAmazonEKSConnector. Depois que criar um perfil vinculado ao serviço, você não poderá alterar o nome do perfil, pois várias entidades podem fazer referência a ele. No entanto, será possível editar a descrição do perfil usando o IAM. Para ter mais informações, consulte Editar uma função vinculada a serviço no Guia do usuário do IAM.

Excluir uma função vinculada ao serviço do Amazon EKS

Se você não precisar mais usar um atributo ou serviço que exija uma função vinculada a um serviço, recomendamos que você exclua essa função. Dessa forma, você não terá uma entidade não utilizada que não seja ativamente monitorada ou mantida. No entanto, você deve limpar suo perfil vinculado ao serviço para excluí-la manualmente.

Limpar um perfil vinculado ao serviço

Antes de usar o IAM para excluir uma função vinculada ao serviço, você deverá excluir qualquer recurso usado pela função.

nota

Se o serviço do Amazon EKS estiver usando a função quando você tentar excluir os recursos, a exclusão poderá falhar. Se isso acontecer, espere alguns minutos e tente a operação novamente.

Para excluir recursos do Amazon EKS usados peloAWSServiceRoleForAmazonEKSConnectorFunção do .

1. Abra o console do Amazon EKS em https://console.aws.amazon.com/eks/home#/clusters.

2. No painel de navegação à esquerda, escolha Clusters.

3. Na página Clusters, selecione seu cluster.

4. Selecione a guia Deregister (Cancelar registro) e, em seguida, selecione a guia OK.

Excluir manualmente o perfil vinculado ao serviço

Use o console do IAM, a AWS CLI ou a API da AWS para excluir a função vinculada ao serviço AWSServiceRoleForAmazonEKSForFargate. Para obter mais informações, consulte Excluir uma função vinculada ao serviço no Guia do usuário do IAM.