Configurer les paramètres d'exécution du pipeline pour les pipelines d'images - EC2 Image Builder
Désactiver automatiquement un pipeline défaillantConfigurer la journalisation du pipeline

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Configurer les paramètres d'exécution du pipeline pour les pipelines d'images

Vous pouvez choisir l'une des options suivantes pour planifier l'exécution du pipeline :

Générateur de calendrier

Utilisez le Schedule Builder pour configurer l'exécution automatique et récurrente du pipeline. Vous définissez quand et à quelle fréquence votre pipeline doit fonctionner (jour, heure et fréquence). Le calendrier par défaut est hebdomadaire en fonction du jour et de l'heure de création du calendrier (UTC).

Expression cron

Exécutez automatiquement le pipeline avec une expression cron qui spécifie le calendrier. Pour plus d'informations sur la syntaxe cron utilisée par Image Builder, consultezUtiliser des expressions cron dans Image Builder.

Manuelle

Le pipeline ne fonctionne pas selon un calendrier. Dans la console, choisissez Exécuter le pipeline dans le menu Actions pour exécuter le pipeline. À partir de AWS CLI là, tu peux courirstart-image-pipeline-execution.

Paramètres de dépendance

Pour les builds planifiés, vous pouvez choisir de toujours s'exécuter selon le calendrier ou d'ignorer l'exécution du pipeline, sauf en cas de mise à jour des dépendances, telle qu'une modification de l'image de base ou d'un composant utilisé dans la recette.

Désactiver automatiquement un pipeline défaillant

Pour les pipelines d'images qui s'exécutent selon un calendrier, vous pouvez configurer le nombre maximum de défaillances consécutives à autoriser (jusqu'à10) avant qu'Image Builder ne désactive automatiquement le pipeline.

Paramètres de désactivation automatique

Image Builder suit le nombre d'échecs consécutifs lors des exécutions de pipeline planifiées et effectue l'une des actions suivantes chaque fois qu'il s'exécute selon un calendrier :

  • Si l'exécution du pipeline est réussie, le nombre de défaillances consécutives est remis à zéro.

  • Si l'exécution du pipeline échoue, Image Builder augmente le nombre d'échecs consécutifs. Si le nombre de défaillances dépasse la limite définie dans leAutoDisablePolicy, Image Builder désactive le pipeline.

Le nombre de défaillances consécutives est également remis à zéro dans les conditions suivantes :

  • Le pipeline s'exécute manuellement et réussit.

  • La configuration du pipeline est mise à jour.

Si le pipeline s'exécute manuellement et échoue, le nombre reste le même. La prochaine exécution planifiée continue à s'incrémenter là où elle s'était arrêtée auparavant.

Configurer la journalisation du pipeline

Lorsque vous créez ou mettez à jour un pipeline d'images, vous pouvez configurer des groupes de CloudWatch journaux personnalisés pour la création d'images et les journaux de pipeline. Assurez-vous que votre rôle d'exécution de pipeline personnalisé dispose des autorisations suivantes pour créer et accéder aux ressources du groupe de journaux.

  • journaux : CreateLogGroup

  • journaux : CreateLogStream

  • journaux : PutLogEvents

Groupes de journaux personnalisés

Pour utiliser des groupes de journaux personnalisés pour la création d'images ou l'exécution de pipelines, créez d'abord le groupe de CloudWatch journaux dans Logs. Pour plus d'informations, consultez la section Créer un groupe de CloudWatch journaux dans le guide de l'utilisateur Amazon Logs. Pour obtenir des conseils supplémentaires sur les exigences CreateLogGroupen matière de dénomination des groupes de journaux, consultez le manuel Amazon CloudWatch Logs API Reference.

Console

Spécifiez le groupe de journaux d'images ou le groupe de journaux de pipeline pour votre pipeline dans la section Configuration de la journalisation sous Paramètres avancés.

CLI

Spécifiez les champs suivants dans l'logging-configurationobjet si vous utilisez un objet JSON pour la configuration :

  • imageLogGroupName

  • pipelineLogGroupName

Pour spécifier tous les paramètres directement dans la ligne de commande, reportez-vous create-image-pipelineà la référence des AWS CLI commandes.

Image Builder utilise les groupes de journaux par défaut suivants si vous ne spécifiez aucun groupe de journaux personnalisé :

Journaux de création d'images

Image Builder écrit les journaux de compilation dans le groupe Image Builder CloudWatch Logs et le flux suivants :

LogGroup: /aws/imagebuilder/ImageName

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

Journaux d'exécution du pipeline

Image Builder écrit les journaux d'exécution du pipeline dans le groupe et le flux Image Builder CloudWatch Logs suivants :

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

LogStream: 2025/09/01 (la date d'exécution du pipeline au YYYY/MM/DD format)

Chaque journal de pipeline est ajouté au flux pour ce jour.