Umgang mit App Runner-Ereignissen in EventBridge

Mit Amazon EventBridge können Sie ereignisgesteuerte Regeln einrichten, die einen Stream von Echtzeitdaten aus Ihrem AWS App Runner Service auf bestimmte Muster hin überwachen. Wenn ein Muster für eine Regel übereinstimmt, wird eine Aktion in einem Ziel wie AWS Lambda Amazon ECS und Amazon AWS Batch SNS EventBridge initiiert. Sie können beispielsweise eine Regel für das Versenden von E-Mail-Benachrichtigungen festlegen, indem Sie ein Amazon SNS SNS-Thema signalisieren, wenn eine Bereitstellung für Ihren Service fehlschlägt. Oder du kannst eine Lambda-Funktion einrichten, um einen Slack-Channel zu benachrichtigen, wenn ein Service-Update fehlschlägt. Weitere Informationen zu EventBridge finden Sie im EventBridge Amazon-Benutzerhandbuch.

App Runner sendet die folgenden Ereignistypen an EventBridge

• Änderung des Dienststatus — Eine Änderung des Status eines App Runner-Dienstes. Zum Beispiel wurde ein Dienststatus in geändertDELETE_FAILED.

• Änderung des Status des Dienstvorgangs — Eine Änderung des Status eines langen, asynchronen Vorgangs in einem App Runner-Dienst. Zum Beispiel, wenn mit der Erstellung eines Dienstes begonnen wurde, ein Dienstupdate erfolgreich abgeschlossen wurde oder eine Dienstbereitstellung mit Fehlern abgeschlossen wurde.

Eine EventBridge Regel erstellen, die auf App Runner-Ereignisse reagiert

Ein EventBridge Ereignis ist ein Objekt, das einige EventBridge Standardfelder wie den AWS Quelldienst und den Detailtyp (Ereignis) sowie einen ereignisspezifischen Satz von Feldern mit den Ereignisdetails definiert. Um eine EventBridge Regel zu erstellen, verwenden Sie die EventBridge Konsole, um ein Ereignismuster zu definieren (welche Ereignisse verfolgt werden sollen) und eine Zielaktion (was bei einem Spiel geschehen soll) festzulegen. Ein Ereignismuster ähnelt den Ereignissen, denen es entspricht. Sie geben eine Teilmenge von Feldern an, die abgeglichen werden sollen, und für jedes Feld geben Sie eine Liste möglicher Werte an. Dieses Thema enthält Beispiele für App Runner-Ereignisse und -Ereignismuster.

Weitere Informationen zum Erstellen von EventBridge Regeln finden Sie unter Regel für einen AWS Service erstellen im EventBridge Amazon-Benutzerhandbuch.

Anmerkung

Einige Dienste unterstützen vordefinierte Muster in EventBridge. Dies vereinfacht die Erstellung eines Ereignismusters. Sie wählen Feldwerte in einem Formular aus und EventBridge generieren das Muster für Sie. Derzeit unterstützt App Runner keine vordefinierten Muster. Sie müssen das Muster als JSON-Objekt eingeben. Sie können die Beispiele in diesem Thema als Ausgangspunkt verwenden.

Beispiele für App Runner-Ereignisse

Dies sind einige Beispiele für Ereignisse, an die App Runner sendet EventBridge.

• Ein Ereignis zur Änderung des Dienststatus. Insbesondere ein Dienst, der vom in OPERATION_IN_PROGRESS den RUNNING Status geändert wurde.

  { 
    "version": "0",
    "id": "6a7e8feb-b491-4cf7-a9f1-bf3703467718",
    "detail-type": "AppRunner Service Status Change",
    "source": "aws.apprunner",
    "account": "111122223333",
    "time": "2021-04-29T11:54:23Z",
    "region": "us-east-2",
    "resources": [
      "arn:aws:apprunner:us-east-2:123456789012:service/my-app/8fe1e10304f84fd2b0df550fe98a71fa"
    ],
    "detail": {
      "previousServiceStatus": "OPERATION_IN_PROGRESS",
      "currentServiceStatus": "RUNNING",
      "serviceName": "my-app",
      "serviceId": "8fe1e10304f84fd2b0df550fe98a71fa",
      "message": "Service status is set to RUNNING.",
      "severity": "INFO"
    }
  }

• Ein Ereignis zur Änderung des Betriebsstatus. Insbesondere ein UpdateService Vorgang, der erfolgreich abgeschlossen wurde.

  { 
    "version": "0",
    "id": "6a7e8feb-b491-4cf7-a9f1-bf3703467718",
    "detail-type": "AppRunner Service Operation Status Change",
    "source": "aws.apprunner",
    "account": "111122223333",
    "time": "2021-04-29T18:43:48Z",
    "region": "us-east-2",
    "resources": [
      "arn:aws:apprunner:us-east-2:123456789012:service/my-app/8fe1e10304f84fd2b0df550fe98a71fa"
    ],
    "detail": {
      "operationStatus": "UpdateServiceCompletedSuccessfully",
      "serviceName": "my-app",
      "serviceId": "8fe1e10304f84fd2b0df550fe98a71fa",
      "message": "Service update completed successfully. New application and configuration is deployed.",
      "severity": "INFO"
    }
  }

Beispiele für App Runner-Ereignismuster

Die folgenden Beispiele zeigen Ereignismuster, die Sie in EventBridge Regeln verwenden können, um einem oder mehreren App Runner-Ereignissen zuzuordnen. Ein Ereignismuster ähnelt einem Ereignis. Schließen Sie nur die Felder ein, die Sie zuordnen möchten, und stellen Sie für jedes Feld eine Liste statt eines Skalars bereit.

• Ordnet alle Ereignisse zur Änderung des Dienststatus für Dienste eines bestimmten Kontos zu, bei dem sich der Dienst nicht mehr im RUNNING Status befindet.

  { 
    "detail-type": [ "AppRunner Service Status Change" ],
    "source": [ "aws.apprunner" ],
    "account": [ "111122223333" ],
    "detail": {
      "previousServiceStatus": [ "RUNNING" ]
    }
  }

• Ordnet alle Ereignisse zur Änderung des Vorgangsstatus für Dienste eines bestimmten Kontos zu, bei dem der Vorgang fehlgeschlagen ist.

  { 
    "detail-type": [ "AppRunner Service Operation Status Change" ],
    "source": [ "aws.apprunner" ],
    "account": [ "111122223333" ],
    "detail": {
      "operationStatus": [
        "CreateServiceFailed",
        "DeleteServiceFailed",
        "UpdateServiceFailed",
        "DeploymentFailed",
        "PauseServiceFailed",
        "ResumeServiceFailed"
      ]
    }
  }

Referenz zum App Runner-Ereignis

Änderung des Dienststatus

Ein Ereignis zur Änderung des Servicestatus wurde auf detail-type gesetztAppRunner Service Status Change. Es hat die folgenden Detailfelder und Werte:

"serviceId": "your service ID",
"serviceName": "your service name",
"message": "Service status is set to CurrentStatus.",
"previousServiceStatus": "any valid service status",
"currentServiceStatus": "any valid service status",
"severity": "varies"

Änderung des Betriebsstatus

Ein Ereignis zur Änderung des Betriebsstatus wurde auf detail-type gesetztAppRunner Service Operation Status Change. Es hat die folgenden Detailfelder und Werte:

"operationStatus": "see following table",
"serviceName": "your service name",
"serviceId": "your service ID",
"message": "see following table",
"severity": "varies"

In der folgenden Tabelle sind alle möglichen Statuscodes und zugehörigen Meldungen aufgeführt.

Status	Fehlermeldung
CreateServiceStarted	Die Erstellung des Dienstes wurde gestartet.
CreateServiceCompletedSuccessfully	Die Erstellung des Dienstes wurde erfolgreich abgeschlossen.
CreateServiceFailed	Die Diensterstellung ist fehlgeschlagen. Einzelheiten finden Sie in den Dienstprotokollen.
DeleteServiceStarted	Das Löschen des Dienstes wurde gestartet.
DeleteServiceCompletedSuccessfully	Das Löschen des Dienstes wurde erfolgreich abgeschlossen.
DeleteServiceFailed	Das Löschen des Dienstes ist fehlgeschlagen.
UpdateServiceStarted
UpdateServiceCompletedSuccessfully	Das Service-Update wurde erfolgreich abgeschlossen. Neue Anwendung und Konfiguration wurden bereitgestellt.
	Das Service-Update wurde erfolgreich abgeschlossen. Die neue Konfiguration wurde bereitgestellt.
UpdateServiceFailed	Das Service-Update ist fehlgeschlagen. Einzelheiten finden Sie in den Serviceprotokollen.
DeploymentStarted	Die Bereitstellung wurde gestartet.
DeploymentCompletedSuccessfully	Die Bereitstellung wurde erfolgreich abgeschlossen.
DeploymentFailed	Bereitstellung fehlgeschlagen. Einzelheiten finden Sie in den Serviceprotokollen.
PauseServiceStarted	Die Dienstpause wurde gestartet.
PauseServiceCompletedSuccessfully	Die Dienstpause wurde erfolgreich abgeschlossen.
PauseServiceFailed	Die Dienstpause ist fehlgeschlagen.
ResumeServiceStarted	Die Wiederaufnahme des Dienstes wurde gestartet.
ResumeServiceCompletedSuccessfully	Die Wiederaufnahme des Dienstes wurde erfolgreich abgeschlossen.
ResumeServiceFailed	Die Wiederaufnahme des Dienstes ist fehlgeschlagen.