As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Definir as configurações de execução do pipeline para pipelines de imagem
Você pode escolher entre as seguintes opções para programar a execução do pipeline:
Construtor de horários
Use o Schedule Builder para configurar a execução automática e recorrente do pipeline. Você define quando e com que frequência seu pipeline deve ser executado (dia, hora e frequência). A programação padrão é toda semana com base no dia e na hora em que a programação foi criada (UTC).
Expressão Cron
Execute automaticamente o pipeline com uma expressão cron que especifica o cronograma. Para obter mais informações sobre a sintaxe cron usada pelo Image Builder, consulte. [Usar expressões cron no Image Builder](cron-expressions.md)
Manual
O pipeline não funciona de acordo com um cronograma. No console, escolha **Executar pipeline** no menu **Ações** para executar o pipeline. A partir do AWS CLI, você pode correr`start-image-pipeline-execution`.
**Configurações de dependência**
Para compilações agendadas, você pode escolher se quer sempre executar dentro do cronograma ou ignorar a execução do pipeline, a menos que haja atualizações de dependência, como uma alteração na imagem base ou em um componente usado na receita.
## Desativar automaticamente um pipeline com defeito
Para pipelines de imagem executados em um cronograma, você pode configurar o número máximo de falhas consecutivas a serem permitidas (até`10`) antes que o Image Builder desative automaticamente o pipeline.
**Configurações de desativação automática**
O Image Builder rastreia o número de falhas consecutivas nas execuções programadas do pipeline e realiza uma das seguintes ações sempre que é executado de acordo com um cronograma:
+ Se a execução do pipeline for bem-sucedida, o número de falhas consecutivas será redefinido para zero.
+ Se a execução do pipeline falhar, o Image Builder incrementa o número de falhas consecutivas. Se a contagem de falhas exceder o limite definido no`AutoDisablePolicy`, o Image Builder desativará o pipeline.
A contagem de falhas consecutivas também é redefinida para zero nas seguintes condições:
+ O pipeline é executado manualmente e é bem-sucedido.
+ A configuração do pipeline é atualizada.
Se a tubulação funcionar manualmente e falhar, a contagem permanecerá a mesma. A próxima execução programada continua aumentando de onde parou antes.
## Configurar o registro do pipeline
Ao criar ou atualizar um pipeline de imagens, você pode configurar grupos de CloudWatch registros personalizados para criação de imagens e registros de pipeline. Certifique-se de que sua função de execução de pipeline personalizada tenha as seguintes permissões para criar e acessar os recursos do grupo de registros.
+ registros: CreateLogGroup
+ registros: CreateLogStream
+ registros: PutLogEvents
**Grupos de registros personalizados**
Para usar grupos de registros personalizados para criação de imagens ou execução de pipeline, primeiro crie o grupo de CloudWatch registros em Registros. Para obter mais informações, consulte [Criar um grupo de registros](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html#Create-Log-Group) no *Guia do usuário do Amazon CloudWatch Logs*. Para obter orientação adicional sobre os requisitos de nomenclatura de grupos de registros, consulte [CreateLogGroup](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateLogGroup.html)a *Referência da API Amazon CloudWatch Logs*.
------
#### [ Console ]
Especifique o **grupo de registros de imagem** ou o **grupo de registros** de pipeline para seu pipeline na seção **Configuração de registro** em **Configurações avançadas**.
------
#### [ CLI ]
Especifique os seguintes campos no `logging-configuration` objeto se você usar um objeto JSON para configuração:
+ `imageLogGroupName`
+ `pipelineLogGroupName`
Para especificar todos os parâmetros diretamente na linha de comando, consulte [create-image-pipeline](https://docs.aws.amazon.com/cli/latest/reference/imagebuilder/create-image-pipeline.html)a *Referência de AWS CLI Comandos*.
------
O Image Builder usa os seguintes grupos de registros padrão se você não especificar um grupo de registros personalizado:
Registros de criação de imagens
O Image Builder grava registros de compilação no seguinte grupo e stream de CloudWatch registros do Image Builder:
**LogGroup:** `/aws/imagebuilder/{{ImageName}}`
**LogStream (x.x.x/x):** `{{ImageVersion/ImageBuildVersion}}`
Registros de execução do pipeline
O Image Builder grava registros de execução do pipeline no seguinte grupo e stream de CloudWatch registros do Image Builder:
**LogGroup:** `/aws/imagebuilder/pipeline/{{pipeline-name}}`
**LogStream:** `{{2025/09/01}}` (a data de execução do pipeline em YYYY/MM/DD formato)
Cada registro do pipeline é anexado ao stream desse dia.