Greengrass nucleus - AWS IoT Greengrass

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

Greengrass nucleus

Greengrass nucleus 구성 요소(aws.greengrass.Nucleus)는 필수 구성 요소이며 디바이스에서 AWS IoT Greengrass 코어 소프트웨어를 실행하기 위한 최소 요구 사항입니다. AWS IoT Greengrass 코어 소프트웨어를 원격으로 사용자 지정하고 업데이트하도록이 구성 요소를 구성할 수 있습니다. 이 구성 요소를 배포하여 코어 디바이스에서 프록시, 디바이스 역할 및 AWS IoT 사물 구성과 같은 설정을 구성합니다.

참고

Greengrass 버전 2.14.0부터 제한된 엣지 디바이스에 nucleus 디바이스 런타임의 메모리 공간 최적화 버전을 사용할 수 있습니다. 구성 및 사용에 대한 자세한 내용은 Greengrass nucleus lite를 참조하세요.

중요

nucleus 구성 요소의 버전이 변경되거나 특정 구성 파라미터를 변경하면 디바이스의 nucleus 및 기타 모든 구성 요소를 포함하는 AWS IoT Greengrass 코어 소프트웨어가 다시 시작되어 변경 사항이 적용됩니다.

구성 요소를 배포할 때는 해당 구성 요소의 모든 종속성에 대해 지원되는 최신 버전을 AWS IoT Greengrass 설치합니다. 따라서 사물 그룹에 새 디바이스를 추가하거나 해당 디바이스를 대상으로 하는 배포를 업데이트하면 AWS제공된 퍼블릭 구성 요소의 새 패치 버전이 코어 디바이스에 자동으로 배포될 수 있습니다. Nucleus 업데이트와 같은 일부 자동 업데이트로 인해 디바이스가 예기치 않게 다시 시작될 수 있습니다.

디바이스에서 실행 중인 구성 요소에 대한 의도하지 않은 업데이트를 방지하려면 배포를 생성할 때 해당 구성 요소의 기본 버전을 직접 포함하는 것이 좋습니다. AWS IoT Greengrass 코어 소프트웨어의 업데이트 동작에 대한 자세한 내용은 섹션을 참조하세요AWS IoT Greengrass 코어 소프트웨어(OTA) 업데이트.

버전

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

  • 2.14.x

  • 2.13.x

  • 2.12.x

  • 2.11.x

  • 2.10.x

  • 2.9.x

  • 2.8.x

  • 2.7.x

  • 2.6.x

  • 2.5.x

  • 2.4.x

  • 2.3.x

  • 2.2.x

  • 2.1.x

  • 2.0.x

장치 요구 사항

참고

AWS IoT Device Tester 용 AWS IoT Greengrass 를 사용하여 디바이스가 AWS IoT Greengrass 코어 소프트웨어를 실행하고와 통신할 수 있는지 확인할 수 있습니다 AWS 클라우드. 자세한 내용은 AWS IoT Device Tester for AWS IoT Greengrass V2 사용 단원을 참조하십시오.

Linux
  • AWS 리전 지원하는의 사용 AWS IoT Greengrass V2. 지원되는 리전 목록은 AWS 일반 참조에서 AWS IoT Greengrass V2 엔드포인트 및 할당량을 참조하세요.

  • AWS IoT Greengrass 코어 소프트웨어에 사용할 수 있는 최소 디스크 공간은 256MB입니다. 이 요구 사항에는 코어 디바이스에 배포된 구성 요소는 포함되지 않습니다.

  • AWS IoT Greengrass 코어 소프트웨어에 할당된 최소 96MB RAM. 이 요구 사항에는 코어 디바이스에서 실행되는 구성 요소는 포함되지 않습니다. 자세한 내용은 JVM 옵션으로 메모리 할당 제어 단원을 참조하십시오.

  • Java 런타임 환경(JRE) 버전 8 이상. 디바이스의 PATH 환경 변수에서 Java를 사용할 수 있어야 합니다. Java를 사용하여 사용자 정의 구성 요소를 개발하려면 JDP(Java Devopment Kit)를 설치해야 합니다. Amazon Corretto 또는 OpenJDK 장기 지원 버전을 사용하는 것이 좋습니다. 버전 8 이상이 필요합니다.

  • GNU C Library(glibc) 버전 2.25 이상.

  • 루트 사용자로 AWS IoT Greengrass 코어 소프트웨어를 실행해야 합니다. 예를 들어 sudo를 사용합니다.

  • 와 같은 AWS IoT Greengrass 코어 소프트웨어를 실행하는 루트 사용자는 모든 사용자 및 모든 그룹에서를 실행할 수 sudo 있는 권한이 root있어야 합니다. /etc/sudoers 파일은 이 사용자에게 다른 그룹으로 sudo를 실행할 수 있는 권한을 부여해야 합니다. /etc/sudoers의 사용자에 대한 권한은 다음 예제와 유사해야 합니다.

    root ALL=(ALL:ALL) ALL
  • 코어 디바이스는 엔드포인트 및 포트 세트에 대한 아웃바운드 요청을 수행할 수 있어야 합니다. 자세한 내용은 프록시 또는 방화벽을 통해 디바이스 트래픽 허용 단원을 참조하십시오.

  • /tmp 디렉터리는 exec 권한으로 탑재되어야 합니다.

  • 다음 쉘 명령 모두:

    • ps -ax -o pid,ppid

    • sudo

    • sh

    • kill

    • cp

    • chmod

    • rm

    • ln

    • echo

    • exit

    • id

    • uname

    • grep

  • 디바이스에 다음 쉘 명령(선택 사항)이 필요할 수도 있습니다.

    • (선택 사항) systemctl. 이 명령은 AWS IoT Greengrass 코어 소프트웨어를 시스템 서비스로 설정하는 데 사용됩니다.

    • (선택 사항) useradd, groupadd, usermod. 이 명령은 ggc_user 시스템 사용자 및 ggc_group 시스템 그룹을 설정하는 데 사용됩니다.

    • (선택 사항) mkfifo. 이 명령은 Lambda 함수를 구성 요소로 실행하는 데 사용됩니다.

  • 구성 요소 프로세스에 대한 시스템 리소스 제한을 구성하려면 디바이스에서 Linux 커널 버전 2.6.24 이상을 실행해야 합니다.

  • Lambda 함수를 실행하려면 디바이스가 추가 요구 사항을 충족해야 합니다. 자세한 내용은 Lambda 함수 요구 사항 단원을 참조하십시오.

Windows
  • AWS 리전 지원하는의 사용 AWS IoT Greengrass V2. 지원되는 리전 목록은 AWS 일반 참조에서 AWS IoT Greengrass V2 엔드포인트 및 할당량을 참조하세요.

  • AWS IoT Greengrass 코어 소프트웨어에 사용할 수 있는 최소 디스크 공간은 256MB입니다. 이 요구 사항에는 코어 디바이스에 배포된 구성 요소는 포함되지 않습니다.

  • AWS IoT Greengrass 코어 소프트웨어에 할당된 최소 160MB RAM. 이 요구 사항에는 코어 디바이스에서 실행되는 구성 요소는 포함되지 않습니다. 자세한 내용은 JVM 옵션으로 메모리 할당 제어 단원을 참조하십시오.

  • Java 런타임 환경(JRE) 버전 8 이상. 디바이스의 PATH 시스템 변수에서 Java를 사용할 수 있어야 합니다. Java를 사용하여 사용자 정의 구성 요소를 개발하려면 JDP(Java Devopment Kit)를 설치해야 합니다. Amazon Corretto 또는 OpenJDK 장기 지원 버전을 사용하는 것이 좋습니다. 버전 8 이상이 필요합니다.

    참고

    Greengrass nucleus의 버전 2.5.0을 사용하려면 Java 런타임 환경(JRE)의 64비트 버전을 사용해야 합니다. Greengrass nucleus 버전 2.5.1은 32비트 및 64비트 JRE를 지원합니다.

  • AWS IoT Greengrass 코어 소프트웨어를 설치하는 사용자는 관리자여야 합니다.

  • AWS IoT Greengrass 코어 소프트웨어를 시스템 서비스로 설치해야 합니다. 소프트웨어를 설치할 때 --setup-system-service true를 지정합니다.

  • 구성 요소 프로세스를 실행하는 각 사용자는 LocalSystem 계정에 있어야 하며 사용자의 이름과 암호는 LocalSystem 계정의 Credential Manager 인스턴스에 있어야 합니다. 지침에 따라 AWS IoT Greengrass 코어 소프트웨어를 설치할 때이 사용자를 설정할 수 있습니다.

  • 코어 디바이스는 엔드포인트 및 포트 세트에 대한 아웃바운드 요청을 수행할 수 있어야 합니다. 자세한 내용은 프록시 또는 방화벽을 통해 디바이스 트래픽 허용 단원을 참조하십시오.

지원하는 플랫폼

AWS IoT Greengrass 는 다음 플랫폼을 실행하는 디바이스를 공식적으로 지원합니다. 이 목록에 포함되지 않은 플랫폼이 있는 디바이스는 작동할 수 있지만는 이러한 지정된 플랫폼에서만 AWS IoT Greengrass 테스트합니다.

Linux

아키텍처:

  • Armv7l

  • ARMv8(AArch64)

  • x86_64

Windows

아키텍처:

  • x86_64

버전:

  • Windows 10

  • Windows 11

  • Windows Server 2019

  • Windows Server 2022

참고

일부 AWS IoT Greengrass 기능은 현재 Windows 디바이스에서 지원되지 않습니다. 자세한 내용은 Greengrass 기능 호환성Windows 디바이스에 대한 기능 고려 사항 단원을 참조하세요.

Windows 디바이스에 대한 기능 고려 사항

일부 AWS IoT Greengrass 기능은 현재 Windows 디바이스에서 지원되지 않습니다. 기능 차이를 검토하여 Windows 디바이스가 요구 사항을 충족하는지 확인합니다. 자세한 내용은 Greengrass 기능 호환성 단원을 참조하십시오.

Linux 플랫폼은 Docker 컨테이너 AWS IoT Greengrass V2 에서도 실행할 수 있습니다. 자세한 내용은 Docker 컨테이너에서 AWS IoT Greengrass 코어 소프트웨어 실행 단원을 참조하십시오.

사용자 지정 Linux 기반 운영 체제를 빌드하려면 meta-aws 프로젝트에서 AWS IoT Greengrass V2 에 대한 BitBake 레시피를 사용하면 됩니다. meta-aws 프로젝트는 OpenEmbedded 및 Yocto 프로젝트 빌드 프레임워크로 빌드된 임베디드 Linux 시스템에서 AWS 엣지 소프트웨어 기능을 빌드하는 데 사용할 수 있는 레시피를 제공합니다. Yocto Project는 하드웨어 아키텍처에 관계없이 임베디드 애플리케이션을 위한 사용자 지정 Linux 기반 시스템을 빌드할 수 있도록 지원하는 오픈 소스 협업 프로젝트입니다. 디바이스에서 AWS IoT Greengrass 코어 소프트웨어를 설치, 구성 및 자동으로 실행하는 BitBake 레시피 AWS IoT Greengrass V2 입니다.

운영 체제

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

  • Linux

  • Windows

자세한 내용은 지원하는 플랫폼 단원을 참조하십시오.

요구 사항

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

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

  • Greengrass nucleus 구성 요소에는 AWS IoT data, AWS IoT Credentials 및 Amazon S3에 대한 연결이 있어야 합니다.

종속성

Greengrass nucleus에는 구성 요소 종속성이 포함되지 않습니다. 하지만 AWS에서 제공하는 여러 구성 요소에는 종속성으로 nucleus가 포함됩니다. 자세한 내용은 AWS제공 구성 요소 단원을 참조하십시오.

구성 요소 종속성에 대한 자세한 내용은 구성 요소 레시피 참조를 참조하세요.

다운로드 및 설치

디바이스에 Greengrass nucleus 구성 요소를 설정하는 설치 관리자를 다운로드할 수 있습니다. 이 설치 관리자는 디바이스를 Greengrass 코어 디바이스로 설정합니다. 수행할 수 있는 설치에는 두 가지 유형이 있습니다. 즉, 필요한 AWS 리소스를 생성하는 빠른 설치 또는 AWS 리소스를 직접 생성하는 수동 설치가 있습니다. 자세한 내용은 AWS IoT Greengrass 코어 소프트웨어 설치 단원을 참조하십시오.

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

구성

이 구성 요소는 구성 요소를 배포할 때 사용자 지정할 수 있는 다음 구성 파라미터를 제공합니다. 일부 파라미터를 사용하려면 AWS IoT Greengrass 코어 소프트웨어를 다시 시작해야 합니다. 그 이유와 이 구성 요소를 구성하는 방법에 대한 자세한 내용은 AWS IoT Greengrass 코어 소프트웨어 구성 섹션을 참조하세요.

iotRoleAlias

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

--provision true 옵션으로 AWS IoT Greengrass 코어 소프트웨어를 실행하면 소프트웨어가 역할 별칭을 프로비저닝하고 핵 구성 요소에서 해당 값을 설정합니다.

interpolateComponentConfiguration

(선택 사항) Greengrass nucleus가 구성 요소 구성에서 구성 요소 레시피 변수를 보간하고 구성 업데이트를 병합하도록 활성화할 수 있습니다. 코어 디바이스가 구성의 레시피 변수를 사용하는 Greengrass 구성 요소를 실행할 수 있도록 이 옵션을 true로 설정하는 것이 좋습니다.

이 기능은 이 구성 요소의 v2.6.0 이상에서 사용할 수 있습니다.

기본값: false

networkProxy

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

중요

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

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

noProxyAddresses

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

proxy

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

url

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

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

    중요

    Greengrass 코어 디바이스에서 HTTPS 프록시가 사용되려면 Greengrass nucleus v2.5.0 이상을 실행해야 합니다.

    HTTPS 프록시를 구성하는 경우 코어 디바이스의 Amazon 루트 CA 인증서에 프록시 서버 CA 인증서를 추가해야 합니다. 자세한 내용은 HTTPS 프록시가 신뢰될 수 있도록 코어 디바이스 설정 단원을 참조하십시오.

  • userinfo - (선택 사항) 사용자 이름 및 암호 정보입니다. url에서 이 정보를 지정하면 Greengrass 코어 디바이스에서는 usernamepassword 필드를 무시합니다.

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

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

    • http – 80

    • https – 443

username

(선택 사항) 프록시 서버를 인증하는 사용자 이름입니다.

password

(선택 사항) 프록시 서버를 인증하는 암호입니다.

mqtt

(선택 사항) Greengrass 코어 디바이스의 MQTT 구성입니다. 자세한 내용은 포트 443에서 또는 네트워크 프록시를 통해 연결 단원을 참조하십시오.

중요

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

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

port

(선택 사항) MQTT 연결에 사용할 포트입니다.

기본값: 8883

keepAliveTimeoutMs

(선택 사항) MQTT 연결을 유지하기 위해 클라이언트가 보내는 각 PING 메시지 사이의 시간(밀리초)입니다. 이 값은 pingTimeoutMs보다 커야 합니다.

기본값: 60000(60초)

pingTimeoutMs

(선택 사항) 클라이언트가 서버로부터 PINGACK 메시지를 수신하기 위해 대기하는 시간(밀리초)입니다. 대기 시간이 제한 시간을 초과하면 코어 디바이스가 닫히고 MQTT 연결을 다시 엽니다. 이 값은 keepAliveTimeoutMs보다 작아야 합니다.

기본값: 30000(30초)

operationTimeoutMs

(선택 사항) 클라이언트가 MQTT 작업(예: CONNECT 또는 PUBLISH)이 완료될 때까지 기다리는 시간(밀리초)입니다. 이 옵션은 MQTT PING 또는 연결 유지 메시지에는 적용되지 않습니다.

기본값: 30000(30초)

maxInFlightPublishes

(선택 사항) 동시에 이동할 수 있는 확인되지 않은 MQTT QoS 1 메시지의 최대 수입니다.

이 기능은 이 구성 요소의 v2.1.0 이상에서 사용할 수 있습니다.

기본값: 5

유효 범위: 최대값 100

maxMessageSizeInBytes

(선택 사항) MQTT 메시지의 최대 크기입니다. 메시지가 이 크기를 초과하면 Greengrass nucleus가 오류와 함께 메시지를 거부합니다.

이 기능은 이 구성 요소의 v2.1.0 이상에서 사용할 수 있습니다.

기본값: 131072(128KB)

유효 범위: 최대값 2621440(2.5MB)

maxPublishRetry

(선택 사항) 게시에 실패한 메시지의 최대 재시도 횟수입니다. -1을 지정하면 무제한으로 재시도할 수 있습니다.

이 기능은 이 구성 요소의 v2.1.0 이상에서 사용할 수 있습니다.

기본값: 100

spooler

(선택 사항) Greengrass 코어 디바이스의 MQTT 스풀러 구성입니다. 이 객체에는 다음 정보가 포함되어 있어야 합니다.

storageType

메시지 저장을 위한 스토리지 유형입니다. storageTypeDisk로 설정된 경우 pluginName을 구성할 수 있습니다. Memory 또는 Disk를 지정할 수 있습니다.

이 기능은 Greengrass nucleus 구성 요소의 v2.11.0 이상에서 사용할 수 있습니다.

중요

MQTT 스풀러 storageTypeDisk로 설정되어 있고 Greengrass nucleus를 버전 2.11.x에서 이보다 낮은 버전으로 다운그레이드하려는 경우 구성을 다시 Memory로 변경해야 합니다. Greengrass nucleus 버전 2.10.x 이하에서 지원되는 storageType의 유일한 구성은 Memory입니다. 이 지침을 따르지 않으면 스풀러가 손상될 수 있습니다. 이렇게 하면 Greengrass 코어 디바이스가 AWS 클라우드에 MQTT 메시지를 보낼 수 없게 됩니다.

기본값: Memory

pluginName

(선택 사항) 플러그인 구성 요소 이름입니다. 이 구성 요소는 storageTypeDisk로 설정된 경우에만 사용됩니다. 이 옵션은 기본적으로 aws.greengrass.DiskSpooler로 설정되고 Greengrass에서 제공하는 디스크 스풀러를 사용합니다.

이 기능은 Greengrass nucleus 구성 요소의 v2.11.0 이상에서 사용할 수 있습니다.

기본값: "aws.greengrass.DiskSpooler"

maxSizeInBytes

(선택 사항) 코어 디바이스가 처리되지 않은 MQTT 메시지를 메모리에 저장하는 캐시의 최대 크기입니다. 캐시가 가득 차면 새 메시지가 거부됩니다.

기본값: 2621440(2.5MB)

keepQos0WhenOffline

(선택 사항) 코어 디바이스가 오프라인 상태에서 수신하는 MQTT QoS 0 메시지를 스풀링할 수 있습니다. 이 옵션을 true로 설정하면 코어 디바이스는 오프라인 상태에서 보낼 수 없는 QoS 0 메시지를 스풀링합니다. 이 옵션을 false로 설정하면 코어 디바이스가 이러한 메시지를 폐기합니다. 코어 디바이스는 스풀이 가득 차지 않는 한 항상 QoS 1 메시지를 스풀링합니다.

기본값: false

version

(선택 사항) MQTT의 버전입니다. mqtt3 또는 mqtt5를 지정할 수 있습니다.

이 기능은 Greengrass nucleus 구성 요소의 v2.10.0 이상에서 사용할 수 있습니다.

기본값: mqtt5

receiveMaximum

(선택 사항) 브로커가 보낼 수 있는 확인되지 않은 최대 QoS1 패킷 수입니다.

이 기능은 Greengrass nucleus 구성 요소의 v2.10.0 이상에서 사용할 수 있습니다.

기본값: 100

sessionExpirySeconds

(선택 사항) 세션이 IoT 코어에서 지속되도록 요청할 수 있는 시간(초)입니다. 기본값은에서 지원하는 최대 시간입니다 AWS IoT Core.

이 기능은 Greengrass nucleus 구성 요소의 v2.10.0 이상에서 사용할 수 있습니다.

기본값: 604800 (7 days)

minimumReconnectDelaySeconds

(선택 사항) 재연결 동작 옵션입니다. MQTT가 다시 연결하는 데 걸리는 최소 시간(초)입니다.

이 기능은 Greengrass nucleus 구성 요소의 v2.10.0 이상에서 사용할 수 있습니다.

기본값: 1

maximumReconnectDelaySeconds

(선택 사항) 재연결 동작 옵션입니다. MQTT가 다시 연결하는 데 걸리는 최대 시간(초)입니다.

이 기능은 Greengrass nucleus 구성 요소의 v2.10.0 이상에서 사용할 수 있습니다.

기본값: 120

minimumConnectedTimeBeforeRetryResetSeconds

(선택 사항) 재연결 동작 옵션입니다. 재시도 지연이 최소로 재설정되기 전에 연결이 활성화되어야 하는 시간(초)입니다.

이 기능은 Greengrass nucleus 구성 요소의 v2.10.0 이상에서 사용할 수 있습니다.

기본값: 30

jvmOptions

(선택 사항) AWS IoT Greengrass 코어 소프트웨어를 실행하는 데 사용할 JVM 옵션입니다. AWS IoT Greengrass 코어 소프트웨어 실행을 위한 권장 JVM 옵션에 대한 자세한 내용은 섹션을 참조하세요JVM 옵션으로 메모리 할당 제어.

중요

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

iotDataEndpoint

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

--provision true 옵션으로 AWS IoT Greengrass 코어 소프트웨어를 실행하면 소프트웨어는에서 데이터 및 자격 증명 엔드포인트를 가져 AWS IoT 와 nucleus 구성 요소에 설정합니다.

iotCredEndpoint

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

--provision true 옵션으로 AWS IoT Greengrass 코어 소프트웨어를 실행하면 소프트웨어는에서 데이터 및 자격 증명 엔드포인트를 가져 AWS IoT 와 nucleus 구성 요소에 설정합니다.

greengrassDataPlaneEndpoint

이 기능은 이 구성 요소의 v2.7.0 이상에서 사용할 수 있습니다.

자세한 내용은 프라이빗 CA에서 서명한 디바이스 인증서 사용 단원을 참조하십시오.

greengrassDataPlanePort

이 기능은 이 구성 요소의 v2.0.4 이상에서 사용할 수 있습니다.

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

중요

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

다음 옵션 중 하나를 선택합니다.

  • 443

  • 8443

기본값: 8443

awsRegion

사용할 AWS 리전 입니다.

runWithDefault

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

중요

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

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

posixUser

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

--component-default-user ggc_user:ggc_group 옵션으로 AWS IoT Greengrass 코어 소프트웨어 설치 관리자를 실행하면 소프트웨어가 nucleus 구성 요소에서이 파라미터를 설정합니다.

windowsUser

이 기능은 이 구성 요소의 v2.5.0 이상에서 사용할 수 있습니다.

Windows 코어 디바이스에서 이 구성 요소를 실행하는 데 사용할 Windows 사용자의 이름입니다. 사용자가 각 Windows 코어 디바이스에 있어야 하며, 해당 이름과 암호가 LocalSystem 계정의 Credentials Manager 인스턴스에 저장되어야 합니다. 자세한 내용은 구성 요소를 실행하는 사용자 구성 단원을 참조하십시오.

--component-default-user ggc_user 옵션으로 AWS IoT Greengrass 코어 소프트웨어 설치 관리자를 실행하면 소프트웨어가 nucleus 구성 요소에서이 파라미터를 설정합니다.

systemResourceLimits

이 기능은 이 구성 요소의 v2.4.0 이상에서 사용할 수 있습니다. AWS IoT Greengrass 는 현재 Windows 코어 디바이스에서 이 기능을 지원하지 않습니다.

기본적으로 일반 및 컨테이너화되지 않은 Lambda 구성 요소 프로세스에 적용할 시스템 리소스 제한. 배포를 생성할 때 개별 구성 요소에 대한 시스템 리소스 제한을 재정의할 수 있습니다. 자세한 내용은 구성 요소에 대한 시스템 리소스 제한 구성 단원을 참조하십시오.

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

cpus

각 구성 요소의 프로세스가 코어 디바이스에서 사용할 수 있는 최대 CPU 시간입니다. 코어 디바이스의 총 CPU 시간은 디바이스의 CPU 코어 수와 같습니다. 예를 들어, 4개의 CPU 코어가 있는 코어 디바이스에서 이 값을 2로 설정하여 각 구성 요소의 프로세스를 각 CPU 코어 사용량의 50%로 제한할 수 있습니다. 1개의 CPU 코어가 있는 디바이스에서 이 값을 0.25로 설정하여 각 구성 요소의 프로세스를 CPU 사용량의 25%로 제한할 수 있습니다. 이 값을 CPU 코어 수보다 큰 수로 설정하면 AWS IoT Greengrass 코어 소프트웨어가 구성 요소의 CPU 사용량을 제한하지 않습니다.

memory

각 구성 요소의 프로세스가 코어 디바이스에서 사용할 수 있는 최대 RAM(KB 단위)입니다.

s3EndpointType

(선택 사항) S3 엔드포인트 유형입니다. 이 파라미터는 미국 동부(버지니아 북부)(us-east-1) 리전에만 적용됩니다. 다른 리전에서 이 파라미터를 설정하면 무시됩니다. 다음 옵션 중 하나를 선택합니다.

  • REGIONAL – S3 클라이언트 및 미리 서명된 URL이 리전 엔드포인트를 사용합니다.

  • GLOBAL – S3 클라이언트 및 미리 서명된 URL이 레거시 엔드포인트를 사용합니다.

  • DUALSTACK – S3 미리 서명된 URL은 듀얼 스택 엔드포인트를 사용합니다.

기본값: GLOBAL

fipsMode

(선택 사항) Greengrass가 FIPS 엔드포인트를 사용하게 됩니다. FIPS 엔드포인트를 활성화하는 방법에 대한 자세한 내용은 FIPS 엔드포인트를 참조하세요.

다음 옵션 중 하나를 선택합니다.

  • true true로 설정하면 엔드포인트는 FIPS 엔드포인트를 사용합니다.

  • false false일 경우 엔드포인트는 FIPS 엔드포인트를 사용하지 않습니다.

기본값: false

logging

(선택 사항) 코어 디바이스의 로깅 구성입니다. Greengrass 로그 구성 및 사용 방법에 대한 자세한 내용은 AWS IoT Greengrass 로그 모니터링 섹션을 참조하세요.

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

level

(선택 사항) 출력할 로그 메시지의 최소 수준입니다.

여기에 수준 순서대로 나열된 다음 로그 수준 중에서 선택합니다.

  • DEBUG

  • INFO

  • WARN

  • ERROR

기본값: INFO

format

(선택 사항) 로그의 데이터 형식입니다. 다음 옵션 중 하나를 선택합니다.

  • TEXT - 텍스트 형식으로 로그를 보려면 이 옵션을 선택합니다.

  • JSON - Greengrass CLI logs 명령을 사용하여 로그를 보거나 프로그래밍 방식으로 로그와 상호 작용하려면 이 옵션을 선택합니다.

기본값: TEXT

outputType

(선택 사항) 로그의 출력 유형입니다. 다음 옵션 중 하나를 선택합니다.

  • FILE – AWS IoT Greengrass 코어 소프트웨어는에서 지정한 디렉터리의 파일에 로그를 출력합니다outputDirectory.

  • CONSOLE – AWS IoT Greengrass 코어 소프트웨어는에 로그를 인쇄합니다stdout. 코어 디바이스에서 인쇄할 때 로그를 보려면 이 옵션을 선택합니다.

기본값: FILE

fileSizeKB

(선택 사항) 각 로그 파일의 최대 크기(KB)입니다. 로그 파일이이 최대 파일 크기를 초과하면 AWS IoT Greengrass 코어 소프트웨어가 새 로그 파일을 생성합니다.

이 파라미터는 outputType에 대해 FILE을 지정한 경우에만 적용됩니다.

기본값: 1024

totalLogsSizeKB

(선택 사항) Greengrass nucleus를 포함하여 각 구성 요소에 대한 로그 파일의 최대 총 크기(KB)입니다. Greengrass nucleus의 로그 파일에는 플러그인 구성 요소의 로그도 포함됩니다. 구성 요소의 총 로그 파일 크기가이 최대 크기를 초과하면 AWS IoT Greengrass 코어 소프트웨어는 해당 구성 요소의 가장 오래된 로그 파일을 삭제합니다.

이 파라미터는 Greengrass nucleus(시스템) 및 각 구성 요소에 지정할 수 있는 로그 관리자 구성 요소디스크 공간 제한 파라미터(diskSpaceLimit)와 동일합니다. AWS IoT Greengrass 코어 소프트웨어는 두 값의 최소값을 Greengrass nucleus 및 각 구성 요소의 최대 총 로그 크기로 사용합니다.

이 파라미터는 outputType에 대해 FILE을 지정한 경우에만 적용됩니다.

기본값: 10240

outputDirectory

(선택 사항) 로그 파일의 출력 디렉터리입니다.

이 파라미터는 outputType에 대해 FILE을 지정한 경우에만 적용됩니다.

기본값: /greengrass/v2/logs, 여기서 /greengrass/v2는 AWS IoT Greengrass 루트 폴더입니다.

fleetstatus

이 파라미터는 이 구성 요소의 v2.1.0 이상에서 사용할 수 있습니다.

(선택 사항) 코어 디바이스의 플릿 상태 구성입니다.

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

periodicStatusPublishIntervalSeconds

(선택 사항) 코어 디바이스가 AWS 클라우드에 디바이스 상태를 게시하는 간격의 시간(초)입니다.

최소: 86400(24시간)

기본값: 86400(24시간)

telemetry

(선택 사항) 코어 디바이스에 대한 시스템 상태 원격 측정 구성입니다. 원격 측정 지표 및 원격 측정 데이터를 활용하는 방법에 대한 자세한 내용은 AWS IoT Greengrass 코어 디바이스에서 시스템 상태 원격 측정 데이터 수집 섹션을 참조하세요.

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

enabled

(선택 사항) 원격 측정을 활성화 또는 비활성화할 수 있습니다.

기본값: true

periodicAggregateMetricsIntervalSeconds

(선택 사항) 코어 디바이스가 지표를 집계하는 간격(초)입니다.

이 값을 지원되는 최소값보다 낮게 설정하면 nucleus가 기본값을 대신 사용합니다.

최소: 3600

기본값: 3600

periodicPublishMetricsIntervalSeconds

(선택 사항) 코어 디바이스가 AWS 클라우드에 원격 측정 지표를 게시하는 간격의 시간(초)입니다.

이 값을 지원되는 최소값보다 낮게 설정하면 nucleus가 기본값을 대신 사용합니다.

최소: 86400

기본값: 86400

deploymentPollingFrequencySeconds

(선택 사항) 배포 알림을 위해 폴링할 기간(초)입니다.

기본값: 15

componentStoreMaxSizeBytes

(선택 사항) 구성 요소 레시피와 아티팩트로 구성된 구성 요소 스토어의 디스크 최대 크기입니다.

기본값: 10000000000(10GB)

platformOverride

(선택 사항) 코어 디바이스의 플랫폼을 식별하는 속성 사전입니다. 이를 사용하여 구성 요소 레시피가 구성 요소의 올바른 수명 주기 및 아티팩트를 식별하는 데 사용할 수 있는 사용자 지정 플랫폼 속성을 정의합니다. 예를 들어 하드웨어 기능 속성을 정의하여 구성 요소가 실행할 최소 아티팩트 세트만 배포할 수 있습니다. 자세한 내용은 구성 요소 레시피의 매니페스트 플랫폼 파라미터를 참조하세요.

이 파라미터를 사용하여 코어 디바이스의 osarchitecture 플랫폼 속성을 재정의할 수도 있습니다.

httpClient

이 파라미터는 이 구성 요소의 v2.5.0 이상에서 사용할 수 있습니다.

(선택 사항) 코어 디바이스의 HTTP 클라이언트 구성입니다. 이러한 구성 옵션은 이 구성 요소의 모든 HTTP 요청에 적용됩니다. 코어 디바이스가 느린 네트워크에서 실행되는 경우 이러한 제한 시간을 늘려 HTTP 요청이 제한 시간에 도달하는 것을 방지할 수 있습니다.

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

connectionTimeoutMs

(선택 사항) 연결 요청 시간이 초과되기 전에 연결이 열릴 때까지 대기하는 시간(밀리초)입니다.

기본값: 2000(2초)

socketTimeoutMs

(선택 사항) 연결 시간이 초과되기 전에 데이터가 열린 연결을 통해 전송될 때까지 대기하는 시간(밀리초)입니다.

기본값: 30000(30초)

예: 구성 병합 업데이트
{ "iotRoleAlias": "GreengrassCoreTokenExchangeRoleAlias", "networkProxy": { "noProxyAddresses": "http://192.168.0.1,www.example.com", "proxy": { "url": "http://my-proxy-server:1100", "username": "Mary_Major", "password": "pass@word1357" } }, "mqtt": { "port": 443 }, "greengrassDataPlanePort": 443, "jvmOptions": "-Xmx64m", "runWithDefault": { "posixUser": "ggc_user:ggc_group" } }

로컬 로그 파일

이 구성 요소는 다음 로그 파일을 사용합니다.

Linux
/greengrass/v2/logs/greengrass.log
Windows
C:\greengrass\v2\logs\greengrass.log
이 구성 요소의 로그를 보려면
  • Core 디바이스에서 다음과 같은 명령을 실행하여 실시간으로 이 구성 요소의 로그 파일을 봅니다. /greengrass/v2 또는 C:\greengrass\v2를 AWS IoT Greengrass 루트 폴더의 경로로 바꿉니다.

    Linux
    sudo tail -f /greengrass/v2/logs/greengrass.log
    Windows (PowerShell)
    Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait

Changelog

다음 표에는 각 구성 요소 버전의 변경 사항이 설명되어 있습니다.

버전

변경 사항

2.14.1

버그 수정 및 개선 사항

  • Greengrass를 새로 설치할 때 구성 요소가 제대로 중지되지 않는 문제를 해결합니다.

2.14.0

주의

이 버전은 더 이상 사용할 수 없습니다. 이 버전의 개선 사항은 이 구성 요소의 이후 버전에서 사용할 수 있습니다.

새로운 특성
  • 새로운 듀얼 스택 엔드포인트 지원을 통해 IPv6 네트워크 통신이 가능합니다.

  • nucleus 재시작 실패 및 Launch디렉터리 손상에 대한 복원력이 향상되었습니다.

버그 수정 및 개선 사항
  • IPC PubSub 구독 종료 시 메모리 누수를 수정합니다.

  • skipif 조건이 true일 때 시작 제한 시간으로 인해 구성 요소가 ERRORED 상태가 되는 구성 요소의 실행 수명 주기를 수정합니다.

  • TLS 정책이 TLS13_1_3_2022_10으로 설정된 경우 코어 디바이스가 AWS IoT Core 에 연결되지 않는 문제를 해결합니다.

2.13.0

새로운 특성
  • Nucleus에서 FIPS 엔드포인트가 지원됩니다.

버그 수정 및 개선 사항
  • 배포 개선 사항 취소: 이제 새 구성이 병합되는 동안과 서비스가 시작될 때까지 기다리는 동안 배포를 취소할 수 있습니다.

2.12.6

버그 수정 및 개선 사항
  • Jetson Nano를 포함한 특정 ARMv8 프로세서에서 시작 시 충돌을 일으키는 문제를 해결합니다.

2.12.5

버그 수정 및 개선 사항
  • 하드 종속성으로 이전에 손상된 구성 요소를 롤백하는 동안 배포 롤백이 간헐적으로 중단되는 문제를 해결합니다.

  • 플릿 프로비저닝 후 nucleus가 상태 업데이트를 게시하지 않는 문제를 해결합니다.

  • 404 오류 발생 이후 GetDeploymentConfiguration API에 대한 재시도가 추가됩니다.

2.12.4

버그 수정 및 개선 사항
  • 일부 Linux 디바이스 시작 도중 nucleus가 교착 상태가 되는 문제를 해결합니다.

2.12.3

주의

이 버전은 더 이상 사용할 수 없습니다. 이 버전의 개선 사항은 이 구성 요소의 이후 버전에서 사용할 수 있습니다.

버그 수정 및 개선 사항

  • nucleus가 다시 시작된 후 구성 요소 복구 중에 nucleus가 올바른 구성 요소 상태를 보고하지 않는 문제를 해결합니다.

  • 일반적인 버그 수정 및 개선입니다.

2.12.2

버그 수정 및 개선 사항
  • 이전 로그가 제대로 정리되지 않은 문제를 해결합니다.

  • 일반적인 버그 수정 및 개선입니다.

2.12.1

버그 수정 및 개선 사항
  • nucleus가 배포 주제에 대한 MQTT 구독을 복제하여 추가 로깅 및 MQTT 게시가 발생할 수 있는 문제를 해결합니다.

2.12.0

새로운 특성
  • 롤백 배포의 일부로 부트스트랩 수명 주기 단계를 실행할 수 있습니다.

2.11.3

버그 수정 및 개선 사항
  • 종속성이 실패할 때 구성 요소가 부적절하게 시작될 수 있는 nucleus 문제를 해결합니다.

새로운 특성
  • 구성 가능한 S3 엔드포인트 유형이 추가됩니다.

2.11.2

버그 수정 및 개선 사항
  • 많은 수(50개 초과)의 구독이 사용 중일 때 오프라인으로 표시될 수 있는 nucleus MQTT 5 클라이언트의 문제를 해결합니다.

  • Docker 다이얼 TCP 실패에 대한 재시도가 추가됩니다.

2.11.1

버그 수정 및 개선 사항
  • 부트스트랩 작업이 실패하고 배포 메타데이터 파일이 손상된 경우 nucleus가 시작되지 않는 문제를 해결합니다.

  • 온디맨드 Lambda 구성 요소가 배포 상태 업데이트에 보고되지 않는 문제를 해결합니다.

  • 중복 권한 부여 정책 ID에 대한 지원을 추가합니다.

2.11.0

새로운 특성
  • 로컬 배포를 취소할 수 있습니다.

  • 로컬 배포 실패 처리 정책을 구성할 수 있습니다.

  • 디스크 스풀러 플러그인에 대한 지원을 추가합니다.

2.10.3

버그 수정 및 개선 사항
  • PKCS#11 공급자를 사용할 때 Greengrass가 배포 알림을 구독하지 않는 문제를 해결합니다.

2.10.2

버그 수정 및 개선 사항
  • 구성 요소 수명 주기의 대소문자를 구분하지 않는 구문 분석이 허용됩니다.

  • 환경 PATH 변수가 올바르게 다시 생성되지 않은 문제를 해결합니다.

  • 특수 문자가 있는 사용자 이름의 스트림 관리자를 포함한 구성 요소에 대한 프록시 URI 인코딩이 수정됩니다.

2.10.1

버그 수정 및 개선 사항
  • Jetson Nano를 포함한 특정 ARMv8 프로세서에서 시작 시 충돌을 일으키는 문제를 해결합니다.

  • Greengrass가 구성 요소의 표준에서 더 이상 종료되지 않고 동작을 2.10.0 이전 동작으로 되돌립니다.

2.10.0

새로운 특성
  • 빈 정규식에 대한 interpolateComponentConfiguration 지원이 추가됩니다. 이제 Greengrass가 루트 구성 객체에서 보간합니다.

  • MQTT5에 대한 지원을 추가합니다.

  • 스캔 없이 플러그인 구성 요소를 빠르게 로드하는 메커니즘이 추가됩니다.

  • 사용하지 않는 Docker 이미지를 삭제하여 Greengrass가 디스크 공간을 절약할 수 있습니다.

버그 수정 및 개선 사항
  • 롤백이 배포에서 특정 구성 값을 그대로 두는 문제를 해결합니다.

  • Greengrass nucleus가 사용자 지정 비AWS 자격 증명 및 데이터 엔드포인트의 AWS 도메인 시퀀스에 대해 검증하는 문제를 해결합니다.

  • 다중 그룹 종속성 확인을 업데이트하여 활성 버전으로 잠그는 대신 AWS 클라우드 협상을 통해 모든 그룹 종속성을 다시 해결합니다. 이 업데이트를 통해 배포 오류 코드 INSTALLED_COMPONENT_NOT_FOUND도 제거됩니다.

  • Greengrass nucleus가 업데이트되어 로컬에 이미 있는 Docker 이미지의 다운로드를 건너뜁니다.

  • Greengrass nucleus가 업데이트되어 제한 시간이 만료되기 전에 구성 요소 설치 단계를 다시 시작합니다.

  • 사소한 추가 수정 및 개선 사항.

2.9.6

버그 수정 및 개선 사항
  • LAUNCH_DIRECTORY_CORRUPTED 오류로 인해 Greengrass 배포가 실패하고 후속 디바이스 재부팅에서 Greengrass가 시작되지 않는 문제를 해결합니다. 이 오류는 Greengrass 디바이스를 Greengrass를 다시 시작해야 하는 배포가 있는 여러 사물 그룹 간에 이동할 때 발생할 수 있습니다.

2.9.5

새로운 특성
  • Greengrass nucleus 소프트웨어 서명 확인에 대한 지원을 추가합니다.

버그 수정 및 개선 사항
  • 로컬 레시피 메타데이터 리전이 Greengrass nucleus 시작 리전과 일치하지 않을 때 배포가 실패하는 문제를 해결합니다. 이러한 일이 발생할 때 Greengrass nucleus는 이제 클라우드와 재협상합니다.

  • MQTT 메시지 스풀러가 메시지를 채우고 메시지가 제거되지 않는 문제를 해결합니다.

  • 사소한 추가 수정 및 개선 사항.

2.9.4

버그 수정 및 개선 사항
  • QOS 0 메시지를 삭제하기 전에 null 메시지를 확인합니다.

  • 1,024자 제한을 초과하는 경우 작업 상태 세부 정보 값이 잘립니다.

  • Windows용 부트스트랩 스크립트가 업데이트되어 해당 경로에 공백이 포함된 경우 Greengrass 루트 경로를 올바르게 읽습니다.

  • 구독 응답이 전송되지 않은 경우 클라이언트 메시지를 삭제 AWS IoT Core 하도록 구독을 업데이트합니다.

  • 기본 구성 파일이 손상되거나 누락된 경우 nucleus가 백업 파일에서 구성을 로드하게 됩니다.

2.9.3

버그 수정 및 개선 사항
  • MQTT 클라이언트 ID가 중복되지 않게 됩니다.

  • 더 강력한 파일 읽기 및 쓰기 기능이 추가되어 손상 방지와 복구가 가능합니다.

  • 특정 네트워크 관련 오류 시 Docker 이미지 가져오기를 재시도합니다.

  • MQTT 연결에 대해 noProxyAddresses 옵션이 추가됩니다.

2.9.2

버그 수정 및 개선 사항
  • interpolateComponentConfiguration 구성이 진행 중인 배포에 적용되지 않는 문제를 해결합니다.

  • OSHI를 사용하여 모든 하위 프로세스가 나열됩니다.

2.9.1

버그 수정 및 개선 사항
  • 배포가 플러그인 구성 요소를 제거하는 경우 Greengrass가 다시 시작되는 수정 사항이 추가됩니다.

2.9.0

새로운 특성
  • 더 작은 디바이스 하위 집합으로 배포를 재시도하는 하위 배포 생성 기능이 추가됩니다. 이 기능을 사용하면 보다 효율적으로 실패한 배포를 테스트하고 해결할 수 있습니다.

버그 수정 및 개선 사항
  • useradd, groupaddusermod가 없는 시스템에 대한 지원이 개선됩니다.

  • 사소한 추가 수정 및 개선 사항.

2.8.1

버그 수정 및 개선 사항
  • Greengrass API 오류에서 배포 오류 코드가 올바르게 생성되지 않은 문제를 해결합니다.

  • 배포 중에 구성 요소가 ERRORED 상태에 도달할 때 플릿 상태 업데이트가 부정확한 정보를 전송하는 문제를 해결합니다.

  • Greengrass에 기존 구독이 50개보다 많을 때 배포를 완료할 수 없는 문제를 해결합니다.

2.8.0

새로운 특성
  • 코어 디바이스에 구성 요소를 배포하는 데 문제가 있는 경우 자세한 오류 코드가 포함된 배포 상태 응답을 보고하도록 Greengrass nucleus가 업데이트됩니다. 자세한 내용은 세부 배포 오류 코드 단원을 참조하십시오.

  • 구성 요소가 BROKEN 또는 ERRORED 상태가 될 때 자세한 오류 코드가 포함된 구성 요소 상태 응답을 보고하도록 Greengrass nucleus가 업데이트됩니다. 자세한 내용은 세부 구성 요소 상태 코드 단원을 참조하십시오.

  • 상태 메시지 필드가 확장되어 디바이스의 클라우드 가용성 정보가 개선됩니다.

  • 플릿 상태 서비스 견고성이 개선됩니다.

버그 수정 및 개선 사항
  • 구성이 변경될 때 손상된 구성 요소를 다시 설치할 수 있습니다.

  • 부트스트랩 배포 중 nucleus 재시작으로 인해 배포가 실패하는 문제를 해결합니다.

  • Windows에서 루트 경로에 공백이 있을 때 설치가 실패하는 문제를 해결합니다.

  • 배포 중에 구성 요소가 종료되고 새 버전의 종료 스크립트를 사용하는 문제를 해결합니다.

  • 다양한 종료 개선 사항.

  • 사소한 추가 수정 및 개선 사항.

2.7.0

새로운 특성
  • 코어 디바이스가 로컬 배포를 적용할 때 AWS IoT Greengrass 클라우드로 상태 업데이트를 보내도록 Greengrass nucleus를 업데이트합니다.

  • CA가 등록되지 않은 사용자 지정 인증 기관(CA)에서 서명한 클라이언트 인증서에 대한 지원을 추가합니다 AWS IoT. 이 기능을 사용하려면 새 greengrassDataPlaneEndpoint 구성 옵션을 iotdata로 설정할 수 있습니다. 자세한 내용은 프라이빗 CA에서 서명한 디바이스 인증서 사용 단원을 참조하십시오.

버그 수정 및 개선 사항
  • nucleus가 중지되거나 다시 시작될 때 Greengrass nucleus가 특정 시나리오에서 배포를 롤백하는 문제를 해결합니다. 이제 nucleus가 다시 시작된 후 nucleus가 배포를 재개합니다.

  • 소프트웨어를 시스템 서비스로 설정하도록 지정할 때 --start 인수를 준수하도록 Greengrass 설치 관리자가 업데이트됩니다.

  • nucleus가 구성 요소를 업데이트한 이벤트에서 배포 ID를 설정하도록 SubscribeToComponentUpdates의 동작이 업데이트됩니다.

  • 사소한 추가 수정 및 개선 사항.

2.6.0

새로운 특성
  • 로컬 게시/구독 주제를 구독할 때 MQTT 와일드카드에 대한 지원을 추가합니다. 자세한 내용은 로컬 메시지 게시/구독SubscribeToTopic 단원을 참조하세요.

  • 구성 요소 구성에서 component_dependency_name:configuration:json_pointer 레시피 변수 이외의 레시피 변수에 대한 지원을 추가합니다. 레시피에서 구성 요소의 DefaultConfiguration을 정의하거나 배포에서 구성 요소를 구성할 때 이러한 레시피 변수를 사용할 수 있습니다. 이 기능을 활성화하려면 interpolateComponentConfiguration 구성 옵션을 true로 설정합니다. 자세한 내용은 레시피 변수병합 업데이트에서 레시피 변수 사용 단원을 참조하세요.

  • IPC(프로세스 간 통신) 권한 부여 정책의 * 와일드카드에 대한 전체 지원이 추가됩니다. 이제 모든 문자 조합과 일치하도록 리소스 문자열에 * 문자를 지정할 수 있습니다. 자세한 내용은 권한 부여 정책의 와일드카드 단원을 참조하십시오.

  • 사용자 지정 구성 요소에서 Greengrass CLI가 사용하는 IPC 작업을 직접 호출할 수 있도록 지원을 추가합니다. 이러한 IPC 작업을 사용하여 로컬 배포를 관리하고, 구성 요소 세부 정보를 보고, 로컬 디버그 콘솔에 로그인하는 데 사용할 수 있는 암호를 생성할 수 있습니다. 자세한 내용은 IPC: 로컬 배포 및 구성 요소 관리를 참조하세요.

버그 수정 및 개선 사항
  • 특정 시나리오에서 하드 종속성이 다시 시작되거나 상태가 변경될 때 종속 구성 요소가 반응하지 않는 문제를 해결합니다.

  • 배포가 실패할 때 코어 디바이스가 AWS IoT Greengrass 클라우드 서비스에 보고하는 오류 메시지를 개선합니다.

  • nucleus가 다시 시작되는 특정 시나리오에서 Greengrass nucleus가 사물 배포를 두 번 적용하는 문제를 해결합니다.

  • 사소한 추가 수정 및 개선 사항. 자세한 내용은 GitHub의 릴리스를 참조하세요.

2.5.6

새로운 특성
  • ECC 키를 사용하는 하드웨어 보안 모듈에 대한 지원을 추가합니다. HSM(하드웨어 보안 모듈)을 사용하여 디바이스의 프라이빗 키와 인증서를 안전하게 저장할 수 있습니다. 자세한 내용은 하드웨어 보안 통합 단원을 참조하십시오.

버그 수정 및 개선 사항
  • 특정 시나리오에서 설치 스크립트가 손상된 구성 요소를 배포할 때 배포가 완료되지 않는 문제를 해결합니다.

  • 시작 중 성능이 개선됩니다.

  • 사소한 추가 수정 및 개선 사항.

2.5.5

새로운 특성
  • 구성 요소에 대해 GG_ROOT_CA_PATH 환경 변수가 추가되어 사용자 지정 구성 요소의 루트 CA(인증 기관) 인증서에 액세스할 수 있습니다.

버그 수정 및 개선 사항
  • 영어 이외의 표시 언어를 사용하는 Windows 디바이스에 대한 지원을 추가합니다.

  • Greengrass nucleus가 부울 설치 관리자 인수를 구문 분석하는 방법이 업데이트되어 부울 값 없이 부울 인수를 지정하여 true 값을 지정할 수 있습니다. 예를 들어 이제 --provision true 대신 --provision을 지정하여 자동 리소스 프로비저닝을 사용하여 설치할 수 있습니다.

  • 또한 특정 시나리오에서 프로비저닝 후 코어 디바이스가 AWS IoT Greengrass 클라우드 서비스에 상태를 보고하지 않는 문제를 해결합니다.

  • 사소한 추가 수정 및 개선 사항.

2.5.4

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

2.5.3

새로운 특성
  • 하드웨어 보안 통합에 대한 지원을 추가합니다. HSM(하드웨어 보안 모듈)을 사용하여 디바이스의 프라이빗 키와 인증서를 안전하게 저장할 수 있습니다. 자세한 내용은 하드웨어 보안 통합 단원을 참조하십시오.

버그 수정 및 개선 사항
  • nucleus가 AWS IoT Core와의 MQTT 연결을 설정하는 동안 런타임 예외 문제를 해결합니다.

2.5.2

버그 수정 및 개선 사항
  • Greengrass nucleus가 업데이트된 후 Windows 서비스가 중지하거나 디바이스를 재부팅한 후 다시 시작되지 않는 문제를 해결합니다.

2.5.1

주의

이 버전은 더 이상 사용할 수 없습니다. 이 버전의 개선 사항은 이 구성 요소의 이후 버전에서 사용할 수 있습니다.

버그 수정 및 개선 사항
  • Windows에서 Java 런타임 환경(JRE)의 32비트 버전에 대한 지원을 추가합니다.

  • AWS IoT 정책이 greengrass:ListThingGroupsForCoreDevice 권한을 부여하지 않는 코어 디바이스에 대한 사물 그룹 제거 동작이 변경됩니다. 이 버전을 사용하면 배포가 계속되고, 경고가 기록되며, 사물 그룹에서 코어 디바이스를 제거할 때 구성 요소가 제거되지 않습니다. 자세한 내용은 디바이스에 AWS IoT Greengrass 구성 요소 배포 단원을 참조하십시오.

  • Greengrass 구성 요소 프로세스에 Greengrass nucleus가 제공되도록 시스템 환경 변수 관련 문제를 해결합니다. 이제 구성 요소를 다시 시작하여 최신 시스템 환경 변수를 사용할 수 있습니다.

2.5.0

새로운 특성
  • Windows가 실행되는 코어 디바이스에 대한 지원을 추가합니다.

  • 사물 그룹 제거 동작이 변경됩니다. 이 버전을 사용하면 사물 그룹에서 코어 디바이스를 제거하여 다음 배포에서 사물 그룹의 구성 요소를 제거할 수 있습니다.

    이 변경으로 인해 코어 디바이스의 AWS IoT 정책에 greengrass:ListThingGroupsForCoreDevice 권한이 있어야 합니다. AWS IoT Greengrass 코어 소프트웨어 설치 관리자를 사용하여 리소스를 프로비저닝한 경우 기본 AWS IoT 정책은이 권한을 greengrass:*포함하는를 허용합니다. 자세한 내용은 에 대한 디바이스 인증 및 권한 부여 AWS IoT Greengrass 단원을 참조하십시오.

  • HTTPS 프록시 구성에 대한 지원을 추가합니다. 자세한 내용은 포트 443에서 또는 네트워크 프록시를 통해 연결 단원을 참조하십시오.

  • windowsUser 구성 파라미터가 추가됩니다. 이 파라미터를 사용하여 Windows 코어 디바이스에서 구성 요소 실행에 사용할 기본 사용자를 지정할 수 있습니다. 자세한 내용은 구성 요소를 실행하는 사용자 구성 단원을 참조하십시오.

  • 느린 네트워크에서 성능을 개선하기 위해 HTTP 요청 제한 시간을 사용자 지정하는 데 사용할 수 있는 httpClient 구성 옵션이 새로 추가됩니다. 자세한 내용은 httpClient 구성 파라미터를 참조하세요.

버그 수정 및 개선 사항
  • 부트스트랩 수명 주기 옵션이 수정되어 구성 요소에서 코어 디바이스를 다시 시작합니다.

  • 레시피 변수의 하이픈에 대한 지원을 추가합니다.

  • 온디맨드 Lambda 함수 구성 요소에 대한 IPC 권한 부여가 수정됩니다.

  • 로그 메시지가 개선되고 중요하지 않은 로그가 INFO에서 DEBUG 수준으로 변경되어 유용성이 증가합니다.

  • 자동 프로비저닝으로 AWS IoT Greengrass 코어 소프트웨어를 설치할 때 Greengrass nucleus가 생성하는 기본 토큰 교환 역할에서 iot:DescribeCertificate 권한을 제거합니다. 이 권한은 Greengrass nucleus에서 사용하지 않습니다.

  • iam:CreatePolicy를 동일한 정책에 사용할 수 있는 경우 자동 프로비저닝 스크립트에 iam:GetPolicy 권한이 필요하지 않도록 문제를 해결합니다.

  • 사소한 추가 수정 및 개선 사항.

2.4.0

새로운 특성
  • 시스템 리소스 제한에 대한 지원을 추가합니다. 각 구성 요소의 프로세스가 코어 디바이스에서 사용할 수 있는 최대 CPU 및 RAM 사용량을 구성할 수 있습니다. 자세한 내용은 구성 요소에 대한 시스템 리소스 제한 구성 단원을 참조하십시오.

  • 구성 요소를 일시 중지하고 재개하도록 IPC 작업이 추가됩니다. 자세한 내용은 PauseComponentResumeComponent 단원을 참조하세요.

  • 플러그인 프로비저닝에 대한 지원을 추가합니다. 설치 중에 실행할 JAR 파일을 지정하여 Greengrass 코어 디바이스에 필요한 AWS 리소스를 프로비저닝할 수 있습니다. Greengrass nucleus에는 사용자 지정 프로비저닝 플러그인 개발을 구현할 수 있는 인터페이스가 포함되어 있습니다. 자세한 내용은 사용자 지정 리소스 프로비저닝을 사용하여 AWS IoT Greengrass 코어 소프트웨어 설치 단원을 참조하십시오.

  • AWS IoT Greengrass 코어 소프트웨어 설치 프로그램에 선택적 thing-name-policy 인수를 추가합니다. 자동 리소스 프로비저닝으로 코어 소프트웨어를 설치할 때이 옵션을 사용하여 기존 또는 사용자 지정 AWS IoT 정책을 지정할 수 있습니다. AWS IoT Greengrass

버그 수정 및 개선 사항
  • 시작 시 로깅 구성이 업데이트됩니다. 이렇게 하면 시작 시 로깅 구성이 적용되지 않는 문제를 해결합니다.

  • 설치 중에 Greengrass 루트 폴더의 구성 요소 스토어를 가리키도록 nucleus 로더 심링크가 업데이트됩니다. 이 업데이트를 사용하면 AWS IoT Greengrass 코어 소프트웨어를 설치할 때 다운로드하는 JAR 파일 및 기타 nucleus 아티팩트를 삭제할 수 있습니다.

  • 사소한 추가 수정 및 개선 사항. 자세한 내용은 GitHub의 릴리스를 참조하세요.

2.3.0

새로운 특성
  • iot:thingName 레시피 변수가 추가됩니다. 이 레시피 변수를 사용하여 레시피 AWS IoT 에서 코어 디바이스 사물의 이름을 가져올 수 있습니다. 자세한 내용은 레시피 변수 단원을 참조하십시오.

버그 수정 및 개선 사항
  • 사소한 추가 수정 및 개선 사항. 자세한 내용은 GitHub의 릴리스를 참조하세요.

2.2.0

새로운 특성
  • 로컬 섀도 관리를 위한 IPC 작업이 추가됩니다.

버그 수정 및 개선 사항
  • JAR 파일의 크기가 감소합니다.

  • 메모리 사용량이 감소합니다.

  • 경우에 따라 로그 구성이 업데이트되지 않는 문제가 해결됩니다.

  • 사소한 추가 수정 및 개선 사항. 자세한 내용은 GitHub의 릴리스를 참조하세요.

2.1.0

새로운 특성
  • Amazon ECR의 프라이빗 리포지토리에서 Docker 이미지 다운로드가 지원됩니다.

  • 다음 파라미터가 추가되어 코어 디바이스에서 MQTT 구성을 사용자 지정합니다.

    • maxInFlightPublishes - 동시에 이동할 수 있는 확인되지 않은 MQTT QoS 1 메시지의 최대 수입니다.

    • maxPublishRetry - 게시에 실패한 메시지의 최대 재시도 횟수입니다.

  • fleetstatusservice 구성 파라미터가 추가되어 코어 디바이스가 디바이스 상태를 AWS 클라우드에 게시하는 간격을 구성합니다.

  • 사소한 추가 수정 및 개선 사항. 자세한 내용은 GitHub의 릴리스를 참조하세요.

버그 수정 및 개선 사항
  • nucleus가 다시 시작될 때 섀도 배포가 중복되는 문제를 해결합니다.

  • 서비스 로드 예외가 발생했을 때 nucleus가 충돌하는 문제를 해결합니다.

  • 순환 종속성이 포함된 배포 실패에 대한 구성 요소 종속성 확인이 개선됩니다.

  • 해당 구성 요소가 이전에 코어 디바이스에서 제거된 경우 플러그인 구성 요소가 재배포되지 않는 문제를 해결합니다.

  • HOME 환경 변수가 Lambda 구성 요소 또는 루트로 실행되는 구성 요소의 /greengrass/v2/work 디렉터리로 설정되는 문제가 해결됩니다. 이제 HOME 변수가 구성 요소를 실행하는 사용자의 홈 디렉터리로 올바르게 설정됩니다.

  • 사소한 추가 수정 및 개선 사항. 자세한 내용은 GitHub의 릴리스를 참조하세요.

2.0.5

버그 수정 및 개선 사항
  • AWS제공된 구성 요소를 다운로드할 때 구성된 네트워크 프록시를 통해 트래픽을 올바르게 라우팅합니다.

  • AWS 중국 리전에서 올바른 Greengrass 데이터 영역 엔드포인트를 사용합니다.

2.0.4

새로운 특성
  • 포트 443을 통한 HTTPS 트래픽이 활성화됩니다. nucleus 구성 요소의 버전 2.0.4에 대한 새 greengrassDataPlanePort 구성 파라미터를 사용하여 기본 포트 8443 대신 포트 443을 통해 이동하도록 HTTPS 통신을 구성할 수 있습니다. 자세한 내용은 포트 443을 통해 HTTPS 구성 단원을 참조하십시오.

  • 작업 경로 레시피 변수가 추가됩니다. 이 레시피 변수를 사용하여 구성 요소의 작업 폴더 경로를 가져올 수 있고, 이 폴더를 사용하여 구성 요소와 해당 종속성 간에 파일을 공유할 수 있습니다. 자세한 내용은 작업 경로 레시피 변수를 참조하세요.

버그 수정 및 개선 사항
  • 역할 정책이 이미 있는 경우 토큰 교환 AWS Identity and Access Management (IAM) 역할 정책의 생성을 방지합니다.

    이 변경으로 인해 --provision true로 실행할 때 설치 관리자에 iam:GetPolicysts:GetCallerIdentity가 필요합니다. 자세한 내용은 설치 관리자가 리소스를 프로비저닝하기 위한 최소 IAM 정책 단원을 참조하십시오.

  • 아직 성공적으로 등록되지 않은 배포의 취소가 올바르게 처리됩니다.

  • 배포를 롤백할 때 최신 타임스탬프가 있는 이전 항목을 제거하도록 구성이 업데이트됩니다.

  • 사소한 추가 수정 및 개선 사항. 자세한 내용은 GitHub의 릴리스를 참조하세요.

2.0.3

초기 버전입니다.