AWS CodeDeploy
User Guide (API Version 2014-10-06)
AWS 服务或AWS文档中描述的功能,可能因地区/位置而异。点 击 Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

管理您的 AWS CodeDeploy 资源的访问权限概述

每个 AWS 资源都归某个 AWS 账户所有,创建和访问资源的权限由权限策略进行管理。账户管理员可以向 IAM 身份(即:用户、组和角色)挂载权限策略,某些服务(如 AWS Lambda)也支持向资源挂载权限策略。

注意

账户管理员(或管理员用户)是具有管理员权限的用户。有关更多信息,请参阅 IAM 用户指南 中的 IAM 最佳实践

在授予权限时,您要决定谁获得权限,获得对哪些资源的权限,以及您允许对这些资源执行的具体操作。

AWS CodeDeploy 资源和操作

在 AWS CodeDeploy 中,主要资源为 deployment group。在策略中,您可以使用 Amazon 资源名称 (ARN) 标识策略应用到的资源。AWS CodeDeploy 支持可与 deployment groups 一起使用的其他资源,包括应用程序、部署配置和实例。这些资源称为子资源。这些资源和子资源具有与其关联的唯一 Amazon 资源名称 (ARN)。有关 ARN 的详细信息,请参阅 Amazon Web Services 一般参考 中的 Amazon 资源名称 (ARN) 和 AWS 服务命名空间

资源类型 ARN 格式
部署组

arn:aws:codedeploy:region:account:deploymentgroup/deployment-group-name

应用程序

arn:aws:codedeploy:region:account:application/application-name

部署配置

arn:aws:codedeploy:region:account-id:deploymentconfig/deployment-configuration-name

实例

arn:aws:codedeploy:region:account-id:instance/instance-ID

所有 AWS CodeDeploy 资源

arn:aws:codedeploy:*

指定账户在指定地区拥有的所有 AWS CodeDeploy 资源

arn:aws:codedeploy:region:account:*

注意

AWS 中的大多数服务将 ARN 中的冒号 (:) 或正斜杠 (/) 视为相同的字符。不过,AWS CodeDeploy 在资源模式和规则中使用精确匹配。请在创建事件模式时务必使用正确的 ARN 字符,以使其与资源中的 ARN 语法匹配。

例如,您可以使用某个特定部署组 (myDeploymentGroup) 的 ARN 在语句中指定该规则,如下所示:

Copy
"Resource": "arn:aws:codedeploy:us-west-2:123456789012:deploymentgroup/myDeploymentGroup"

您还可以使用通配符 (*) 指定属于特定账户的所有 deployment groups,如下所示:

Copy
"Resource": "arn:aws:codedeploy:us-west-2:123456789012:deploymentgroup/*"

要指定所有资源,或者如果特定 API 操作不支持 ARN,请在 Resource 元素中使用通配符 (*),如下所示:

Copy
"Resource": "*"

有些 AWS CodeDeploy API 操作接受多个资源(例如,BatchGetDeploymentGroups)。要在单个语句中指定多种资源,请使用逗号将它们隔开,如下所示:

Copy
"Resource": ["arn1", "arn2"]

AWS CodeDeploy 提供一组操作用来处理 AWS CodeDeploy 资源。有关可用操作的列表,请参阅 AWS CodeDeploy 权限参考

了解资源所有权

AWS 账户对在该账户下创建的资源具有所有权,而无论创建资源的人员是谁。具体而言,资源所有者是对资源创建请求进行身份验证的委托人实体(即根账户、IAM 用户或 IAM 角色)的 AWS 账户。以下示例说明了它的工作原理:

  • 如果您使用 AWS 账户的根账户凭证创建规则,则您的 AWS 账户即为该 AWS CodeDeploy 资源的所有者。

  • 如果您在您的 AWS 账户中创建 IAM 用户并对该用户授予创建 AWS CodeDeploy 资源的权限,则该用户可以创建 AWS CodeDeploy 资源。但是,该用户所属的 AWS 账户拥有这些 AWS CodeDeploy 资源。

  • 如果您在您的 AWS 账户中创建具有创建 AWS CodeDeploy 资源的权限的 IAM 角色,则能够担任该角色的任何人都可以创建 AWS CodeDeploy 资源。该角色所属的 AWS 账户拥有这些 AWS CodeDeploy 资源。

管理对资源的访问

权限策略 规定谁可以访问哪些内容。下一节介绍创建权限策略时的可用选项。

注意

本节讨论如何在 AWS CodeDeploy 范围内使用 IAM。这里不提供有关 IAM 服务的详细信息。有关完整的 IAM 文档,请参阅什么是 IAM?(在 IAM 用户指南 中)。有关 IAM 策略语法和说明的信息,请参阅 IAM 用户指南 中的 AWS IAM 策略参考

挂载到 IAM 身份的策略称作基于身份 的策略(IAM 策略),而挂载到资源的策略称作基于资源 的策略。AWS CodeDeploy 只支持基于身份的策略(IAM 策略)。

基于身份的策略 (IAM 策略)

您可以向 IAM 身份挂载策略。例如,您可以执行以下操作:

  • 将权限策略附加到您的账户中的用户或组 - 要授予查看 AWS CodeDeploy 控制台中的应用程序、部署组和其他 AWS CodeDeploy 资源的用户权限,您可以将权限策略附加到用户或用户所属的组。

     

  • 向角色挂载权限策略(授予跨账户权限) - 您可以向 IAM 角色挂载基于身份的权限策略,以授予跨账户的权限。例如,账户 A 中的管理员可以创建一个角色,以向其他 AWS 账户(如账户 B)或某项 AWS 服务授予跨账户权限,如下所述:

     

    1. 账户 A 管理员创建一个 IAM 角色,向该角色挂载授权其访问账户 A 中资源的权限策略。

       

    2. 账户 A 管理员可以向将账户 B 标识为能够担任该角色的委托人的角色挂载信任策略。

       

    3. 之后,账户 B 管理员可以委派权限,指派账户 B 中的任何用户担任该角色。这样,账户 B 中的用户就可以创建或访问账户 A 中的资源了。如果您需要授予 AWS 服务权限来担任该角色,则信任策略中的委托人也可以是 AWS 服务委托人。

       

    有关使用 IAM 委派权限的更多信息,请参阅 IAM 用户指南 中的访问权限管理

在 AWS CodeDeploy 中,基于身份的策略用于管理对与部署过程相关的多种权限。您可以控制对所有以下类型资源的访问:

  • 应用程序和应用程序修订

  • 部署

  • 部署配置

  • 实例和本地实例

基于资源策略所控制的能力因资源类型而异,如下表所述:

资源类型

功能

全部

查看和列出有关资源的详细信息

应用程序

部署配置

部署组

创建资源

删除资源

部署

创建部署

停止部署

应用程序修订

注册应用程序修订

应用程序

部署组

更新资源

本地实例

向实例中添加标签

从实例中删除标签

注册实例

取消注册实例

可以创建特定的 IAM 策略来限制您账户中的用户有权访问的调用和资源,然后将这些策略与 IAM 用户关联。有关如何创建 IAM 角色和探索 AWS CodeDeploy 的 IAM 策略语句示例的更多信息,请参阅管理您的 AWS CodeDeploy 资源的访问权限概述

基于资源的策略

其他服务 (如 Amazon S3) 也支持基于资源的权限策略。例如,您可以将策略挂载到 S3 存储桶以管理对该存储桶的访问权限。AWS CodeDeploy 不支持基于资源的策略。

指定策略元素:操作、效果和委托人

对于每个 AWS CodeDeploy 资源,该服务都定义了一组 API 操作。为授予这些 API 操作的权限,AWS CodeDeploy 定义了一组您可以在策略中指定的操作。某些 API 操作可能需要多个操作的权限才能执行 API 操作。有关资源和 API 操作的更多信息,请参阅 AWS CodeDeploy 资源和操作AWS CodeDeploy 权限参考

以下是基本的策略元素:

  • Resource - 您使用 Amazon 资源名称 (ARN) 来标识策略应用到的资源。有关更多信息,请参阅 AWS CodeDeploy 资源和操作

  • Action - 您可以使用操作关键字标识要允许或拒绝的资源操作。例如,codedeploy:GetApplication 权限允许执行 GetApplication 操作的用户权限。

  • Effect - 用于指定当用户请求特定操作时的效果 (可以是允许或拒绝)。如果没有显式授予 (允许) 对资源的访问权限,则隐式拒绝访问。您也可显式拒绝对资源的访问,这样可确保用户无法访问该资源,即使有其他策略授予了访问权限的情况下也是如此。

  • Principal - 在基于身份的策略 (IAM 策略) 中,附加了策略的用户是隐式委托人。对于基于资源的策略,您可以指定要接收权限的用户、账户、服务或其他实体 (仅适用于基于资源的策略)。

要了解有关 IAM 策略语法和说明的更多信息,请参阅 IAM 用户指南 中的 AWS IAM 策略参考

有关显示所有 AWS CodeDeploy API 操作及其适用资源的表,请参阅 AWS CodeDeploy 权限参考

在策略中指定条件

当您授予权限时,可使用访问策略语言来指定规定策略何时生效的条件。例如,您可能希望策略仅在特定日期后应用。有关使用策略语言指定条件的更多信息,请参阅 IAM 用户指南 中的条件

要表示条件,您可以使用预定义的条件键。没有特定于 AWS CodeDeploy 的条件键。但有 AWS 范围内的条件密钥,您可以根据需要使用。有关 AWS 范围内的键的完整列表,请参阅 IAM 用户指南 中的条件的可用键