지원 종료 공지: 2026년 10월 7일에는에 대한 지원을 중단할 AWS 예정입니다 AWS IoT Greengrass Version 1. 2026년 10월 7일 이후에는 더 이상 AWS IoT Greengrass V1 리소스에 액세스할 수 없습니다. 자세한 내용은 [에서 마이그레이션 AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html)을 참조하세요.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 배포 알림 받기
Amazon EventBridge 이벤트 규칙을 사용하여 Greengrass 그룹 배포의 상태 변경에 대한 알림을 받을 수 있습니다. EventBridge는 AWS 리소스의 변경 사항을 설명하는 시스템 이벤트의 스트림을 거의 실시간으로 제공합니다.는 이러한 이벤트를 EventBridge에 *한 번 이상* AWS IoT Greengrass 전송합니다. 즉,는 전송을 보장하기 위해 지정된 이벤트의 사본을 여러 개 전송할 AWS IoT Greengrass 수 있습니다. 또한 이벤트 리스너는 이벤트가 발생한 순서대로 이벤트를 수신하지 못할 수 있습니다.
**참고**
Amazon EventBridge는 애플리케이션을 [Greengrass 코어 장치](telemetry.md) 및 배포 알림과 같이 다양한 소스의 데이터와 연결하는 데 사용할 수 있는 이벤트 버스 서비스입니다. 자세한 내용은 *Amazon EventBridge 사용 설명서*의 [Amazon EventBridge란?](https://docs.aws.amazon.com/eventbridge/latest/userguide/what-is-amazon-eventbridge.html) 섹션을 참조하세요.
AWS IoT Greengrass 는 그룹 배포 상태가 변경될 때 이벤트를 내보냅니다. 모든 상태 전환 또는 지정한 상태로의 전환에 대해 실행하는 EventBridge 규칙을 생성할 수 있습니다. 배포가 규칙을 트리거하는 상태로 전환되면 EventBridge는 규칙에 정의된 대상 작업을 간접 호출합니다. 이렇게 하면 알림을 전송하고, 이벤트 정보를 캡처하고, 적절한 조치를 취하거나, 상태 변경에 대응하는 기타 이벤트를 시작할 수 있습니다. 예를 들어 다음 사용 사례에 대한 규칙을 생성할 수 있습니다.
+ 자산 다운로드 및 담당자 알림 전송과 같은 배포 후 작업을 트리거합니다.
+ 배포 성공 또는 실패 시 알림 보내기
+ 배포 이벤트에 대한 사용자 지정 지표 게시
AWS IoT Greengrass 는 배포가 `Building`, `InProgress`, 및 상태가 `Success`되면 이벤트를 내보냅니다`Failure`.
**참고**
[대량 배포](bulk-deploy-cli.md) 작업 상태를 모니터링하는 기능은 현재 지원되지 않습니다. 그러나는 대량 배포의 일부인 개별 그룹 배포에 대한 상태 변경 이벤트를 AWS IoT Greengrass 내보냅니다.
## 그룹 배포 상태 변경 이벤트
배포 상태 변경에 대한 [이벤트](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/CloudWatchEventsandEventPatterns.html)에서 사용하는 형식은 다음과 같습니다.
```
{
"version":"0",
"id":" cd4d811e-ab12-322b-8255-EXAMPLEb1bc8",
"detail-type":"Greengrass Deployment Status Change",
"source":"aws.greengrass",
"account":"123456789012",
"time":"2018-03-22T00:38:11Z",
"region":"us-west-2",
"resources":[],
"detail":{
"group-id": "284dcd4e-24bc-4c8c-a770-EXAMPLEf03b8",
"deployment-id": "4f38f1a7-3dd0-42a1-af48-EXAMPLE09681",
"deployment-type": "NewDeployment|Redeployment|ResetDeployment|ForceResetDeployment",
"status": "Building|InProgress|Success|Failure"
}
}
```
하나 이상의 그룹에 적용할 규칙을 생성할 수 있습니다. 다음 배포 유형과 배포 상태 중 하나로 규칙을 필터링할 수 있습니다.
**배포 유형**
+ `NewDeployment`. 그룹 버전의 최초 배포.
+ `ReDeployment`. 그룹 버전의 재배포.
+ `ResetDeployment`. AWS 클라우드 및 AWS IoT Greengrass 코어에 저장된 배포 정보를 삭제합니다. 자세한 내용은 [배포 재설정](reset-deployments-scenario.md) 단원을 참조하십시오.
+ `ForceResetDeployment`. AWS 클라우드 에 저장된 배포 정보를 삭제하며, 코어 대응을 대기하지 않고 성공을 보고합니다. 코어가 연결되었거나 다음에 연결할 때 코어에 저장된 배포 정보도 삭제합니다.
**배포 상태**
+ `Building`. AWS IoT Greengrass 는 그룹 구성을 검증하고 배포 아티팩트를 빌드합니다.
+ `InProgress`. AWS IoT Greengrass 코어에서 배포가 진행 중입니다.
+ `Success`. 배포가 성공했습니다.
+ `Failure`. 배포가 실패했습니다.
이벤트가 중복되거나 이벤트 순서가 잘못되었을 수 있습니다. 이벤트 순서를 정하려면 `time` 속성을 사용하세요.
**참고**
AWS IoT Greengrass 는 `resources` 속성을 사용하지 않으므로 항상 비어 있습니다.
## EventBridge 규칙 생성을 위한 사전 조건
에 대한 EventBridge 규칙을 생성하기 전에 다음을 AWS IoT Greengrass수행합니다.
+ Eventbridge의 이벤트, 규칙, 대상을 숙지해야 합니다.
+ EventBridge 규칙에 의해 간접 호출되는 대상을 생성하고 구성해야 합니다. 규칙은 다음을 비롯한 다양한 유형의 대상을 간접 호출할 수 있습니다.
+ Amazon Simple Notification Service(Amazon SNS)
+ AWS Lambda 함수
+ Amazon Kinesis Video Streams
+ Amazon Simple Queue Service(Amazon SQS) 대기열
자세한 내용은 *Amazon EventBridge 사용 설명서*의 [Amazon EventBridge란?](https://docs.aws.amazon.com/eventbridge/latest/userguide/what-is-amazon-eventbridge.html) 및 [Amazon EventBridge 시작하기](https://docs.aws.amazon.com/eventbridge/latest/userguide/eventbridge-getting-set-up.html) 섹션을 참조하세요.
## 배포 알림 구성(콘솔)
다음 단계를 사용하여 그룹의 배포 상태가 변경될 때 Amazon SNS 주제를 게시하는 EventBridge 규칙을 생성합니다. 이렇게 하면 웹 서버, 이메일 주소 및 기타 주제 구독자가 이벤트에 대응할 수 있습니다. 자세한 내용은 Amazon [ EventBridge 사용 설명서의 AWS 리소스에서 이벤트를 트리거하는 EventBridge 규칙 생성을](https://docs.aws.amazon.com/eventbridge/latest/userguide/create-eventbridge-rule.html) 참조하세요. * EventBridge *
1. [Amazon EventBridge 콘솔](https://console.aws.amazon.com/events/)을 엽니다.
1. 탐색 창에서 **규칙**을 선택합니다.
1. **규칙 생성**을 선택합니다.
1. 규칙에 대해 이름과 설명을 입력하세요.
규칙은 동일한 리전과 동일한 이벤트 버스의 다른 규칙과 동일한 이름을 가질 수 없습니다.
1. **이벤트 버스**에서 이 규칙과 연결할 이벤트 버스를 선택합니다. 이 규칙이 자신의 계정에서 발생하는 이벤트와 일치하도록 하려면 **AWS 기본 이벤트 버스(default event bus)**를 선택합니다. 계정의 AWS 서비스가 이벤트를 내보내면 항상 계정의 기본 이벤트 버스로 이동합니다.
1. **규칙 유형(Rule type)**에서 **이벤트 패턴이 있는 규칙(Rule with an event pattern)**을 생성합니다.
1. **다음**을 선택합니다.
1. **이벤트 소스**에서 **AWS 서비스**를 선택합니다.
1. **이벤트 패턴**의 경우, **AWS 서비스**를 선택합니다.
1. **AWS 서비스 이름**에서 Greengrass를 선택합니다.
1. **이벤트 유형에**에서 **Greengrass 배포 상태 변경**을 선택합니다.
**참고**
**AWS CloudTrail 이벤트 유형을 통한 API 호출**은 와의 AWS IoT Greengrass 통합을 기반으로 합니다 AWS CloudTrail. 이 옵션을 사용하여 AWS IoT Greengrass API에 대한 읽기 또는 쓰기 호출로 시작된 규칙을 생성할 수 있습니다. 자세한 내용은 [를 사용하여 AWS IoT Greengrass API 호출 로깅 AWS CloudTrail](logging-using-cloudtrail.md) 단원을 참조하십시오.
1. 알림을 트리거하는 배포 상태를 선택합니다.
+ 모든 상태 변경 이벤트에 대한 알림을 받으려면 **모든 상태**를 선택합니다.
+ 일부 상태 변경 이벤트에 대해서만 알림을 받으려면 **특정 상태**를 선택한 다음 대상 상태를 선택합니다.
1. 알림을 트리거하는 배포 유형을 선택합니다.
+ 모든 배포 유형에 대한 알림을 받으려면 **모든 상태**를 선택합니다.
+ 일부 배포 유형에 대해서만 알림을 받으려면 **특정 상태**를 선택한 다음 대상 배포 유형을 선택합니다.
1. **다음**을 선택합니다.
1. **대상 유형**에서 **AWS 서비스**를 선택합니다.
1. **대상 선택**에서 대상을 구성합니다. 이 예제에서는 Amazon SNS 주제를 사용하지만 알림을 보내도록 다른 대상 유형을 구성할 수 있습니다.
1. **대상**에서 **SNS 주제**를 선택합니다.
1. **주제**에서 대상 주제를 선택합니다.
1. **다음**을 선택합니다.
1. **태그**에서 규칙에 대한 태그를 정의하거나 필드를 비워 둡니다.
1. **다음**을 선택합니다.
1. 규칙의 세부 정보를 검토하고 **규칙 생성**을 선택합니다.
## 배포 알림 구성(CLI)
다음 단계를 사용하여 그룹의 배포 상태가 변경될 때 Amazon SNS 주제를 게시하는 EventBridge 규칙을 생성합니다. 이렇게 하면 웹 서버, 이메일 주소 및 기타 주제 구독자가 이벤트에 대응할 수 있습니다.
1. 규칙을 생성합니다.
+ *group-id*를 AWS IoT Greengrass 그룹 ID로 바꿉니다.
```
aws events put-rule \
--name TestRule \
--event-pattern "{\"source\": [\"aws.greengrass\"], \"detail\": {\"group-id\": [\"group-id\"]}}"
```
패턴에서 생략된 속성은 무시됩니다.
1. 규칙 대상으로 주제를 추가합니다.
+ *topic-arn*을 Amazon SNS 주제의 ARN으로 바꿉니다.
```
aws events put-targets \
--rule TestRule \
--targets "Id"="1","Arn"="topic-arn"
```
**참고**
Amazon EventBridge가 대상 주제를 호출하도록 허용하려면 주제에 리소스 기반 정책을 추가해야 합니다. 자세한 내용은 *Amazon EventBridge 사용 설명서*의 [Amazon SNS 권한](https://docs.aws.amazon.com/eventbridge/latest/userguide/resource-based-policies-eventbridge.html#sns-permissions) 섹션을 참조하세요.
자세한 내용은 *Amazon EventBridge 사용 설명서*에서 [EventBridge의 이벤트 및 이벤트 패턴](https://docs.aws.amazon.com/eventbridge/latest/userguide/eventbridge-and-event-patterns.html) 섹션을 참조하세요.
## 배포 알림 구성(CloudFormation)
CloudFormation 템플릿을 사용하여 Greengrass 그룹 배포의 상태 변경에 대한 알림을 보내는 EventBridge 규칙을 생성합니다. 자세한 내용은 **AWS CloudFormation 사용 설명서의 [Amazon EventBridge 리소스 유형 참조](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/AWS_Events.html)를 참조하세요.
## 다음 사항도 참조하세요.
+ [AWS IoT Greengrass 코어에 AWS IoT Greengrass 그룹 배포](deployments.md)
+ *Amazon EventBridge 사용 설명서*의 [Amazon EventBridge란?](https://docs.aws.amazon.com/eventbridge/latest/userguide/what-is-amazon-eventbridge.html) 섹션을 참조하세요.