View a markdown version of this page

为图像管道配置流水线执行设置 - EC2 Image Builder
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

为图像管道配置流水线执行设置

您可以从以下选项中进行选择来安排管道执行:

日程生成器

使用计划生成器配置自动重复的管道执行。您可以定义管道的运行时间和频率(日期、时间和频率)。默认时间表是每周根据计划创建的日期和时间 (UTC) 制定的。

Cron 表达式

使用指定时间表的 cron 表达式自动运行管道。有关映像生成器使用的 cron 语法的更多信息,请参阅 在 Image Builder 中使用 cron 表达式。

手动

管道未按计划运行。在控制台中,选择 运行管道 来自 行动 菜单来运行管道。来自 Amazon CLI,你可以跑 start-image-pipeline-execution。

依赖项设置

对于计划构建,您可以选择是始终按计划运行还是跳过管道执行,除非有依赖项更新,例如更改基础映像或配方中使用的组件。

自动禁用失效的管道

对于按计划运行的映像管道,您可以配置允许的最大连续失败次数(最多 10),然后映像生成器会自动禁用管道。如果你没有设置 AutoDisablePolicy,Image Builder 使用的默认值为 5 连续失败。

Auto-disable 设置

Image Builder 跟踪定期管道执行的连续失败次数,并在每次按计划运行时采取以下操作之一:

  • 如果管道成功执行,则连续失败的次数将重置为零。

  • 如果管道执行失败,映像生成器会增加连续失败的次数。如果失败次数超过了中定义的限制 AutoDisablePolicy,映像生成器禁用管道。

在以下条件下,连续失败次数也将重置为零:

  • 管道手动运行并成功。

  • 管道配置已更新。

如果管道手动运行但出现故障,则计数保持不变。下一次预定运行继续从之前中断的地方递增。

配置管道日志

创建或更新图像管道时,可以配置自定义 CloudWatch 镜像构建和管道日志的日志组。确保您的自定义管道执行角色具有以下权限来创建和访问日志组资源。

  • 日志:CreateLogGroup

  • 日志:CreateLogStream

  • 日志:PutLogEvents

自定义日志组

要使用自定义日志组进行映像构建或管道执行,请先在中创建日志组 CloudWatch 日志。有关更多信息,请参阅 创建日志组 在 亚马逊 CloudWatch 日志用户指南。有关日志组命名要求的更多指导,请参阅 CreateLogGroup 在 亚马逊 CloudWatch 日志 API 参考。

Console

指定 图像日志组 要么 管道日志组 用于您的管道 日志配置 下方的部分 高级设置。

Amazon CLI

在中指定以下字段 logging-configuration 对象(如果您使用 JSON 对象进行配置):

  • imageLogGroupName

  • pipelineLogGroupName

要直接在命令行中指定所有参数,请参见 创建图像管道 在 Amazon CLI 命令参考。

如果您未指定自定义日志组,Image Builder 将使用以下默认日志组:

映像生成日志

映像生成器将编译日志写入以下映像生成器 CloudWatch 日志组和直播:

LogGroup: /aws/imagebuilder/ImageName

LogStream (x.x。x/x): ImageVersion/ImageBuildVersion

管道执行日志

映像生成器将管道执行日志写入以下映像生成器 CloudWatch 日志组和直播:

LogGroup: /aws/imagebuilder/pipeline/pipeline-name

LogStream: 2025/09/01 (管道执行日期在 YYYY/MM/DD 格式)

每个流水线日志都将附加到当天的直播中。