での App Runner イベントの処理 EventBridge - AWS App Runner
App Runner イベントを処理する EventBridge ルールの作成App Runner イベントの例App Runner イベントパターンの例App Runner イベントリファレンス

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

での App Runner イベントの処理 EventBridge

Amazon を使用すると EventBridge、特定のパターンについて AWS App Runner サービスからのリアルタイムデータのストリームをモニタリングするイベント駆動型ルールを設定できます。ルールのパターンが一致する AWS Batchと、、Amazon ECS AWS Lambda、Amazon SNS などのターゲットでアクション EventBridge が開始されます。例えば、サービスへのデプロイが失敗するたびに Amazon SNS トピックにシグナルを送信することで、E メール通知を送信するルールを設定できます。または、サービスの更新が失敗するたびに Slack チャネルに通知する Lambda 関数を設定できます。の詳細については EventBridge、「Amazon ユーザーガイド EventBridge 」を参照してください。

App Runner は、次のイベントタイプを に送信します。 EventBridge

  • サービスステータスの変更 — App Runner サービスのステータスの変更。例えば、サービスのステータスが に変更されましたDELETE_FAILED。

  • サービスオペレーションステータスの変更 — App Runner サービスでの長い非同期オペレーションのステータスの変更。例えば、サービスの作成が開始された、サービスの更新が正常に完了した、サービスデプロイがエラーで完了したなどです。

App Runner イベントを処理する EventBridge ルールの作成

EventBridge イベントは、ソース AWS サービスや詳細 (イベント) EventBridge タイプ、イベントの詳細を含むイベント固有のフィールドセットなど、一部の標準フィールドを定義するオブジェクトです。 EventBridge ルールを作成するには、 EventBridge コンソールを使用してイベントパターン (追跡する必要があるイベント) を定義し、ターゲットアクション (一致に対して何を行うか) を指定します。イベントパターンは、一致するイベントに似ています。一致するフィールドのサブセットを指定し、フィールドごとに可能な値のリストを指定します。このトピックでは、App Runner イベントとイベントパターンの例を示します。

EventBridge ルールの作成の詳細については、「Amazon ユーザーガイド」の AWS 「 サービスのルールの作成」を参照してください。 EventBridge

注記

一部の サービスは、 で事前定義されたパターンをサポートしています EventBridge。これは、イベントパターンが作成される方法を簡素化します。フォームでフィールド値を選択すると、 によってパターン EventBridge が生成されます。現時点では、App Runner は事前定義されたパターンをサポートしていません。パターンを JSON オブジェクトとして入力する必要があります。このトピックの例を開始点として使用できます。

App Runner イベントの例

以下は、App Runner が に送信するイベントの例です EventBridge。

  • サービスステータス変更イベント。具体的には、 から RUNNINGステータスOPERATION_IN_PROGRESSに変更されたサービスです。

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

  • オペレーションステータス変更イベント。具体的には、正常に完了したUpdateServiceオペレーションです。

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

App Runner イベントパターンの例

次の例は、1 つ以上の App Runner イベントを照合するために EventBridge ルールで使用できるイベントパターンを示しています。イベントパターンはイベントに似ています。照合するフィールドのみを含め、それぞれにスカラーの代わりにリストを指定します。

  • 特定のアカウントのサービスのサービスステータス変更イベントのうち、サービスのステータスがなくなったものをすべて一致させますRUNNING。

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

  • オペレーションが失敗した特定のアカウントのサービスのオペレーションステータス変更イベントをすべて一致させます。

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

App Runner イベントリファレンス

サービスステータスの変更

サービスステータス変更イベントが にdetail-type設定されていますAppRunner Service Status Change。これには、次の詳細フィールドと値があります。

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

オペレーションステータスの変更

オペレーションステータス変更イベントが にdetail-type設定されていますAppRunner Service Operation Status Change。これには、次の詳細フィールドと値があります。

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

次の表に、考えられるすべてのステータスコードと関連するメッセージを示します。

ステータス メッセージ

CreateServiceStarted

サービスの作成が開始されました。

CreateServiceCompletedSuccessfully

サービスの作成が正常に完了しました。

CreateServiceFailed

サービスの作成に失敗しました。詳細については、「 サービスログ」を参照してください。

DeleteServiceStarted

サービスの削除が開始されました。

DeleteServiceCompletedSuccessfully

サービスの削除が正常に完了しました。

DeleteServiceFailed

サービスの削除に失敗しました。

UpdateServiceStarted

UpdateServiceCompletedSuccessfully

サービスの更新が正常に完了しました。新しいアプリケーションと設定がデプロイされます。

サービスの更新が正常に完了しました。新しい設定がデプロイされます。

UpdateServiceFailed

サービスの更新に失敗しました。詳細については、「 サービスログ」を参照してください。

DeploymentStarted

デプロイが開始されました。

DeploymentCompletedSuccessfully

デプロイが正常に完了しました。

DeploymentFailed

デプロイに失敗しました。詳細については、「 サービスログ」を参照してください。

PauseServiceStarted

サービスの一時停止が開始されました。

PauseServiceCompletedSuccessfully

サービスの一時停止は正常に完了しました。

PauseServiceFailed

サービスの一時停止に失敗しました。

ResumeServiceStarted

サービス再開が開始されました。

ResumeServiceCompletedSuccessfully

サービス再開は正常に完了しました。

ResumeServiceFailed

サービス再開に失敗しました。