Usar funções para grupos de nós do Amazon EKS

O Amazon EKS usa perfis vinculados a serviços 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 serviços compatíveis com funções vinculadas aos serviços, consulte Serviços da AWS que funcionam com o IAM e procure os serviços que apresentam Sim na coluna Funções vinculadas aos serviços. Escolha um Sim com um link para visualizar a documentação do perfil vinculado para esse serviço.

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

O Amazon EKS usa o perfil vinculado a serviço chamado AWSServiceRoleForAmazonEKSNodegroup. O perfil permite que o Amazon EKS gerencie grupos de nós em sua conta. A política AWSServiceRoleForAmazonEKSNodegroup anexada permite que o perfil gerencie os recursos a seguir: grupos do Auto Scaling, grupos de segurança, modelos de execução e perfis de instância do IAM. Para ter mais informações, consulte Política gerenciada da AWS: AWSServiceRoleForAmazonEKSNodegroup.

A função vinculada ao serviço AWSServiceRoleForAmazonEKSNodegroup confia nos seguintes serviços para assumir a função:

• eks-nodegroup.amazonaws.com

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

• AWSServiceRoleForAmazonEKSNodegroup

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

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

Não é necessário criar manualmente uma função vinculada ao serviço. Quando você cria o CreateNodegroup no AWS Management Console, na CLI AWS ou na API AWS, o Amazon EKS cria o perfil vinculada ao serviço para você.

Importante

Esse perfil vinculado ao serviço pode aparecer em sua conta se você concluiu uma ação em outro serviço que usa os atributos compatíveis com esse perfil. Se você estava usando o serviço do Amazon EKS antes de 1º de janeiro de 2017, quando ele começou a oferecer suporte a funções vinculadas ao serviço, o Amazon EKS criou a função AWSServiceRoleForAmazonEKSNodegroup na sua conta. Para saber mais, consulte Uma nova função apareceu na minha conta do IAM.

Criação de uma função vinculada ao serviço no Amazon EKS (API da AWS)

Não é necessário criar manualmente uma função vinculada ao serviço. Quando você cria um grupo de nós gerenciados no AWS Management Console, na CLI AWS ou na API AWS, o Amazon EKS cria o perfil vinculada ao serviço para você.

Se excluir esse perfil vinculado ao serviço e precisar criá-lo novamente, será possível usar esse mesmo processo para recriar o perfil em sua conta. Quando você cria outro grupo de nós gerenciados, o Amazon EKS cria a função vinculada ao serviço novamente para você.

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 AWSServiceRoleForAmazonEKSNodegroup. 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 obter mais informações, consulte Editar um perfil vinculado ao 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 requer uma função vinculada a serviço, é recomendável excluí-la. Dessa forma, você não tem uma entidade não utilizada que não seja monitorada ativamente 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.

1. Abra o console do Amazon EKS.

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

3. Selecione a guia Compute (Computação).

4. Na seção Node groups (Grupos de nós), escolha o grupo de nós a ser excluído.

5. Digite o nome do grupo de nós na janela de confirmação de exclusão e selecione Delete (Excluir) para excluir.

6. Repita esse procedimento para qualquer outro grupo de nós no cluster. Aguarde até que todas as operações de exclusão sejam concluídas.

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 AWSServiceRoleForAmazonEKSNodegroup. Para obter mais informações, consulte Excluir um perfil vinculado ao serviço no Guia do usuário do IAM.

Regiões com suporte a funções vinculadas a serviço do Amazon EKS

O Amazon EKS oferece suporte a funções vinculadas a serviços em todas as regiões em que o serviço estiver disponível. Para obter mais informações, consulte Endpoints e cotas do Amazon EKS.