Greengrass nucleus lite - AWS IoT Greengrass
버전운영 체제요구 사항호환성다운로드 및 설치구성로컬 로그 파일Changelog

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

Greengrass nucleus lite

Greengrass nucleus lite(aws.greengrass.NucleusLite)는 최소 메모리 사용(5MB RAM 미만)에 최적화된 제한된 엣지 디바이스용 디바이스 런타임입니다. AWS IoT Greengrass 버전 2.14.0 릴리스에 도입되었으며 AWS IoT Greengrass 일반 구성 요소, Greengrass V2 API 및 SDK와 역호환됩니다.

Greengrass nucleus lite는 일반 Greengrass nucleus(aws.greengrass.Nucleus)를 대체하는 옵션으로 제공되며, 이기종 Greengrass 디바이스로 구성된 플릿에서도 사용할 수 있습니다.

버전

이 구성 요소에는 다음과 같은 버전이 있습니다.

  • 2.3.x

  • 2.2.x

  • 2.1.x

  • 2.0.x

운영 체제

이 구성 요소는 다음 운영 체제를 실행하는 코어 디바이스에 설치할 수 있습니다.

  • Linux(systemd를 사용한 배포)

자세한 내용은 Greengrass nucleus를 참조하세요.

요구 사항

AWS IoT Greengrass nucleus lite 및 AWS IoT Greengrass 코어 소프트웨어를 설치하고 실행하려면 디바이스가 특정 요구 사항을 충족해야 합니다. 자세한 내용은 설정 가이드를 참조하세요.

  • nucleus 런타임을 위한 5MB RAM 공간.

  • 5MB 저장 공간(디스크/FLASH).

추가 시스템 의존성은 설정 가이드에 문서화되어 있습니다.

VPC에서 Greengrass nucleus 구성 요소의 실행이 지원됩니다. 이 구성 요소를 VPC에 배포하려면 다음이 필요합니다.

  • Greengrass nucleus는 AWS IoT 데이터, AWS IoT 자격 증명 및 Amazon S3에 연결되어 있어야 합니다.

호환성

AWS IoT Greengrass nucleus lite는 AWS IoT Greengrass v2 API(의 하위 세트) 및 지원되는 SDKs. 특정 언어 런타임/VM에 의존하지 않지만, 배포에 추가되는 구성 요소는 특정 런타임(Java JVM, Python 등)의 존재를 요구할 수 있습니다. nucleus lite에서 지원되는 기능에 대한 자세한 내용은 Greengrass 기능 호환성 섹션을 참조하세요.

다운로드 및 설치

apt 패키지를 다운로드하거나, 소스에서 빌드하거나, Yocto 계층을 사용하거나, 사전 빌드된 Yocto 이미지를 다운로드할 수 있습니다(예: Raspberry Pi). AWS IoT Core 콘솔에서는 디바이스에 필요한 모든 자격 증명과 초기 설정이 포함된 연결 키트를 다운로드할 수 있습니다. 각 배포 방법별 설치 지침이 포함되어 있습니다.

자습서에 따라 AWS IoT Greengrass nucleus lite를 설치하고 Greengrass 구성 요소 개발을 탐색할 수도 있습니다. 자세한 내용은 자습서: AWS IoT Greengrass V2 시작하기 단원을 참조하십시오.

구성

nucleus는 다음 구성 파라미터를 지원합니다. 일부 파라미터를 사용하려면 AWS IoT Greengrass 코어 소프트웨어를 다시 시작해야 합니다.

iotRoleAlias

토큰 교환 IAM AWS IoT 역할을 가리키는 역할 별칭입니다. Greengrass 코어 디바이스가 서비스와 상호 작용 AWS 할 수 있도록 AWS IoT 자격 증명 공급자가이 역할을 맡습니다. 자세한 내용은 코어 디바이스가 AWS 서비스와 상호 작용하도록 권한 부여를 참조하세요.

iotDataEndpoint

의 AWS IoT 데이터 엔드포인트입니다 AWS 계정.

iotCredEndpoint

의 AWS IoT 자격 증명 엔드포인트입니다 AWS 계정.

greengrassDataPlanePort

데이터 플레인 연결에 사용할 포트입니다. 자세한 내용은 포트 443에서 또는 네트워크 프록시를 통해 연결을 참조하세요.

중요

디바이스가 아웃바운드 연결을 수행할 수 있는 포트를 지정해야 합니다. 차단된 포트를 지정하면 디바이스가에 연결하여 배포를 수신 AWS IoT Greengrass 할 수 없습니다. 다음 옵션 중 하나를 선택합니다.

  • 443

  • 8443

  • 기본값: 8443

awsRegion

사용할 AWS 리전 입니다.

runWithDefault

구성 요소 실행에 사용할 시스템 사용자.

중요

이 구성 파라미터에 변경 사항을 배포하면 AWS IoT Greengrass 코어 소프트웨어가 다시 시작되어 변경 사항이 적용됩니다.

이 객체에는 다음 정보가 포함되어 있어야 합니다.

posixUser

코어 디바이스가 일반 구성 요소를 실행하는 데 사용하는 시스템 사용자 및 선택적으로 시스템 그룹의 이름 또는 ID입니다. user:group 형식으로 사용자와 그룹을 콜론(:)으로 구분하여 지정합니다. 그룹은 선택 사항입니다. 그룹을 지정하지 않으면 AWS IoT Greengrass 코어 소프트웨어는 사용자의 기본 그룹을 사용합니다. 예를 들어 ggc_user 또는 ggc_user:ggc_group을 지정할 수 있습니다. 자세한 내용은 구성 요소를 실행하는 사용자 구성 단원을 참조하십시오.

networkProxy

(선택 사항) 모든 연결에 사용할 네트워크 프록시입니다. 자세한 내용은 포트 443에서 또는 네트워크 프록시를 통해 연결 단원을 참조하십시오.

중요

이 구성 파라미터에 대한 변경 사항을 배포하면 다음에 AWS IoT Greengrass 코어 소프트웨어를 다시 시작한 후 변경 사항이 적용됩니다.

이 객체에는 다음 정보가 포함되어 있어야 합니다.

noProxyAddresses

(선택 사항) 프록시에서 제외되는 IP 주소 또는 호스트 이름을 쉼표로 구분한 목록입니다.

proxy

연결할 프록시입니다. 이 객체에는 다음 정보가 포함되어 있어야 합니다.

url

http://host:port 형식으로 표시되는 프록시 서버의 URL입니다.

  • scheme - 체계로, http여야 합니다.

  • host - 프록시 서버의 호스트 이름 또는 IP 주소입니다.

  • port – (선택 사항) 포트 번호입니다. 포트를 지정하지 않으면 Greengrass 코어 디바이스에서는 다음 기본값이 사용됩니다.

    • http – 80

로컬 로그 파일

메시지는 stdout에 로깅되고 로그 파일은 systemd에서 처리됩니다.

이 구성 요소의 로그를 보려면

  • 로그를 확인하려면 journalctl을 사용합니다.

Changelog

버전

변경 사항

2.3.0
새로운 기능

  • IoT Core MQTT 권한 부여를 위한 TPM 2.0 사용 지원.

  • 샘플 Apt 패키지는 이제 Ubuntu 22.04, Ubuntu 24.04, Debian 12, Debian 13 등 더 많은 운영 체제를 지원합니다.

  • 이제 RestartComponent IPC가 지원됩니다.

버그 수정 및 개선 사항

  • 로컬 배포에는 더 이상 인터넷 액세스가 필요하지 않습니다.

  • Greengrass Nucleus 런타임 동작과 일치하도록 GetConfiguration이 업데이트되었습니다. (변경 위반)

  • 일반적인 버그 수정 및 개선 사항.

2.2.2
버그 수정 및 개선 사항

  • 변경되지 않은 구성 요소 버전이 포함된 수정 배포에서, 실행 가능한 아티팩트가 이미 실행 중인 경우 배포 실패 문제를 수정합니다.

  • 중첩된 하위 객체가 4개를 초과하는 경우 레시피 변수 보간 문제를 수정합니다.

  • 따옴표와 셸 특수 문자를 포함한 레시피 변수 보간을 수정합니다.

  • MQTT 연결 실패 시 발생하던 fds 누수 문제를 수정합니다.

2.2.1
버그 수정 및 개선 사항

  • nucleus가 TES 자격 증명을 가져오지 못하는 문제를 수정합니다.

2.2.0
새로운 기능

  • 컨테이너 이미지 아티팩트 URI에 대한 지원을 추가합니다.

버그 수정 및 개선 사항

  • 일반적인 버그 수정 및 개선 사항.

2.1.0
새로운 기능

  • networkProxy 구성 옵션을 사용하여 설정 가능한 HTTP 프록시 지원을 추가합니다.

버그 수정 및 개선 사항

  • 구버전 libcurl을 실행하는 장치를 위해 libcurl 요구 버전을 7.86에서 7.82로 낮췄습니다.

  • journalctl 로그를 recipe-runner 대신 구성요소에 귀속되도록 업데이트했습니다.

  • IPC 호출의 오류 응답을 개선합니다.

  • 일반 구성 요소 아티팩트의 S3 다운로드 시 재시도 기능을 추가합니다.

  • 사소한 버그를 수정했습니다.

2.0.2
버그 수정 및 개선 사항

  • apt 패키지의 종속성에 cgroup-tools를 포함하도록 수정합니다.

2.0.1
버그 수정 및 개선 사항

  • Greengrass 레시피의 timeout 섹션에 대한 레시피 변수 보간 지원을 추가합니다.

  • 스트림 관리자의 ValidateAuthorizationToken IPC 명령 지원을 추가합니다.

  • 플릿 프로비저닝 관련 경고를 수정합니다.

  • 작업 리스너에 재시도 및 백오프 기능을 추가합니다.

  • 일반적인 버그 수정 및 개선 사항.

2.0.0

초기 버전입니다.