Greengrass 커넥터 시작하기(CLI)

먼저 보안 암호를 만듭니다.

aws secretsmanager create-secret --name greengrass-TwilioAuthToken --secret-string twilio-auth-token

출력에서 보안 암호의 ARN을 복사합니다. 이 정보를 사용하여 암호 리소스를 생성하고 Twilio Notifications 커넥터를 구성합니다.

최초 버전이 포함된 리소스 정의를 생성합니다.

출력에서 리소스 정의의 LatestVersionArn을 복사합니다. 이 값을 사용하여 코어에 배포할 그룹 버전에 리소스 정의 버전을 추가합니다.

초기 버전을 사용하여 커넥터 정의를 생성합니다.

출력에서 커넥터 정의의 LatestVersionArn을 복사합니다. 이 값을 사용하여 코어에 배포할 그룹 버전에 커넥터 정의 버전을 추가합니다.

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 함수 배포 패키지입니다.

함수 생성 시 역할 ARN에서 전달할 수 있도록 IAM 역할을 생성합니다.

출력에서 Arn을 복사합니다.

AWS Lambda API를 사용하여 TempMonitor 함수를 생성합니다. 다음 명령은 zip 파일이 현재 디렉터리에 있다고 가정합니다.

aws lambda create-function \
--function-name TempMonitor \
--zip-file fileb://temp_monitor_python.zip \
--role role-arn \
--handler temp_monitor.function_handler \
--runtime python3.7

이 함수의 버전을 게시합니다.

aws lambda publish-version --function-name TempMonitor --description 'First version'

게시된 버전에 대한 별칭을 생성합니다.

Greengrass 그룹은 별칭(권장) 또는 버전을 기준으로 Lambda 함수를 참조할 수 있습니다. 별칭을 사용하면 함수 코드를 업데이트할 때 구독 테이블이나 그룹 정의를 변경할 필요가 없으므로 코드 업데이트를 더 쉽게 관리할 수 있습니다. 그 대신 새 함수 버전에 대한 별칭을 가리킵니다.

aws lambda create-alias --function-name TempMonitor --name GG_TempMonitor --function-version 1

출력에서 AliasArn을 복사합니다. 이 값은 AWS IoT Greengrass에 대한 함수를 구성할 때 그리고 구독을 생성할 때 사용합니다.

최초 버전이 포함된 함수 정의를 생성합니다.

출력에서 LatestVersionArn을 복사합니다. 이 값을 사용하여 코어에 배포할 그룹 버전에 함수 정의 버전을 추가합니다.

출력에서 Id을 복사합니다. 이 값은 나중에 함수를 업데이트할 때 사용합니다.

구독이 포함된 초기 버전이 들어 있는 구독 정의를 생성합니다.

출력에서 LatestVersionArn을 복사합니다. 이 값을 사용하여 코어에 배포할 그룹 버전에 구독 정의 버전을 추가합니다.

그룹 및 최신 그룹 버전의 ID 가져오기:

1. 대상 Greengrass 그룹 및 그룹 버전의 ID를 확인합니다. 이 절차에서는 이것이 최신 그룹 및 그룹 버전이라고 가정합니다. 다음 쿼리는 가장 최근에 생성된 그룹을 반환합니다.

   aws greengrass list-groups --query "reverse(sort_by(Groups, &CreationTimestamp))[0]"

   또는 이름으로 쿼리할 수도 있습니다. 그룹 이름은 고유한 이름이 아니어도 되므로 여러 그룹을 반환할 수도 있습니다.

   aws greengrass list-groups --query "Groups[?Name=='MyGroup']"

   참고

   AWS IoT 콘솔에서도 이러한 값을 찾을 수 있습니다. 그룹 ID는 그룹의 설정 페이지에 표시됩니다. 그룹 버전 ID는 그룹의 배포 탭에 표시됩니다.

2. 출력에서 대상 그룹의 Id을 복사합니다. 이 값을 사용하여 그룹을 배포할 때 코어 정의 버전을 가져옵니다.

3. 그룹에 추가된 최신 버전의 ID가 되도록 출력에서 LatestVersion을 복사합니다. 이 값을 사용하여 코어 정의 버전을 가져옵니다.

코어 정의 버전의 ARN 가져오기:

1. 그룹 버전을 가져옵니다. 이 단계에서는 최신 그룹 버전에 코어 정의 버전이 포함되어 있다고 가정합니다.

   • group-id를 해당 그룹에서 복사한 Id로 바꿉니다.

   • group-version-id를 해당 그룹에서 복사한 LatestVersion으로 바꿉니다.

   aws greengrass get-group-version \
   --group-id group-id \
   --group-version-id group-version-id

2. 출력에서 CoreDefinitionVersionArn을 복사합니다.

그룹 버전을 만듭니다.

aws greengrass create-group-version \
--group-id group-id \
--core-definition-version-arn core-definition-version-arn \
--resource-definition-version-arn resource-definition-version-arn \
--connector-definition-version-arn connector-definition-version-arn \
--function-definition-version-arn function-definition-version-arn \
--subscription-definition-version-arn subscription-definition-version-arn

출력에서 Version 값을 복사합니다. 이것이 그룹 버전의 ID입니다. 이 값을 사용하여 그룹 버전을 배포합니다.

코어 디바이스 터미널에서 AWS IoT Greengrass 데몬이 실행 중인지 확인합니다.

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

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

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

2. 데몬을 시작하려면:

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

배포를 생성합니다.

aws greengrass create-deployment \
--deployment-type NewDeployment \
--group-id group-id \
--group-version-id group-version-id

출력에서 DeploymentId을 복사합니다.

배포 상태를 가져옵니다.

aws greengrass get-deployment-status \
--group-id group-id \
--deployment-id deployment-id

상태가 Success이면, 배포에 성공한 것입니다. 문제 해결에 대한 도움말은 AWS IoT Greengrass 문제 해결 단원을 참조하십시오.

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

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

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

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

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

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