创建和更新 AMI 分配配置 - EC2 Image Builder
从控制台创建 AMI 分发配置为来自的输出 AMI 创建分布设置 AWS CLI从控制台更新 AMI 分发设置为启用了 EC2 快速启动的 Windows AMI 创建分发设置 AWS CLI为来自的输出 VM 磁盘创建分发设置 AWS CLI从更新 AMI 分发设置 AWS CLI

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

创建和更新 AMI 分配配置

本节介绍如何创建和更新 Image Builder AMI 的分配配置。

从控制台创建 AMI 分发配置

分发配置包括输出 AMI 名称、用于加密的特定区域设置、启动权限以及 AWS 账户可以启动输出 AMI 的组织和组织单位 (OU) 以及许可证配置。

要创建新的 AMI 分配配置：

  1. 打开位于 https://console.aws.amazon.com/imagebuilder/的 EC2 Image Builder 控制台。

  2. 从导航窗格中，选择分配设置。这将显示在您的账户下创建的分配配置的列表。

  3. 选择分配设置面板顶部附近的创建分配设置。

  4. 在映像类型部分，选择 Amazon Machine Image (AMI) 输出类型。

  5. 在常规部分，输入分配配置的名称和可选描述。

  6. 在区域设置部分，输入您要分配 AMI 的每个区域的以下详细信息：

    1. 默认情况下，AMI 分配到当前区域（区域 1）。区域 1 是分配的来源。区域 1 的某些设置未开放编辑功能。对于您添加的任何区域，您可以从区域下拉列表中选择一个区域。

      Kms 密钥标 AWS KMS key 识用于加密目标区域中映像的 EBS 卷。请务必注意，这不适用于该构建在源区域（区域 1）中使用您的账户创建的原始 AMI。在该构建的分配阶段运行的加密仅适用于分配给其他账户或地区的映像。

      要对在源区域为您的账户创建的 AMI 的 EBS 卷进行加密，您必须在映像配方块设备映射（控制台中的存储（卷））中设置 KMS 密钥。

      Image Builder 将 AMI 复制到您为该区域指定的目标账户。

      先决条件

      要跨账户复制映像，您必须在所有分布目标账户中创建该EC2ImageBuilderDistributionCrossAccountRole角色，并将Ec2ImageBuilderCrossAccountDistributionAccess 策略托管策略附加到该角色。

      输出 AMI 名称为可选项。如果您提供了名称，则最终的输出 AMI 名称会附加一个 AMI 构建时间的时间戳。如果未指定名称，Image Builder 会将构建时间戳附加到配方名称。这样可以确保每次构建的 AMI 名称都是唯一的。

      1. 通过 AMI 共享，您可以向指定的 AWS 委托人授予从您的 AMI 启动实例的访问权限。如果展开 AMI 共享部分，则可以输入以下详细信息：

        • 启动权限 — 如果您想保持 AMI 私有，请选择私有，并允许特定 AWS 委托人访问您的私有 AMI 启动实例。如果要使 AMI 公开，请选择公开。任何 AWS 委托人都可以从您的公有 AMI 启动实例。

        • 委托人-您可以为以下类型的 AWS 委托人授予启动实例的访问权限：

          • AWS 账户-授予对特定 AWS 账户的访问权限

          • 组织单位 (OU) — 授予对 OU 及其所有子实体的访问权限。子实体包括 OU 和 AWS 账户。

          • 组织-授予您 AWS Organizations及其所有子实体的访问权限。子实体包括 OU 和 AWS 账户。

            首先，选择主体类型。然后在下拉列表右侧的框中，输入要授予访问权限的 AWS 主体的 ID。您可以输入多个不同类型的 ID。

      2. 您可以展开 “许可配置” 部分，将使用创建的许可配置附加 AWS License Manager 到 Image Builder 映像。许可证配置包含基于您的企业协议条款的许可规则。Image Builder 会自动包含与您的基本 AMI 关联的许可证配置。

      3. 您可以展开启动模板配置部分，指定用于从您创建的 AMI 启动实例的 EC2 启动模板。

        如果您使用的是 EC2 启动模板，则可以指示 Image Builder 在构建完成后创建包含最新 AMI ID 的启动模板的新版本。要更新启动模板，请按以下方式配置设置：

        • 启动模板名称 — 选择您希望 Image Builder 更新的启动模板的名称。

        • 设置默认版本 — 选中此复选框可将启动模板的默认版本更新为新版本。

        要添加另一个启动模板配置，请选择添加启动模板配置。您在每个区域最多可以拥有五种启动模板配置。

    2. 要为其他区域添加分配设置，请选择添加区域。

  7. 完成后，选择创建设置。

为来自的输出 AMI 创建分布设置 AWS CLI

分配配置允许您指定输出 AMI 的名称和描述，授权其他 AWS 账户 人启动 AMI，将 AMI 复制到其他账户，以及将 AMI 复制到其他 AWS 区域。它还允许将 AMI 导出到 Amazon Simple Storage Service (Amazon S3)，或者为输出 Windows AMI 配置 EC2 Fast Launch。要公开 AMI，请将启动许可授权账户设置为 all。请参阅位于 EC2 ModifyImageAttribute 的公开 AMI 示例。

以下示例说明如何采用 AWS CLI使用 create-distribution-configuration 命令为 AMI 创建新的分配配置。

  1. 创建 CLI 输入 JSON 文件

    使用文件编辑工具创建一个 JSON 文件，其中包含以下示例之一中显示的密钥，以及对您的环境有效的值。这些示例定义了哪些 AWS 账户 AWS Organizations 或哪些组织单位 (OU) 有权启动您分发到指定区域的 AMI。对文件 create-ami-distribution-configuration.json 进行命名，以便在下一步中使用：

    Accounts

    此示例将 AMI 分配到两个区域，并指定在每个区域都拥有启动权限的 AWS 账户 。

    {
    "name": "MyExampleAccountDistribution",
    "description": "Copies AMI to eu-west-1, and specifies accounts that can launch instances in each Region.",
    "distributions": [
        {
            "region": "us-west-2",
            "amiDistributionConfiguration": {
                "name": "Name {{imagebuilder:buildDate}}",
                "description": "An example image name with parameter references",
                "amiTags": {
                    "KeyName": "Some Value"
                },
                "launchPermission": {
                    "userIds": [
                        "987654321012"
                    ]
                }
            }
        },
        {
            "region": "eu-west-1",
            "amiDistributionConfiguration": {
                "name": "My {{imagebuilder:buildVersion}} image {{imagebuilder:buildDate}}",
                "amiTags": {
                    "KeyName": "Some value"
                },
                "launchPermission": {
                    "userIds": [
                        "100000000001"
                    ]
                }
            }
        }
    ]
}
    Organizations and OUs

    此示例将 AMI 分配到源区域，并指定组织和 OU 启动权限。

    {
  "name": "MyExampleAWSOrganizationDistribution",
  "description": "Shares AMI with the Organization and OU",
  "distributions": [
    {
      "region": "us-west-2",
      "amiDistributionConfiguration": {
        "name": "Name {{ imagebuilder:buildDate }}",
        "launchPermission": {
          "organizationArns": [
            "arn:aws:organizations::123456789012:organization/o-myorganization123"
          ],
          "organizationalUnitArns": [
            "arn:aws:organizations::123456789012:ou/o-123example/ou-1234-myorganizationalunit"
          ]
        }
      }
    }
  ]
}
  2. 使用创建的文件作为输入，运行以下命令。
    aws imagebuilder create-distribution-configuration --cli-input-json file://create-ami-distribution-configuration.json
    注意

    • JSON 文件路径开头必须包含 file:// 符号。

    • JSON 文件的路径应遵循运行命令的基本操作系统的相应约定。例如，Windows 使用反斜杠 (\) 引用目录路径，Linux 则使用正斜杠 (/)。

    有关更多详细信息，请参阅 AWS CLI 命令参考中的 create-distribution-configuration。

从控制台更新 AMI 分发设置

您可以使用 Image Builder 控制台更改您的 AMI 分配设置。更新后的分配设置将用于以后的所有自动和手动管道部署。但是，所做的更改不适用于 Image Builder 已经分配的任何资源。例如，如果您已将 AMI 分配到某个区域，但随后又将其从分配中移除，则在您手动将其移除之前，已分配的 AMI 将保留在该区域中。

更新 AMI 分配配置

  1. 打开位于 https://console.aws.amazon.com/imagebuilder/的 EC2 Image Builder 控制台。

  2. 从导航窗格中，选择分配设置。这将显示在您的账户下创建的分配配置的列表。

  3. 要查看详细信息或更新分配配置，请选择配置名称链接。这将打开分配设置的详细视图。

    注意

    您也可以选中配置名称旁边的框，然后选择查看详细信息。

  4. 要编辑分配配置，请从分配详细信息部分的右上角选择编辑。某些字段已锁定，例如分配配置的名称和显示为区域 1 的默认区域。有关分配配置设置的更多信息，请参阅 从控制台创建 AMI 分发配置。

  5. 完成后，选择 Save changes（保存更改）。

为启用了 EC2 快速启动的 Windows AMI 创建分发设置 AWS CLI

以下示例说明如何使用create-distribution-configuration命令从中创建已为您的 AMI 配置了 EC2 Fast Launch 的分配设置 AWS CLI。

注意

对于预先启用 EC2 快速启动的 AMI，Image Builder 不支持跨账户分发。必须从目标账户启用 EC2 快速启动。

  1. 创建 CLI 输入 JSON 文件

    使用文件编辑工具创建一个 JSON 文件，其中包含以下示例中显示的密钥，以及对您的环境有效的值。

    此示例同时启动其所有目标资源的实例，因为并行启动的最大数量大于目标资源数量。该文件在下一步所示的命令示例中被命名为 ami-dist-config-win-fast-launch.json。

    {
"name": "WinFastLaunchDistribution",
"description": "An example of Windows AMI EC2 Fast Launch settings in the distribution configuration.",
"distributions": [
    {
        "region": "us-west-2",
        "amiDistributionConfiguration": {
            "name": "Name {{imagebuilder:buildDate}}",
            "description": "Includes Windows AMI EC2 Fast Launch settings.",
            "amiTags": {
                "KeyName": "Some Value"
            }
        },
        "fastLaunchConfigurations": [{
            "enabled": true,
            "snapshotConfiguration": {
                "targetResourceCount": 5
            },
            "maxParallelLaunches": 6,
            "launchTemplate": {
                "launchTemplateId": "lt-0ab1234c56d789012",
                "launchTemplateVersion": "1"
             }
        }],
        "launchTemplateConfigurations": [{
                   "launchTemplateId": "lt-0ab1234c56d789012",
                   "setDefaultVersion": true
          }]
    }]
}
    注意

    您可以指定 launchTemplateName 而非 launchTemplate 部分中的 launchTemplateId，但不能同时指定名称和 ID。

  2. 使用创建的文件作为输入，运行以下命令。
    aws imagebuilder create-distribution-configuration --cli-input-json file://ami-dist-config-win-fast-launch.json
    注意

    • JSON 文件路径开头必须包含 file:// 符号。

    • JSON 文件的路径应遵循运行命令的基本操作系统的相应约定。例如，Windows 使用反斜杠 (\) 引用目录路径，Linux 则使用正斜杠 (/)。

    有关更多详细信息，请参阅 AWS CLI 命令参考中的 create-distribution-configuration。

为来自的输出 VM 磁盘创建分发设置 AWS CLI

以下示例说明如何使用 create-distribution-configuration 命令创建分配设置，以便在每次构建映像时将 VM 映像磁盘导出到 Amazon S3。

  1. 创建 CLI 输入 JSON 文件

    您可以简化在 AWS CLI中使用的 create-distribution-configuration 命令。为此，请创建一个 JSON 文件，其中包含要传递到命令中的所有导出配置。

    注意

    JSON 文件中数据值的命名惯例遵循为 Image Builder API 操作请求参数指定的模式。要查看 API 命令请求参数，请参阅 EC2 Image Builder API 参考中的 CreateDistributionConfiguration 命令。

    要将数据值作为命令行参数提供，请参阅 AWS CLI 命令参考中指定的参数名，将 create-distribution-configuration 命令作为选项。

    以下是我们在本示例的 s3ExportConfiguration JSON 对象中指定的参数摘要：

    • roleName（字符串，必填）— 授予 VM Import/Export 权限以将映像导出到 S3 存储桶的角色名称。

    • diskImageFormat（字符串，必填）-将更新的磁盘映像导出为以下支持的格式之一：

      • 虚拟硬盘 (VHD)— 可与 Citrix Xen 和 Microsoft Hyper-V 虚拟化产品兼容。

      • 流优化型 ESX 虚拟机磁盘 (VMDK)— 可与 VMware ESX 和 VMware vSphere 版本 4、5 和 6 相兼容。

      • 原始 — 原始格式。

    • s3Bucket（字符串，必填）— 用于存储 VM 的输出磁盘映像的 S3 存储桶。

    将该文件保存为 export-vm-disks.json。在 create-distribution-configuration 命令中使用文件名。

    {
    "name": "example-distribution-configuration-with-vm-export",
    "description": "example",
    "distributions": [
        {
            "region": "us-west-2",
            "amiDistributionConfiguration": {
            	"description": "example-with-vm-export"

            },
            "s3ExportConfiguration": {
                "roleName": "vmimport",
                "diskImageFormat": "RAW",
                "s3Bucket": "vm-bucket-export"
            }
        }],
    "clientToken": "abc123def4567ab"
}
  2. 使用创建的文件作为输入，运行以下命令。
    aws imagebuilder create-distribution-configuration --cli-input-json file://export-vm-disks.json
    注意

    • JSON 文件路径开头必须包含 file:// 符号。

    • JSON 文件的路径应遵循运行命令的基本操作系统的相应约定。例如，Windows 使用反斜杠 (\) 引用目录路径，Linux 则使用正斜杠 (/)。

    有关更多详细信息，请参阅 AWS CLI 命令参考中的 create-distribution-configuration。

从更新 AMI 分发设置 AWS CLI

以下示例说明如何通过 AWS CLI使用 update-distribution-configuration 命令为您的 AMI 更新分配配置。

  1. 创建 CLI 输入 JSON 文件

    使用您常用的文件编辑工具创建一个 JSON 文件，其中包含以下示例中显示的密钥，以及对您的环境有效的值。此示例使用名为 update-ami-distribution-configuration.json 的文件。

    {
    "distributionConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:distribution-configuration/update-ami-distribution-configuration.json",
    "description": "Copies AMI to eu-west-2, and specifies accounts that can launch instances in each Region.",
    "distributions": [
      {
            "region": "us-west-2",
            "amiDistributionConfiguration": {
                "name": "Name {{imagebuilder:buildDate}}",
                "description": "An example image name with parameter references",
                "launchPermissions": {
                    "userIds": [
                        "987654321012"
                    ]
                }
            }
        },
        {
            "region": "eu-west-2",
            "amiDistributionConfiguration": {
                "name": "My {{imagebuilder:buildVersion}} image {{imagebuilder:buildDate}}",
                "tags": {
                    "KeyName": "Some value"
                },
                "launchPermissions": {
                    "userIds": [
                        "100000000001"
                    ]
                }
            }
        }
    ]
}
  2. 使用创建的文件作为输入，运行以下命令。
    aws imagebuilder update-distribution-configuration --cli-input-json file://update-ami-distribution-configuration.json
    注意

    • JSON 文件路径开头必须包含 file:// 符号。

    • JSON 文件的路径应遵循运行命令的基本操作系统的相应约定。例如，Windows 使用反斜杠 (\) 引用目录路径，Linux 则使用正斜杠 (/)。

    有关更多详细信息，请参阅 AWS CLI 命令参考中的 update-distribution-configuration。要更新分配配置资源的标签，请参阅 标记资源 一节。