使用EC2启动模板配置AMI分发 - EC2Image Builder

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

使用EC2启动模板配置AMI分发

为了帮助确保您的 Image Builder AMI 在目标账户和地区获得一致的EC2启动体验,您可以使用在分配设置中指定亚马逊启动模板launchTemplateConfigurations。如果launchTemplateConfigurations在分发过程中存在,Image Builder 会创建启动模板的新版本,其中包含模板中的所有原始设置以及版本中的新 AMI ID。有关使用启动模板启动EC2实例的更多信息,请参阅以下链接之一,具体取决于您的目标操作系统。

注意

当您在映像中包含启用 Windows 快速启动的启动模板时,启动模板必须包含以下标签,这样 Image Builder 才能代表您启用 Windows 快速启动。

CreatedBy: EC2 Image Builder

从控制台向AMI分发设置中添加EC2启动模板

要为您的输出提供启动模板AMI,请在控制台中执行以下步骤:

  1. 打开 EC2 Image Builder 控制台,网址为https://console.aws.amazon.com/imagebuilder/

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

  3. 分配设置页面的顶部,选择创建分配设置。这将打开创建分配设置页面。

  4. 在 “图像类型” 部分,选择 Amazon 系统映像 (AMI) 输出类型。这是默认设置。

  5. 常规部分中,输入要创建的分配设置资源的名称必填)。

  6. 区域设置部分,从列表中选择EC2启动模板的名称。如果您的账户中没有启动模板,请选择创建新的启动模板,这将在EC2控制面板中打开启动模板

    选中 “设置默认版本” 复选框,将启动模板的默认版本更新为 Image Builder 使用您的输出创建的新版本AMI。

    要向所选区域添加其他启动模板,请选择添加启动模板配置

    要移除启动模板,请选择移除

  7. 继续指定所需的任何其他设置,然后选择创建设置以创建新的分配设置资源。

从中向AMI分发设置中添加EC2启动模板 AWS CLI

本节介绍如何使用启动模板配置分发设置文件,以及如何使用中的create-image命令 AWS CLI 来构建和分发 Image Builder AMI 以及使用该模板的新版本的启动模板。

  1. 配置分配设置文件

    在使用启动模板创建 Image Builder AMI 之前 AWS CLI,必须先创建一个用于指定launchTemplateConfigurations设置的分发配置JSON结构。您必须在源区域中指定至少一个 launchTemplateConfigurations 条目。

    以下名为 create-distribution-config-launch-template.json 的示例文件显示了在源区域中配置启动模板的几种可能场景。

    { "name": "NewDistributionConfiguration", "description": "This is just a test", "distributions": [ { "region": "us-west-2", "amiDistributionConfiguration": { "name": "test-{{imagebuilder:buildDate}}-{{imagebuilder:buildVersion}}", "description": "description" }, "launchTemplateConfigurations": [ { "launchTemplateId": "lt-0a1bcde2fgh34567", "accountId": "935302948087", "setDefaultVersion": true }, { "launchTemplateId": "lt-0aaa1bcde2ff3456" }, { "launchTemplateId": "lt-12345678901234567", "accountId": "123456789012" } ] } ], "clientToken": "clientToken1" }
  2. 创建分配设置

    要使用中的create-distribution-configuration命令创建 Image Builder 分发设置资源 AWS CLI,请在命令中提供以下参数:

    • --name 参数中输入分配的名称。

    • 附加您在--cli-input-json参数中创建的分发配置JSON文件。

    aws imagebuilder create-distribution-configuration --name my distribution name--cli-input-json file://create-distribution-config-launch-template.json
    注意
    • 您必须在JSON文件路径的开头添加file://符号。

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

您也可以使用--distributions参数JSON直接在命令中提供。