EventBridge에서 App Runner 이벤트 처리

포커스 모드

EventBridge에서 App Runner 이벤트 처리 - AWS App Runner

App Runner 이벤트에 대한 EventBridge 규칙 생성 App Runner 이벤트 예제 App Runner 이벤트 패턴 예제 App Runner 이벤트 참조

Amazon EventBridge를 사용하면 특정 패턴에 대해 AWS App Runner 서비스의 실시간 데이터 스트림을 모니터링하는 이벤트 기반 규칙을 설정할 수 있습니다. 규칙의 패턴이 일치하면 EventBridge는 AWS Lambda Amazon ECS AWS Batch및 Amazon SNS와 같은 대상에서 작업을 시작합니다. 예를 들어 서비스에 대한 배포가 실패할 때마다 Amazon SNS 주제에 신호를 보내 이메일 알림을 보내는 규칙을 설정할 수 있습니다. 또는 서비스 업데이트가 실패할 때마다 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 EventBridge 사용 설명서의 서비스에 대한 AWS 규칙 생성을 참조하세요.

참고

일부 서비스는 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 이벤트 패턴 예제

다음 예제에서는 EventBridge 규칙에서 하나 이상의 App Runner 이벤트를 일치시키는 데 사용할 수 있는 이벤트 패턴을 보여줍니다. 이벤트 패턴은 이벤트와 유사합니다. 일치시킬 필드만 포함하고 각 필드에 스칼라 대신 목록을 제공합니다.

서비스가 더 이상 상태가 아닌 특정 계정의 서비스에 대한 모든 서비스 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`	서비스 업데이트가 성공적으로 완료되었습니다. 새 애플리케이션 및 구성이 배포됩니다.
`UpdateServiceCompletedSuccessfully`	서비스 업데이트가 성공적으로 완료되었습니다. 새 구성이 배포됩니다.
`UpdateServiceFailed`	서비스 업데이트에 실패했습니다. 자세한 내용은 서비스 로그를 참조하세요.
`DeploymentStarted`	배포가 시작되었습니다.
`DeploymentCompletedSuccessfully`	배포가 성공적으로 완료되었습니다.
`DeploymentFailed`	배포에 실패했습니다. 자세한 내용은 서비스 로그를 참조하세요.
`PauseServiceStarted`	서비스 일시 중지가 시작되었습니다.
`PauseServiceCompletedSuccessfully`	서비스 일시 중지가 성공적으로 완료되었습니다.
`PauseServiceFailed`	서비스 일시 중지에 실패했습니다.
`ResumeServiceStarted`	서비스 재개가 시작되었습니다.
`ResumeServiceCompletedSuccessfully`	서비스 재개가 성공적으로 완료되었습니다.
`ResumeServiceFailed`	서비스 재개에 실패했습니다.