Image Builder での Amazon EventBridge の統合 - EC2 Image Builder
Image Builder が送信するイベントメッセージ

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

Image Builder での Amazon EventBridge の統合

Amazon EventBridge は、Image Builder アプリケーションを他の からの関連データに接続するために使用できるサーバーレスイベントバスサービスです AWS サービス。では EventBridge、ルールは受信イベントを照合し、処理のためにターゲットに送信します。1 つのルールで複数のターゲットにイベントを送信でき、これらのイベントは並行して実行されます。

を使用すると EventBridge、 を自動化 AWS サービス し、アプリケーションの可用性の問題やリソースの変更などのシステムイベントに自動的に対応できます。からの AWS サービス イベントは、ほぼリアルタイムで EventBridge に配信されます。受信イベントに反応するルールを設定して、アクションを開始できます。例えば、EC2インスタンスのステータスが保留中から実行中に変わったときに Lambda 関数にイベントを送信する場合などです。これらはパターンと呼ばれる。イベントパターンに基づいてルールを作成するには、「Amazon ユーザーガイド」の「イベントに反応する Amazon EventBridge ルールの作成」を参照してください。 EventBridge

自動的に開始されるアクションには以下のようなものがありまれます。

  • AWS Lambda 関数を呼び出す

  • Amazon EC2 Run Command を呼び出す

  • Amazon Kinesis Data Streams へのイベントを中継する

  • AWS Step Functions ステートマシンをアクティブ化する

  • Amazon SNSトピックまたは Amazon SQSキューを通知する

また、Image Builder パイプラインを実行して四半期ごとにイメージを更新するなど、デフォルトのイベントバスに定期的にアクションを実行するスケジューリングルールを設定することもできます。スケジュール表現には次の 2 種類があります。

  • cron 式 – 次の cron 式の例では、タスクを毎日正午 UTC+0 に実行するようにスケジュールします。

    cron(0 12 * * ? *)

    で cron 式を使用する方法の詳細については EventBridge、「Amazon EventBridge ユーザーガイド」の「Cron 式」を参照してください。

  • rate 式 - 以下の rate 式の例は、12 時間ごとにタスクを実行するようにスケジュールします。

    rate(12 hour)

    での rate 式の使用の詳細については EventBridge、「Amazon EventBridge ユーザーガイド」の「Rate 式」を参照してください。

EventBridge ルールと Image Builder イメージパイプラインの統合方法の詳細については、「」を参照してくださいImage Builder パイプラインで EventBridge ルールを使用する。

Image Builder が送信するイベントメッセージ

Image Builder は、Image Builder リソースのステータスに重大な変更 EventBridge があると、イベントメッセージを に送信します。例えば、イメージの状態が変更された場合などです。次の例は、Image Builder が送信する可能性のある一般的なJSONイベントメッセージを示しています。

EC2 Image Builder イメージの状態の変更

Image Builder は、イメージの作成中にイメージリソースの状態が変更されたときにこのイベントを送信します。例えば、次のようにイメージのステータスが 1 つの状態から別の状態に変わった場合です。

  • building から testing へ

  • testing から distribution へ

  • testing から failed へ

  • integrating から available へ

{
    "version": "0",
    "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "detail-type": "EC2 Image Builder Image State Change",
    "source": "aws.imagebuilder",
    "account": "111122223333",
    "time": "2024-01-18T17:50:56Z",
    "region": "us-west-2",
    "resources": ["arn:aws:imagebuilder:us-west-2:111122223333:image/cmkencryptedworkflowtest-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222/1.0.0/1"],
    "detail": {
        "previous-state": {
            "status": "TESTING"
        },
        "state": {
            "status": "AVAILABLE"
        }
    }
}
EC2 Image Builder CVE が検出されました

イメージに対してCVE検出を有効にしている場合、Image Builder はイメージスキャンが完了するたびに結果を含むメッセージを送信します。

{
    "version": "0",
    "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "detail-type": "EC2 Image Builder CVE Detected",
    "source": "aws.imagebuilder",
    "account": "111122223333",
    "time": "2023-03-01T16:59:09Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:imagebuilder:us-east-1:111122223333:image/test-image/1.0.0/1",
        "arn:aws:imagebuilder:us-east-1:111122223333:image-pipeline/test-pipeline"
    ],
    "detail": {
        "resource-id": "i-1234567890abcdef0",
        "finding-severity-counts": {
            "all": 0,
            "critical": 0,
            "high": 0,
            "medium": 0
        }
    }
}
EC2 Image Builder ワークフローステップの待機

Image Builder は、WaitForActionワークフローステップが一時停止して非同期アクションが完了するのを待つときにメッセージを送信します。

{
    "version": "0",
    "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "detail-type": "EC2 Image Builder Workflow Step Waiting",
    "source": "aws.imagebuilder",
    "account": "111122223333",
    "time": "2024-01-18T16:54:44Z",
    "region": "us-west-2",
    "resources": ["arn:aws:imagebuilder:us-west-2:111122223333:image/workflowstepwaitforactionwithvalidsnstopictest-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222/1.0.0/1", "arn:aws:imagebuilder:us-west-2:111122223333:workflow/build/build-workflow-a1b2c3d4-5678-90ab-cdef-EXAMPLE33333/1.0.0/1"],
    "detail": {
        "workflow-execution-id": "wf-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
        "workflow-step-execution-id": "step-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
        "workflow-step-name": "TestAutoSNSStop"
    }
}