AWS Elastic Beanstalk
开发人员指南
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 Amazon AWS 入门

为 Elastic Beanstalk 使用服务相关角色

AWS Elastic Beanstalk 可以使用 AWS Identity and Access Management (IAM) 服务相关角色。服务相关角色是一种与 Elastic Beanstalk 直接关联的独特类型的 IAM 角色。服务相关角色由 Elastic Beanstalk 预定义,具有服务代表您调用其他 AWS 服务所需的所有权限。当您创建环境但没有为其显式指定服务角色时,Elastic Beanstalk 将使用服务相关角色。

服务相关角色可让您更轻松地设置 Elastic Beanstalk,因为您不必手动添加必要的权限。Elastic Beanstalk 定义其服务相关角色的权限,除非另外定义,否则只有 Elastic Beanstalk 可以代入该角色。定义的权限包括信任策略和权限策略,以及不能附加到任何其他 IAM 实体的权限策略。

只有在首先删除角色的相关资源后,才能删除角色。这将保护您的 Elastic Beanstalk 资源,因为您不会无意中删除对资源的访问权限。

有关支持服务相关角色的其他服务的信息,请参阅与 IAM 配合使用的 AWS 服务并查找 Service-Linked Role 列为 Yes 的服务。选择 Yes 与查看该服务的服务相关角色文档的链接。

用于 Elastic Beanstalk 的服务相关角色权限

Elastic Beanstalk 使用名为 AWSServiceRoleForElasticBeanstalk. Elastic Beanstalk uses this service-linked role to call other AWS services on your behalf. 的服务相关角色。

AWSServiceRoleForElasticBeanstalk 服务相关角色信任 elasticbeanstalk.amazonaws.com.cn 服务来代入该角色。

AWSServiceRoleForElasticBeanstalk 服务相关角色的权限策略包含 Elastic Beanstalk 代表您完成操作需要的所有权限:

{ "Version": "2012-10-17", "Statement": [ { "Sid": "AllowCloudformationReadOperationsOnElasticBeanstalkStacks", "Effect": "Allow", "Action": [ "cloudformation:DescribeStackResource", "cloudformation:DescribeStackResources", "cloudformation:DescribeStacks" ], "Resource": [ "arn:aws-cn:cloudformation:*:*:stack/awseb-*", "arn:aws-cn: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": [ "*" ] } ] }

您必须配置权限以允许 IAM 实体 (例如,用户、组或角色) 创建、编辑或删除服务相关角色。

允许 IAM 实体创建 AWSServiceRoleForElasticBeanstalk 服务相关角色

将以下语句添加到需要创建服务相关角色的 IAM 实体的权限策略:

{ "Effect": "Allow", "Action": [ "iam:CreateServiceLinkedRole", "iam:PutRolePolicy" ], "Resource": "arn:aws-cn:iam::*:role/aws-service-role/elasticbeanstalk.amazonaws.com.cn/AWSServiceRoleForElasticBeanstalk*", "Condition": {"StringLike": {"iam:AWSServiceName": "elasticbeanstalk.amazonaws.com.cn"}} }

允许 IAM 实体编辑 AWSServiceRoleForElasticBeanstalk 服务相关角色的说明

将以下语句添加到需要编辑服务相关角色的描述的 IAM 实体的权限策略:

{ "Effect": "Allow", "Action": [ "iam:UpdateRoleDescription" ], "Resource": "arn:aws-cn:iam::*:role/aws-service-role/elasticbeanstalk.amazonaws.com.cn/AWSServiceRoleForElasticBeanstalk*", "Condition": {"StringLike": {"iam:AWSServiceName": "elasticbeanstalk.amazonaws.com.cn"}} }

允许 IAM 实体删除 AWSServiceRoleForElasticBeanstalk 服务相关角色

将以下语句添加到需要删除服务相关角色的 IAM 实体的权限策略:

{ "Effect": "Allow", "Action": [ "iam:DeleteServiceLinkedRole", "iam:GetServiceLinkedRoleDeletionStatus" ], "Resource": "arn:aws-cn:iam::*:role/aws-service-role/elasticbeanstalk.amazonaws.com.cn/AWSServiceRoleForElasticBeanstalk*", "Condition": {"StringLike": {"iam:AWSServiceName": "elasticbeanstalk.amazonaws.com.cn"}} }

或者,您可以使用 AWS 托管策略提供对 Elastic Beanstalk 的完全访问权限

为 Elastic Beanstalk 创建服务相关角色

您无需手动创建 AWSServiceRoleForElasticBeanstalk 角色。当您 create an Elastic Beanstalk environment using the Elastic Beanstalk API and don't specify a service role 时,Elastic Beanstalk 将为您创建服务相关角色。

您还可以使用 IAM 控制台、AWS CLI 或 IAM API 通过 Elastic Beanstalk 使用案例创建服务相关角色。有关更多信息,请参阅 IAM 用户指南中的创建服务相关角色

重要

如果您在 September 27, 2017 之前使用 Elastic Beanstalk 服务,那么当它开始支持服务相关角色时,Elastic Beanstalk 会在您的账户中创建 AWSServiceRoleForElasticBeanstalk 角色。要了解更多信息,请参阅我的 IAM 账户中出现新角色

编辑用于 Elastic Beanstalk 的服务相关角色

Elastic Beanstalk 不允许您编辑 AWSServiceRoleForElasticBeanstalk 服务相关角色。创建服务相关角色后,您将无法更改角色的名称,因为可能有多种实体引用该角色。不过,您可以使用 IAM 编辑角色的说明。

编辑服务相关角色描述 (IAM 控制台)

您可以使用 IAM 控制台编辑服务相关角色的描述。

编辑服务相关角色的描述 (控制台)

  1. 在 IAM 控制台的导航窗格中,选择 Roles

  2. 选择要修改的角色的名称。

  3. Role description 的最右侧,选择 Edit

  4. 在框中键入新描述,然后选择 Save

编辑服务相关角色描述 (IAM CLI)

您可以从 AWS Command Line Interface使用 IAM 命令编辑服务相关角色的描述。

更改服务相关角色的描述 (CLI)

  1. (可选) 要查看角色的当前描述,请使用以下命令:

    $ aws iam get-role --role-name role-name

    通过 CLI 命令使用角色名称(并非 ARN)指向角色。例如,如果一个角色的 ARN 为:arn:aws-cn:iam::123456789012:role/myrole,则应将角色称为 myrole

  2. 要更新服务相关角色的描述,请使用以下命令之一:

    $ aws iam update-role-description --role-name role-name --description description

编辑服务相关角色描述 (IAM API)

您可以使用 IAM API 编辑服务相关角色的描述。

更改服务相关角色的描述 (API)

  1. (可选) 要查看角色的当前描述,请使用以下命令:

    IAM API:GetRole

  2. 要更新角色的描述,请使用以下命令:

    IAM API: UpdateRoleDescription

删除用于 Elastic Beanstalk 的服务相关角色

如果您不再需要使用某个需要服务相关角色的功能或服务,我们建议您删除该角色。这样您就没有未被主动监控或维护的未使用实体。但是,您必须先清除您的服务相关角色,然后才能将其删除。

清除服务相关角色

在您可以使用 IAM 删除服务相关角色之前,必须先确认该角色没有活动会话并删除该角色使用的任何资源。

检查服务相关角色是否在 IAM 控制台中有活动会话

  1. 登录 AWS 管理控制台 并通过以下网址打开 IAM 控制台 https://console.amazonaws.cn/iam/

  2. 在 IAM 控制台的导航窗格中,选择角色。然后选择 AWSServiceRoleForElasticBeanstalk 角色的名称 (不是复选框)。

  3. 在所选角色的 Summary 页面上,选择 Access Advisor 选项卡。

  4. Access Advisor 选项卡上,查看服务相关角色的近期活动。

    注意

    如果您不确定 Elastic Beanstalk 是否正在使用 AWSServiceRoleForElasticBeanstalk 角色,您可以尝试删除该角色。如果服务正在使用该角色,则删除操作会失败,并且您可以查看正在使用该角色的区域。如果该角色已被使用,则您必须等待会话结束,然后才能删除该角色。您无法撤销服务相关角色对会话的权限。

当您确定正在使用 AWSServiceRoleForElasticBeanstalk 角色的 Elastic Beanstalk 环境时,可以终止这些环境,然后再删除该角色。

终止 Elastic Beanstalk 环境 (控制台)

  1. 打开 Elastic Beanstalk 控制台

  2. 导航到您的环境的管理页

  3. 选择 Actions,然后选择 Terminate Environment

  4. Confirm Termination 对话框中,键入环境名称,然后选择 Terminate

有关使用 EB CLI 终止 Elastic Beanstalk 环境的详细信息,请参阅eb terminate

有关使用 API 终止 Elastic Beanstalk 环境的详细信息,请参阅 TerminateEnvironment

删除服务相关角色

您可以使用 IAM 控制台、AWS CLI 或 IAM API 删除服务相关角色。有关更多信息,请参阅 IAM 用户指南中的删除服务相关角色