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

# 为图像管道配置管道执行设置
<a name="schedule-pipeline"></a>

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

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

Cron 表达式  
使用指定时间表的 cron 表达式自动运行管道。有关 Image Builder 使用的 cron 语法的更多信息，请参阅[在 Image Builder 中使用 cron 表达式](cron-expressions.md)。

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

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

## 自动禁用失败的管道
<a name="schedule-pipeline-auto-disable"></a>

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

**自动禁用设置**  
Image Builder 会跟踪计划管道执行的连续失败次数，并在每次按计划运行时执行以下操作之一：
+ 如果管道执行成功，则连续失败的次数将重置为零。
+ 如果管道执行失败，Image Builder 会增加连续失败的次数。如果失败次数超过中定义的限制`AutoDisablePolicy`，Image Builder 将禁用管道。

在以下条件下，连续的失败计数也会重置为零：
+ 管道手动运行并成功运行。
+ 管道配置已更新。

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

## 配置管道日志
<a name="configure-pipeline-logging"></a>

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

**自定义日志组**  
要使用自定义日志组进行映像构建或管道执行，请先在 “日志” 中创建 CloudWatch 日志组。有关更多信息，请参阅 *Amazon 日志用户指南中的创建 CloudWatch 日志*[组](https://docs.amazonaws.cn/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html#Create-Log-Group)。有关日志组命名要求的更多指导，请参阅 *Amazon CloudWatch 日志 API 参考[CreateLogGroup](https://docs.amazonaws.cn/AmazonCloudWatchLogs/latest/APIReference/API_CreateLogGroup.html)*中的。

------
#### [ Console ]

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

------
#### [ CLI ]

如果您使用 JSON `logging-configuration` 对象进行配置，请在对象中指定以下字段：
+ `imageLogGroupName`
+ `pipelineLogGroupName`

要直接在命令行中指定所有参数，请参阅《*Amazon CLI 命令参考*》[create-image-pipeline](https://docs.amazonaws.cn/cli/latest/reference/imagebuilder/create-image-pipeline.html)中的。

------

如果您未指定自定义日志组，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格式为管道执行日期）  
每条管道日志都会附加到当天的直播中。