A função vinculada ao serviço de atualizações gerenciadas

AWS Elastic Beanstalk usa funções vinculadas ao serviço AWS Identity and Access Management (IAM). A função vinculada ao serviço é um tipo exclusivo de função do IAM vinculada diretamente ao Elastic Beanstalk. As funções vinculadas ao serviço são predefinidas pelo Elastic Beanstalk e incluem todas as permissões que o serviço exige para chamar outros serviços em seu nome. AWS

Uma função vinculada ao serviço facilita a configuração do Elastic Beanstalk, já que não é preciso adicionar as permissões necessárias manualmente. O Elastic Beanstalk define as permissões de suas funções vinculadas ao serviço e, a menos que seja definido em contrário, somente o Elastic Beanstalk pode assumir suas funções. As permissões definidas incluem a política de confiança e a política de permissões, que não pode ser anexada a nenhuma outra entidade do IAM.

Um perfil vinculado ao serviço poderá ser excluído somente após excluir seus atributos relacionados. Isso protege seus recursos do Elastic Beanstalk porque não é possível remover por engano a permissão para acessar os recursos.

Para obter informações sobre outros serviços compatíveis com funções vinculadas a serviços, consulte Serviços da AWS compatíveis com o IAM e procure os serviços que contenham Sim na coluna Funções vinculadas ao 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 Elastic Beanstalk

O Elastic Beanstalk usa a função vinculada ao serviço AWSServiceRoleForElasticBeanstalkManagedUpdateschamada — Permite que o Elastic Beanstalk realize atualizações programadas da plataforma de seus ambientes em execução.

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

• managedupdates.elasticbeanstalk.amazonaws.com

A política gerenciada AWSElasticBeanstalkManagedUpdatesServiceRolePolicyconcede AWSServiceRoleForElasticBeanstalkManagedUpdates à função vinculada ao serviço todas as permissões que o Elastic Beanstalk precisa para concluir as ações de atualização gerenciada em seu nome. Para ver o conteúdo da política gerenciada, consulte a AWSElasticBeanstalkManagedUpdatesServiceRolePolicypágina no Guia de referência de políticas AWS gerenciadas.

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

Como alternativa, você pode usar uma política AWS gerenciada para fornecer acesso total ao Elastic Beanstalk.

Criar uma função vinculada ao serviço para o Elastic Beanstalk

Não é necessário criar manualmente uma função vinculada a serviço. Quando você cria um ambiente do Elastic Beanstalk com a sua respectiva API, habilita atualizações gerenciadas e especifica AWSServiceRoleForElasticBeanstalkManagedUpdates como o valor para a opção ServiceRoleForManagedUpdates do namespace aws:elasticbeanstalk:managedactions, o Elastic Beanstalk cria a função novamente vinculada ao serviço para você.

Quando o Elastic Beanstalk tenta AWSServiceRoleForElasticBeanstalkManagedUpdates criar a função vinculada ao serviço para sua conta ao criar um ambiente, você deve ter a permissão. iam:CreateServiceLinkedRole Se você não tiver essa permissão, ocorrerá falha na criação do ambiente e você verá uma mensagem explicando o problema.

Como alternativa, outro usuário com permissão para criar funções vinculadas ao serviço pode usar o IAM para pré-criá-las com antecedência. Você poderá criar seu ambiente, mesmo sem ter a permissão iam:CreateServiceLinkedRole.

Você (ou outro usuário) pode usar o console do IAM para criar uma função vinculada ao serviço com o caso de uso Elastic Beanstalk Managed Updates (Atualizações gerenciadas do Elastic Beanstalk). Na CLI ou na API do IAM, crie uma função vinculada ao serviço com o nome de serviço managedupdates.elasticbeanstalk.amazonaws.com. Para obter mais informações, consulte Criar uma função vinculada ao serviço no Guia do usuário do IAM. Se você excluir essa função vinculada ao serviço, será possível usar esse mesmo processo para criar a função novamente.

Se excluir esse perfil vinculado ao serviço e precisar criá-lo novamente, você poderá usar esse mesmo processo para recriar o perfil em sua conta. Quando você cria um ambiente do Elastic Beanstalk com a sua respectiva API, habilita atualizações gerenciadas e especifica AWSServiceRoleForElasticBeanstalkManagedUpdates como o valor para a opção ServiceRoleForManagedUpdates do namespace aws:elasticbeanstalk:managedactions, o Elastic Beanstalk cria novamente a função novamente vinculada ao serviço para você.

Editar uma função vinculada ao serviço para o Elastic Beanstalk

O Elastic Beanstalk não permite que você edite a função vinculada ao serviço. AWSServiceRoleForElasticBeanstalkManagedUpdates 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 uma função vinculada a serviço no Guia do usuário do IAM.

Excluir uma função vinculada a serviço para o Elastic Beanstalk

Se você não precisar mais usar um recurso ou serviço que requer um perfil vinculado ao serviço, é recomendável excluí-lo. Dessa forma, você não tem uma entidade não utilizada que não seja monitorada ativamente ou mantida. No entanto, você deve limpar os recursos de sua função vinculada ao serviço antes de excluí-la manualmente.

Limpar um perfil vinculado ao serviço

Para poder usar o IAM para excluir uma função vinculada ao serviço, primeiro é necessário confirmar se os ambientes com atualizações gerenciadas habilitadas do Elastic Beanstalk estão usando uma função de serviço diferente ou se foram encerrados.

nota

Se o serviço Elastic Beanstalk estiver usando a função vinculada ao serviço quando você tentar encerrar os ambientes, o encerramento poderá falhar. Se isso acontecer, espere alguns minutos e tente a operação novamente.

Para encerrar um ambiente do Elastic Beanstalk que usa o (console) AWSServiceRoleForElasticBeanstalkManagedUpdates

1. Abra o console do Elastic Beanstalk e, na lista Regiões, selecione sua. Região da AWS

2. No painel de navegação, selecione Ambientes e selecione o nome do ambiente na lista.

   nota

   Se você tiver muitos ambientes, use a barra de pesquisa para filtrar a lista de ambientes.

3. Escolha Actions e, em seguida, Terminate Environment.

4. Use a caixa de diálogo na tela para confirmar o encerramento do ambiente.

Consulte eb terminate para obter detalhes sobre como encerrar um ambiente do Elastic Beanstalk usando a CLI do EB.

Consulte TerminateEnvironmentpara obter detalhes sobre como encerrar um ambiente do Elastic Beanstalk usando a API.

Excluir manualmente o perfil vinculado ao serviço

Use o console do IAM, a CLI do IAM ou a API do IAM para excluir a função vinculada ao AWSServiceRoleForElasticBeanstalkManagedUpdates serviço. Para mais informações, consulte Excluir um perfil vinculado ao serviço no Guia do usuário do IAM.

Regiões compatíveis com funções vinculadas ao serviço do Elastic Beanstalk

O Elastic Beanstalk é compatível com funções vinculadas ao serviço em todas as regiões em que o serviço está disponível. Para obter mais informações, consulte Endpoints e cotas do AWS Elastic Beanstalk.