A função de função vinculada ao serviço de monitoramento

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 AWSServiceRoleForElasticBeanstalk: permite que o Elastic Beanstalk monitore a integridade dos ambientes em execução e publique notificações de eventos de integridade.

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

A política de permissões da função vinculada ao serviço AWSServiceRoleForElasticBeanstalk contém todas as permissões de que o Elastic Beanstalk precisa para concluir ações em seu nome:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "AllowCloudformationReadOperationsOnElasticBeanstalkStacks",
            "Effect": "Allow",
            "Action": [
                "cloudformation:DescribeStackResource",
                "cloudformation:DescribeStackResources",
                "cloudformation:DescribeStacks"
            ],
            "Resource": [
                "arn:aws:cloudformation:*:*:stack/awseb-*",
                "arn:aws:cloudformation:*:*:stack/eb-*"
            ]
        },
        {
            "Sid": "AllowOperations",
            "Effect": "Allow",
            "Action": [
                "autoscaling:DescribeAutoScalingGroups",
                "autoscaling:DescribeAutoScalingInstances",
                "autoscaling:DescribeNotificationConfigurations",
                "autoscaling:DescribeScalingActivities",
                "autoscaling:PutNotificationConfiguration",
                "ec2:DescribeInstanceStatus",
                "ec2:AssociateAddress",
                "ec2:DescribeAddresses",
                "ec2:DescribeInstances",
                "ec2:DescribeSecurityGroups",
                "elasticloadbalancing:DescribeInstanceHealth",
                "elasticloadbalancing:DescribeLoadBalancers",
                "elasticloadbalancing:DescribeTargetHealth",
                "elasticloadbalancing:DescribeTargetGroups",
                "sqs:GetQueueAttributes",
                "sqs:GetQueueUrl",
                "sns:Publish"
            ],
            "Resource": [
                "*"
            ]
        }
    ]
}

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 um ambiente do Elastic Beanstalk é criado usando a API do Elastic Beanstalk e nenhuma função de serviço é especificada, o Elastic Beanstalk cria a função vinculada ao serviço para você.

Quando o Elastic Beanstalk tenta criar a função vinculada ao serviço AWSServiceRoleForElasticBeanstalk 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 do Elastic Beanstalk. Na CLI ou na API do IAM, crie uma função vinculada ao serviço com o nome de serviço 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 um ambiente do Elastic Beanstalk é criado usando a API do Elastic Beanstalk e nenhuma função de serviço é especificada, o Elastic Beanstalk cria novamente a função 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 AWSServiceRoleForElasticBeanstalk. 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 todos os ambientes do Elastic Beanstalk estão usando uma função de serviço diferente ou se foram encerrados.

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 AWSServiceRoleForElasticBeanstalk. 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.