Lambda 함수를 구성 요소로 가져오기 (콘솔) - AWS IoT Greengrass

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

Lambda 함수를 구성 요소로 가져오기 (콘솔)

AWS IoT Greengrass콘솔을 사용하여 Lambda 함수 구성 요소를 생성할 때는 AWS Lambda 기존 함수를 가져온 다음 Greengrass 디바이스에서 실행되는 구성 요소를 생성하도록 구성합니다.

시작하기 전에 Greengrass 디바이스에서 Lambda 함수를 실행하기 위한 요구 사항을 검토하십시오.

1단계: 가져올 Lambda 함수 선택

  1. AWS IoT Greengrass콘솔 탐색 메뉴에서 구성 요소를 선택합니다.

  2. 구성 요소 페이지에서 구성 요소 생성을 선택합니다.

  3. 구성 요소 생성 페이지의 구성 요소 정보에서 Lambda 함수 가져오기를 선택합니다.

  4. Lambda 함수에서 가져오려는 Lambda 함수를 검색하여 선택합니다.

    AWS IoT GreengrassLambda 함수의 이름을 사용하여 구성 요소를 생성합니다.

  5. Lambda 함수 버전에서 가져올 버전을 선택합니다. Lambda 별칭은 다음과 같이 선택할 수 없습니다. $LATEST

    AWS IoT GreengrassLambda 함수 버전을 유효한 시맨틱 버전으로 사용하여 구성 요소를 생성합니다. 예를 들어 함수 버전이 3인 경우 구성 요소 버전은 3.0.0가 됩니다.

2단계: Lambda 함수 파라미터 구성

구성 요소 생성 페이지의 Lambda 함수 구성에서 Lambda 함수를 실행하는 데 사용할 다음 파라미터를 구성합니다.

  1. (선택 사항) Lambda 함수가 작업 메시지를 구독하는 이벤트 소스 목록을 추가합니다. 이 함수를 로컬 게시/구독 메시지 및 MQTT 메시지에 구독하도록 이벤트 소스를 지정할 수 있습니다. AWS IoT Core Lambda 함수는 이벤트 소스로부터 메시지를 수신할 때 호출됩니다.

    참고

    이 함수를 다른 Lambda 함수 또는 구성 요소의 메시지를 구독하려면 이 Lambda 함수 구성 요소를 배포할 때 기존 구독 라우터 구성 요소를 배포하십시오. 레거시 구독 라우터 구성 요소를 배포할 때 Lambda 함수가 사용하는 구독을 지정하십시오.

    이벤트 소스에서 다음을 수행하여 이벤트 소스를 추가하십시오.

    1. 추가하는 각 이벤트 소스에 대해 다음 옵션을 지정하십시오.

      • 주제 — 메시지를 구독하기 위한 주제입니다.

      • 유형 — 이벤트 소스의 유형입니다. 다음 옵션 중 하나를 선택합니다.

        • 로컬 게시/구독 — 로컬 게시/구독 메시지를 구독합니다.

          Greengrass nucleus v2.6.0 이상 및 Lambda 관리자 v2.2.5 이상을 사용하는 경우, 이 유형을 지정할 때 주제에 MQTT 주제 와일드카드 (및) 를 사용할 수 있습니다. + #

        • AWS IoT CoreAWS IoT CoreMQTT — MQTT 메시지를 구독하십시오.

          이 유형을 지정할 때 주제에 MQTT 주제 와일드카드 (+#) 를 사용할 수 있습니다.

    2. 다른 이벤트 소스를 추가하려면 [Add event source] 를 선택하고 이전 단계를 반복합니다. 이벤트 소스를 제거하려면 제거하려는 이벤트 소스 옆의 제거를 선택합니다.

  2. Timeout (초) 에는 고정되지 않은 Lambda 함수가 제한 시간이 초과되기 전에 실행할 수 있는 최대 시간 (초) 을 입력합니다. 기본값은 3초입니다.

  3. Pinned의 경우, Lambda 함수 구성 요소를 고정할지 여부를 선택합니다. 기본값은 True입니다.

    • 고정된 (또는 수명이 긴) Lambda 함수는 시작 시 AWS IoT Greengrass 시작되어 자체 컨테이너에서 계속 실행됩니다.

    • 고정되지 않은 (또는 온디맨드) Lambda 함수는 작업 항목을 수신할 때만 시작되고 지정된 최대 유휴 시간 동안 유휴 상태를 유지한 후에 종료됩니다. 함수에 여러 작업 항목이 있는 경우 AWS IoT Greengrass Core 소프트웨어는 함수의 여러 인스턴스를 생성합니다.

  4. (선택 사항) 추가 파라미터에서 다음 Lambda 함수 파라미터를 설정합니다.

    • 상태 제한 시간 (초) - Lambda 함수 구성 요소가 Lambda 관리자 구성 요소에 상태 업데이트를 보내는 간격 (초) 입니다. 이 파라미터는 고정된 함수에만 적용됩니다. 기본값은 60초입니다.

    • 최대 대기열 크기 - Lambda 함수 구성 요소에 대한 메시지 대기열의 최대 크기입니다. AWS IoT GreengrassCore 소프트웨어는 Lambda 함수를 실행하여 각 메시지를 사용할 수 있을 때까지 메시지를 FIFO (선입선출) 대기열에 저장합니다. 기본값은 1,000개의 메시지입니다.

    • 최대 인스턴스 수 - 고정되지 않은 Lambda 함수가 동시에 실행할 수 있는 최대 인스턴스 수입니다. 기본값은 100개 인스턴스입니다.

    • 최대 유휴 시간 (초) - 고정되지 않은 Lambda 함수가 Core 소프트웨어가 프로세스를 중지하기 전에 유휴 상태로 유지할 수 있는 최대 시간 (초) 입니다. AWS IoT Greengrass 기본값은 60초입니다.

    • 인코딩 유형 - Lambda 함수가 지원하는 페이로드 유형입니다. 다음 옵션 중 하나를 선택합니다.

      • JSON

      • 이진

      기본값은 JSON입니다.

  5. (선택 사항) 실행 시 Lambda 함수에 전달할 명령줄 인수 목록을 지정합니다.

    1. 추가 파라미터, 프로세스 인수에서 인수 추가를 선택합니다.

    2. 추가하는 각 인수에 대해 함수에 전달하려는 인수를 입력합니다.

    3. 인수를 제거하려면 제거하려는 인수 옆의 제거를 선택합니다.

  6. (선택 사항) Lambda 함수를 실행할 때 사용할 수 있는 환경 변수를 지정합니다. 환경 변수를 사용하면 함수 코드를 변경할 필요 없이 구성 설정을 저장하고 업데이트할 수 있습니다.

    1. 추가 매개변수, 환경 변수에서 환경 변수 추가를 선택합니다.

    2. 추가하는 각 환경 변수에 대해 다음 옵션을 지정합니다.

      • — 변수 이름.

      • — 이 변수의 디폴트 값입니다.

    3. 환경 변수를 제거하려면 제거하려는 환경 변수 옆의 제거를 선택합니다.

3단계: (선택 사항) Lambda 함수에 지원되는 플랫폼 지정

모든 코어 디바이스에는 운영 체제 및 아키텍처에 대한 속성이 있습니다. Lambda 함수 구성 요소를 배포하면 Core 소프트웨어는 사용자가 지정하는 플랫폼 값을 코어 디바이스의 플랫폼 속성과 비교하여 Lambda 함수가 해당 디바이스에서 지원되는지 여부를 결정합니다. AWS IoT Greengrass

참고

Greengrass nucleus 구성 요소를 코어 디바이스에 배포할 때 사용자 지정 플랫폼 속성을 지정할 수도 있습니다. 자세한 내용은 Greengrass nucleus 구성요소의 플랫폼 오버라이드 매개변수를 참조하십시오.

Lambda 함수 구성, 추가 파라미터, 플랫폼에서 다음을 수행하여 이 Lambda 함수가 지원하는 플랫폼을 지정합니다.

  1. 각 플랫폼에 대해 다음 옵션을 지정하십시오.

    • 운영 체제 - 플랫폼의 운영 체제 이름입니다. 현재 지원되는 값은 linux입니다.

    • 아키텍처 - 플랫폼의 프로세서 아키텍처. 지원되는 값은 다음과 같습니다.

      • amd64

      • arm

      • aarch64

      • x86

  2. 다른 플랫폼을 추가하려면 [Add platform] 을 선택하고 이전 단계를 반복합니다. 지원되는 플랫폼을 제거하려면 제거하려는 플랫폼 옆의 제거를 선택합니다.

4단계: (선택 사항) Lambda 함수의 구성 요소 종속성 지정

구성 요소 종속성은 함수가 사용하는 추가 AWS 제공 구성 요소 또는 사용자 지정 구성 요소를 식별합니다. Lambda 함수 구성 요소를 배포할 때 배포에는 함수 실행에 대한 이러한 종속성이 포함됩니다.

중요

AWS IoT GreengrassV1에서 실행하도록 생성한 Lambda 함수를 가져오려면 함수가 사용하는 기능 (예: 비밀, 로컬 섀도우, 스트림 관리자) 에 대한 개별 구성 요소 종속성을 정의해야 합니다. 이러한 구성 요소를 하드 종속성으로 정의하여 종속성 상태가 변경될 경우 Lambda 함수 구성 요소가 다시 시작되도록 합니다. 자세한 설명은 V1 람다 함수 가져오기 섹션을 참조하세요.

Lambda 함수 구성, 추가 파라미터, 구성 요소 종속성에서 다음 단계를 완료하여 Lambda 함수의 구성 요소 종속성을 지정하십시오.

  1. [종속성 추가] 를 선택합니다.

  2. 추가하는 각 구성 요소 종속성에 대해 다음 옵션을 지정합니다.

    • 구성 요소 이름 - 구성 요소 이름. 예를 들어 스트림 관리자 구성 요소를 aws.greengrass.StreamManager 포함하려면 를 입력합니다.

    • 버전 요구 사항 — 이 구성 요소 종속성의 호환 버전을 식별하는 npm 스타일 시맨틱 버전 제약 조건입니다. 단일 버전 또는 버전 범위를 지정할 수 있습니다. 예를 들어, 이 Lambda 함수가 스트림 관리자 구성 요소의 첫 번째 메이저 버전에 있는 모든 버전에 종속되도록 ^1.0.0 지정하려면 를 입력합니다. 시맨틱 버전 제약에 대한 자세한 내용은 npm semver 계산기를 참조하십시오.

    • 유형 — 종속성 유형. 다음 옵션 중 하나를 선택합니다.

      • 하드 — 종속성 상태가 변경되면 Lambda 함수 구성 요소가 다시 시작됩니다. 이는 기본 작업입니다.

      • Soft — 종속성 상태가 변경되어도 Lambda 함수 구성 요소가 다시 시작되지 않습니다.

  3. 구성 요소 종속성을 제거하려면 구성 요소 종속성 옆의 제거를 선택합니다.

5단계: (선택 사항) 컨테이너에서 Lambda 함수 실행

기본적으로 Lambda 함수는 Core 소프트웨어 내의 AWS IoT Greengrass 격리된 런타임 환경에서 실행됩니다. 격리 없이 (즉, 컨테이너 없음 모드) 프로세스로 Lambda 함수를 실행하도록 선택할 수도 있습니다.

Linux 프로세스 구성에서 격리 모드의 경우 다음 옵션 중에서 선택하여 Lambda 함수의 컨테이너화를 선택합니다.

  • Greengrass 컨테이너 - Lambda 함수는 컨테이너에서 실행됩니다. 이는 기본 작업입니다.

  • 컨테이너 없음 - Lambda 함수는 격리 없이 프로세스로 실행됩니다.

컨테이너에서 Lambda 함수를 실행하는 경우 다음 단계를 완료하여 Lambda 함수에 대한 프로세스 구성을 구성하십시오.

  1. 컨테이너에서 사용할 수 있도록 메모리 양과 시스템 리소스 (예: 볼륨 및 디바이스) 를 구성합니다.

    컨테이너 매개변수에서 다음을 수행합니다.

    1. 메모리 크기에 컨테이너에 할당하려는 메모리 크기를 입력합니다. 메모리 크기를 MB 또는 kB 단위로 지정할 수 있습니다.

    2. 읽기 전용 sys 폴더의 경우 컨테이너가 장치 폴더의 /sys 정보를 읽을 수 있는지 여부를 선택합니다. 기본값은 False입니다.

  2. (선택 사항) 컨테이너화된 Lambda 함수가 액세스할 수 있는 로컬 볼륨을 구성합니다. 볼륨을 정의할 때 AWS IoT Greengrass Core 소프트웨어는 소스 파일을 컨테이너 내의 대상에 탑재합니다.

    1. 볼륨에서 볼륨 추가를 선택합니다.

    2. 추가하는 각 볼륨에 대해 다음 옵션을 지정합니다.

      • 물리적 볼륨 - 코어 디바이스의 소스 폴더 경로입니다.

      • 논리적 볼륨 - 컨테이너 내 대상 폴더의 경로입니다.

      • 권한 - (선택 사항) 컨테이너에서 소스 폴더에 액세스할 수 있는 권한입니다. 다음 옵션 중 하나를 선택합니다.

        • 읽기 전용 — Lambda 함수는 소스 폴더에 대한 읽기 전용 액세스 권한을 가집니다. 이는 기본 작업입니다.

        • 읽기-쓰기 — Lambda 함수는 소스 폴더에 대한 읽기/쓰기 액세스 권한을 가집니다.

      • 그룹 소유자 추가 - (선택 사항) Lambda 함수 구성 요소를 실행하는 시스템 그룹을 소스 폴더의 소유자로 추가할지 여부. 기본값은 False입니다.

    3. 볼륨을 제거하려면 제거하려는 볼륨 옆의 제거를 선택합니다.

  3. (선택 사항) 컨테이너화된 Lambda 함수가 액세스할 수 있는 로컬 시스템 디바이스를 구성합니다.

    1. 디바이스에서 디바이스 추가를 선택합니다.

    2. 추가하는 각 장치에 대해 다음 옵션을 지정합니다.

      • 마운트 경로 - 코어 디바이스의 시스템 디바이스 경로입니다.

      • 권한 - (선택 사항) 컨테이너에서 시스템 장치에 액세스할 수 있는 권한입니다. 다음 옵션 중 하나를 선택합니다.

        • 읽기 전용 — Lambda 함수는 시스템 디바이스에 대한 읽기 전용 액세스 권한을 가집니다. 이는 기본 작업입니다.

        • 읽기-쓰기 — Lambda 함수는 소스 폴더에 대한 읽기/쓰기 액세스 권한을 가집니다.

      • 그룹 소유자 추가 - (선택 사항) Lambda 함수 구성 요소를 실행하는 시스템 그룹을 시스템 디바이스의 소유자로 추가할지 여부. 기본값은 False입니다.

6단계: Lambda 함수 구성 요소 생성

Lambda 함수 구성 요소에 대한 설정을 구성한 후 [Create] 를 선택하여 새 구성 요소 생성을 완료합니다.

코어 디바이스에서 Lambda 함수를 실행하기 위해 코어 디바이스에 새 구성 요소를 배포하면 됩니다. 자세한 내용은 디바이스에 AWS IoT Greengrass 구성 요소 배포을(를) 참조하세요.