배포 알림 받기 - AWS IoT Greengrass

다음에 대한 설명서를 보고 있습니다.AWS IoT Greengrass Version 1.AWS IoT Greengrass Version 2의 최신 주요 버전입니다AWS IoT Greengrass. 사용에 관한 자세한 내용은 단원을 참조하십시오.AWS IoT Greengrass V2에 대한 자세한 내용은AWS IoT Greengrass Version 2개발자 안내서.

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

배포 알림 받기

Amazon EventBridge 이벤트 규칙은 Greengrass 그룹 배포의 상태 변경에 대한 알림을 제공합니다. EventBridge 는 시스템 이벤트의 스트림을 거의 실시간으로 제공합니다. 이는AWS있습니다.AWS IoT Greengrass에서 이러한 이벤트를 EventBridge최소 한 번 이상기준. 이는 것을 의미합니다.AWS IoT Greengrass는 전달을 보장하기 위해 지정된 이벤트의 복사본을 여러 개 보낼 수 있습니다. 또한 이벤트 리스너는 반드시 이벤트가 발생한 순서로 수신하지 않을 수 있습니다.

참고

Amazon EventBridge 는 애플리케이션을 다양한 소스의 데이터와 연결하는 데 사용할 수 있는 이벤트 버스 서비스입니다.Greengrass 코어 디바이스배포 알림과 함께 사용합니다. 자세한 내용은 단원을 참조하십시오.Amazon EventBridge 란 무엇입니까?Amazon EventBridge 사용 설명서.

AWS IoT Greengrass는 그룹 배포 상태가 변경될 때 이벤트를 발생시킵니다. 모든 상태 전환 또는 지정한 상태 전환에 대해 실행하는 EventBridge 규칙을 생성할 수 있습니다. 배포가 규칙을 시작하는 상태로 전환되면 EventBridge 는 규칙에 정의된 대상 작업을 호출합니다. 이렇게 하면 알림을 전송하고, 이벤트 정보를 캡처하고, 적절한 조치를 취하거나, 상태 변경에 대응하는 기타 이벤트를 시작할 수 있습니다. 예를 들면, 다음 사용 사례에 대한 규칙을 생성할 수 있습니다.

  • 자산 다운로드 및 담당자 알림 전송과 같은 배포 후 작업 시작

  • 배포 성공 또는 실패 시 알림 보내기

  • 배포 이벤트에 대한 사용자 지정 지표 게시

AWS IoT Greengrass는 배포가 다음 상태 Building, InProgress, SuccessFailure로 전환될 때 이벤트를 발생시킵니다.

참고

대량 배포 작업 상태를 모니터링하는 기능은 현재 지원되지 않습니다. 하지만 AWS IoT Greengrass는 대량 배포에 포함된 개별 그룹 배포의 상태 변경 이벤트를 발생시킵니다.

그룹 배포 상태 변경 이벤트

배포 상태 변경에 대한 이벤트에서 사용하는 형식은 다음과 같습니다.

{ "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코어. 자세한 정보는 배포 재설정을 참조하십시오.

  • ForceResetDeployment. 에 저장된 배포 정보를 삭제합니다.AWS 클라우드그리고 코어 대응을 대기하지 않고 성공을 보고합니다. 코어가 연결되었거나 다음에 연결할 때 코어에 저장된 배포 정보도 삭제합니다.

배포 상태
  • Building - AWS IoT Greengrass가 그룹 구성을 검증하고 배포 아티팩트를 빌드합니다.

  • InProgress. 배포가 에서 진행 중입니다.AWS IoT Greengrass코어.

  • Success. 배포가 성공했습니다.

  • Failure. 배포가 실패했습니다.

이벤트가 중복되거나 이벤트 순서가 잘못되었을 수 있습니다. 이벤트 순서를 정하려면 time 속성을 사용하십시오.

참고

AWS IoT Greengrass에서는 resources 속성이 사용되지 않으므로 항상 비어 있습니다.

EventBridge 규칙 생성을 위한 사전 조건

에 대한 EventBridge 규칙을 생성하기 전에AWS IoT Greengrass에서 다음을 수행합니다.

  • 이벤트, 규칙 및 대상을 익히십시오.

  • EventBridge 규칙에서 호출된 대상을 생성하고 구성합니다. 규칙은 다음을 비롯한 다양한 유형의 대상을 호출합니다.

    • Amazon Simple Notification Service (Amazon SNS)

    • AWS Lambda 함수

    • Amazon Kinesis Video Streams

    • Amazon Simple Queue Service(Amazon SQS) 대기열

자세한 내용은 단원을 참조하십시오.Amazon EventBridge 란 무엇입니까?Amazon EventBridge 시작하기Amazon EventBridge 사용 설명서.

배포 알림 구성(콘솔)

다음 단계를 사용하여 그룹의 배포 상태가 변경될 때 Amazon SNS 주제를 게시하는 EventBridge 규칙을 생성합니다. 이렇게 하면 웹 서버, 이메일 주소 및 기타 주제 구독자가 이벤트에 대응할 수 있습니다. 자세한 내용은 단원을 참조하십시오.이벤트에서 트리거되는 EventBridge 규칙 생성AWS리소스Amazon EventBridge 사용 설명서.

  1. 열기Amazon EventBridge 콘솔를 선택하고규칙 생성.

  2. 이름 및 설명에 규칙의 이름과 설명을 입력합니다.

  3. 패턴 정의에서 규칙 패턴을 구성합니다.

    1. [Event pattern]을 선택합니다.

    2. Pre-defined pattern by service(서비스별 사전 정의된 패턴)을 선택하십시오.

    3. Service provider(서비스 제공업체)에 대해 AWS를 선택하십시오.

    4. 서비스 이름에서 Greengrass를 선택합니다.

    5. 이벤트 유형에에서 Greengrass 배포 상태 변경을 선택합니다.

      참고

      AWSCloudTrail 통한 API 호출이벤트 유형은AWS IoT Greengrass를 와 통합AWS CloudTrail. 이 옵션을 사용하여 읽기 또는 쓰기 호출에 의해 시작되는 규칙을 생성할 수 있습니다.AWS IoT GreengrassAPI. 자세한 정보는 AWS CloudTrail를 사용하여 AWS IoT Greengrass API 호출 로깅을 참조하십시오.

    6. 알림을 시작하는 배포 상태를 선택합니다.

      • 모든 상태 변경 이벤트에 대한 알림을 받으려면 모든 상태를 선택합니다.

      • 일부 상태 변경 이벤트에 대해서만 알림을 받으려면 특정 상태를 선택한 다음 대상 상태를 선택합니다.

    7. 알림을 시작하는 배포 유형을 선택합니다.

      • 모든 배포 유형에 대한 알림을 받으려면 모든 상태를 선택합니다.

      • 일부 배포 유형에 대해서만 알림을 받으려면 특정 상태를 선택한 다음 대상 배포 유형을 선택합니다.

  4. 이벤트 버스 선택에서 기본 이벤트 버스 옵션을 유지합니다.

  5. 대상 선택에서 대상을 구성합니다. 이 예에서는 Amazon SNS 주제를 사용하지만 알림을 보내도록 다른 대상 유형을 구성할 수 있습니다.

    1. 대상에서 SNS 주제를 선택합니다.

    2. 주제에서 대상 주제를 선택합니다.

    3. 대상 추가를 선택합니다.

  6. 태그 - 선택 사항에서 규칙에 대한 태그를 정의하거나 필드를 비워 둡니다.

  7. 생성을 선택합니다.

배포 알림 구성(CLI)

다음 단계를 사용하여 그룹의 배포 상태가 변경될 때 Amazon SNS 주제를 게시하는 EventBridge 규칙을 생성합니다. 이렇게 하면 웹 서버, 이메일 주소 및 기타 주제 구독자가 이벤트에 대응할 수 있습니다.

  1. 규칙을 생성합니다.

    • Replacegroup-id의 ID로 바꾸십시오.AWS IoT Greengrass그룹

    aws events put-rule \ --name TestRule \ --event-pattern "{\"source\": [\"aws.greengrass\"], \"detail\": {\"group-id\": [\"group-id\"]}}"

    패턴에서 생략된 속성은 무시됩니다.

  2. 규칙 대상으로 주제를 추가합니다.

    • Replace주제-ARNAmazon SNS 주제의 ARN 에 게시합니다.

    aws events put-targets \ --rule TestRule \ --targets "Id"="1","Arn"="topic-arn"
    참고

    Amazon EventBridge 가 대상 주제를 호출하게 하려면 주제에 리소스 기반의 정책을 추가해야 합니다. 자세한 내용은 단원을 참조하십시오.Amazon SNS 권한Amazon EventBridge 사용 설명서.

자세한 내용은 단원을 참조하십시오.이벤트 브리지의 이벤트 및 이벤트 패턴Amazon EventBridge 사용 설명서.

배포 알림 구성(AWS CloudFormation)

사용AWS CloudFormation템플릿을 사용하여 Greengrass 그룹 배포의 상태 변경에 대한 알림을 보내는 EventBridge 규칙을 만듭니다. 자세한 내용은 단원을 참조하십시오.Amazon EventBridge resource type referenceAWS CloudFormation사용 설명서.

다음 사항도 참조하세요.