创建映像配方的新版本

创建新的映像配方版本：

1. 在配方详细信息页面顶部，选择创建新版本。这将带您进入创建映像配方页面。

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

   您的最终图片最多可以包含来自 Amazon Web Services Marketplace 图片产品和组件的四个产品代码。如果您选择的基本图片和组件包含四个以上的产品代码，则当您尝试创建配方时，Image Builder 会返回错误。

1. 创建CLI输入JSON文件

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

   注意

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

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

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

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

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

   • parentImage（字符串，必填）-图像配方用作自定义图像基础的图像。该值可以是基础图像ARN或 AMI ID。

     注意

     Linux 和 macOS 示例使用 Image BuilderAMI，Windows 示例使用 Image Builder。ARN

   • semanticVersion<major>（字符串，必填）—图像配方的语义版本，用以下格式表示，每个位置都有数值来表示特定版本：。 <minor>。 <patch>。例如，值可能为 1.0.0。要了解有关 Image Builder 资源的语义版本控制的更多信息，请参阅Image Builder 中的语义版本控制。

   • 组件（数组，必填）– 包含 ComponentConfiguration 对象的数组。必须指定至少一个构建组件：

     注意

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

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

       提示

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

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

       重要

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

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

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

   • additionalInstanceConfiguration(object)-为您的编译实例指定其他设置并启动脚本。

     • systemsManagerAgent（对象）-包含编译实例上的 Systems Manager 代理的设置。

       • uninstallAfterBuild（布尔值）-控制在创建新版本映像之前，是否将 Systems Manager 代理从最终版本映像中删除AMI。如果将此选项设置为 true，则从最终映像中移除该代理。如果该选项设置为false，则将代理留在原处，以便将其包含在新版本中AMI。默认值为 false。

         注意

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

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

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

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

       注意

       用户数据始终采用 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-0a01b234c5de6fabc",
   "semanticVersion": "1.0.0",
   "components": [
   	{
   		"componentArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/bb$"
   	}
   ],
   "additionalInstanceConfiguration": {
   	"systemsManagerAgent": {
   	 	"uninstallAfterBuild": true
   	},
   	"userDataOverride": "IyEvYmluL2Jhc2gKbWtkaXIgLXAgL3Zhci9iYi8KdG91Y2ggL3Zhcg=="
   }
   }

   Windows

   以下示例引用最新版本的 Windows Server 2016 英文版全基础映像。此示例ARN中的引用SKU基于您指定的语义版本过滤器中的最新图像: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:123456789012:component/my-example-component/2019.12.02/1"
   	},
   	{
   		"componentArn": "arn:aws:imagebuilder:us-west-2:123456789012: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-0a01b234c5de6fabc",
   "semanticVersion": "1.0.0",
   "components": [
   	{
   		"componentArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/catalina$"
   	}
   ],
   "additionalInstanceConfiguration": {
   	"systemsManagerAgent": {
   	 	"uninstallAfterBuild": true
   	},
   	"userDataOverride": "IyEvYmluL2Jhc2gKbWtkaXIgLXAgL3Zhci9iYi8KdG91Y2ggL3Zhcg=="
   }
   }

2. 创建配方

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

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

   注意

   • 您必须在JSON文件路径的开头添加file://符号。

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

   您的最终图片最多可以包含来自 Amazon Web Services Marketplace 图片产品和组件的四个产品代码。如果您选择的基础图片和组件包含四个以上的产品代码，则在运行create-image-recipe命令时，Image Builder 会返回错误。

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

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

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

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

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

常规

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

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

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