Tutoriel : Transmettre les informations d'un événement à une AWS Batch cible selon un calendrier à l'aide du transformateur EventBridge d'entrée - AWS Batch

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.

Tutoriel : Transmettre les informations d'un événement à une AWS Batch cible selon un calendrier à l'aide du transformateur EventBridge d'entrée

Vous pouvez utiliser le transformateur EventBridge d'entrée pour transmettre des informations sur les événements AWS Batch lors de la soumission d'une tâche. Cela peut être particulièrement utile si vous invoquez des tâches à la suite d'autres informations relatives à un AWS événement. Le téléchargement d'un objet dans un compartiment Amazon S3 en est un exemple. Vous pouvez également utiliser une définition de tâche avec des valeurs de substitution de paramètres dans la commande du conteneur. Le transformateur EventBridge d'entrée peut fournir les valeurs des paramètres en fonction des données d'événement.

Ensuite, vous créez une cible d' AWS Batch événement qui analyse les informations de l'événement qui le lance et les transforme en parameters objet. Lorsque la tâche s'exécute, les paramètres de l'événement déclencheur sont transmis à la commande du conteneur de tâches.

Note

Dans ce scénario, toutes les AWS ressources (telles que les compartiments, les EventBridge règles et les CloudTrail journaux Amazon S3) doivent se trouver dans la même région.

Pour créer une AWS Batch cible utilisant le transformateur d'entrée

  1. Ouvrez la EventBridge console Amazon à l'adresse https://console.aws.amazon.com/events/.

  2. Dans la barre de navigation, sélectionnez le Région AWS à utiliser.

  3. Dans le volet de navigation, choisissez Règles.

  4. Choisissez Créer une règle.

  5. Dans Nom, spécifiez un nom unique pour votre environnement informatique. Le nom peut contenir jusqu'à 64 caractères. Il peut contenir des lettres majuscules et minuscules, des chiffres, des traits d'union (-) et des traits de soulignement (_).

    Note

    Une règle ne peut pas porter le même nom qu'une autre règle du même bus Région AWS d'événements ou du même bus d'événements.

  6. (Facultatif) Dans Description, entrez une description pour la règle.

  7. Pour Event bus (Bus d'événement), sélectionnez le bus d'événement que vous souhaitez associer à cette règle. Si vous souhaitez que cette règle mette en correspondance les événements en provenance de votre compte, sélectionnez Par défaut. Lorsqu'un événement Service AWS de votre compte est émis, il est toujours redirigé vers le bus d'événements par défaut de votre compte.

  8. (Facultatif) Désactivez la règle sur le bus sélectionné si vous ne souhaitez pas l'exécuter immédiatement.

  9. Pour Rule type (Type de règle), choisissez Schedule (Planifier).

  10. Choisissez Continuer pour créer une règle ou Suivant.

  11. Pour Schedule pattern (Planifier le modèle), effectuez l'une des étapes suivantes :

    • Choisissez Un calendrier détaillé qui s’exécute à une heure précise, à 8 h 00 PSTle premier lundi de chaque mois, puis entrez une expression cron. Pour plus d'informations, consultez la section Cron Expressions dans le guide de EventBridge l'utilisateur Amazon.

    • Choisissez Un horaire qui fonctionne à un rythme régulier, par exemple toutes les 10 minutes. puis entrez une expression de taux.

  12. Choisissez Suivant.

  13. Pour Target types (Types de cibles), choisissez Service AWS.

  14. Pour Sélectionner une cible, choisissez Batch job queue. Configurez ensuite les éléments suivants :

    • File d'attente de tâches : entrez le nom de ressource Amazon (ARN) de la file d'attente de tâches dans laquelle planifier votre tâche.

    • Définition de la tâche : Entrez le nom et la version révisée ou complète ARN de la définition de tâche à utiliser pour votre tâche.

    • Job name (Nom de la tâche ): saisissez un nom pour votre tâche.

    • Array size (Taille du tableau) : (facultatif) saisissez une taille de tableau pour que votre tâche exécute plusieurs copies. Pour de plus amples informations, veuillez consulter Tâches liées à.

    • Job attempts (Tentatives d'exécution de tâche) : (facultatif) saisissez le nombre de nouvelles tentatives pour votre tâche en cas d'échec. Pour de plus amples informations, veuillez consulter Nouvelles tentatives de travail automatisées.

  15. Pour les types de cibles de file d'attente de tâches EventBridge Batch, une autorisation est requise pour envoyer des événements à la cible. EventBridge peut créer le IAM rôle nécessaire à l'exécution de votre règle. Effectuez l’une des actions suivantes :

    • Pour créer un IAM rôle automatiquement, choisissez Créer un nouveau rôle pour cette ressource spécifique.

    • Pour utiliser un IAM rôle que vous avez déjà créé, choisissez Utiliser un rôle existant.

  16. (Facultatif) Développez Additional settings (Paramètres supplémentaires).

  17. Dans la section Additional settings (Réglages supplémentaires), pour Configure target input (Configurer l'entrée cible), choisissez Input Transformer (Transformateur d'entrée).

  18. Choisissez Configure input transformer (Configurer le transformateur d'entrée).

  19. (Facultatif) Pour un exemple d'événement :

    1. Dans Exemple de type d'événement, sélectionnez AWS événements.

    2. Pour Sample events, choisissez Batch Job State Change.

  20. Dans la section Target input transformer (Transformateur d'entrée cible), pour Input path (Chemin d'entrée), spécifiez les valeurs à analyser depuis l'événement déclencheur. Par exemple, pour analyser l'événement Batch Job State Change, utilisez le JSON format suivant.

    {
    "instance": "$.detail.jobId",
    "state": "$.detail.status"
}

  21. Pour Modèle, entrez ce qui suit.

    {
    "instance": <jobId> ,
    "status": <status>
}

  22. Choisissez Confirmer.

  23. Pour Âge maximal de l'événement, spécifiez l'intervalle de temps pendant lequel les événements non traités sont conservés.

  24. Pour Réessayer, entrez le nombre de nouvelles tentatives d'un événement.

  25. Pour la file d'attente de lettres mortes, choisissez une option concernant la manière dont les événements non traités sont gérés. Si nécessaire, spécifiez la SQS file d'attente Amazon à utiliser comme file d'attente de lettres mortes.

  26. (Facultatif) Choisissez Ajouter une autre cible pour ajouter une cible supplémentaire.

  27. Choisissez Suivant.

  28. (Facultatif) Pour les balises, choisissez Ajouter une nouvelle balise pour ajouter une étiquette de ressource. Pour plus d'informations, consultez les EventBridge balises Amazon dans le guide de EventBridge l'utilisateur Amazon.

  29. Choisissez Suivant.

  30. Pour Réviser et créer, passez en revue les étapes de configuration. Si vous devez apporter des modifications, choisissez Modifier. Lorsque vous avez terminé, choisissez Créer une règle.