创建容器食谱的新版本

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

1. 在容器食谱详细信息页面顶部，选择 Create New Very（创建新版本）。您将进入容器配方的 “创建配方” 页面。

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

1. 创建 CLI 输入 JSON 文件

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

   注意

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

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

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

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

     注意

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

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

       提示

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

     • 参数（对象数组）-包含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使用默认值。

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

   • dockerfileTemplateData（字符串）— 用于构建映像的 Dockerfile 模板，以行内数据块表示。

   • 名称（字符串，必填）—容器食谱的名称。

   • 描述（字符串）—容器食谱的描述。

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

   • PlatformOverRid e（字符串）— 指定使用自定义基本映像时的操作系统平台。

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

   • 标签（字符串映射）— 附加到容器食谱的标签。

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

     • 映像（字符串）— 用作容器构建和测试实例基本映像的 AMI ID。如果您未指定此值，Image Builder 将使用相应的 Amazon ECS 优化型 AMI 作为基本映像。

     • blockDeviceMappings（对象数组）— 定义要连接的块设备，以便从image参数中指定的 Image Builder AMI 构建实例。

       • 设备名称（字符串）— 这些映射适用的设备。

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

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

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

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

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

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

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

     • 服务（字符串，必填）— 指定注册此映像的服务。

   • wor kingDirectory kingDiretory（字符串）—构建和测试工作流中使用的工作目录。

   {
      "components": [ 
         { 
            "componentArn": "arn:aws:imagebuilder:us-east-1:123456789012: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-1234567890",
         "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 则使用正斜杠 (/)。