Configurar los ajustes de ejecución de canalizaciones para canalizaciones de imágenes - EC2 Image Builder
Inhabilita automáticamente una canalización defectuosaConfigure el registro de canalizaciones

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Configurar los ajustes de ejecución de canalizaciones para canalizaciones de imágenes

Puede elegir entre las siguientes opciones para programar la ejecución de la canalización:

Generador de horarios

Utilice el Schedule Builder para configurar la ejecución automática y recurrente de las canalizaciones. Tú defines cuándo y con qué frecuencia debe ejecutarse tu canalización (día, hora y frecuencia). La programación predeterminada es todas las semanas en función del día y la hora en que se creó la programación (UTC).

Expresión rate

Ejecuta la canalización automáticamente con una expresión cron que especifique la programación. Para obtener más información sobre la sintaxis cron que utiliza Image Builder, consulteUtilizar expresiones cron en Generador de imágenes.

Manual

La canalización no se ejecuta según una programación. En la consola, selecciona Ejecutar canalización en el menú Acciones para ejecutar la canalización. Desde el AWS CLI, puedes correrstart-image-pipeline-execution.

Configuración de dependencias

En el caso de las compilaciones programadas, puedes elegir si deseas ejecutarlas siempre según lo programado o saltarte la ejecución en proceso, a menos que haya actualizaciones de dependencias, como un cambio en la imagen base o en un componente que se utilice en la receta.

Inhabilita automáticamente una canalización defectuosa

Para las canalizaciones de imágenes que se ejecutan según una programación, puede configurar el número máximo de errores consecutivos que se deben permitir (hasta10) antes de que Image Builder desactive automáticamente la canalización.

Desactivar automáticamente los ajustes

Image Builder realiza un seguimiento del número de errores consecutivos de las ejecuciones de canalizaciones programadas y realiza una de las siguientes acciones cada vez que se ejecuta de forma programada:

  • Si la ejecución de la canalización se realiza correctamente, el número de errores consecutivos se restablece a cero.

  • Si se produce un error en la ejecución de la canalización, Image Builder incrementa el número de errores consecutivos. Si el recuento de errores supera el límite definido enAutoDisablePolicy, Image Builder deshabilita la canalización.

El recuento de errores consecutivos también se restablece a cero en las siguientes condiciones:

  • La canalización se ejecuta manualmente y se ejecuta correctamente.

  • Se actualiza la configuración de la canalización.

Si la canalización se ejecuta manualmente y falla, el recuento sigue siendo el mismo. La siguiente ejecución programada continúa incrementándose donde la dejó antes.

Configure el registro de canalizaciones

Al crear o actualizar una canalización de imágenes, puede configurar grupos de CloudWatch registros personalizados para los registros de creación y canalización de imágenes. Asegúrese de que su función de ejecución de canalización personalizada tenga los siguientes permisos para crear y acceder a los recursos del grupo de registros.

  • registros: CreateLogGroup

  • registros: CreateLogStream

  • registros: PutLogEvents

Grupos de registros personalizados

Para usar grupos de registros personalizados para la creación de imágenes o la ejecución de canalizaciones, primero cree el grupo de CloudWatch registros en Logs. Para obtener más información, consulte Crear un grupo de CloudWatch registros en la Guía del usuario de Amazon Logs. Para obtener más información sobre los requisitos de denominación de los grupos de CloudWatch registros, consulta CreateLogGroupla referencia de la API de Amazon Logs.

Console

Especifique el grupo de registros de imágenes o el grupo de registros de canalización para su canalización en la sección Configuración de registros, en Configuración avanzada.

CLI

Especifica los siguientes campos dentro del logging-configuration objeto si utilizas un objeto JSON para la configuración:

  • imageLogGroupName

  • pipelineLogGroupName

Para especificar todos los parámetros directamente en la línea de comandos, consulte create-image-pipelinela Referencia de AWS CLI comandos.

Image Builder utiliza los siguientes grupos de registros predeterminados si no se especifica un grupo de registro personalizado:

Registros de creación de imágenes

Image Builder escribe los registros de compilación en el siguiente grupo y flujo de CloudWatch registros de Image Builder:

LogGroup: /aws/imagebuilder/ImageName

LogStream (x.x.x/x): ImageVersion/ImageBuildVersion

Registros de ejecución de canalización

Image Builder escribe los registros de ejecución de la canalización en el siguiente grupo y flujo de CloudWatch registros de Image Builder:

LogGroup: /aws/imagebuilder/pipeline/pipeline-name

LogStream: 2025/09/01 (la fecha de ejecución de la canalización en YYYY/MM/DD formato)

Cada registro de canalización se adjunta a la transmisión de ese día.