创建图像配方的新版本

要创建新的映像食谱版本，请执行以下操作：

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

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

1. 创建 CLI 输入 JSON 文件

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

   注意

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

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

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

   • 名称（字符串，必填项）—映像食谱的名称。

   • 描述（字符串）—映像食谱的描述。

   • ParentImag e（字符串，必填）— 图像配方用作自定义图像基础的图像。值可以是基本映像 ARN 或 AMI ID。

     注意

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

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

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

     注意

     组件按照中指定的顺序安装。

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

       提示

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

     • 参数（对象数组）-包含ComponentParameter对象数组。

       重要

       组件参数是纯文本值，已登录Amazon CloudTrail。我们建议您使用Amazon Secrets Manager或Amazon Systems Manager参数存储来存储您的密钥。有关 Secrets Manager 的更多信息，请参阅什么是Secrets Manager？ 在Amazon Secrets Manager用户指南中。有关Amazon Systems Manager参数存储的更多信息，请参阅Amazon Systems Manager用户指南中的Amazon Systems Manager参数存储。

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

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

   • additionalInstanceConfiguration（对象）-为构建实例指定其他设置和启动脚本。

     • 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（字符串）— 提供当您启动构建实例时要运行的命令或命令脚本。

       注意

       用户数据始终采用 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 English Full Base 映像。此示例中的 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. 创建配方

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

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

   注意

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

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

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

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

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

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

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

常规

1. 为基础图像指定唯一名称。如果您不输入值，则基础图像会继承配方名称。

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

3. 您也可以输入基础图像的描述。