기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Image Builder에서의 Amazon EventBridge 통합
<a name="integ-eventbridge"></a>

Amazon EventBridge는 Image Builder 애플리케이션을 다른 AWS 서비스의 관련 데이터와 연결하는 데 사용할 수 있는 서버리스 이벤트 버스 서비스입니다. EventBridge에서 규칙은 들어오는 이벤트에서 일치하는 것을 찾아서 대상으로 전송하여 처리합니다. 단일 규칙으로 이벤트를 여러 대상으로 전송할 수 있으며 이러한 이벤트는 병렬로 실행됩니다.

EventBridge를 사용하면를 자동화 AWS 서비스 하고 애플리케이션 가용성 문제 또는 리소스 변경과 같은 시스템 이벤트에 자동으로 대응할 수 있습니다. AWS 서비스 의 이벤트는 거의 실시간으로 EventBridge로 전송됩니다. 수신 이벤트에 반응하여 작업을 시작하는 규칙을 설정할 수 있습니다. 예를 들어, EC2 인스턴스의 상태가 보류 중에서 실행 중으로 변경될 때 Lambda 함수에 이벤트를 보내는 등의 작업을 시작할 수 있습니다. 이를 *패턴*이라고 합니다. 이벤트 패턴에 기반을 둔 규칙을 생성하는 방법에 대한 자세한 정보는 *Amazon EventBridge 사용 설명서*의 [이벤트에 대응하는 Amazon EventBridge 규칙 생성](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html)을 참조하세요.

자동으로 실행할 수 있는 작업은 다음과 같습니다.
+  AWS Lambda 함수 호출
+ Amazon EC2 Run Command 호출
+ Amazon Kinesis Data Streams로 이벤트 릴레이
+  AWS Step Functions 상태 시스템 활성화
+ Amazon SNS 주제 또는 Amazon SQS 대기열 알림

또한 Image Builder 파이프라인을 실행하여 분기별로 이미지를 새로 고치는 등의 작업을 정기적으로 수행하도록 기본 이벤트 버스에 대한 스케줄링 규칙을 설정할 수 있습니다. 일정 표현식에는 두 가지 유형이 있습니다.
+ **cron 표현식** - 다음은 UTC\$10 정오에 작업이 실행되도록 스케줄을 지정하는 cron 표현식 예제입니다.

  `cron(0 12 * * ? *)`

  EventBridge에서의 cron 표현식에 대한 자세한 정보는 *Amazon EventBridge 사용 설명서*의 [Cron 표현식](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html#eb-cron-expressions)을 참조하세요.
+ **rate 표현식** - rate 표현식의 다음 예는 12시간마다 작업이 실행되도록 스케줄링합니다.

  `rate(12 hour)`

  EvenBridge에서의 rate 표현식 사용에 대한 자세한 정보는 *Amazon EventBridge 사용 설명서*의 [rate 표현식](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html#eb-rate-expressions)을 참조하세요.

EventBridge 규칙이 Image Builder 이미지 파이프라인과 통합되는 방법에 대한 자세한 내용은 [Image Builder 파이프라인과 함께 EventBridge 규칙 사용](ev-rules-for-pipeline.md) 섹션을 참조하세요.

## Image Builder에서 보내는 이벤트 메시지
<a name="integ-eb-event-summary"></a>

Image Builder는 Image Builder 리소스의 상태가 크게 변경되면 EventBridge로 이벤트 메시지를 전송합니다. 예를 들어 이미지에 대한 상태가 변경된 경우입니다. 다음 예제에서는 Image Builder가 보낼 수 있는 일반적인 JSON 이벤트 메시지를 보여줍니다.

**Topics**
+ [EC2 Image Builder 이미지 상태 변경](#eb-event-state-change)
+ [EC2 Image Builder CVE 감지됨](#eb-event-cve-detected)
+ [EC2 Image Builder 워크플로 단계 대기](#eb-event-wf-step-waiting)
+ [EC2 Image Builder 이미지 파이프라인 자동 비활성화](#eb-event-pipeline-disabled)

### EC2 Image Builder 이미지 상태 변경
<a name="eb-event-state-change"></a>

Image Builder는 이미지 생성 중에 이미지 리소스의 상태가 변경될 때 이 이벤트를 전송합니다. 예를 들어 이미지 상태가 다음과 같이 한 상태에서 다른 상태로 변경되는 경우:
+ `building`에서 `testing`으로
+ `testing`에서 `distribution`으로
+ `testing`에서 `failed`으로
+ `integrating`에서 `available`으로

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

### EC2 Image Builder CVE 감지됨
<a name="eb-event-cve-detected"></a>

이미지에 대해 CVE 감지를 활성화한 경우 이미지 스캔이 완료될 때마다 Image Builder가 결과와 함께 메시지를 보냅니다.

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

### EC2 Image Builder 워크플로 단계 대기
<a name="eb-event-wf-step-waiting"></a>

Image Builder는 `WaitForAction` 워크플로 단계가 일시 중지되어 비동기 작업이 완료될 때까지 기다리는 메시지를 보냅니다.

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

### EC2 Image Builder 이미지 파이프라인 자동 비활성화
<a name="eb-event-pipeline-disabled"></a>

파이프라인에 `autoDisablePolicy` 대해를 구성한 경우 Image Builder는 파이프라인을 비활성화하고 예약된 연속 파이프라인 실행 실패 수가 정책당 허용되는 최대 수를 초과하면 이벤트 메시지를 EventBridge에 전송합니다.

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