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 コマンドを呼び出す

  • 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)

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

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"
    }
}