

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Configurare le impostazioni di esecuzione delle pipeline per le pipeline di immagini
<a name="schedule-pipeline"></a>

È possibile scegliere tra le seguenti opzioni per pianificare l'esecuzione della pipeline:

Schedule Builder  
Usa Schedule Builder per configurare l'esecuzione automatica e ricorrente della pipeline. Sei tu a definire quando e con che frequenza deve essere eseguita la pipeline (giorno, ora e frequenza). La pianificazione predefinita è settimanale in base al giorno e all'ora di creazione della pianificazione (UTC).

Espressione Cron  
Esegui automaticamente la pipeline con un'espressione cron che specifica la pianificazione. Per ulteriori informazioni sulla sintassi cron utilizzata da Image Builder, vedere. [Usa le espressioni cron in Image Builder](cron-expressions.md)

Manuale  
La pipeline non viene eseguita secondo una pianificazione. Nella console, scegli **Esegui pipeline** dal menu **Azioni** per eseguire la pipeline. Da AWS CLI, puoi eseguire. `start-image-pipeline-execution`

**Impostazioni delle dipendenze**  
Per le build pianificate, puoi scegliere se eseguirle sempre secondo la pianificazione o saltare l'esecuzione della pipeline a meno che non ci siano aggiornamenti delle dipendenze, come una modifica all'immagine di base o a un componente utilizzato nella ricetta. 

## Disattiva automaticamente una pipeline guasta
<a name="schedule-pipeline-auto-disable"></a>

Per le pipeline di immagini che vengono eseguite secondo una pianificazione, è possibile configurare il numero massimo di errori consecutivi da consentire (fino a`10`) prima che Image Builder disattivi automaticamente la pipeline.

**Disattiva automaticamente le impostazioni**  
Image Builder tiene traccia del numero di errori consecutivi per le esecuzioni pianificate della pipeline ed esegue una delle seguenti azioni ogni volta che viene eseguito secondo una pianificazione:
+ Se l'esecuzione della pipeline ha esito positivo, il numero di errori consecutivi viene ripristinato a zero.
+ Se l'esecuzione della pipeline fallisce, Image Builder incrementa il numero di errori consecutivi. Se il numero di errori supera il limite definito in`AutoDisablePolicy`, Image Builder disattiva la pipeline.

Anche il conteggio degli errori consecutivi viene azzerato nelle seguenti condizioni:
+ La pipeline viene eseguita manualmente e ha esito positivo.
+ La configurazione della pipeline viene aggiornata.

Se la pipeline viene eseguita manualmente e fallisce, il conteggio rimane lo stesso. La successiva esecuzione pianificata continua ad aumentare dal punto in cui era stata interrotta in precedenza.

## Configura la registrazione della pipeline
<a name="configure-pipeline-logging"></a>

Quando si crea o si aggiorna una pipeline di immagini, è possibile configurare gruppi di CloudWatch log personalizzati per i registri di creazione delle immagini e della pipeline. Assicurati che il tuo ruolo di esecuzione della pipeline personalizzato disponga delle seguenti autorizzazioni per creare e accedere alle risorse del gruppo di log.
+ registri: CreateLogGroup
+ registri: CreateLogStream
+ registri: PutLogEvents

**Gruppi di log personalizzati**  
Per utilizzare gruppi di log personalizzati per la creazione di immagini o l'esecuzione di pipeline, create innanzitutto il gruppo di log in CloudWatch Logs. Per ulteriori informazioni, consulta [Creare un gruppo di log](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html#Create-Log-Group) nella *Amazon CloudWatch Logs User Guide*. Per ulteriori indicazioni sui requisiti di denominazione dei gruppi di log, consulta [CreateLogGroup](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateLogGroup.html)*Amazon CloudWatch Logs API* Reference.

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

**Specificate il **gruppo di log Image** o il **gruppo di log Pipeline** per la pipeline nella sezione **Configurazione della registrazione** in Impostazioni avanzate.**

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

Specificate i seguenti campi all'interno dell'`logging-configuration`oggetto se utilizzate un oggetto JSON per la configurazione:
+ `imageLogGroupName`
+ `pipelineLogGroupName`

Per specificare tutti i parametri direttamente nella riga di comando, [create-image-pipeline](https://docs.aws.amazon.com/cli/latest/reference/imagebuilder/create-image-pipeline.html)consultate la sezione *AWS CLI Command Reference.*

------

Image Builder utilizza i seguenti gruppi di log predefiniti se non si specifica un gruppo di log personalizzato:

Registri di creazione delle immagini  
Image Builder scrive i log di compilazione nel seguente gruppo e stream di Image Builder CloudWatch Logs:  
**LogGroup:** `/aws/imagebuilder/ImageName`  
**LogStream (x.x.x/x):** `ImageVersion/ImageBuildVersion`

Registri di esecuzione della pipeline  
Image Builder scrive i log di esecuzione della pipeline nel seguente gruppo e flusso di Image Builder Logs: CloudWatch   
**LogGroup:** `/aws/imagebuilder/pipeline/pipeline-name`  
**LogStream:** `2025/09/01` (la data di esecuzione della pipeline nel formato) YYYY/MM/DD  
Ogni registro della pipeline viene aggiunto allo stream per quel giorno.