本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 在 Image Builder 管道中使用 EventBridge 规则
<a name="ev-rules-for-pipeline"></a>

来自各种合作伙伴服务的活动几乎实时地 AWS 流式传输到Amazon EventBridge 活动总线。您还可以生成自定义事件，并将事件从您自己的应用程序发送到 EventBridge。事件总线使用规则来确定将事件数据路由到何处。

Image Builder 管道可用作 EventBridge 规则目标，这意味着您可以根据为响应总线上的事件而创建的规则或按计划运行 Image Builder 管道。

有关 Image Builder 发送到的系统生成事件的摘要 EventBridge，请参阅[Image Builder 发送的事件消息](integ-eventbridge.md#integ-eb-event-summary)。

**注意**  
事件总线是特定于某个区域的。规则和目标必须位于同一区域。

**Topics**
+ [EventBridge 条款](#ev-terms)
+ [查看 Image Builder 管道的 EventBridge 规则](#ev-rules-pipeline-tab)
+ [使用 EventBridge 规则安排管道构建](#ev-rules-schedule-pipeline)

## EventBridge 条款
<a name="ev-terms"></a>

本节包含术语摘要，可帮助您了解如何 EventBridge 与 Image Builder 管道集成。

事件  
描述环境中可能影响一个或多个应用程序资源的变化。环境可以是 AWS 环境、SaaS 合作伙伴服务或应用程序，也可以是您的一个应用程序或服务。您还可以在时间线上设置计划的事件。

事件总线  
接收来自应用程序和服务的事件数据的管道。

来源  
将事件发送到事件总线的服务或应用程序。

目标  
一种资源或端点，在匹配规则时 EventBridge 调用，将数据从事件传送到目标。

规则  
规则 规则匹配传入事件并将其路由到目标进行处理。一条规则可以将一个事件发送到多个目标，然后这些目标将可并行运行。规则要么基于事件模式，要么基于计划。

模式  
事件模式定义事件结构和规则匹配的字段，以启动目标操作。

计划  
计划规则在计划中执行操作，例如运行 Image Builder 管道在每个季度刷新映像。有两种类型的计划表达式：  
+ **Cron 表达式** — 使用可以概述简单条件的 cron 语法匹配特定的调度条件；例如，每周在特定日期运行。您还可以制定更复杂的条件，例如每季度在每月的第五天凌晨 2 点到凌晨 4 点之间运行。
+ **rate 表达式**-指定调用目标时的固定间隔，例如每 12 小时一次。

## 查看 Image Builder 管道的 EventBridge 规则
<a name="ev-rules-pipeline-tab"></a>

Image Builder **Image 管道**详细信息页面中的**EventBridge 规则**选项卡显示 EventBridge 您的账户有权访问的事件总线，以及适用于当前管道的所选事件总线规则。此选项卡还直接链接到用于创建新资源的EventBridge 控制台。

**链接到 EventBridge 控制台的操作**
+ **创建事件总线**
+ **创建规则**

要了解更多信息 EventBridge，请参阅 *Amazon EventBridge 用户指南*中的以下主题。
+ [什么是亚马逊 EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html)
+ [亚马逊 EventBridge 活动巴士](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-bus.html)
+ [亚马逊 EventBridge 活动](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html)
+ [亚马逊 EventBridge 规则](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html)

## 使用 EventBridge 规则安排管道构建
<a name="ev-rules-schedule-pipeline"></a>

在本示例中，我们使用 rate 表达式为默认事件总线创建了新的计划规则。此示例中的规则每 90 天在事件总线上生成一个事件。该事件启动管道构建以刷新图像。

1. 打开 EC2 Image Builder 控制台，网址为[https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/)。

1. 要查看在您的账户下创建的映像管道列表，请从导航窗格中选择**映像管道**。
**注意**  
映像管道列表包括管道创建的输出映像类型的指示器，即 AMI 或 Docker。

1. 要查看详细信息或编辑管道，请选择**管道名称**链接。这将打开管道的详细视图。
**注意**  
您也可以选中**管道名称**旁边的框，然后选择**查看详细信息**。

1. 打开 “**EventBridge 规则**” 选项卡。

1. 保留在**事件总线**面板中预先选择的默认事件总线。

1. 选择**创建规则**。这将带您进入亚马逊 EventBridge 控制台中的**创建规则**页面。

1. 为规则输入名称和描述。规则名称在所选区域的事件总线中必须是唯一的。

1. 在**定义模式**面板中，选择**计划**选项。这将展开面板，每个选项都选中了 **Fixed rate every**。

1. 在第一个框中输入 `90`，然后从下拉列表中选择**Days**。

1. 在**选择目标**面板中执行以下操作：

   1. 从**目标** 下拉列表中选择 `EC2 Image Builder`

   1. 要将规则应用于 Image Builder 管道，请从**映像管道**下拉列表中选择目标管道。

   1. EventBridge 需要权限才能启动所选管道的构建。在此示例中，保留**为此特定资源创建新角色的**默认选项。

   1. 选择 **Add target**。

1. 选择 **Create**（创建）。

**注意**  
要详细了解本示例中未涉及的费率表达式规则设置，请参阅 *Amazon EventBridge 用户指南*中的[费率表达式](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html#eb-rate-expressions)。