AWS IoT Greengrass Version 1 2023년 6월 30일에 수명 연장 단계에 들어갔습니다. AWS IoT Greengrass V1 관리형 정책에 대한 자세한 정보는 섹션을 참조하세요. 이 날짜 이후에는 기능, 개선 사항, 버그 수정 또는 보안 패치를 제공하는 업데이트가 AWS IoT Greengrass V1 릴리스되지 않습니다. 에서 실행되는 기기는 AWS IoT Greengrass V1 중단되지 않으며 계속 작동하고 클라우드에 연결됩니다. 새로운 기능이 크게 추가되고 추가 플랫폼에 대한 지원이 추가되는 으로 마이그레이션하는 AWS IoT Greengrass Version 2 것이 좋습니다.

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

AWS IoT Greengrass 코어에서 Lambda 함수 실행

AWS IoT Greengrass은(는) 사용자가 AWS Lambda에 작성한 사용자 정의 코드를 위한 컨테이너화된 Lambda 런타임 환경을 제공합니다. AWS IoT Greengrass 코어에 배포된 Lambda 함수는 코어의 로컬 Lambda 런타임에서 실행됩니다. 로컬 Lambda 함수는 로컬 이벤트, 클라우드의 메시지 및 기타 소스에 의해 트리거가 가능하기 때문에 로컬 컴퓨팅 기능을 연결된 디바이스에 제공할 수 있습니다. 예를 들어 클라우드로 데이터를 전송하기 앞서 Lambda 함수를 사용해 디바이스 데이터를 필터링할 수 있습니다.

코어에 Lambda 함수를 배포하려면 Greengrass 그룹에 해당 함수를 추가하고(기존 Lambda 함수를 참조하여) 해당 함수에 대해 그룹별 설정을 구성한 다음, 그룹을 배포합니다. 함수가 AWS 서비스에 액세스하는 경우에는 Greengrass 그룹 역할에 필요한 모든 권한을 추가해야 합니다.

권한, 격리, 메모리 제한 등을 비롯해 Lambda 함수 실행 방법을 결정하는 파라미터를 구성할 수 있습니다. 자세한 설명은 그룹별 구성을 사용한 Lambda 함수 실행 제어 섹션을 참조하세요.

다음 표에는 지원되는 AWS Lambda 런타임 및 해당 런타임이 실행될 수 있는 AWS IoT Greengrass 코어 소프트웨어 버전이 나와 있습니다.

* 지원되는 버전의 AWS IoT Greengrass에서 이러한 런타임을 사용하는 Lambda 함수를 실행할 수 있지만 AWS Lambda에서 생성할 수는 없습니다. 디바이스의 런타임이 해당 함수에 지정된 AWS Lambda 런타임과 다른 경우 FunctionDefintionVersion의 FunctionRuntimeOverride을(를) 사용하여 자체 런타임을 선택할 수 있습니다. 자세한 내용은 을 참조하십시오 CreateFunctionDefinition. 지원되는 런타임에 대한 자세한 내용은 AWS Lambda 개발자 안내서의 런타임 지원 정책을 참조하십시오.

Greengrass Lambda 함수용 SDK

AWS는 AWS IoT Greengrass에서 실행되는 Lambda 함수에서 사용 가능한 SDK를 3개 제공합니다. 이 SDK는 서로 다른 패키지에 포함되어 있기 때문에 두 패키지를 동시에 사용할 수 있습니다. Lambda 함수에서 SDK를 사용하려면 에 업로드하는 Lambda 함수 배포 패키지AWS Lambda에 SDK를 포함시킵니다.

배포 패키지를 만드는 방법에 대한 자세한 내용은 시작하기 튜토리얼의 Lambda 함수 생성 및 패키징 또는 AWS Lambda 개발자 안내서의 배포 패키지 생성을 참조하십시오.

클라우드 기반 Lambda 함수 마이그레이션

AWS IoT Greengrass 코어 SDK는 AWS SDK 프로그래밍 모델을 따르기 때문에 클라우드를 위해 개발된 Lambda 함수를 AWS IoT Greengrass 코어에서 실행되는 Lambda 함수로 손쉽게 옮길 수 있습니다.

예를 들면 다음의 Python Lambda 함수는 AWS SDK for Python (Boto3)을 사용하여 클라우드의 some/topic 주제에 메시지를 게시합니다.

import boto3

iot_client = boto3.client("iot-data")
response = iot_client.publish(
    topic="some/topic", qos=0, payload="Some payload".encode()
)

AWS IoT Greengrass 코어에서 이 함수를 옮기려면 import 명령문 및 client 초기화에서 모듈 이름을 boto3에서 greengrasssdk(으)로 바꿉니다(다음 예제 참조).

import greengrasssdk

iot_client = greengrasssdk.client("iot-data")
iot_client.publish(topic="some/topic", qos=0, payload="Some payload".encode())

프로그래밍 모델 간의 유사성 덕분에 클라우드에서 Lambda 함수를 개발한 다음 최소한의 노력으로 AWS IoT Greengrass에 마이그레이션할 수 있습니다. Lambda 실행 파일은 클라우드에서 실행되지 않으므로 배포 전에 AWS SDK를 사용하여 클라우드에서 개발할 수 없습니다.

별칭 또는 버전을 기준으로 Lambda 함수 참조

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

AWS IoT Greengrass은(는) $LATEST 버전에서 Lambda 별칭을 지원하지 않습니다. $LATEST 버전은 변경 불가능한 게시 함수 버전으로 제한되지 않고 언제라도 변경이 가능한데, 이는 버전 불변성이라는 AWS IoT Greengrass 원칙과 상반됩니다.

코드 변경에 따라 Lambda 함수를 계속 업데이트하기 위한 일반적인 방법은 Greengrass 그룹 및 구독에서 PRODUCTION(이)라는 별칭을 사용하는 것입니다. 새로운 버전의 Lambda 함수를 프로덕션 환경으로 승격함에 따라 별칭이 안정적인 최신 버전을 가리키도록 하고 그룹을 재배포합니다. 또한 이전 버전으로 롤백하기 위해 이 방법을 사용할 수도 있습니다.

Greengrass Lambda 함수를 위한 통신 흐름

Lambda 함수는 AWS, 로컬 서비스 및 클라우드 서비스(AWS IoT Greengrass 서비스 포함)의 다른 구성원들과의 여러 통신 방법을 지원합니다.

MQTT 메시지를 사용한 통신

Lambda 함수는 구독에 의해 제어되는 게시-구독 패턴을 사용하여 MQTT 메시지를 전송하고 수신할 수 있습니다.

이러한 통신 흐름을 통해 Lambda 함수는 메시지를 다음 엔터티와 교환할 수 있습니다.

구독은 메시지 소스와 메시지 대상, 소스에서 대상까지의 메시지 라우팅에 사용된 주제(제목)를 정의합니다. Lambda 함수에 게시되는 메시지는 함수의 등록 핸들러에 전달됩니다. 구독은 보안 강화 및 예측 가능한 상호 작용을 지원합니다. 자세한 설명은 MQTT 메시징 워크플우로의 관리형 구독 섹션을 참조하세요.

기타 통신 흐름

입력 MQTT 주제(또는 제목) 검색

AWS IoT Greengrass는 구독을 사용하여 그룹 내의 디바이스, Lambda 함수 및 커넥터와 AWS IoT 또는 로컬 섀도우 서비스 간의 MQTT 메시지 교환을 제어합니다. 구독은 메시지 원본, 메시지 대상 및 메시지 라우팅에 사용되는 MQTT 주제를 정의합니다. 대상이 Lambda 함수이면 소스가 메시지를 게시할 때 함수 핸들러가 호출됩니다. 자세한 설명은 MQTT 메시지를 사용한 통신 섹션을 참조하세요.

다음 예에서는 Lambda 함수가 핸들러에 전달되는 context에서 입력 항목을 가져올 수 있는 방법을 보여 줍니다. 컨텍스트 계층 구조(context.client_context.custom['subject'])에서 subject 키에 액세스하여 이 작업을 수행합니다. 또한 예제에서는 입력 JSON 메시지를 구문 분석한 후 구문 분석된 주제와 메시지를 게시합니다.

import greengrasssdk
import logging

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

OUTPUT_TOPIC = 'test/topic_results'

def get_input_topic(context):
    try:
        topic = context.client_context.custom['subject']
    except Exception as e:
        logging.error('Topic could not be parsed. ' + repr(e))
    return topic
    
def get_input_message(event):
    try:
        message = event['test-key']
    except Exception as e:
        logging.error('Message could not be parsed. ' + repr(e))
    return message

def function_handler(event, context):
    try:
        input_topic = get_input_topic(context)
        input_message = get_input_message(event)
        response = 'Invoked on topic "%s" with message "%s"' % (input_topic, input_message)
        logging.info(response)
    except Exception as e:
        logging.error(e)

    client.publish(topic=OUTPUT_TOPIC, payload=response)

    return

함수를 테스트하려면 기본 구성 설정을 사용하여 그룹에 함수를 추가하십시오. 그리고 나서 다음 구독을 추가하고 그룹을 배포합니다. 지침은 모듈 3(1부): AWS IoT Greengrass의 Lambda 함수을(을) 참조하십시오.

배포가 완료되면 함수를 호출합니다.

Greengrass Lambda 함수의 라이프사이클 구성

Lambda 함수 수명 주기에 따라 함수가 시작되는 시점과 컨테이너를 생성 및 사용하는 방법이 결정됩니다. 또한 수명 주기는 함수 핸들러 외부에 있는 변수 및 사전 처리 로직이 보관되는 방법을 결정합니다.

AWS IoT Greengrass은(는) 온디맨드(기본값) 또는 수명이 긴 수명 주기를 지원합니다.

컨테이너 재사용에 대한 자세한 내용은 AWS 컴퓨팅 블로그의 AWS Lambda에서 컨테이너 재사용 이해하기를 참조하십시오.

Lambda 실행 파일

이 기능은 AWS IoT Greengrass 코어 v1.6 이상에 사용할 수 있습니다.

Lambda 실행 파일은(는) 코어 환경에서 이진 코드를 실행하는 데 사용할 수 있는Greengrass Lambda 함수의 유형입니다. 이를 통해 디바이스별 기능을 기본적으로 실행할 수 있으며 컴파일된 코드의 공간이 더 작아지는 이점을 누릴 수 있습니다. Lambda 실행 파일은 이벤트에 의해 간접적으로 호출되고, 다른 함수를 간접적으로 호출하고, 로컬 리소스에 액세스할 수 있습니다.

Lambda 실행 파일은 이진 인코딩 유형만 지원하지만(JSON는 지원하지 않음), 그렇지 않고 다른 Lambda 함수처럼 Greengrass 그룹에서 이들을 관리하고 배포할 수 있습니다. 그러나 을(를) 생성하는 프로세스는 Python, Java 및 Node.js Lambda 함수를 생성하는 프로세스와는 다릅니다.

Lambda 실행 파일은 함수 코드에 특정한 호출 및 프로그래밍 패턴을 구현해야 합니다. 예를 들어 main 메서드는 다음과 같이 해야 합니다.

다음 스니펫은 simple_handler.c 코드 예제의 main 메서드입니다. GitHub

int main() {
    gg_error err = GGE_SUCCESS;

    err = gg_global_init(0);
    if(err) {
        gg_log(GG_LOG_ERROR, "gg_global_init failed %d", err);
        goto cleanup;
    }

    gg_runtime_start(handler, 0);

cleanup:
    return -1;
}

요건, 제약 조건 및 기타 구현 세부 정보에 대한 자세한 내용은 AWS IoT GreengrassC용 코어 SDK을 참조하십시오.

Lambda 실행 파일 생성

SDK와 함께 코드를 컴파일하고 난 후에는 AWS Lambda API를 사용하여 Lambda 함수를 생성하고 컴파일된 실행 파일을 업로드합니다.

다음 예제에서는 create-function CLI 명령을 사용하여 Lambda 실행 파일을 생성합니다. 이 명령은 다음을 지정합니다.

aws lambda create-function \
--region aws-region \
--function-name function-name \
--handler executable-name \
--role role-arn \
--zip-file fileb://file-name.zip \
--runtime arn:aws:greengrass:::runtime/function/executable

그런 다음 AWS Lambda API를 사용하여 버전을 게시하고 별칭을 생성합니다.

그리고 Greengrass 그룹에 Lambda 실행 파일을 추가하고 그룹별 설정에서 이진 입력 데이터를 수용하도록 이를 구성한 다음, 그룹을 배포합니다. 이 작업은 AWS IoT Greengrass 콘솔에서 또는 AWS IoT Greengrass API를 사용하여 수행할 수 있습니다.