기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
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 사용 단원을 참조하십시오.
지원하는 플랫폼
AWS IoT Greengrass 는 다음 플랫폼을 실행하는 디바이스를 공식적으로 지원합니다. 이 목록에 포함되지 않은 플랫폼이 있는 디바이스는 작동할 수 있지만는 이러한 지정된 플랫폼에서만 AWS IoT Greengrass 테스트합니다.
Windows 디바이스에 대한 기능 고려 사항
일부 AWS IoT Greengrass 기능은 현재 Windows 디바이스에서 지원되지 않습니다. 기능 차이를 검토하여 Windows 디바이스가 요구 사항을 충족하는지 확인합니다. 자세한 내용은 Greengrass 기능 호환성 단원을 참조하십시오.
Linux 플랫폼은 Docker 컨테이너 AWS IoT Greengrass V2 에서도 실행할 수 있습니다. 자세한 내용은 Docker 컨테이너에서 AWS IoT Greengrass 코어 소프트웨어 실행 단원을 참조하십시오.
사용자 지정 Linux 기반 운영 체제를 빌드하려면 meta-aws
프로젝트meta-aws
프로젝트는 OpenEmbedded
운영 체제
이 구성 요소는 다음 운영 체제를 실행하는 코어 디바이스에 설치할 수 있습니다.
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 코어 디바이스에서는username
및password
필드를 무시합니다. -
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
)이 완료될 때까지 기다리는 시간(밀리초)입니다. 이 옵션은 MQTTPING
또는 연결 유지 메시지에는 적용되지 않습니다.기본값:
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
-
메시지 저장을 위한 스토리지 유형입니다.
storageType
이Disk
로 설정된 경우pluginName
을 구성할 수 있습니다.Memory
또는Disk
를 지정할 수 있습니다.이 기능은 Greengrass nucleus 구성 요소의 v2.11.0 이상에서 사용할 수 있습니다.
중요
MQTT 스풀러
storageType
이Disk
로 설정되어 있고 Greengrass nucleus를 버전 2.11.x에서 이보다 낮은 버전으로 다운그레이드하려는 경우 구성을 다시Memory
로 변경해야 합니다. Greengrass nucleus 버전 2.10.x 이하에서 지원되는storageType
의 유일한 구성은Memory
입니다. 이 지침을 따르지 않으면 스풀러가 손상될 수 있습니다. 이렇게 하면 Greengrass 코어 디바이스가 AWS 클라우드에 MQTT 메시지를 보낼 수 없게 됩니다.기본값:
Memory
pluginName
-
(선택 사항) 플러그인 구성 요소 이름입니다. 이 구성 요소는
storageType
이Disk
로 설정된 경우에만 사용됩니다. 이 옵션은 기본적으로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
옵션으로 AWS IoT Greengrass 코어 소프트웨어 설치 관리자를 실행하면 소프트웨어가 nucleus 구성 요소에서이 파라미터를 설정합니다.ggc_user
:ggc_group
windowsUser
-
이 기능은 이 구성 요소의 v2.5.0 이상에서 사용할 수 있습니다.
Windows 코어 디바이스에서 이 구성 요소를 실행하는 데 사용할 Windows 사용자의 이름입니다. 사용자가 각 Windows 코어 디바이스에 있어야 하며, 해당 이름과 암호가 LocalSystem 계정의 Credentials Manager 인스턴스에 저장되어야 합니다. 자세한 내용은 구성 요소를 실행하는 사용자 구성 단원을 참조하십시오.
--component-default-user
옵션으로 AWS IoT Greengrass 코어 소프트웨어 설치 관리자를 실행하면 소프트웨어가 nucleus 구성 요소에서이 파라미터를 설정합니다.ggc_user
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
을 지정한 경우에만 적용됩니다.기본값:
, 여기서
/logs/greengrass/v2
는 AWS IoT Greengrass 루트 폴더입니다./greengrass/v2
-
-
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
-
(선택 사항) 코어 디바이스의 플랫폼을 식별하는 속성 사전입니다. 이를 사용하여 구성 요소 레시피가 구성 요소의 올바른 수명 주기 및 아티팩트를 식별하는 데 사용할 수 있는 사용자 지정 플랫폼 속성을 정의합니다. 예를 들어 하드웨어 기능 속성을 정의하여 구성 요소가 실행할 최소 아티팩트 세트만 배포할 수 있습니다. 자세한 내용은 구성 요소 레시피의 매니페스트 플랫폼 파라미터를 참조하세요.
이 파라미터를 사용하여 코어 디바이스의
os
및architecture
플랫폼 속성을 재정의할 수도 있습니다. -
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" } }
로컬 로그 파일
이 구성 요소는 다음 로그 파일을 사용합니다.
이 구성 요소의 로그를 보려면
-
Core 디바이스에서 다음과 같은 명령을 실행하여 실시간으로 이 구성 요소의 로그 파일을 봅니다.
또는/greengrass/v2
C:\greengrass\v2
를 AWS IoT Greengrass 루트 폴더의 경로로 바꿉니다.
Changelog
다음 표에는 각 구성 요소 버전의 변경 사항이 설명되어 있습니다.
버전 |
변경 사항 |
---|---|
2.14.1 |
버그 수정 및 개선 사항
|
2.14.0 |
주의이 버전은 더 이상 사용할 수 없습니다. 이 버전의 개선 사항은 이 구성 요소의 이후 버전에서 사용할 수 있습니다.
|
2.13.0 |
|
2.12.6 |
|
2.12.5 |
|
2.12.4 |
|
2.12.3 |
주의이 버전은 더 이상 사용할 수 없습니다. 이 버전의 개선 사항은 이 구성 요소의 이후 버전에서 사용할 수 있습니다. 버그 수정 및 개선 사항
|
2.12.2 |
|
2.12.1 |
|
2.12.0 |
|
2.11.3 |
|
2.11.2 |
|
2.11.1 |
|
2.11.0 |
|
2.10.3 |
|
2.10.2 |
|
2.10.1 |
|
2.10.0 |
|
2.9.6 |
|
2.9.5 |
|
2.9.4 |
|
2.9.3 |
|
2.9.2 |
|
2.9.1 |
|
2.9.0 |
|
2.8.1 |
|
2.8.0 |
|
2.7.0 |
|
2.6.0 |
|
2.5.6 |
|
2.5.5 |
|
2.5.4 |
|
2.5.3 |
|
2.5.2 |
|
2.5.1 |
주의이 버전은 더 이상 사용할 수 없습니다. 이 버전의 개선 사항은 이 구성 요소의 이후 버전에서 사용할 수 있습니다.
|
2.5.0 |
|
2.4.0 |
|
2.3.0 |
|
2.2.0 |
|
2.1.0 |
|
2.0.5 |
|
2.0.4 |
|
2.0.3 |
초기 버전입니다. |