Greengrass 커넥터 시작하기(콘솔)

AWS Secrets Manager 콘솔에 로그인합니다.

Store a new secret(새 보안 암호 저장)을 선택합니다.

암호 유형 선택에서 다른 암호 유형을 선택합니다.

이 비밀에 저장할 키/값 쌍 지정의 일반 텍스트 탭에 Twilio 인증 토큰을 입력하십시오. JSON 형식 지정을 모두 제거하고 토큰 값만 입력합니다.

암호화 키로 aws/secretsmanager가 선택된 상태를 유지하고 다음을 선택합니다.

Secret name(보안 암호 이름)에 greengrass-TwilioAuthToken을 입력한 후 다음을 선택합니다.

이 자습서에서는 교체할 필요가 없으므로 자동 교체 비활성화를 선택하고 다음을 선택합니다.

Review(검토) 페이지에서 설정을 검토한 다음 Store(저장)를 선택합니다.

이제 해당 암호를 참조하는 암호 리소스를 Greengrass 그룹에 생성합니다.

AWS IoT 콘솔 탐색 창의 관리에서 Greengrass 디바이스를 확장한 다음 그룹(V1)을 선택합니다.

암호 리소스를 추가할 그룹을 선택합니다.

그룹 구성 페이지에서 리소스 탭을 선택한 다음 비밀 섹션까지 아래로 스크롤합니다. 비밀 섹션에 그룹에 속하는 비밀 리소스가 표시됩니다. 이 섹션에서 암호 리소스를 추가, 편집, 제거할 수 있습니다.

비밀 섹션에서 추가를 선택합니다.

비밀 리소스 추가 페이지에서 리소스 이름으로 MyTwilioAuthToken을(를) 입력합니다.

비밀로 greengrass-TwilioAuthToken을 선택하세요.

레이블 선택(선택 사항) 섹션에서 AWSCURRENT 스테이징 레이블은 비밀의 최신 버전을 나타냅니다. 이 레이블은 암호 리소스에 항상 포함되어 있습니다.

리소스 추가를 선택합니다.

그룹 구성 페이지에서 커넥터를 선택한 다음 커넥터 추가를 선택합니다.

커넥터 추가 페이지에서 Twilio 알림을 선택합니다.

버전을 선택합니다.

구성 섹션에서:

리소스 추가를 선택합니다.

AWS IoT Greengrass 코어 SDK 다운로드 페이지에서 Python용 AWS IoT Greengrass 코어 SDK를 다운로드합니다.

다운로드한 패키지의 압축을 풀어 SDK를 가져옵니다. SDK는 greengrasssdk 폴더입니다.

temp_monitor.py이라는 로컬 파일에 다음과 같은 Python 코드 함수를 저장합니다.

import greengrasssdk
import json
import random

client = greengrasssdk.client('iot-data')

# publish to the Twilio Notifications connector through the twilio/txt topic
def function_handler(event, context):
    temp = event['temperature']
    
    # check the temperature
    # if greater than 30C, send a notification
    if temp > 30:
        data = build_request(event)
        client.publish(topic='twilio/txt', payload=json.dumps(data))
        print('published:' + str(data))
        
    print('temperature:' + str(temp))
    return

# build the Twilio request from the input data
def build_request(event):
    to_name = event['to_name']
    to_number = event['to_number']
    temp_report = 'temperature:' + str(event['temperature'])

    return {
        "request": {
            "recipient": {
                "name": to_name,
                "phone_number": to_number,
                "message": temp_report
            }
        },
        "id": "request_" + str(random.randint(1,101))
    }

다음 항목을 temp_monitor_python.zip라는 파일로 압축합니다. ZIP 파일을 만들 때 상위 폴더가 아닌 코드 및 종속성만 포함합니다.

이것이 Lambda 함수 배포 패키지입니다.

먼저, Lambda 함수를 생성합니다.

1. AWS Management Console에서 [Services]를 선택한 다음 AWS Lambda 콘솔을 엽니다.

2. 함수 생성을 선택한 다음 새로 작성을 선택합니다.

3. 기본 정보 섹션에서 다음 값을 사용합니다.

   • [함수 이름(Function name)]에 TempMonitor을 입력합니다.

   • 실행 시간에서 Python 3.7을 선택합니다.

   • 권한의 경우, 기본 설정을 유지합니다. 이를 통해 기본 Lambda 권한을 부여하는 실행 역할을 생성합니다. 이 역할은 AWS IoT Greengrass에서 사용되지 않습니다.

4. 페이지 하단에서 함수 생성을 선택합니다.

이제 핸들러를 등록하고 Lambda 함수 배포 패키지를 업로드합니다.

1. 코드 탭의 코드 소스에서 다음에서 업로드를 선택합니다. 드롭다운에서 .zip 파일을 선택합니다.

   

2. 업로드를 선택한 다음 temp_monitor_python.zip 배포 패키지를 선택합니다. 그런 다음 저장(Save)을 선택합니다.

3. 함수의 코드 탭에 있는 런타임 설정에서 편집을 선택하고 다음 값을 입력합니다.

   • 실행 시간에서 Python 3.7을 선택합니다.

   • 핸들러에 temp_monitor.function_handler를 입력합니다.

4. Save를 선택합니다.

   참고

   AWS Lambda 콘솔의 테스트 버튼은 이 함수와 함께 작동하지 않습니다. AWS IoT Greengrass 코어 SDK에는 AWS Lambda 콘솔에서 Greengrass Lambda 함수를 독립적으로 실행하는 데 필요한 모듈이 포함되어 있지 않습니다. 이러한 모듈(예: greengrass_common)은 Greengrass 코어에 배포된 후 함수에 제공됩니다.

이제 Lambda 함수의 첫 번째 버전을 게시하고 버전의 별칭을 생성합니다.

1. [Actions] 메뉴에서 [Publish new revision]을 선택합니다.

2. 버전 설명에 First version을 입력한 후 게시를 선택합니다.

3. TempMonitor: 1 구성 페이지의 작업 메뉴에서 별칭 생성을 선택합니다.

4. [Create a new alias] 페이지에서 다음 값을 사용합니다.

   • 이름(Name)에 GG_TempMonitor을 입력합니다.

   • 버전에서 1을 선택합니다.

   참고

   AWS IoT Greengrass은(는) $LATEST 버전에서 Lambda 별칭을 지원하지 않습니다.

5. 생성을 선택합니다.

그룹 구성 페이지에서 Lambda 함수 탭을 선택합니다.

내 Lambda 함수에서 추가를 선택합니다.

Lambda 함수 추가 페이지에서 Lambda 함수에 대한 TempMonitor를 선택합니다.

Lambda 함수 버전의 경우 Alias: GG_TempMonitor를 선택합니다.

Lambda 함수 추가를 선택합니다.

그룹 구성 페이지에서 구독을 선택한 다음 구독 추가를 선택합니다.

구독 생성 페이지에서 다음과 같이 원본과 대상을 구성합니다.

1. 소스 유형에서 Lambda 함수를 선택한 다음 TempMonitor를 선택합니다.

2. 대상 유형에서 커넥터를 선택한 다음 Twilio 알림을 선택합니다.

주제 필터의 경우 twilio/txt를 선택합니다.

구독 생성을 선택합니다.

1~4단계를 반복하여 AWS IoT에서 함수에 메시지를 게시하도록 허용하는 구독을 생성합니다.

1. 소스 유형의 경우 서비스를 선택한 다음 IoT Cloud를 선택합니다.

2. 대상 선택에서 Lambda 함수를 선택한 다음 TempMonitor를 선택합니다.

3. 주제 필터에 temperature/input을 입력합니다.

1~4단계를 반복하여 커넥터가 AWS IoT에 메시지를 게시하도록 허용하는 구독을 생성합니다.

1. 소스 유형에서 커넥터를 선택한 다음 Twilio 알림을 선택합니다.

2. 대상 유형에서 서비스를 선택한 다음 IoT Cloud를 선택합니다.

3. 주제 필터에 twilio/message/status가 입력됩니다. 이것은 커넥터가 게시하는 미리 정의된 주제입니다.

AWS IoT Greengrass 코어가 실행 중인지 확인합니다. 필요한 경우 Raspberry Pi 터미널에서 다음 명령을 실행합니다.

1. 데몬이 실행 중인지 확인하려면:

   ps aux | grep -E 'greengrass.*daemon'

   출력에 root에 대한 /greengrass/ggc/packages/ggc-version/bin/daemon 입력이 포함되어 있는 경우에는 데몬이 실행 중인 것입니다.

   참고

   경로의 버전은 코어 디바이스에 설치된 AWS IoT Greengrass 코어 소프트웨어 버전에 따라 다릅니다.

2. 데몬을 시작하려면:

   cd /greengrass/ggc/core/
   sudo ./greengrassd start

그룹 구성 페이지에서 배포를 선택합니다.

1. Lambda 함수 탭의 시스템 Lambda 함수 섹션에서 IP 감지기를 선택하고 편집을 선택합니다.

2. IP 감지기 설정 편집 대화 상자에서 MQTT 브로커 엔드포인트 자동 탐지 및 재정의를 선택합니다.

3. Save를 선택합니다.

   이렇게 하면 디바이스가 IP 주소, DNS, 포트 번호 등 코어의 연결 정보를 자동으로 획득할 수 있습니다. 자동 탐지가 바람직하지만 AWS IoT Greengrass은(는) 수동으로 지정된 엔드포인트도 지원합니다. 그룹이 처음 배포될 때만 검색 방법 메시지가 표시됩니다.

   참고

   메시지가 표시되면 Greengrass 서비스 역할을 생성할 권한을 부여하고 이 권한을 현재 AWS 리전의 AWS 계정과 연결합니다. 이 역할은 AWS IoT Greengrass가 AWS 서비스의 리소스에 액세스할 수 있습니다.

   배포 페이지에 배포 타임스탬프, 버전 ID, 상태가 표시됩니다. 완료되면 배포에 대해 성공적으로 완료했습니다 상태가 표시되어야 합니다.

   문제 해결에 대한 도움말은 AWS IoT Greengrass 문제 해결 단원을 참조하십시오.

AWS IoT 홈 페이지에서 테스트를 선택합니다.

구독에서 다음 값을 사용한 다음 주제 구독을 선택합니다. Twilio Notifications 커넥터는 이 주제에 상태 정보를 게시합니다.

주제 게시에서 다음 값을 사용한 후 게시를 선택하여 함수를 간접 호출합니다.

{
   "to_name": "recipient-name",
   "to_number": "recipient-phone-number",
   "temperature": 31
}

성공하면 수신자가 문자 메시지를 수신하고 콘솔에 출력 데이터의 success 상태가 표시됩니다.

이제 입력 메시지에서 temperature를 29로 변경하고 게시합니다. 이 값이 30보다 작기 때문에 TempMonitor 기능이 Twilio 메시지를 트리거하지 않습니다.