Utiliser des EventBridge règles avec les pipelines Image Builder - EC2Image Builder

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, consultezMessages d'événements envoyés par Image Builder.

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.

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.

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/.

  2. 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.

  3. 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.

  4. Ouvrez l'onglet EventBridge Règles.

  5. Conservez le bus d'événements par défaut présélectionné dans le panneau Event Bus.

  6. Choisissez Créer une règle. Cela vous amène à la page Créer une règle dans la EventBridge console Amazon.

  7. 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.

  8. 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.

  9. Entrez 90 dans la première case, puis sélectionnez Jours dans la liste déroulante.

  10. Effectuez les actions suivantes dans le panneau Sélectionner des cibles :

    1. Sélectionnez EC2 Image Builder dans la liste déroulante Cible.

    2. Pour appliquer la règle à un pipeline Image Builder, sélectionnez le pipeline cible dans la liste déroulante Image Pipeline.

    3. 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.

    4. Sélectionnez Ajouter une cible.

  11. 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 dans le guide de EventBridge l'utilisateur Amazon.