As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Use EventBridge regras com pipelines do Image Builder
Eventos de uma ampla variedade de serviços AWS e de parceiros são transmitidos para os ônibus de EventBridge eventos da Amazon quase em tempo real. Você também pode gerar eventos personalizados e enviar eventos de seus próprios aplicativos para EventBridge o. Os barramentos de eventos usam regras para determinar para onde rotear os dados do evento.
Os pipelines do Image Builder estão disponíveis como destinos de EventBridge regras, o que significa que você pode executar um pipeline do Image Builder com base nas regras criadas para responder a eventos no barramento ou em uma programação.
Para obter um resumo dos eventos gerados pelo sistema para os quais o Image Builder envia EventBridge, consulte[Mensagens de eventos que o Image Builder envia](integ-eventbridge.md#integ-eb-event-summary).
**nota**
Os barramentos de eventos são específicos para uma região. A regra e o alvo devem estar localizados na mesma região.
**Topics**
+ [EventBridge termos](#ev-terms)
+ [Veja EventBridge as regras para seu pipeline do Image Builder](#ev-rules-pipeline-tab)
+ [Use EventBridge regras para agendar a construção de um pipeline](#ev-rules-schedule-pipeline)
## EventBridge termos
Esta seção contém um resumo dos termos para ajudar você a entender como se EventBridge integra aos seus pipelines do Image Builder.
Event
Descreve uma alteração em um ambiente que pode afetar um ou mais recursos do aplicativo. O ambiente pode ser um AWS ambiente, um serviço ou aplicativo de parceiro SaaS ou um de seus aplicativos ou serviços. Também é possível configurar eventos agendados em uma linha do tempo.
Barramento de eventos
Um pipeline que recebe dados de eventos de aplicativos e serviços.
Origem
O serviço ou aplicativo que enviou o evento para o ônibus do evento.
Alvo
Um recurso ou endpoint que é EventBridge invocado quando corresponde a uma regra, entregando dados do evento para o destino.
Regra
Uma regra corresponde a eventos de entrada e encaminha-os para os destinos para processamento. Uma única regra pode enviar um evento para vários destinos, que podem ser executados paralelamente. As regras são baseadas em um padrão de evento ou em uma programação.
Padrão
Um padrão de evento define a estrutura do evento e os campos aos quais uma regra corresponde para iniciar a ação de destino.
Programação
As regras de agendamento executam uma ação em um cronograma, como executar um pipeline do Image Builder para atualizar uma imagem trimestralmente. Há dois tipos de expressões de agendamento:
+ **Expressões Cron**: combine critérios de agendamento específicos usando a sintaxe cron que pode delinear critérios simples; por exemplo, execução semanal em um dia específico. Você também pode estabelecer critérios mais complexos, como correr trimestralmente no quinto dia do mês, entre 2h e 4h.
+ **Expressões de taxa**: especifique um intervalo regular quando o alvo é invocado, como a cada 12 horas.
## Veja EventBridge as regras para seu pipeline do Image Builder
A guia de **EventBridge regras** na página de detalhes dos **pipelines de imagem do Image** Builder exibe os barramentos de EventBridge eventos aos quais sua conta tem acesso e as regras do barramento de eventos selecionado que se aplicam ao pipeline atual. Essa guia também se vincula diretamente ao EventBridge console para criar novos recursos.
**Ações vinculadas ao EventBridge console**
+ **Crie um barramento de eventos**
+ **Criar regra**
Para saber mais sobre isso EventBridge, consulte os tópicos a seguir no *Guia EventBridge do usuário da Amazon*.
+ [O que é a Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html)
+ [Ônibus para EventBridge eventos da Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-bus.html)
+ [ EventBridge Eventos da Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html)
+ [ EventBridge Regras da Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html)
## Use EventBridge regras para agendar a construção de um pipeline
Neste exemplo, criamos uma nova regra de agendamento para o barramento de eventos padrão, usando uma expressão de taxa. A regra neste exemplo gera um evento no barramento de eventos a cada 90 dias. O evento inicia a criação de um pipeline para atualizar a imagem.
1. Abra o console do EC2 Image Builder em [https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/).
1. Para ver uma lista dos pipelines de imagem criados em sua conta, escolha **Pipelines de imagem** no painel de navegação.
**nota**
A lista de pipelines de imagem inclui um indicador do tipo de imagem de saída criada pelo pipeline: AMI ou Docker.
1. Para ver detalhes ou editar um pipeline, escolha o link do **nome do pipeline**. Isto abre a visão detalhada do pipeline.
**nota**
Você também pode selecionar a caixa ao lado de **Nome do pipeline**, depois escolher **Exibir detalhes**.
1. Abra a guia de **EventBridge regras**.
1. Mantenha o barramento de eventos padrão pré-selecionado no painel **Barramento de eventos**.
1. Escolha **Criar regra**. Isso leva você à página **Criar regra** no EventBridge console da Amazon.
1. Insira um nome e uma descrição para a regra. O nome da regra deve ser exclusivo no barramento de eventos da região selecionada.
1. No painel **Definir padrão**, escolha a opção **Programação**. Isso expande o painel, com a **taxa fixa de todas as** opções selecionadas.
1. Insira `90` na primeira caixa e selecione **Dias** na lista suspensa.
1. Execute as seguintes ações no painel **Selecionar alvos**:
1. Selecione na `EC2 Image Builder` lista suspensa **Alvo**.
1. Para aplicar a regra a um pipeline do Image Builder, selecione o pipeline de destino na lista suspensa **Pipeline de imagens**.
1. EventBridge precisa de permissão para iniciar uma construção para o pipeline selecionado. Neste exemplo, mantenha a opção padrão de **Criar uma nova função para esse recurso específico**.
1. Escolha **Adicionar destino**.
1. Selecione **Criar**
**nota**
Para saber mais sobre as configurações das regras de expressão de taxas que não são abordadas neste exemplo, consulte [Expressões de taxa](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html#eb-rate-expressions) no *Guia EventBridge do usuário da Amazon*.