本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 設定映像管道的管道執行設定
<a name="schedule-pipeline"></a>

您可以從下列選項中選擇排程管道執行：

排程建置器  
使用排程建置器來設定自動、重複的管道執行。您可以定義管道應該執行的時間和頻率 （天、時間和頻率）。預設排程是根據建立排程的日期和時間 (UTC)，每週一次。

Cron 表達式  
使用指定排程的 Cron 表達式自動執行管道。如需 Image Builder 使用之 cron 語法的詳細資訊，請參閱 [在映像建置器中使用 Cron 表達式](cron-expressions.md)。

手動  
管道不會按照排程執行。在 主控台中，從**動作**功能表中選擇**執行管道**以執行管道。從 中 AWS CLI，您可以執行 `start-image-pipeline-execution`。

**相依性設定**  
對於排程組建，您可以選擇是否一律依排程執行或略過管道執行，除非有相依性更新，例如基本映像的變更，或配方中使用的元件。

## 自動停用失敗的管道
<a name="schedule-pipeline-auto-disable"></a>

對於依排程執行的映像管道，您可以設定在映像建置器自動停用管道之前，允許 （最多`10`) 的連續故障數目上限。

**自動停用設定**  
Image Builder 會追蹤排程管道執行的連續失敗次數，並在每次排程執行時採取下列其中一個動作：
+ 如果管道執行成功，連續失敗次數會重設為零。
+ 如果管道執行失敗，Image Builder 會遞增連續失敗的次數。如果失敗計數超過 中定義的限制`AutoDisablePolicy`，Image Builder 會停用管道。

在下列情況下，連續失敗計數也會重設為零：
+ 管道會手動執行並成功。
+ 管道組態已更新。

如果管道手動執行且失敗，計數會保持不變。下一個排程的執行會繼續增加之前停止的位置。

## 設定管道記錄
<a name="configure-pipeline-logging"></a>

當您建立或更新映像管道時，您可以為映像建置和管道日誌設定自訂 CloudWatch Logs 群組。請確定您的自訂管道執行角色具有建立和存取日誌群組資源的下列許可。
+ logs:CreateLogGroup
+ logs:CreateLogStream
+ logs:PutLogEvents

**自訂日誌群組**  
若要使用自訂日誌群組進行映像建置或管道執行，請先在 CloudWatch Logs 中建立日誌群組。如需詳細資訊，請參閱《*Amazon CloudWatch Logs 使用者指南》中的*[建立日誌群組](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html#Create-Log-Group)。如需日誌群組命名需求的其他指引，請參閱《*Amazon CloudWatch Logs API 參考*》中的 [CreateLogGroup](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateLogGroup.html)。

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

在**進階設定**下的**記錄組態**區段中，指定管道**的影像日誌群組**或**管道日誌群組**。

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

如果您使用 JSON 物件進行組態，請在`logging-configuration`物件中指定下列欄位：
+ `imageLogGroupName`
+ `pipelineLogGroupName`

若要直接在命令列中指定所有參數，請參閱《 *AWS CLI 命令參考*》中的 [create-image-pipeline](https://docs.aws.amazon.com/cli/latest/reference/imagebuilder/create-image-pipeline.html)。

------

如果您未指定自訂日誌群組，Image Builder 會使用下列預設日誌群組：

映像建置日誌  
Image Builder 會將建置日誌寫入下列 Image Builder CloudWatch Logs 群組和串流：  
**LogGroup：** `/aws/imagebuilder/{{ImageName}}`  
**LogStream (x.x.x/x)：** `{{ImageVersion/ImageBuildVersion}}`

管道執行日誌  
Image Builder 會將管道執行日誌寫入下列 Image Builder CloudWatch Logs 群組和串流：  
**LogGroup：** `/aws/imagebuilder/pipeline/{{pipeline-name}}`  
**LogStream：**`{{2025/09/01}}`（管道執行日期，格式為 YYYY/MM/DD)  
每個管道日誌都會附加到當天的串流。