Image Builder パイプラインで EventBridge ルールを使用する - EC2 イメージビルダー
イベントブリッジの用語Image Builder パイプラインのEventBridge ルールを表示するEventBridge ルールを使用してパイプライン構築をスケジュールする

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

Image Builder パイプラインで EventBridge ルールを使用する

さまざまな AWS およびパートナーサービスからのイベントは、ほぼリアルタイムで Amazon EventBridge イベントバスにストリーミングされます。カスタムイベントを生成したり、独自のアプリケーションから EventBridge にイベントを送信したりすることもできます。イベントバスはルールを使用してイベントデータのルーティング先を決定します。

Image Builder パイプラインは EventBridge ルールターゲットとして使用できます。つまり、バス上のイベントに応答するために作成したルールに基づいて、またはスケジュールに基づいて Image Builder パイプラインを実行できます。

Image Builder から EventBridge に送信されるシステム生成イベントの概要については、「Image Builder が送信するイベントメッセージ」を参照してください。

注記

イベントバスはリージョン固有です。ルールとターゲットは同じリージョンに存在する必要があります。

イベントブリッジの用語

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

イベント

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

イベントバス

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

ソース

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

Target

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

ルール

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

パターン

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

スケジュール

スケジュールルールは、Image Builder パイプラインを実行して四半期ごとにイメージを更新するなど、スケジュールに基づいてアクションを実行します。スケジュール表現には次の 2 種類があります。

  • Cron 式 — 例えば、特定の日に毎週実行するなど、単純な基準を概説できる cron 構文を使用して、特定のスケジューリング条件を照合します。また、月の 5 日目の午前 2 時から午前 4 時の間に四半期ごとに実行するなど、より複雑な条件を設定することもできます。

  • レート表現 — 12 時間ごとなど、ターゲットを定期的に呼び出す間隔を指定します。

Image Builder パイプラインのEventBridge ルールを表示する

Image Builder の イメージパイプライン 詳細ページの EventBridge ルール タブには、アカウントがアクセスできる EventBridge イベントバスと、現在のパイプラインに適用される選択したイベントバスのルールが表示されます。このタブは、新しいリソースを作成するためのEventBridge コンソールにも直接リンクしています。

EventBridge コンソールにリンクするアクション

  • イベントバスを作成

  • ルールの作成

EventBridge の詳細については、Amazon EventBridge ユーザーガイドの以下のトピックを参照してください。

EventBridge ルールを使用してパイプライン構築をスケジュールする

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

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

  2. アカウントで作成されたイメージパイプラインのリストを表示するには、ナビゲーションペインから [Image pipelines] を選択します。

    注記

    イメージパイプラインのリストには、パイプラインによって作成される出力イメージのタイプ (AMI または Docker) のインジケータが含まれています。

  3. 詳細を表示したりパイプラインを編集したりするには、[パイプライン名] のリンクを選択します。パイプラインの詳細ビューが開きます。

    注記

    また、パイプライン名の横にあるチェックボックスを選択し、詳細を表示を選択することもできます。

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

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

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

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

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

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

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

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

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

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

    4. Add target を選択します。

  11. 作成を選択します。

注記

この例で説明されていない rate 式ルールの設定について詳しくは、Amazon EventBridge User Guide のレート表現を参照してください。