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

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

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

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

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

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

注記

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

EventBridge 用語

このセクションでは、 が Image Builder パイプラインと EventBridge どのように統合されるかを理解するのに役立つ用語の概要を示します。

イベント

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

イベントバス

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

ソース

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

Target

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

ルール

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

パターン

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

スケジュール

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

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

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

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

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

EventBridge コンソールにリンクするアクション
  • イベントバスを作成

  • ルールの作成

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

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

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

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

  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. 作成を選択します。

注記

この例で説明されていないレート式ルールの設定の詳細については、「Amazon EventBridge ユーザーガイド」の「レート式」を参照してください。