创建容器映像管道(Amazon CLI) - EC2 Image Builder
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

创建容器映像管道(Amazon CLI)

可以使用 JSON 文件作为 Amazon CLI中 create-image-pipeline 命令的输入来创建配置集。

您的管道构建新映像以合并基础映像和组件中所有待处理更新的频率取决于您所配置的 schedule。每个schedule都具有以下属性:

  • scheduleExpression— 设置管道运行的时间计划,以评估 pipelineExecutionStartCondition 并确定是否应开始构建。该计划是使用 cron 表达式配置的。有关如何在 Image Builder 中设置 cron 表达式格式的更多信息,请参阅 在 EC2 Image Builder 中使用 cron 表达式

  • pipelineExecutionStartCondition— 确定您的管道是否应该开始构建。有效值包括:

    • EXPRESSION_MATCH_ONLY— 每次 cron 表达式与当前时间匹配时,Pipeline 都会生成一个新映像。

    • EXPRESSION_MATCH_AND_DEPENDENCY_UPDATES_AVAILABLE— 除非您的基础映像或组件有待处理的更改,否则您的管道不会启动新的映像构建。

在中运行create-image-pipeline命令时 Amazon CLI,许多配置资源都是可选的。但是,有些资源有条件性要求,具体取决于管道创建的映像类型。容器映像管道需要以下资源:

  • 容器配方数

  • 基础设施配置

如果您在运行 create-image-pipeline 命令时未包含分配配置资源,则输出映像将存储在您运行该命令的区域的容器配方中指定为目标存储库的 ECR 存储库中。如果您为管道添加了分配配置资源,则将使用您在分配中为第一个区域指定的目标存储库。

  1. 创建 CLI 输入 JSON 文件

    使用您常用的文件编辑工具创建 JSON 文件,其中包含以下密钥以及对您的环境有效的值。此示例使用名为 create-image-pipeline.json 的文件:

    { "name": "MyWindows2019Pipeline", "description": "Builds Windows 2019 Images", "enhancedImageMetadataEnabled": true, "containerRecipeArn": "arn:aws:imagebuilder:us-west-2:123456789012:container-recipe/my-example-recipe/2020.12.03", "infrastructureConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:infrastructure-configuration/my-example-infrastructure-configuration", "distributionConfigurationArn": "arn:aws:imagebuilder:us-west-2:123456789012:distribution-configuration/my-example-distribution-configuration", "imageTestsConfiguration": { "imageTestsEnabled": true, "timeoutMinutes": 60 }, "schedule": { "scheduleExpression": "cron(0 0 * * SUN *)", "pipelineExecutionStartCondition": "EXPRESSION_MATCH_AND_DEPENDENCY_UPDATES_AVAILABLE" }, "status": "ENABLED" }
    注意
    • JSON 文件路径开头必须包含 file:// 符号。

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

  2. 使用创建的文件作为输入,运行以下命令。

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