本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
使用 Image Builder 设置跨账户 AMI 分配
您可以配置分发设置,将映像生成器 AMI 传送到您指定的其他账户。
然后,目标账户可以根据需要启动或修改 AMI。
有关包含以下内容的可部署示例的信息 Amazon KMS 密钥策略和目标账户角色,请参阅 跨账户 AMI 示例
Amazon CLI 本节中的命令示例假设您之前创建了镜像配方和基础架构配置 JSON 文件。要为映像配方创建 JSON 文件,请参阅 使用创建图像配方 Amazon CLI 或用于 PowerShell。要为基础设施配置创建 JSON 文件,请参阅 创建基础设施配置。
跨账户 AMI 分配的先决条件
为确保目标账户能够成功地从您的 Image Builder 映像启动实例,您必须为所有区域的所有目标账户配置相应权限。
如果您使用加密您的 AMI Amazon Key Management Service (Amazon KMS),你必须配置一个 Amazon KMS key 用于加密新图像的账户。
当 Image Builder 对加密的 AMI 执行跨账户分配时,源账户中的映像将被解密并推送到目标区域,然后使用该区域的指定密钥对其重新加密。由于 Image Builder 代表目标账户行事,并使用您在目标区域创建的 IAM 角色,因此该账户必须有权访问源区域和目标区域中的密钥。
如果由于缺少角色或密钥策略而导致跨账户分配失败,请修复配置,然后重试映像。如果映像在分发阶段出现故障,Image Builder 将在不重建映像的情况下重新运行该阶段。有关更多信息,请参阅 重试失败的图像。
加密密钥
如果您的映像使用 Amazon KMS加密,则需要满足以下先决条件。IAM 先决条件将在下一部分中介绍。
源账户要求
-
在您构建和分配 AMI 的所有区域的账户中创建 KMS 密钥。您也可以使用现有密钥。
-
更新所有这些密钥的密钥策略,以允许目标账户使用您的密钥。
目标账户要求
-
向
EC2ImageBuilderDistributionCrossAccountRole添加内联策略,允许该角色执行分配加密 AMI 所需的操作。有关 IAM 配置步骤,请参阅 IAM 策略 先决条件部分。
有关跨账户访问的更多信息,请使用 Amazon KMS,参见 允许其他账户中的用户使用 KMS 密钥 在 Amazon Key Management Service 开发者指南。
在映像配方中指定您的加密密钥,如下所示:
-
如果您使用的是 Image Builder 控制台,请从配方的存储(卷)部分的加密(KMS 别名)下拉列表中选择您的加密密钥。
-
如果你使用的是 CreateImageRecipe API 操作,或 create-image-recipe 命令在 Amazon CLI,在中配置您的密钥
ebs下方的部分blockDeviceMappings在你的 JSON 输入中。以下 JSON 片段显示了映像配方的加密设置。除了提供您的加密密钥外,您还必须将
encrypted标志设置为true。{ ... "blockDeviceMappings": [ { "deviceName": "Example root volume", "ebs": { "deleteOnTermination": true, "encrypted": true, "iops": 100, "kmsKeyId": "image-owner-key-id", ... }, ... }], ... }
IAM 策略
要在中配置跨账户分发权限 Amazon Identity and Access Management (IAM),请按照以下步骤操作:
-
要使用跨账户分配的 Image Builder AMI,目标账户所有者必须在其账户中创建一个名为
EC2ImageBuilderDistributionCrossAccountRole的新 IAM 角色。 -
他们必须将 Ec2ImageBuilderCrossAccountDistributionAccess policy 附加到角色才能启用跨账户分配。有关托管策略的更多信息,请参阅 Amazon Identity and Access Management 用户指南 中的托管策略与内联策略。
-
确认源账户 ID 已添加到目标账户的 IAM 角色所附的信任策略中。以下示例显示了目标账户中的信任策略,该策略指定了源账户中的账户 ID。
有关信任策略的更多信息,请参阅 Resource-Based 政策 在 Amazon Identity and Access Management 用户指南。
-
如果您分配的 AMI 已加密,则目标账户所有者必须在其账户的
EC2ImageBuilderDistributionCrossAccountRole中添加以下内联策略,以便使用您的 KMS 密钥。这使映像生成器能够在使用时代表他们采取行动 Amazon KMS 使用每个区域的相应密钥对 AMI 进行加密和解密。有关内联策略的更多信息,请参阅 Amazon Identity and Access Management 用户指南中的内联策略。
-
如果您使用
launchTemplateConfigurations指定 Amazon EC2 启动模板,则还必须在每个目标账户的EC2ImageBuilderDistributionCrossAccountRole中添加以下策略。 -
如果你使用 Amazon Systems Manager 参数存储参数要存储分配账户和地区的输出 AMI 的 AMI ID,必须将以下策略添加到您的
EC2ImageBuilderDistributionCrossAccountRole在每个目标账户中。
跨账户分配的限制
跨账户分配 Image Builder 映像时有一些限制:
-
每个目标区域的目标账户仅限 50 个并发 AMI 副本。
-
如果要将半虚拟化 (PV) 虚拟化 AMI 复制到另一个区域,则目标区域必须支持 PV 虚拟化 AMI。有关更多信息,请参阅 Linux AMI 虚拟化类型。
-
您无法创建加密快照的未加密副本。如果您没有为
KmsKeyId参数指定 Amazon Key Management Service (Amazon KMS) 客户托管密钥,Image Builder 将使用 Amazon Elastic Block Store (Amazon EBS) 的默认密钥。有关更多信息,请参阅 Amazon Elastic Compute Cloud 用户指南 中的 Amazon EBS 加密。
有关更多信息,请参阅 CreateDistributionConfiguration 在 EC2 映像生成器 API 参考。
在控制台中为映像生成器 AMI 配置跨账户分发
本部分介绍如何创建和配置分配设置,以使用 Amazon Web Services 管理控制台跨账户分配 Image Builder 映像。配置跨账户分配需要特定的 IAM 权限。在继续操作之前,您必须完成本部分的 跨账户 AMI 分配的先决条件。
要在 Image Builder 控制台中创建分配,请执行以下步骤:
-
打开 EC2 映像生成器控制台,网址为 https://console.aws.amazon.com/imagebuilder/
。 -
从导航窗格中,选择分配设置。这将显示在您的账户下创建的分配设置列表。
-
在分配设置页面的顶部,选择创建分配设置。这将跳转到创建分配设置页面。
-
在映像类型部分,选择 Amazon Machine Image (AMI) 作为输出类型。这是默认设置。
-
在常规部分中,输入要创建的分配设置资源的名称(必填)。
-
在区域设置部分,在选定区域的目标账户中输入您要向其分配 AMI 的 12 位账户 ID,然后按输入。这将检查格式是否正确,然后框的下方会显示您输入的账户 ID。重复该过程以添加更多帐户。
要删除您输入的账户,请选择账户 ID 右侧显示的 X。
输入每个区域的输出 AMI 名称。
-
继续指定所需的任何其他设置,然后选择创建设置以创建新的分配设置资源。
从 Image Builder AMI 配置跨账户分发 Amazon CLI
本节介绍如何配置分发设置文件和使用 create-image 命令在 Amazon CLI 跨账户构建和分发映像生成器 AMI。
配置跨账户分配需要特定的 IAM 权限。在运行 create-image 命令之前,您必须完成本部分的 跨账户 AMI 分配的先决条件。
-
配置分配设置文件
在你使用之前 create-image 命令在 Amazon CLI 要创建分发到其他账户的映像生成器 AMI,必须创建一个
DistributionConfiguration在 JSON 结构中指定目标账户 IDAmiDistributionConfiguration设置。您必须在源区域中指定至少一个AmiDistributionConfiguration。以下名为
create-distribution-configuration.json的示例文件显示了源区域中跨账户映像分配的配置。{ "name": "cross-account-distribution-example", "description": "Cross Account Distribution Configuration Example", "distributions": [ { "amiDistributionConfiguration": { "targetAccountIds": ["123456789012", "987654321098"], "name": "Name {{ imagebuilder:buildDate }}", "description": "ImageCopy Ami Copy Configuration" }, "region": "us-west-2" } ] } -
创建分配设置
要创建映像生成器发行设置资源,请使用 创建分发配置 命令在 Amazon CLI,在命令中提供以下参数:
-
在
--name参数中输入分配的名称。 -
附加您在
--cli-input-json参数中创建的分配配置 JSON 文件。
aws imagebuilder create-distribution-configuration --namemy distribution name--cli-input-json file://create-distribution-configuration.json注意-
JSON 文件路径开头必须包含
file://符号。 -
JSON 文件的路径应遵循运行命令的基本操作系统的相应约定。例如,Windows 使用反斜杠 (\) 引用目录路径,而 Linux 和 macOS 使用正斜杠 (/)。
-
您也可以使用 --distributions 参数直接在命令中提供 JSON。