本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 搭配映像建置器管道使用 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)
+ [檢視映像建置器管道的 EventBridge 規則](#ev-rules-pipeline-tab)
+ [使用 EventBridge 規則來排程管道建置](#ev-rules-schedule-pipeline)

## EventBridge 詞彙
<a name="ev-terms"></a>

本節包含術語摘要，協助您了解 EventBridge 如何與您的映像建置器管道整合。

事件  
描述環境中可能影響一或多個應用程式資源的變更。環境可以是 AWS 環境、SaaS 合作夥伴服務或應用程式，或是您的其中一個應用程式或服務。您也可以在時間軸上設定排程事件。

事件匯流排  
從應用程式和服務接收事件資料的管道。

來源  
將事件傳送至事件匯流排的服務或應用程式。

目標  
EventBridge 在符合規則時叫用的資源或端點，將資料從事件傳遞到目標。

規則  
規則會比對連入事件，並將這些事件路由到目標以進行處理。單一規則可以將事件傳送至多個目標，然後可以平行執行。規則是以事件模式或排程為基礎。

模式  
事件模式會定義事件結構和規則相符的欄位，以啟動目標動作。

排程  
排程規則會依排程執行動作，例如執行映像建置器管道以每季重新整理映像。排程表達式有兩種類型：  
+ **Cron 表達**式 – 使用可以概述簡單條件的 cron 語法來比對特定排程條件；例如，特定日期每週執行一次。您也可以建立更複雜的條件，例如在每個月第五天的凌晨 2 點到凌晨 4 點之間執行。
+ **速率表達式** – 指定調用目標時的規則間隔，例如每 12 小時。

## 檢視映像建置器管道的 EventBridge 規則
<a name="ev-rules-pipeline-tab"></a>

映像建置器**映像管道**詳細資訊頁面中的 **EventBridge 規則**索引標籤會顯示您帳戶可存取的 EventBridge 事件匯流排，以及適用於目前管道之所選事件匯流排的規則。此索引標籤也會直接連結至 EventBridge 主控台，以建立新資源。

**連結至 EventBridge 主控台的動作**
+ **建立事件匯流排**
+ **建立規則**

若要進一步了解 EventBridge，請參閱《*Amazon EventBridge 使用者指南*》中的下列主題。
+ [什麼是 Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html)
+ [Amazon EventBridge 事件匯流排](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-bus.html)
+ [Amazon EventBridge 事件](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html)
+ [Amazon EventBridge 規則](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html)

## 使用 EventBridge 規則來排程管道建置
<a name="ev-rules-schedule-pipeline"></a>

在此範例中，我們使用速率表達式為預設事件匯流排建立新的排程規則。此範例中的規則每 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. 選擇**建立規則**。這將帶您前往 Amazon EventBridge 主控台中的**建立規則**頁面。

1. 輸入規則的名稱和描述。規則名稱在所選區域的事件匯流排內必須是唯一的。

1. 在**定義模式**面板中，選擇**排程**選項。這會展開面板，並選取**每個選項的固定速率**。

1. `90` 在第一個方塊中輸入 ，然後從下拉式清單中選取**天數**。

1. 在**選取目標**面板中執行下列動作：

   1. `EC2 Image Builder` 從**目標**下拉式清單中選取 。

   1. 若要將規則套用至映像建置器管道，請從**映像管道**下拉式清單中選取目標管道。

   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)式。