创建新版本的容器配方

创建新的容器配方版本：

1. 在容器配方详细信息页面上，选择页面顶部的创建新版本。控制台为容器配方打开创建配方页面。

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

1. 创建 CLI 输入 JSON 文件

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

   注意

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

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

   以下是此示例中参数的摘要：

   • 组件（对象数组，可选）-包含ComponentConfiguration对象数组。对于容器配方，组件是可选的。你可以使用 BUILD 组件自定义输出镜像，在 Dockerfile 模板中添加指令（例如RUN或COPY语句），或两者兼而有之。测试组件会验证图像但不对其进行修改。

     注意

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

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

       提示

       要使用该示例创建您自己的容器配方，请将示例 ARN 替换为您用于配方的组件的 ARN。其中包括每个版本的 Amazon Web Services 区域、名称和版本号。

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

       重要

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

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

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

   • containerType（字符串，必填）- 要创建的容器的类型。有效值包括 DOCKER。

   • dockerfile TemplateData（字符串）— 用于构建镜像的内联 Dockerfile 模板。行内数据限制为 16,000 个字符。您必须指定 dockerfileTemplateData 或 dockerfileTemplateUri，但不能同时指定两者。

     您的 Dockerfile 模板可以包含上下文变量（映像生成器在运行时用编译信息替换的占位符）。至少包括parentImage变量。如果您的配方包含成分，还要包括environments变量和components变量。

     parentImage（必需）

     在构建时，此变量会解析为配方的基础映像。

     示例：

     FROM
     {{{ imagebuilder:parentImage }}}

     environments（如果指定了组件，则为必需）

     在构建时，此变量解析为 Dockerfile 指令，将您的组件存放在构建上下文中。这些指令将组件脚本复制到镜像中，并设置这些脚本使用的环境变量。它可以准备环境，但不运行您指定的组件。将此变量放在components变量之前。

     示例：

     {{{ imagebuilder:environments }}}

     components（可选）

     在编译时，此变量解析为运行容器配方所包含组件的构建和测试组件脚本的命令，然后将这些脚本从镜像中移除。这是运行组件的变量。将其放在environments变量之后。

     示例：

     {{{ imagebuilder:components }}}

     要改为将模板存储在亚马逊 S3 中，请使用带有有效亚马逊 S3 URI 的 dockerfile TemplateUri 参数（例如，s3://my-bucket/templates/Dockerfile）。

   • 名称（字符串，必填）- 容器配方的名称。

   • 描述（字符串）- 容器配方的描述。

   • parentImage（字符串，必填）-Docker 容器配方中用作自定义图像基准的容器映像。

     • 托管的公开图片 DockerHub

     • 亚马逊 ECR 中的现有容器镜像

     • Amazon-managed 容器镜像

   • platformOverride（字符串）– 指定使用自定义基础映像时的操作系统平台。我们建议您在使用Docker Hub或 Amazon ECR 图像时设置此值。如果你省略它，Image Builder 会尝试从容器清单中检测平台，但容器清单可能并不总是可用的。您无法指定您的父映像platformOverride何时是映像生成器映像 ARN。有效值为 Linux 和 Windows。容器配方不支持 macOS 平台。

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

   • 标签（字符串映射）– 附加到容器配方的标签。

   • instanceConfiguration（对象）– 可用于配置实例以构建和测试容器映像的一组选项。

     • image（字符串）-容器构建和测试实例的基础镜像。它可以包含 AMI ID，也可以指定 Amazon Systems Manager (SSM) 参数存储参数，前缀为参数名称或 ARN。ssm:如果您使用 SSM 参数，则参数值必须包含 AMI ID。如果您未指定基础映像，映像生成器将使用相应的 Amazon ECS 优化的 AMI 作为基础映像。

     • 块 DeviceMappings（对象数组）-定义要连接的块储存设备，用于从image参数中指定的映像生成器 AMI 构建实例。

       • deviceName（字符串）- 这些映射适用的设备。

       • ebs（对象）– 用于管理此映射的特定于 Amazon EBS 的配置。

         • 删除 OnTermination（布尔值）-用于配置关联设备终止时删除。

         • 已加密（布尔值）- 用于配置设备加密。

         • volumeSize（整数）- 用于覆盖设备的卷大小。

         • volumeType（字符串）- 用于覆盖设备的卷类型。

   • targetRepository（对象，必填）– 如果管道的分发配置中没有为管道运行区域（区域 1）指定其他存储库，则为容器映像的目标存储库。

     • repositoryName（字符串，必填）– 存储输出容器映像的容器存储库的名称。此名称以存储库位置作为前缀。

     • 服务（字符串，必填）-指定存储输出图像的存储库服务。有效值为 ECR。目标存储库必须已经存在。

   • workingDirectory（字符串）– 构建和测试工作流期间使用的工作目录。

   以下示例显示了一个完整的容器配方输入文件，该文件定义了带有构建组件的 Linux Docker 容器。将其另存为create-container-recipe.json，然后在create-container-recipe命令中使用。

   {
   	"components": [ 
   	  { 
   		 "componentArn": "arn:aws:imagebuilder:us-west-2:111122223333:component/helloworldal2/x.x.x"
   	  }
   	],
   	"containerType": "DOCKER",
   	"description": "My Linux Docker container image",
   	"dockerfileTemplateData": "FROM {{{ imagebuilder:parentImage }}}\n{{{ imagebuilder:environments }}}\n{{{ imagebuilder:components }}}",
   	"name": "amazonlinux-container-recipe",
   	"parentImage": "amazonlinux:latest",
   	"platformOverride": "Linux",
   	"semanticVersion": "1.0.2",
   	"tags": { 
   	  "sometag" : "Tag detail" 
   	},
   	"instanceConfiguration": {
   	  "image": "ami-1234567890abcdef1",
   	  "blockDeviceMappings": [
   		 {
   			"deviceName": "/dev/xvda",
   			"ebs": {
   				"deleteOnTermination": true,
   				"encrypted": false,
   				"volumeSize": 8,
   				"volumeType": "gp2"
   			 }
   		  }			
   	  ]
   	},
   	"targetRepository": { 
   	  "repositoryName": "myrepo",
   	  "service": "ECR"
   	},
   	"workingDirectory": "/tmp"
   }

2. 创建配方

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

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

   注意

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

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

   以下示例输出显示了新创建的容器配方的 ARN 以及请求的请求 ID 和客户端令牌。

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