创建映像配方的新版本

创建新的映像配方版本：

1. 在配方详细信息页面顶部，选择创建新版本。这将打开 “创建图像配方” 页面。

2. 要创建新版本，请进行更改，然后选择Create recipe（创建配方）。

   您的最终图片最多可以包含来自 AWS Marketplace 图片产品和组件的九个商品代码。如果您的基础图像和组件超过此限制，Image Builder 将在配方创建过程中返回错误。

1. 创建 CLI 输入 JSON 文件

   您可以使用内联命令参数为 create-image-recipe 命令提供所有输入。但是，生成的命令可能会很长。为了简化命令，您可以改为提供包含所有配方设置的 JSON 文件。

   注意

   JSON 文件中数据值的命名约定遵循为映像生成器 API 操作请求参数指定的模式。要查看 API 操作请求参数，请参阅 EC2 映像生成器 API 参考中的CreateImageRecipe命令。

   要将数据值作为命令行参数提供，请参阅《AWS CLI 命令引用》中指定的参数名称。

   以下是这些示例指定的参数的摘要：

   • 名称（字符串，必填项） - 映像配方的名称。

   • 描述（字符串）- 映像配方的描述。

   • parentImage （字符串，必填项）- 映像配方用作自定义映像基础的映像。您可以使用以下选项之一指定父图像：

     • AMI ID — 当您有要自定义的特定 AMI（例如ami-1234567890abcdef1）时使用。由于 AMI ID 是静态的，因此当您希望配方自动获取更新的基础映像时，我们建议改为使用映像生成器映像 ARN 或 SSM 参数。

     • 映像生成器图像资源 ARN — 当您想在映像生成器映像之上进行构建时使用。这包括 Amazon-managed 映像生成器为最常用的操作系统提供的映像，以及您之前创建的映像。使用语义版本指定图像 ARN，或使用版本通配符始终获取最新版本。

     • AWS Systems Manager (SSM) 参数存储参数 -当您希望配方在不创建新的配方版本的情况下自动获取新的 AMI ID 时使用。在参数前面加上前缀ssm:，然后是参数名称或 ARN。对于应始终使用最新的亚马逊 Linux 或 Windows 基础映像的管道来说，这是理想的选择。

     • AWS Marketplace 产品 ID — 当您在中订阅 AMI 产品 AWS Marketplace 并想要进一步对其进行自定义时使用。

     注意

     • 当您使用 AMI ID 或解析为 AMI 的 SSM 参数时，您必须有权访问账户中的该 AMI。AMI 还必须存在于映像生成器运行构建的同一区域中。

     • Linux 和 macOS 示例指定了 AMI ID，而 Windows 示例使用映像生成器映像 ARN。

   • <major>SemanticVersion（字符串，必填）-以该格式输入要创建的版本号。<minor>。<patch>。Image Builder 支持配方版本自动递增，允许您在配方版本中使用通配符模式。当您使用通配符版本（例如）创建配方时1.0.x，Image Builder 会自动递增版本号（例如1.0.11.0.2、1.0.3、、等）。这样就无需手动跟踪和增加配方版本。要了解有关 Image Builder 资源的语义版本控制的更多信息，请参阅Image Builder 中的语义版本控制。

   • 组件（数组，可选）-包含ComponentConfiguration对象数组。组件是可选的-您可以为测试或分发工作流程创建不带任何组件的配方：

     注意

     Image Builder 按照您在配方中指定的顺序安装组件。但是，CIS 强化组件始终最后运行，以确保基准测试针对您的输出映像运行。

     • componentARN（字符串，必填）– 组件 ARN。

       提示

       要使用其中一个示例创建自己的映像配方，必须将示例 ARN 替换为用于配方的组件的 ARN。

     • 参数（对象数组）- 包含 ComponentParameter 对象数组。如果需要输入参数，但组件中未定义默认值，则必须提供一个值。如果缺少任何必需的参数且未定义默认值，Image Builder 将不会创建配方版本。

       重要

       组件参数是纯文本值，并且已记录在 AWS CloudTrail中。我们建议您使用 AWS Secrets Manager 或 AWS Systems Manager 参数存储来存储您的密钥。有关 Secrets Manager 的更多信息，请参阅AWS Secrets Manager 用户指南中的什么是 Secrets Manager?。有关 AWS Systems Manager Parameter Store 的更多信息，请参阅《AWS Systems Manager 用户指南》中的AWS Systems Manager Parameter Store。

       • 名称（字符串，必填）- 要设置的组件参数的名称。

       • 值（字符串数组，必填）- 包含用于设置指定组件参数值的字符串数组。如果为组件定义了默认值且未提供其他值，则 AWSTOE 使用该默认值。

   • amiWatermarks（字符串数组，可选）— 要附加到根据此配方生成的输出 AMI 的水印名称列表。水印是谱系标记，可帮助您追踪图像的历史。指定 1 到 5 个名称。每个名称必须为 3 到 128 个字符，可以包含字母、数字、空格和以下特殊字符：( ) [ ] . / - ' @ _。有关更多信息，请参阅 使用水印追踪 AMI 血统。

   • 附加 InstanceConfiguration（对象）-为您的构建实例指定其他设置和启动脚本。

     • 系统 ManagerAgent（对象）-包含构建实例上系统管理器代理的设置。

       注意

       Windows 食谱不支持该systemsManagerAgent配置。如果您将其包含在 Windows 父映像中，则请求会失败。

       • 卸载 AfterBuild（布尔值）— 控制在创建新 AMI 之前是否将系统管理器代理从您的最终构建映像中移除。如果将此选项设置为 true，则从最终映像中移除该代理。如果将此选项设置为 false，则保留该代理，以便将它包含在新 AMI 中。默认值为 false。

         注意

         如果 JSON 文件中未包含该 uninstallAfterBuild 属性，并且满足以下条件，则 Image Builder 会从最终映像中移除 Systems Manager 代理，使其在 AMI 中不可用：

         • userDataOverride 为空或已从 JSON 文件中省略。

         • 对于未在基础映像上预装代理的操作系统，Image Builder 会自动在构建实例上安装 Systems Manager 代理。

     • 用户 DataOverride（字符串）-提供启动构建实例时要运行的命令或命令脚本。

       注意

       用户数据始终采用 base 64 编码。例如，以下命令被编码为 IyEvYmluL2Jhc2gKbWtkaXIgLXAgL3Zhci9iYi8KdG91Y2ggL3Zhcg==：

       #!/bin/bash
       mkdir -p /var/bb/
       touch /var

       Linux 示例使用此编码值。

   Linux

   以下示例中的基础映像（parentImage 属性）是 AMI。使用 AMI 时，您必须具有访问该 AMI 的权限，并且 AMI 必须位于源区域（与 Image Builder 运行命令的区域相同）。将文件另存为 create-image-recipe.json，并在 create-image-recipe 命令中使用。

   {
   "name": "BB Ubuntu Image recipe",
   "description": "Hello World image recipe for Linux.",
   "parentImage": "ami-1234567890abcdef1",
   "semanticVersion": "1.0.0",
   "components": [
   	{
   		"componentArn": "arn:aws:imagebuilder:us-west-2:111122223333:component/bb$"
   	}
   ],
   "additionalInstanceConfiguration": {
   	"systemsManagerAgent": {
   	 	"uninstallAfterBuild": true
   	},
   	"userDataOverride": "IyEvYmluL2Jhc2gKbWtkaXIgLXAgL3Zhci9iYi8KdG91Y2ggL3Zhcg=="
   }
   }

   Windows

   以下示例引用最新版本的 Windows Server 2016 英文版全基础映像。此示例中的 ARN 根据您指定的语义版本过滤器引用最新图像:. arn:aws:imagebuilder:us-west-2:aws:image/windows-server-2016-english-full-base-x86/x.x.x

   {
   "name": "MyBasicRecipe",
   "description": "This example image recipe creates a Windows 2016 image.",
   "parentImage": "arn:aws:imagebuilder:us-west-2:aws:image/windows-server-2016-english-full-base-x86/x.x.x",
   "semanticVersion": "1.0.0",
   "components": [
   	{
   		"componentArn": "arn:aws:imagebuilder:us-west-2:111122223333:component/my-example-component/2019.12.02/1"
   	},
   	{
   		"componentArn": "arn:aws:imagebuilder:us-west-2:111122223333:component/my-imported-component/1.0.0/1"
   	}
   ]
   }

   注意

   要了解有关 Image Builder 资源的语义版本控制的更多信息，请参阅Image Builder 中的语义版本控制。

   macOS

   以下示例中的基础映像（parentImage 属性）是 AMI。使用 AMI 时，您必须具有访问该 AMI 的权限，并且 AMI 必须位于源区域（与 Image Builder 运行命令的区域相同）。将文件另存为 create-image-recipe.json，并在 create-image-recipe 命令中使用。

   {
   "name": "macOS Catalina Image recipe",
   "description": "Hello World image recipe for macOS.",
   "parentImage": "ami-1234567890abcdef1",
   "semanticVersion": "1.0.0",
   "components": [
   	{
   		"componentArn": "arn:aws:imagebuilder:us-west-2:111122223333:component/catalina$"
   	}
   ],
   "additionalInstanceConfiguration": {
   	"systemsManagerAgent": {
   	 	"uninstallAfterBuild": true
   	},
   	"userDataOverride": "IyEvYmluL2Jhc2gKbWtkaXIgLXAgL3Zhci9iYi8KdG91Y2ggL3Zhcg=="
   }
   }

   示例：不含成分的食谱

   您可以创建没有任何组件的配方，用于测试现有 AMI 或仅限分发的工作流程。以下示例显示了使用现有 AMI 而不应用任何其他组件的配方：

   {
   	"name": "Test Distribution Recipe",
   	"description": "Recipe for testing and distributing existing AMI without modifications.",
   	"parentImage": "ami-1234567890abcdef1",
   	"semanticVersion": "1.0.0",
   	"additionalInstanceConfiguration": {
   		"systemsManagerAgent": {
   		 	"uninstallAfterBuild": true
   		}
   	}
   }

2. 创建配方

   使用以下命令以创建配方。在 --cli-input-json 参数中提供您在上一步中创建的 JSON 文件的名称：

   aws imagebuilder create-image-recipe --cli-input-json file://create-image-recipe.json

   注意

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

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

   您的最终图片最多可以包含来自 AWS Marketplace 图片产品和组件的九个商品代码。如果运行create-image-recipe命令时您的基础映像和组件超过此限制，则映像生成器在创建配方时会返回错误。

   该命令返回新图像配方的 ARN，如以下示例输出所示。

   {
   	"requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
   	"clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
   	"imageRecipeArn": "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/my-recipe/1.0.1"
   }

3. 验证你的食谱

   要确认 Image Builder 是否按预期创建了您的配方，请使用上一步返回的 ARN 运行get-image-recipe命令。

   aws imagebuilder get-image-recipe --image-recipe-arn arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/my-recipe/1.0.1

1. 在基础映像的选择映像部分中，选择导入基础映像选项。

2. 像往常一样选择映像操作系统 (OS)和操作系统 (OS) 版本。

1. 源 – 可以是 S3 存储桶或 EBS 快照。

2. 选择磁盘的 S3 位置 – 输入 Amazon S3 中存储磁盘映像的位置。要浏览位置，请选择浏览 S3。

3. 要添加磁盘容器，请选择添加磁盘容器。

General

1. 为基本映像指定一个唯一的名称。如果不输入任何值，则基础映像将继承该配方名称。

2. 指定基础映像的版本。采用以下格式：<major>.<minor>.<patch>。如果不输入任何值，则基础映像将继承该配方版本。

3. 您也可以为基础映像输入描述。