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

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

为图像管道配置管道执行设置

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

日程生成器

使用计划生成器配置自动重复的管道执行。您可以定义管道运行的时间和频率(日期、时间和频率)。默认计划为每周一次,基于创建计划的日期和时间 (UTC)。

Cron 表达式

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

手动

管道未按计划运行。在控制台中,从 “操作” 菜单中选择 “运行管道” 以运行管道。从那 Amazon CLI里,你可以跑start-image-pipeline-execution了。

依赖项设置

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

自动禁用失败的管道

对于按计划运行的图像管道,在 Image Builder 自动禁用管道之前,您可以配置允许的最大连续失败次数(最多10)。

自动禁用设置

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

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

  • 如果管道执行失败,Image Builder 会增加连续失败的次数。如果失败次数超过中定义的限制AutoDisablePolicy,Image Builder 将禁用管道。

在以下条件下,连续的失败计数也会重置为零:

  • 管道手动运行并成功运行。

  • 管道配置已更新。

如果管道手动运行但失败,则计数保持不变。下一次计划运行继续从之前停下来的地方递增。

配置管道日志

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

  • 日志:CreateLogGroup

  • 日志:CreateLogStream

  • 日志:PutLogEvents

自定义日志组

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

Console

在 “高级设置” 下的 “日志配置” 部分中为您的管道指定图像日志或管道日志组。

CLI

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

  • imageLogGroupName

  • pipelineLogGroupName

要直接在命令行中指定所有参数,请参阅《Amazon CLI 命令参考create-image-pipeline中的。

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

镜像构建日志

Image Builder 将构建日志写入以下 Image Builder CloudWatch 日志组并进行直播:

LogGroup: /aws/imagebuilder/ImageName

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

管道执行日志

Image Builder 将管道执行日志写入以下 Image Builder CloudWatch 日志组并进行流式传输:

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

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

每条管道日志都会附加到当天的直播中。