Gere um AWS CloudFormation modelo a partir do EventBridge Pipes

AWS CloudFormation permite que você configure e gerencie seus AWS recursos em contas e regiões de forma centralizada e repetível, tratando a infraestrutura como código. CloudFormation faz isso permitindo que você crie modelos, que definem os recursos que você deseja provisionar e gerenciar.

EventBridge permite que você gere modelos a partir dos canais existentes em sua conta, como uma ajuda para ajudá-lo a começar a desenvolver CloudFormation modelos. É possível selecionar um único pipe ou vários pipes para incluir no modelo. Em seguida, você pode usar esses modelos como base para criar pilhas de recursos sob CloudFormation gerenciamento.

Para obter mais informações sobre CloudFormation, consulte o Guia AWS CloudFormation do Usuário.

Para ônibus de eventos, você pode gerar CloudFormation modelos a partir de ônibus de eventos e regras de ônibus de eventos.

Recursos incluídos nos modelos EventBridge do Pipe

Ao EventBridge gerar o CloudFormation modelo, ele cria um AWS::Pipes::Piperecurso para cada canal selecionado. Além disso, EventBridge inclui os seguintes recursos nas condições descritas:

• AWS::Events::ApiDestination

  Se seus canais incluírem destinos de API, como enriquecimentos ou alvos, EventBridge inclua-os no CloudFormation modelo como AWS::Events::ApiDestination recursos.

• AWS::Events::EventBus

  Se seus canais incluírem um barramento de eventos como destino, EventBridge inclua-o no CloudFormation modelo como um AWS::Events::EventBus recurso.

• AWS::IAM::Role

  Se você EventBridge criou uma nova função de execução ao configurar o pipe, pode optar por EventBridge incluir essa função no modelo como um AWS::IAM::Role recurso. EventBridge não inclui funções que você cria. (Em ambos os casos, a RoleArn propriedade do AWS::Pipes::Pipe recurso contém o ARN da função.)

Considerações ao usar CloudFormation modelos gerados a partir de Pipes EventBridge

Considere os seguintes fatores ao usar um CloudFormation modelo que você gerou a partir de EventBridge:

• EventBridge não inclui nenhuma senha no modelo gerado.

  Você pode editar o modelo para incluir parâmetros de modelo que permitam aos usuários especificar senhas ou outras informações confidenciais ao usar o modelo para criar ou atualizar uma CloudFormation pilha.

  Além disso, os usuários podem usar o Secrets Manager para criar um segredo na região desejada e depois editar o modelo gerado para empregar parâmetros dinâmicos.

• Os destinos no modelo gerado permanecem exatamente como foram especificados no pipe original. Isso poderá resultar em problemas entre regiões se você não editar adequadamente o modelo antes de utilizá-lo para criar pilhas em outras regiões.

  Além disso, o modelo gerado não cria os destinos downstream automaticamente.

Gerando um CloudFormation modelo a partir do EventBridge Pipes

Para gerar um CloudFormation modelo a partir de um ou mais tubos usando o EventBridge console, faça o seguinte:

Para gerar um CloudFormation modelo a partir de um ou mais tubos

1. Abra o EventBridge console da Amazon em https://console.aws.amazon.com/events/.

2. No painel de navegação, escolha Pipes.

3. Em Tubos, escolha um ou mais tubos que você deseja incluir no CloudFormation modelo gerado.

   Para um único pipe, também é possível escolher o nome do pipe para exibir a página de detalhes do pipe.

4. Escolha CloudFormation Modelo e, em seguida, escolha em qual formato você EventBridge deseja gerar o modelo: JSON ou YAML.

   EventBridge exibe o modelo, gerado no formato selecionado.

5. Se você EventBridge criou uma nova função de execução para qualquer um dos canais selecionados e EventBridge deseja incluir essas funções no modelo, escolha Incluir IAM funções criadas pelo console em seu nome.

6. EventBridge oferece a opção de baixar o arquivo de modelo ou copiar o modelo para a área de transferência.

   • Para baixar o arquivo de modelo, escolha Baixar.

   • Para copiar o modelo para a área de transferência, escolha Copiar.

7. Para sair do modelo, escolha Cancelar.