创建图片配方和版本

要创建新的映像配方版本：

1. 在配方详细信息页面的顶部，选择创建新版本. 这会将您带到创建镜像配方页.

2. 要创建新版本，请进行更改，然后选择创建镜像配方.

1. 创建 CLI 输入 JSON 文件

   为了简化imagebuilder create-image-recipe中使用的命令Amazon CLI，我们创建了一个 JSON 文件，其中包含我们想传递给命令的所有配方属性。

   注意

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

   不要使用此命名约定将这些数据点直接提供给imagebuilder create-image-recipe命令作为选项。

   以下是我们在这些示例中指定的参数的摘要：

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

   • 描述(字符串) — 映像配方的描述。

   • ParentImage（字符串，必填）— 映像配方用作其基础环境的源（父）映像。该值可以是父映像 ARN 或 Image Builder AMI ID。

     注意

     Linux 示例使用 Image Builder AMI，Windows 示例使用 ARN。

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

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

     重要

     组件是按指定顺序安装的。

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

       注意

       要使用其中一个示例来创建自己的映像配方，必须将示例 ARN 替换为用于配方的组件的 ARN，包括Amazon Web Services 区域、每个人的名称和版本号。

     • 参数（对象数组）— 包含一个ComponentParameter对象。

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

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

   • additionalInstanceConfiguration(object) — 为构建实例指定其他设置和启动脚本。

     • systemsManagerAgent（对象）— 包含构建实例上的 Systems Manager 代理的设置。

       • uninstallAfterBuild（布尔值）— 控制在创建新 AMI 之前是否从最终构建映像中删除 Systems Manager 代理。如果将其设置为true，然后将代理程序从最终映像中删除。如果设置为false，然后将代理留在里面，以便将其包含在新 AMI 中。默认值为 false。

         注意

         如果uninstallAfterBuild属性不包括在 JSON 文件中，并且满足以下条件，然后 Image Builder 将从最终映像中删除 Systems Manager 代理，因此 AMI 中不可用：

         • 这些区域有：userDataOverride是空的，或者已经被遗漏在 JSON 文件之外。

         • Image Builder 会自动在源（父）映像上预装代理的操作系统的构建实例上安装 Systems Manager 代理。

     • userDataOverride(string) — 提供要在启动构建实例时运行的命令或命令脚本。

       注意

       用户数据始终以 64 为基数编码。例如，以下命令将编码为IyEvYmluL2Jhc2gKbWtkaXIgLXAgL3Zhci9iYi8KdG91Y2ggL3Zhci$：

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

       Linux 示例使用这个编码值。

   Linux

   本示例中的源（父）映像是 Image Builder AMI。当您使用 Image Builder AMI 时，您必须有权访问 AMI，并且 AMI 必须位于您使用 Image Builder 的同一区域。将文件另存为create-image-recipe.json，以便在imagebuilder 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": "IyEvYmluL2Jhc2gKbWtkaXIgLXAgL3Zhci9iYi8KdG91Y2ggL3Zhci$
       }
   }

   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 资源语义版本控制的更多信息，请参阅语义版本控制.

2. 创建配方

   使用以下命令创建配方，引用您在上一步中创建的 JSON 文件的文件名：

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

   注意

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

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

1. 在选择 Select image对于基本映像的部分，选择导入基本映像选项。

2. 选择映像操作系统 (OS)和操作系统版本，正如您平常一样。

1. 源— 这可以是 S3 存储桶，也可以是 EBS 快照。

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

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

常规

1. 指定唯一名称对于基本映像。如果您不输入值，基本映像将继承配方名称。

2. 指定版本对于基本映像。使用以下格式：major.minor.patch. 如果您不输入值，基本映像将继承配方版本。

3. 您还可以输入说明对于基本映像。