Générer un AWS CloudFormation modèle à partir de EventBridge Pipes

AWS CloudFormation vous permet de configurer et de gérer vos AWS ressources sur l'ensemble des comptes et des régions de manière centralisée et reproductible en traitant l'infrastructure comme du code. CloudFormation pour ce faire, vous pouvez créer des modèles qui définissent les ressources que vous souhaitez approvisionner et gérer.

EventBridge vous permet de générer des modèles à partir des canaux existants de votre compte, afin de vous aider à démarrer le développement CloudFormation de modèles. Vous pouvez sélectionner un ou plusieurs canaux à inclure dans le modèle. Vous pouvez ensuite utiliser ces modèles comme base pour créer des piles de ressources à CloudFormation gérer.

Pour plus d'informations CloudFormation, consultez le guide de AWS CloudFormation l'utilisateur.

Pour les bus d'événements, vous pouvez générer des CloudFormation modèles à partir des bus d'événements et des règles des bus d'événements.

Ressources incluses dans les modèles EventBridge Pipe

Lors EventBridge de la CloudFormation génération du modèle, il crée une AWS::Pipes::Piperessource pour chaque canal sélectionné. En outre, EventBridge inclut les ressources suivantes dans les conditions décrites :

• AWS::Events::ApiDestination

  Si vos canaux incluent des destinations d'API, sous forme d'enrichissements ou de cibles, EventBridge incluez-les dans le CloudFormation modèle en tant que AWS::Events::ApiDestination ressources.

• AWS::Events::EventBus

  Si vos canaux incluent un bus d'événements comme cible, EventBridge incluez-le dans le CloudFormation modèle en tant que AWS::Events::EventBus ressource.

• AWS::IAM::Role

  Si vous aviez EventBridge créé un nouveau rôle d'exécution lors de la configuration du canal, vous pouvez choisir d' EventBridge inclure ce rôle dans le modèle en tant que AWS::IAM::Role ressource. EventBridge n'inclut pas les rôles que vous créez. (Dans les deux cas, la RoleArn propriété de la AWS::Pipes::Pipe ressource contient l'ARN du rôle.)

Considérations relatives à l'utilisation CloudFormation de modèles générés à partir de EventBridge Pipes

Tenez compte des facteurs suivants lorsque vous utilisez un CloudFormation modèle à partir duquel vous l'avez généré EventBridge :

• EventBridge n'inclut aucun mot de passe dans le modèle généré.

  Vous pouvez modifier le modèle pour y inclure des paramètres qui permettent aux utilisateurs de spécifier des mots de passe ou d'autres informations sensibles lorsqu'ils utilisent le modèle pour créer ou mettre à jour une CloudFormation pile.

  En outre, les utilisateurs peuvent utiliser Secrets Manager pour créer un secret dans la région souhaitée, puis modifier le modèle généré pour utiliser des paramètres dynamiques.

• Les cibles du modèle généré restent exactement telles qu’elles ont été spécifiées dans le canal d’origine. Cela peut entraîner des problèmes entre régions si vous ne modifiez pas correctement le modèle avant de l’utiliser pour créer des piles dans d’autres régions.

  De plus, le modèle généré ne crée pas automatiquement les cibles en aval.

Génération d'un CloudFormation modèle à partir de EventBridge Pipes

Pour générer un CloudFormation modèle à partir d'un ou de plusieurs canaux à l'aide de la EventBridge console, procédez comme suit :

Pour générer un CloudFormation modèle à partir d'un ou de plusieurs canaux

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

2. Dans le volet de navigation, choisissez Pipelines.

3. Sous Tuyaux, choisissez un ou plusieurs tuyaux que vous souhaitez inclure dans le CloudFormation modèle généré.

   Pour un canal unique, vous pouvez également choisir le nom du canal pour afficher la page de détails du canal.

4. Choisissez CloudFormation Modèle, puis choisissez le format dans lequel vous EventBridge souhaitez générer le modèle : JSON ou YAML.

   EventBridge affiche le modèle, généré dans le format sélectionné.

5. Si vous avez EventBridge créé un nouveau rôle d'exécution pour l'un des canaux sélectionnés et que vous EventBridge souhaitez inclure ces rôles dans le modèle, choisissez Inclure IAM les rôles créés par la console en votre nom.

6. EventBridge vous permet de télécharger le fichier modèle ou de le copier dans le presse-papiers.

   • Pour télécharger le fichier modèle, choisissez Télécharger.

   • Pour copier le modèle dans le presse-papiers, choisissez Copier.

7. Pour quitter le modèle, choisissez Annuler.