A função vinculada ao serviço de atualizações gerenciadas - AWS Elastic Beanstalk

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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

O AWS Elastic Beanstalk 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 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 requer para chamar outros produtos da AWS em seu nome.

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, 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 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 chamada AWSServiceRoleForElasticBeanstalkManagedUpdates: permite que o Elastic Beanstalk realize atualizações programadas da plataforma de seus ambientes em execução.

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

  • managedupdates.elasticbeanstalk.amazonaws.com

A política gerenciada AWSElasticBeanstalkManagedUpdatesServiceRolePolicy permite que o perfil vinculado a serviço AWSServiceRoleForElasticBeanstalkManagedUpdates tenha todas as permissões de que o Elastic Beanstalk precisa para concluir as ações de atualização gerenciada em seu nome. Para visualizar o conteúdo da política gerenciada, consulte a página Política de perfil de serviço de atualizações gerenciadas do AWSElasticBeanstalk no Guia de referência de política gerenciada do AWS.

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 gerenciada da AWS 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 ao 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 criar a função vinculada ao serviço AWSServiceRoleForElasticBeanstalkManagedUpdates para sua conta ao criar um ambiente, é necessário 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 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ê 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 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 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.

Como encerrar um ambiente do Elastic Beanstalk que use a função AWSServiceRoleForElasticBeanstalkManagedUpdates (console)
  1. Abra o console do Elastic Beanstalk e, na lista Regions (Regiões), selecione a 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 TerminateEnvironment para obter detalhes sobre o encerramento de um ambiente do Elastic Beanstalk usando a API.

Excluir manualmente o perfil vinculado ao serviço

Use o console, a CLI ou a API do IAM para excluir a função vinculada ao serviço AWSServiceRoleForElasticBeanstalkManagedUpdates. 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.