Gestione degli eventi App Runner in EventBridge

Con Amazon EventBridge, puoi configurare regole basate sugli eventi che monitorano un flusso di dati in tempo reale dal tuo AWS App Runner servizio per determinati modelli. Quando viene rispettato uno schema per una regola, EventBridge avvia un'azione in una destinazione come AWS Lambda Amazon ECS e Amazon AWS Batch SNS. Ad esempio, puoi impostare una regola per l'invio di notifiche e-mail segnalando un argomento di Amazon SNS ogni volta che una distribuzione del tuo servizio fallisce. In alternativa, puoi impostare una funzione Lambda per notificare a un canale Slack ogni volta che un aggiornamento del servizio fallisce. Per ulteriori informazioni su EventBridge, consulta Amazon EventBridge User Guide.

App Runner invia i seguenti tipi di eventi a EventBridge

• Modifica dello stato del servizio: modifica dello stato di un servizio App Runner. Ad esempio, lo stato di un servizio è cambiato inDELETE_FAILED.

• Modifica dello stato di funzionamento del servizio: modifica dello stato di un'operazione lunga e asincrona su un servizio App Runner. Ad esempio, la creazione di un servizio è iniziata, un aggiornamento del servizio è stato completato con successo o la distribuzione del servizio è stata completata con errori.

Creazione di una EventBridge regola per agire sugli eventi di App Runner

Un EventBridge evento è un oggetto che definisce alcuni EventBridge campi standard, come il AWS servizio di origine e il tipo di dettaglio (evento), e un insieme di campi specifici dell'evento con i dettagli dell'evento. Per creare una EventBridge regola, si utilizza la EventBridge console per definire uno schema di eventi (quali eventi devono essere registrati) e specificare un'azione mirata (cosa fare durante una partita). Uno schema di eventi è simile agli eventi a cui corrisponde. Si specifica un sottoinsieme di campi da abbinare e per ogni campo si specifica un elenco di valori possibili. Questo argomento fornisce esempi di eventi e modelli di eventi di App Runner.

Per ulteriori informazioni sulla creazione di EventBridge regole, consulta Creating a rule for an AWS service nella Amazon EventBridge User Guide.

Nota

Alcuni servizi supportano modelli predefiniti in EventBridge. Ciò semplifica il modo in cui viene creato un modello di eventi. Seleziona i valori dei campi su un modulo e EventBridge genera lo schema automaticamente. Al momento, App Runner non supporta modelli predefiniti. Devi inserire il pattern come oggetto JSON. È possibile utilizzare gli esempi in questo argomento come punto di partenza.

Esempi di eventi App Runner

Questi sono alcuni esempi di eventi a cui App Runner invia. EventBridge

• Un evento di modifica dello stato del servizio. In particolare, un servizio che è cambiato dallo RUNNING stato OPERATION_IN_PROGRESS a.

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

• Un evento di modifica dello stato dell'operazione. In particolare, un'UpdateServiceoperazione completata con successo.

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

Esempi di pattern di eventi di App Runner

Gli esempi seguenti mostrano modelli di eventi che è possibile utilizzare nelle EventBridge regole per abbinare uno o più eventi di App Runner. Uno schema di eventi è simile a un evento. Includi solo i campi che desideri abbinare e fornisci un elenco anziché uno scalare per ciascuno di essi.

• Abbina tutti gli eventi di modifica dello stato del servizio per i servizi di un account specifico, in cui il servizio non è più in RUNNING stato.

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

• Abbina tutti gli eventi di modifica dello stato dell'operazione per i servizi di un account specifico, in cui l'operazione non è riuscita.

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

Riferimento all'evento App Runner

Modifica dello stato del servizio

Un evento di modifica dello stato del servizio è detail-type impostato suAppRunner Service Status Change. Ha i seguenti campi e valori di dettaglio:

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

Modifica dello stato dell'operazione

Un evento di modifica dello stato dell'operazione è detail-type impostato suAppRunner Service Operation Status Change. Ha i seguenti campi e valori di dettaglio:

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

La tabella seguente elenca tutti i possibili codici di stato e i messaggi correlati.

Stato	Messaggio
CreateServiceStarted	La creazione del servizio è iniziata.
CreateServiceCompletedSuccessfully	Creazione del servizio completata con successo.
CreateServiceFailed	Creazione del servizio non riuscita. Per i dettagli, consulta i registri di servizio.
DeleteServiceStarted	L'eliminazione del servizio è iniziata.
DeleteServiceCompletedSuccessfully	Eliminazione del servizio completata con successo.
DeleteServiceFailed	Eliminazione del servizio non riuscita.
UpdateServiceStarted
UpdateServiceCompletedSuccessfully	Aggiornamento del servizio completato con successo. Viene implementata una nuova applicazione e configurazione.
	Aggiornamento del servizio completato con successo. È stata implementata una nuova configurazione.
UpdateServiceFailed	Aggiornamento del servizio non riuscito. Per i dettagli, consulta i registri di servizio.
DeploymentStarted	La distribuzione è iniziata.
DeploymentCompletedSuccessfully	Distribuzione completata con successo.
DeploymentFailed	Implementazione non riuscita. Per i dettagli, consulta i registri di servizio.
PauseServiceStarted	La pausa del servizio è iniziata.
PauseServiceCompletedSuccessfully	Sospensione del servizio completata con successo.
PauseServiceFailed	Sospensione del servizio non riuscita.
ResumeServiceStarted	Ripresa del servizio iniziata.
ResumeServiceCompletedSuccessfully	Ripresa del servizio completata con successo.
ResumeServiceFailed	Ripresa del servizio non riuscita.