Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

EventBridge Amazon-Integration in Image Builder

Amazon EventBridge ist ein serverloser Eventbus-Service, mit dem Sie Ihre Image Builder Builder-Anwendung mit verwandten Daten von anderen AWS-Services verbinden können. EventBridgeIn ordnet eine Regel eingehende Ereignisse zu und sendet sie zur Verarbeitung an Ziele. Eine einzelne Regel kann ein Ereignis an mehrere Ziele senden, und diese Ereignisse laufen dann parallel ab.

Damit können Sie Systemereignisse wie Probleme mit EventBridge der Anwendungsverfügbarkeit oder Ressourcenänderungen automatisieren AWS-Services und automatisch darauf reagieren. AWS-Services Ereignisse nahezu EventBridge in Echtzeit bereitstellen. Sie können Regeln einrichten, die auf eingehende Ereignisse reagieren, um Aktionen einzuleiten. Beispielsweise das Senden eines Ereignisses an eine Lambda-Funktion, wenn sich der Status einer EC2-Instance von „Ausstehend“ in „Wird ausgeführt“ ändert. EventBridge nennt diese übereinstimmenden Definitionen Ereignismuster. Informationen zum Erstellen einer Regel, die auf einem Ereignismuster basiert, finden Sie im EventBridge Amazon-Benutzerhandbuch unter Erstellen von EventBridge Amazon-Regeln, die auf Ereignisse reagieren.

Image Builder arbeitet EventBridge in zwei unabhängigen Richtungen. Wählen Sie diejenige aus, die Ihrem Ziel entspricht:

Schrittweise Anleitungen für beide Richtungen finden Sie unterVerwendung EventBridge mit Image Builder-Pipelines. Den Veranstaltungskatalog finden Sie unterVon Image Builder gesendete Ereignismeldungen.

Zu den Aktionen, die automatisch initiiert werden können, gehören:

Sie können auch Planungsregeln für den Standardereignisbus einrichten, um in regelmäßigen Abständen eine Aktion auszuführen, z. B. das Ausführen einer Image Builder Builder-Pipeline zur vierteljährlichen Aktualisierung eines Images. Es gibt zwei Arten von Zeitplanausdrücken:

Weitere Informationen zur Integration von EventBridge Regeln in Image Builder Builder-Image-Pipelines finden Sie unterVerwendung EventBridge mit Image Builder-Pipelines.

Von Image Builder gesendete Ereignismeldungen

Image Builder sendet Ereignisse an den EventBridge Standardereignisbus, wenn eine Image Builder Builder-Ressource einen wichtigen Punkt in ihrem Lebenszyklus erreicht, z. B. wenn ein Bild den Status ändert, ein Scan abgeschlossen ist, ein Workflow-Schritt zur Eingabe unterbrochen wird oder eine Pipeline automatisch deaktiviert wird. Jedes Ereignis verwendet die Quelle. aws.imagebuilder

In den folgenden Abschnitten werden die einzelnen Ereignisse beschrieben: wann Image Builder es sendet, die Felder im Ereignis detail und die Ressourcen-ARNs im resources Array. Informationen darüber, wie Sie auf diese Ereignisse reagieren können, finden Sie unterReagieren Sie auf Ereignisse, die Image Builder sendet. Die Konto-IDs, Regionen, ARNs und Zeitstempel in den Beispielen sind Platzhalter. Ersetzen Sie sie durch Ihre eigenen.

EC2 Image Builder Image-Statusänderung

Image Builder sendet dieses Ereignis, wenn sich der Status einer Bildressource während der Image-Erstellung ändert. Wenn sich der Status des Images beispielsweise wie folgt von einem Status in einen anderen ändert:

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

Image Builder sendet dieses Ereignis jedes Mal, wenn sich der Status einer Image-Ressource während der Image-Erstellung ändert, und zwar über die oben gezeigten Build-Übergänge hinweg.

Das Ereignis detail enthält die folgenden Felder:

Die Werte für den Build-Transition-Status sindBUILDING,TESTING,DISTRIBUTING,INTEGRATING, AVAILABLECANCELLED, und. FAILED

Das resources Array enthält den ARN der Bildressource, deren Status geändert wurde.

EC2 Image Builder CVE erkannt

Wenn Sie die CVE-Erkennung für Ihr Bild aktiviert haben, sendet Image Builder nach Abschluss eines Bildscans eine Nachricht mit den Ergebnissen.

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

Image Builder sendet dieses Ereignis, wenn ein Bildscan abgeschlossen ist, und nur, wenn Sie das Scannen von Bildern (Amazon Inspector) für das Bild aktivieren. Wenn der Scanvorgang ausgeschaltet ist, sendet Image Builder dieses Ereignis nicht. Informationen zum Einschalten des Scannens finden Sie unterKonfigurieren Sie Sicherheitsscans für Image Builder-Images in der AWS-Managementkonsole.

Das Ereignis detail enthält die folgenden Felder:

Das resources Array enthält den ARN der Bildressource und den ARN der Image-Pipeline, wenn der Scan über eine Pipeline ausgeführt wurde.

EC2 Image Builder Builder-Workflow-Schritt „Warten“

Image Builder sendet eine Nachricht, wenn ein WaitForAction Workflow-Schritt angehalten wird, um auf den Abschluss einer asynchronen Aktion zu warten.

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

Image Builder sendet dieses Ereignis, wenn ein WaitForAction Workflow-Schritt angehalten wird, um auf Ihre Antwort zu warten. Der Workflow bleibt angehalten, bis Sie antworten oder der Schritt das Timeout überschreitet.

Das Ereignis detail enthält die folgenden Felder:

Das resources Array enthält den ARN der Bildressource und den ARN des Workflows.

Um zu antworten, rufen Sie SendWorkflowStepAction mit dem workflow-step-execution-id From the Event und einem action of RESUME auf, um fortzufahren oder den Build STOP zu beenden. Siehe WaitForAction. Informationen dazu, wie Sie dies automatisch von einem Ereignis aus steuern können, finden Sie unterReagieren Sie auf Ereignisse, die Image Builder sendet.

EC2 Image Builder Builder-Image-Pipeline wurde automatisch deaktiviert

Wenn Sie das autoDisablePolicy für Ihre Pipeline konfiguriert haben, deaktiviert Image Builder die Pipeline und sendet eine Ereignismeldung an, EventBridge wenn die Anzahl der aufeinanderfolgenden geplanten Pipeline-Ausführungsfehler die maximale Anzahl überschreitet, die gemäß der Richtlinie zulässig ist.

{
    "version": "0",
    "id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "detail-type": "EC2 Image Builder Image Pipeline Automatically Disabled",
    "source": "aws.imagebuilder",
    "account": "111122223333",
    "time": "2025-09-18T16:54:44Z",
    "region": "us-west-2",
    "resources": ["arn:aws:imagebuilder:us-west-2:111122223333:image-pipeline/disabled-image-pipeline-name"],
    "detail": {
        "consecutive-failures": "5"
    }
}

Wenn Sie einen nach autoDisablePolicy dem Zeitplan einer Pipeline konfigurieren, zählt Image Builder aufeinanderfolgende Fehler bei geplanten Builds. Wenn die Anzahl die Werte der Richtlinie erreichtfailureCount, deaktiviert Image Builder die Pipeline und sendet dieses Ereignis.

Das Ereignis detail enthält die folgenden Felder:

Das resources Array enthält den ARN der Pipeline, die deaktiviert wurde.