Definir as configurações de execução do pipeline para pipelines de imagem - EC2 Image Builder
Desativar automaticamente um pipeline com defeitoConfigurar o registro do pipeline

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

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 correrstart-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 noAutoDisablePolicy, 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 no Guia do usuário do Amazon CloudWatch Logs. Para obter orientação adicional sobre os requisitos de nomenclatura de grupos de registros, consulte CreateLogGroupa 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-pipelinea 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.