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.
# Utiliser des EventBridge règles avec les pipelines Image Builder
Les événements issus d'un large éventail de services AWS et de services partenaires sont diffusés sur les bus d' EventBridge événements Amazon en temps quasi réel. Vous pouvez également générer des événements personnalisés et envoyer des événements depuis vos propres applications à EventBridge. Les bus d'événements utilisent des règles pour déterminer où acheminer les données d'événements.
Les pipelines Image Builder sont disponibles en tant que cibles de EventBridge règles, ce qui signifie que vous pouvez exécuter un pipeline Image Builder en fonction des règles que vous créez pour répondre aux événements survenus dans le bus ou selon un calendrier.
Pour un résumé des événements générés par le système auxquels Image Builder envoie des EventBridge messages, consultez[Messages d'événements envoyés par Image Builder](integ-eventbridge.md#integ-eb-event-summary).
**Note**
Les bus dédiés aux événements sont spécifiques à une région. La règle et la cible doivent se trouver dans la même région.
**Topics**
+ [EventBridge termes](#ev-terms)
+ [Afficher EventBridge les règles de votre pipeline Image Builder](#ev-rules-pipeline-tab)
+ [Utiliser EventBridge des règles pour planifier la construction d'un pipeline](#ev-rules-schedule-pipeline)
## EventBridge termes
Cette section contient un résumé des termes qui vous aideront à comprendre comment EventBridge s'intègre à vos pipelines Image Builder.
Événement
Décrit une modification d'un environnement susceptible d'affecter une ou plusieurs ressources de l'application. L'environnement peut être un AWS environnement, un service ou une application partenaire SaaS, ou l'une de vos applications ou services. Vous pouvez également configurer des événements planifiés sur une chronologie.
Bus d’événement
Un pipeline qui reçoit des données d'événements provenant d'applications et de services.
Source
Le service ou l'application qui a envoyé l'événement au bus d'événements.
Cible
Ressource ou point de terminaison EventBridge qui s'appelle lorsqu'il correspond à une règle, fournissant les données de l'événement à la cible.
Règle
Une règle correspond à des événements entrants et les envoie vers des cibles pour être traités. Une seule règle peut envoyer un événement à plusieurs cibles, qui peuvent ensuite s'exécuter en parallèle. Les règles sont basées soit sur un modèle d’événement, soit sur un calendrier.
Modèle
Un modèle d'événement définit la structure de l'événement et les champs auxquels une règle correspond afin de lancer l'action cible.
Planificateur
Les règles de planification exécutent une action selon un calendrier, par exemple en exécutant un pipeline Image Builder pour actualiser une image tous les trimestres. Il existe deux types d'expressions de planification :
+ **Expressions Cron** — Faites correspondre des critères de planification spécifiques à l'aide de la syntaxe cron qui peut définir des critères simples, par exemple, une exécution hebdomadaire un jour précis. Vous pouvez également établir des critères plus complexes, tels que la diffusion trimestrielle le cinquième jour du mois, entre 2 h et 4 h du matin.
+ **Expressions de taux** — Spécifiez un intervalle régulier lorsque la cible est invoquée, par exemple toutes les 12 heures.
## Afficher EventBridge les règles de votre pipeline Image Builder
L'onglet **EventBridge règles** de la page détaillée des **pipelines d'images Image** Builder affiche les bus d' EventBridge événements auxquels votre compte a accès, ainsi que les règles du bus d'événements sélectionné qui s'appliquent au pipeline actuel. Cet onglet renvoie également directement à la EventBridge console pour créer de nouvelles ressources.
**Actions liées à la EventBridge console**
+ **Créer un bus d'événements**
+ **Créer une règle**
Pour en savoir plus EventBridge, consultez les rubriques suivantes dans le *guide de EventBridge l'utilisateur Amazon*.
+ [Qu'est-ce qu'Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html)
+ [Bus EventBridge événementiels Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-bus.html)
+ [ EventBridge Événements Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html)
+ [ EventBridge Règles d'Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html)
## Utiliser EventBridge des règles pour planifier la construction d'un pipeline
Dans cet exemple, nous créons une nouvelle règle de planification pour le bus d'événements par défaut, à l'aide d'une expression de débit. Dans cet exemple, la règle génère un événement sur le bus d'événements tous les 90 jours. L'événement lance la création d'un pipeline pour actualiser l'image.
1. Ouvrez la console EC2 Image Builder à l'adresse [https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/).
1. Pour voir la liste des pipelines d'images créés sous votre compte, choisissez **Pipelines d'images** dans le volet de navigation.
**Note**
La liste des pipelines d'images inclut un indicateur du type d'image de sortie créée par le pipeline : AMI ou Docker.
1. Pour afficher les détails ou modifier un pipeline, cliquez sur le lien **Nom du pipeline**. Cela ouvre la vue détaillée du pipeline.
**Note**
Vous pouvez également cocher la case à côté du **nom du pipeline**, puis sélectionner **Afficher les détails**.
1. Ouvrez l'onglet **EventBridge Règles**.
1. Conservez le bus d'événements par défaut présélectionné dans le panneau **Event Bus**.
1. Choisissez **Créer une règle**. Cela vous amène à la page **Créer une règle** dans la EventBridge console Amazon.
1. Saisissez un nom et une description pour la règle. Le nom de la règle doit être unique dans le bus d'événements pour la région sélectionnée.
1. Dans le panneau **Définir le modèle**, choisissez l'option **Planifier**. Cela élargit le panel, avec le **taux fixe pour chaque** option sélectionnée.
1. Entrez `90` dans la première case, puis sélectionnez **Jours** dans la liste déroulante.
1. Effectuez les actions suivantes dans le panneau **Sélectionner des cibles** :
1. Sélectionnez `EC2 Image Builder` dans la liste déroulante **Cible**.
1. Pour appliquer la règle à un pipeline Image Builder, sélectionnez le pipeline cible dans la liste déroulante **Image Pipeline**.
1. EventBridge a besoin d'une autorisation pour lancer une génération pour le pipeline sélectionné. Pour cet exemple, conservez l'option par défaut pour **créer un nouveau rôle pour cette ressource spécifique**.
1. Sélectionnez **Ajouter une cible**.
1. Sélectionnez **Create** (Créer).
**Note**
Pour en savoir plus sur les paramètres des règles d'expression de débit qui ne sont pas abordées dans cet exemple, consultez la section [Expressions de débit](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html#eb-rate-expressions) dans le *guide de EventBridge l'utilisateur Amazon*.