翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 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**
+ [イベントブリッジの用語](#ev-terms)
+ [Image Builder パイプラインのEventBridge ルールを表示する](#ev-rules-pipeline-tab)
+ [EventBridge ルールを使用してパイプライン構築をスケジュールする](#ev-rules-schedule-pipeline)

## イベントブリッジの用語
<a name="ev-terms"></a>

このセクションでは、EventBridge と Image Builder パイプラインの統合方法を理解するための用語の概要を説明します。

イベント  
1 つまたは複数のアプリケーションリソースに影響を与える可能性のある環境の変更について記述します。環境は、 AWS 環境、SaaS パートナーサービスまたはアプリケーション、またはアプリケーションまたはサービスのいずれかです。タイムラインに予定されたイベントをセットアップすることもできます。

イベントバス  
アプリケーションやサービスからイベントデータを受け取るパイプライン。

ソース  
イベントをイベントバスに送信したサービスまたはアプリケーション。

ターゲット  
EventBridge がルールに一致したときに呼び出し、イベントからターゲットにデータを配信するリソースまたはエンドポイント。

ルール  
ルールは、受信したイベントをマッチングし、処理のためにターゲットに送信します。1 つのルールで複数のターゲットにイベントを送信し、それを並行して実行することができます。ルールは、イベントパターンまたはスケジュールに基づいて作成します。

パターン  
イベントパターンは、ターゲットアクションを開始するために、ルールがマッチするイベント構造とフィールドを定義します。

スケジュール  
スケジュールルールは、Image Builder パイプラインを実行して四半期ごとにイメージを更新するなど、スケジュールに基づいてアクションを実行します。スケジュール表現には次の 2 種類があります。  
+ Cron 式 — 例えば、特定の日に毎週実行するなど、単純な基準を概説できる cron 構文を使用して、特定のスケジューリング条件を照合します。また、月の 5 日目の午前 2 時から午前 4 時の間に四半期ごとに実行するなど、より複雑な条件を設定することもできます。
+ レート表現 — 12 時間ごとなど、ターゲットを定期的に呼び出す間隔を指定します。

## Image Builder パイプラインのEventBridge ルールを表示する
<a name="ev-rules-pipeline-tab"></a>

Image Builder の **イメージパイプライン** 詳細ページの **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>

この例では、rate 式を使用してデフォルトイベントバス用の新しいスケジュールルールを作成します。この例のルールは 90 日ごとにイベントバスでイベントを生成します。このイベントは、イメージを更新するパイプラインの構築を開始します。

1. [https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/) で、EC2 Image Builder コンソールを開きます。

1. アカウントで作成されたイメージパイプラインのリストを表示するには、ナビゲーションペインから [**Image pipelines**] を選択します。
**注記**  
イメージパイプラインのリストには、パイプラインによって作成される出力イメージのタイプ (AMI または Docker) のインジケータが含まれています。

1. 詳細を表示したりパイプラインを編集したりするには、**[パイプライン名]** のリンクを選択します。パイプラインの詳細ビューが開きます。
**注記**  
また、**パイプライン名**の横にあるチェックボックスを選択し、**詳細を表示**を選択することもできます。

1. **EventBridge のルール**タブを開きます。

1. **Event Bus** パネルであらかじめ選択されているデフォルトのイベントバスはそのままにしておきます。

1. **ルールの作成**を選択します。Amazon EventBridge コンソールの**ルールを作成**ページに移動します。

1. ルールの名前と説明を入力します。ルール名は、選択したリージョンのイベントバス内で一意である必要があります。

1. **パターンを定義**パネルで、**スケジュール**オプションを選択します。これによりパネルが拡張され、**すべての固定レート**オプションが選択されます。

1. `90` 最初のボックスに入力し、ドロップダウンリストから **Days** を選択します。

1. **ターゲットの選択** パネルで以下のアクションを実行します。

   1. **Target** のドロップダウンリストから `EC2 Image Builder` を選択します。

   1. Image Builder パイプラインにルールを適用するには、**Image Pipeline** ドロップダウンリストからターゲットパイプラインを選択します。

   1. EventBridge には、選択したパイプラインのビルドを実行するためのアクセス許可が必要です。この例では、**この特定のリソースに対して新しいロールを作成する**をデフォルトのままにします。

   1. **Add target** を選択します。

1. **作成**を選択します。

**注記**  
この例で説明されていない rate 式ルールの設定について詳しくは、Amazon EventBridge User Guide の[レート表現](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html#eb-rate-expressions)を参照してください。