기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
섀도 관리자
섀도 관리자 구성 요소(aws.greengrass.ShadowManager)는 코어 디바이스에서 로컬 섀도 서비스를 활성화합니다. 로컬 섀도 서비스를 사용하면 구성 요소가 프로세스 간 통신을 사용하여 로컬 섀도와 상호 작용할 수 있습니다. 섀도우 관리자 구성 요소는 로컬 섀도우 문서의 스토리지를 관리하고 AWS IoT Device Shadow 서비스와 로컬 섀도우 상태의 동기화도 처리합니다.
Greengrass 코어 디바이스가 섀도와 상호 작용하는 방법에 대한 자세한 내용은 디바이스 섀도우와 연동 섹션을 참조하세요.
버전
이 구성 요소에는 다음과 같은 버전이 있습니다.
유형
이 구성 요소는 플러그인 구성 요소(aws.greengrass.plugin)입니다. Greengrass 핵은 핵과 동일한 Java 가상 머신(JVM)에서이 구성 요소를 실행합니다. 코어 디바이스에서 구성 요소의 버전을 변경하면 nucleus가 다시 시작됩니다.
이 구성 요소에서는 Greengrass nucleus와 동일한 로그 파일이 사용됩니다. 자세한 내용은 AWS IoT Greengrass 로그 모니터링 단원을 참조하십시오.
자세한 내용은 구성 요소 유형 단원을 참조하십시오.
운영 체제
이 구성 요소는 다음 운영 체제를 실행하는 코어 디바이스에 설치할 수 있습니다.
요구 사항
이 구성 요소에는 다음과 같은 요구 사항이 있습니다.
-
(선택 사항) 섀도우를 AWS IoT Device Shadow 서비스에 동기화하려면 Greengrass 코어 디바이스의 AWS IoT 정책에서 다음 AWS IoT Core 섀도우 정책 작업을 허용해야 합니다.
-
iot:GetThingShadow
-
iot:UpdateThingShadow
-
iot:DeleteThingShadow
이러한 AWS IoT Core 정책에 대한 자세한 내용은 AWS IoT 개발자 안내서의 AWS IoT Core 정책 작업을 참조하세요.
최소 AWS IoT 정책에 대한 자세한 내용은 섹션을 참조하세요. AWS IoT Greengrass V2 코어 디바이스에 대한 최소 AWS IoT 정책
-
섀도우 관리자 구성 요소는에서 실행할 수 있습니다VPC.
종속성
구성 요소를 배포할 때는 호환되는 버전의 종속성 AWS IoT Greengrass 도 배포합니다. 즉, 구성 요소를 성공적으로 배포하려면 구성 요소 및 모든 해당 종속성에 대한 요구 사항을 충족해야 합니다. 이 단원에는 이 구성 요소의 릴리스된 버전에 대한 종속성과 각 종속성에 대한 구성 요소 버전을 정의하는 의미 체계 버전 제약 조건이 나열되어 있습니다. AWS IoT Greengrass 콘솔에서도 각 구성 요소 버전에 대한 종속성을 볼 수 있습니다. 구성 요소 세부 정보 페이지에서 종속성 목록을 찾습니다.
- 2.3.10
-
다음 표에는이 구성 요소의 버전 2.3.10에 대한 종속성이 나열되어 있습니다.
- 2.3.9
-
다음 표에는 이 구성 요소의 버전 2.3.9에 대한 종속성이 나열되어 있습니다.
- 2.3.5 – 2.3.8
-
다음 표에는 이 구성 요소의 버전 2.3.5~2.3.8에 대한 종속성이 나열되어 있습니다.
- 2.3.3 and 2.3.4
-
다음 표에는 이 구성 요소의 버전 2.3.3 및 2.3.4에 대한 종속성이 나열되어 있습니다.
- 2.3.2
-
다음 표에는 이 구성 요소의 버전 2.3.2에 대한 종속성이 나열되어 있습니다.
- 2.3.0 and 2.3.1
-
다음 표에는 이 구성 요소의 버전 2.3.0 및 2.3.1에 대한 종속성이 나열되어 있습니다.
- 2.2.3 and 2.2.4
-
다음 표에는 이 구성 요소의 버전 2.2.3 및 2.2.4에 대한 종속성이 나열되어 있습니다.
- 2.2.2
-
다음 표에는 이 구성 요소의 버전 2.2.2에 대한 종속성이 나열되어 있습니다.
- 2.2.1
-
다음 표에는 이 구성 요소의 버전 2.2.1에 대한 종속성이 나열되어 있습니다.
- 2.1.1 and 2.2.0
-
다음 표에는 이 구성 요소의 버전 2.1.1 및 2.2.0에 대한 종속성이 나열되어 있습니다.
- 2.0.5 - 2.1.0
-
다음 표에는 이 구성 요소의 버전 2.0.5~2.1.0에 대한 종속성이 나열되어 있습니다.
- 2.0.3 and 2.0.4
-
다음 표에는 이 구성 요소의 버전 2.0.3 및 2.0.4에 대한 종속성이 나열되어 있습니다.
- 2.0.1 and 2.0.2
-
다음 표에는 이 구성 요소의 버전 2.0.1 및 2.0.2에 대한 종속성이 나열되어 있습니다.
- 2.0.0
-
다음 표에는 이 구성 요소의 버전 2.0.0에 대한 종속성이 나열되어 있습니다.
구성 요소 종속성에 대한 자세한 내용은 구성 요소 레시피 참조를 참조하세요.
구성
이 구성 요소는 구성 요소를 배포할 때 사용자 지정할 수 있는 다음 구성 파라미터를 제공합니다.
- 2.3.x
-
strategy-
(선택 사항)이 구성 요소가 AWS IoT Core 와 코어 디바이스 간에 섀도우를 동기화하는 데 사용하는 전략입니다.
이 객체에는 다음 정보가 포함됩니다.
type-
(선택 사항) 이 구성 요소가 AWS IoT Core 와 코어 디바이스 간에 섀도를 동기화하는 데 사용하는 전략의 유형. 다음 옵션 중 하나를 선택합니다.
기본값: realTime
delay-
(선택 사항) periodic 동기화 전략을 지정하는 경우 이 구성 요소가 섀도를 AWS IoT Core와 동기화하는 간격(초).
이 파라미터는 periodic 동기화 전략을 지정하는 경우에 필요합니다.
synchronize-
(선택 사항) 섀도가 AWS 클라우드와 동기화되는 방법을 결정하는 동기화 설정.
섀도를 AWS 클라우드와 동기화하려면 이 속성으로 구성 업데이트를 생성해야 합니다.
이 객체에는 다음 정보가 포함됩니다.
coreThing-
(선택 사항) 동기화할 코어 디바이스 섀도. 이 객체에는 다음 정보가 포함됩니다.
classic-
(선택 사항) 기본적으로 섀도 관리자는 코어 디바이스에 대한 클래식 섀도의 로컬 상태를 AWS 클라우드와 동기화합니다. 클래식 디바이스 섀도를 동기화하지 않으려면 이를 false로 설정합니다.
기본값: true
namedShadows-
(선택 사항) 동기화할 이름이 지정된 코어 디바이스 섀도의 목록. 섀도의 정확한 이름을 지정해야 합니다.
AWS IoT Greengrass 서비스는 AWSManagedGreengrassV2Deployment명명된 섀도우를 사용하여 개별 코어 디바이스를 대상으로 하는 배포를 관리합니다. 이 명명된 섀도우는 AWS IoT Greengrass 서비스에서 사용하도록 예약되어 있습니다. 이 이름이 지정된 섀도를 업데이트하거나 삭제하지 마세요.
shadowDocumentsMap-
(선택 사항) 동기화할 추가 디바이스 섀도. 이 구성 파라미터를 사용하면 섀도 문서를 더 간편하게 지정할 수 있습니다. 이 파라미터를 shadowDocuments 객체 대신 사용하는 것이 좋습니다.
shadowDocumentsMap 객체를 지정하는 경우 shadowDocuments 객체를 지정해서는 안 됩니다.
각 객체에는 다음 정보가 포함되어 있습니다.
thingName-
이 섀도우 구성에 대한 섀도우 구성thingName입니다.
classic-
(선택 사항) 클래식 디바이스 섀도를 thingName 디바이스와 동기화하지 않으려면 이를 false로 설정합니다.
namedShadows-
동기화하려는 이름이 지정된 섀도의 목록. 섀도의 정확한 이름을 지정해야 합니다.
shadowDocuments-
(선택 사항) 동기화할 추가 디바이스 섀도의 목록. shadowDocumentsMap 파라미터를 대신 사용하는 것이 좋습니다.
shadowDocuments 객체를 지정하는 경우 shadowDocumentsMap 객체를 지정해서는 안 됩니다.
이 목록의 각 객체에는 다음 정보가 포함되어 있습니다.
thingName-
섀도를 동기화할 디바이스의 사물 이름.
classic-
(선택 사항) 클래식 디바이스 섀도를 thingName 디바이스와 동기화하지 않으려면 이를 false로 설정합니다.
기본값: true
namedShadows-
(선택 사항) 동기화하려는 이름이 지정된 디바이스 섀도의 목록. 섀도의 정확한 이름을 지정해야 합니다.
direction-
(선택 사항) 로컬 섀도 서비스와 AWS 클라우드간에 섀도를 동기화하는 방향. AWS 클라우드에 대한 대역폭 및 연결을 줄이도록 이 옵션을 구성할 수 있습니다. 다음 옵션 중 하나를 선택합니다.
-
betweenDeviceAndCloud - 로컬 섀도 서비스와 AWS 클라우드간에 섀도를 동기화합니다.
-
deviceToCloud – 로컬 섀도우 서비스에서 로 섀도우 업데이트를 보내고에서 섀도우 업데이트를 AWS 클라우드무시합니다 AWS 클라우드.
-
cloudToDevice - AWS 클라우드에서 섀도 업데이트를 수신하고 섀도 업데이트를 로컬 섀도 서비스에서 AWS 클라우드로 전송하지 않습니다.
기본값: BETWEEN_DEVICE_AND_CLOUD
rateLimits-
(선택 사항) 섀도 서비스 요청의 속도 제한을 결정하는 설정.
이 객체에는 다음 정보가 포함됩니다.
maxOutboundSyncUpdatesPerSecond-
(선택 사항) 디바이스가 전송하는 초당 최대 동기화 요청 수.
기본값: 초당 100개 요청
maxTotalLocalRequestsRate-
(선택 사항) 코어 디바이스로 전송되는 초당 최대 로컬 IPC 요청 수입니다.
기본값: 초당 200개 요청
maxLocalRequestsPerSecondPerThing-
(선택 사항) 연결된 각 IoT 사물에 대해 전송되는 초당 최대 로컬 IPC 요청 수입니다.
기본값: 각 사물에 대해 초당 20개 요청
이러한 속도 제한 파라미터는 로컬 섀도 서비스에 대한 초당 최대 요청 수를 정의합니다. AWS IoT Device Shadow 서비스에 대한 초당 최대 요청 수는에 따라 다릅니다 AWS 리전. 자세한 내용은의 AWS IoT 디바이스 섀도우 서비스에 API 대한 제한을 참조하세요Amazon Web Services 일반 참조.
shadowDocumentSizeLimitBytes-
(선택 사항) 로컬 섀도우에 대해 허용되는 각 JSON 상태 문서의 최대 크기입니다.
이 값을 늘리면 클라우드 섀도우에 대한 JSON 상태 문서의 리소스 한도도 늘려야 합니다. 자세한 내용은의 AWS IoT 디바이스 섀도우 서비스에 API 대한 제한을 참조하세요Amazon Web Services 일반 참조.
기본값: 8,192바이트
최대: 30,720바이트
예: 구성 병합 업데이트
다음 예제에서는 섀도 관리자 구성 요소에 사용 가능한 모든 구성 파라미터가 포함된 샘플 구성 병합 업데이트를 보여줍니다.
{
"strategy":{
"type":"periodic",
"delay":300
},
"synchronize":{
"shadowDocumentsMap":{
"MyDevice1":{
"classic":false,
"namedShadows":[
"MyShadowA",
"MyShadowB"
]
},
"MyDevice2":{
"classic":true,
"namedShadows":[]
}
},
"direction":"betweenDeviceAndCloud"
},
"rateLimits":{
"maxOutboundSyncUpdatesPerSecond":100,
"maxTotalLocalRequestsRate":200,
"maxLocalRequestsPerSecondPerThing":20
},
"shadowDocumentSizeLimitBytes":8192
}
- 2.2.x
-
strategy-
(선택 사항)이 구성 요소가 AWS IoT Core 와 코어 디바이스 간에 섀도우를 동기화하는 데 사용하는 전략입니다.
이 객체에는 다음 정보가 포함됩니다.
type-
(선택 사항) 이 구성 요소가 AWS IoT Core 와 코어 디바이스 간에 섀도를 동기화하는 데 사용하는 전략의 유형. 다음 옵션 중 하나를 선택합니다.
기본값: realTime
delay-
(선택 사항) periodic 동기화 전략을 지정하는 경우 이 구성 요소가 섀도를 AWS IoT Core와 동기화하는 간격(초).
이 파라미터는 periodic 동기화 전략을 지정하는 경우에 필요합니다.
synchronize-
(선택 사항) 섀도가 AWS 클라우드와 동기화되는 방법을 결정하는 동기화 설정.
섀도를 AWS 클라우드와 동기화하려면 이 속성으로 구성 업데이트를 생성해야 합니다.
이 객체에는 다음 정보가 포함됩니다.
coreThing-
(선택 사항) 동기화할 코어 디바이스 섀도. 이 객체에는 다음 정보가 포함됩니다.
classic-
(선택 사항) 기본적으로 섀도 관리자는 코어 디바이스에 대한 클래식 섀도의 로컬 상태를 AWS 클라우드와 동기화합니다. 클래식 디바이스 섀도를 동기화하지 않으려면 이를 false로 설정합니다.
기본값: true
namedShadows-
(선택 사항) 동기화할 이름이 지정된 코어 디바이스 섀도의 목록. 섀도의 정확한 이름을 지정해야 합니다.
AWS IoT Greengrass 서비스는 AWSManagedGreengrassV2Deployment명명된 섀도우를 사용하여 개별 코어 디바이스를 대상으로 하는 배포를 관리합니다. 이 명명된 섀도우는 AWS IoT Greengrass 서비스에서 사용하도록 예약되어 있습니다. 이 이름이 지정된 섀도를 업데이트하거나 삭제하지 마세요.
shadowDocumentsMap-
(선택 사항) 동기화할 추가 디바이스 섀도. 이 구성 파라미터를 사용하면 섀도 문서를 더 간편하게 지정할 수 있습니다. 이 파라미터를 shadowDocuments 객체 대신 사용하는 것이 좋습니다.
shadowDocumentsMap 객체를 지정하는 경우 shadowDocuments 객체를 지정해서는 안 됩니다.
각 객체에는 다음 정보가 포함되어 있습니다.
thingName-
이 섀도우 구성에 대한 섀도우 구성thingName입니다.
classic-
(선택 사항) 클래식 디바이스 섀도를 thingName 디바이스와 동기화하지 않으려면 이를 false로 설정합니다.
namedShadows-
동기화하려는 이름이 지정된 섀도의 목록. 섀도의 정확한 이름을 지정해야 합니다.
shadowDocuments-
(선택 사항) 동기화할 추가 디바이스 섀도의 목록. shadowDocumentsMap 파라미터를 대신 사용하는 것이 좋습니다.
shadowDocuments 객체를 지정하는 경우 shadowDocumentsMap 객체를 지정해서는 안 됩니다.
이 목록의 각 객체에는 다음 정보가 포함되어 있습니다.
thingName-
섀도를 동기화할 디바이스의 사물 이름.
classic-
(선택 사항) 클래식 디바이스 섀도를 thingName 디바이스와 동기화하지 않으려면 이를 false로 설정합니다.
기본값: true
namedShadows-
(선택 사항) 동기화하려는 이름이 지정된 디바이스 섀도의 목록. 섀도의 정확한 이름을 지정해야 합니다.
direction-
(선택 사항) 로컬 섀도 서비스와 AWS 클라우드간에 섀도를 동기화하는 방향. AWS 클라우드에 대한 대역폭 및 연결을 줄이도록 이 옵션을 구성할 수 있습니다. 다음 옵션 중 하나를 선택합니다.
-
betweenDeviceAndCloud - 로컬 섀도 서비스와 AWS 클라우드간에 섀도를 동기화합니다.
-
deviceToCloud – 로컬 섀도우 서비스에서 로 섀도우 업데이트를 보내고에서 섀도우 업데이트를 AWS 클라우드무시합니다 AWS 클라우드.
-
cloudToDevice - AWS 클라우드에서 섀도 업데이트를 수신하고 섀도 업데이트를 로컬 섀도 서비스에서 AWS 클라우드로 전송하지 않습니다.
기본값: BETWEEN_DEVICE_AND_CLOUD
rateLimits-
(선택 사항) 섀도 서비스 요청의 속도 제한을 결정하는 설정.
이 객체에는 다음 정보가 포함됩니다.
maxOutboundSyncUpdatesPerSecond-
(선택 사항) 디바이스가 전송하는 초당 최대 동기화 요청 수.
기본값: 초당 100개 요청
maxTotalLocalRequestsRate-
(선택 사항) 코어 디바이스로 전송되는 초당 최대 로컬 IPC 요청 수입니다.
기본값: 초당 200개 요청
maxLocalRequestsPerSecondPerThing-
(선택 사항) 연결된 각 IoT 사물에 대해 전송되는 초당 최대 로컬 IPC 요청 수입니다.
기본값: 각 사물에 대해 초당 20개 요청
이러한 속도 제한 파라미터는 로컬 섀도 서비스에 대한 초당 최대 요청 수를 정의합니다. AWS IoT Device Shadow 서비스에 대한 초당 최대 요청 수는에 따라 다릅니다 AWS 리전. 자세한 내용은의 AWS IoT 디바이스 섀도우 서비스에 API 대한 제한을 참조하세요Amazon Web Services 일반 참조.
shadowDocumentSizeLimitBytes-
(선택 사항) 로컬 섀도우에 대해 허용되는 각 JSON 상태 문서의 최대 크기입니다.
이 값을 늘리면 클라우드 섀도우에 대한 JSON 상태 문서의 리소스 한도도 늘려야 합니다. 자세한 내용은의 AWS IoT 디바이스 섀도우 서비스에 API 대한 제한을 참조하세요Amazon Web Services 일반 참조.
기본값: 8,192바이트
최대: 30,720바이트
예: 구성 병합 업데이트
다음 예제에서는 섀도 관리자 구성 요소에 사용 가능한 모든 구성 파라미터가 포함된 샘플 구성 병합 업데이트를 보여줍니다.
{
"strategy":{
"type":"periodic",
"delay":300
},
"synchronize":{
"shadowDocumentsMap":{
"MyDevice1":{
"classic":false,
"namedShadows":[
"MyShadowA",
"MyShadowB"
]
},
"MyDevice2":{
"classic":true,
"namedShadows":[]
}
},
"direction":"betweenDeviceAndCloud"
},
"rateLimits":{
"maxOutboundSyncUpdatesPerSecond":100,
"maxTotalLocalRequestsRate":200,
"maxLocalRequestsPerSecondPerThing":20
},
"shadowDocumentSizeLimitBytes":8192
}
- 2.1.x
-
strategy-
(선택 사항)이 구성 요소가 AWS IoT Core 와 코어 디바이스 간에 섀도우를 동기화하는 데 사용하는 전략입니다.
이 객체에는 다음 정보가 포함됩니다.
type-
(선택 사항) 이 구성 요소가 AWS IoT Core 와 코어 디바이스 간에 섀도를 동기화하는 데 사용하는 전략의 유형. 다음 옵션 중 하나를 선택합니다.
기본값: realTime
delay-
(선택 사항) periodic 동기화 전략을 지정하는 경우 이 구성 요소가 섀도를 AWS IoT Core와 동기화하는 간격(초).
이 파라미터는 periodic 동기화 전략을 지정하는 경우에 필요합니다.
synchronize-
(선택 사항) 섀도가 AWS 클라우드와 동기화되는 방법을 결정하는 동기화 설정.
섀도를 AWS 클라우드와 동기화하려면 이 속성으로 구성 업데이트를 생성해야 합니다.
이 객체에는 다음 정보가 포함됩니다.
coreThing-
(선택 사항) 동기화할 코어 디바이스 섀도. 이 객체에는 다음 정보가 포함됩니다.
classic-
(선택 사항) 기본적으로 섀도 관리자는 코어 디바이스에 대한 클래식 섀도의 로컬 상태를 AWS 클라우드와 동기화합니다. 클래식 디바이스 섀도를 동기화하지 않으려면 이를 false로 설정합니다.
기본값: true
namedShadows-
(선택 사항) 동기화할 이름이 지정된 코어 디바이스 섀도의 목록. 섀도의 정확한 이름을 지정해야 합니다.
AWS IoT Greengrass 서비스는 AWSManagedGreengrassV2Deployment명명된 섀도우를 사용하여 개별 코어 디바이스를 대상으로 하는 배포를 관리합니다. 이 명명된 섀도우는 AWS IoT Greengrass 서비스에서 사용하도록 예약되어 있습니다. 이 이름이 지정된 섀도를 업데이트하거나 삭제하지 마세요.
shadowDocumentsMap-
(선택 사항) 동기화할 추가 디바이스 섀도. 이 구성 파라미터를 사용하면 섀도 문서를 더 간편하게 지정할 수 있습니다. 이 파라미터를 shadowDocuments 객체 대신 사용하는 것이 좋습니다.
shadowDocumentsMap 객체를 지정하는 경우 shadowDocuments 객체를 지정해서는 안 됩니다.
각 객체에는 다음 정보가 포함되어 있습니다.
thingName-
이 섀도우 구성에 대한 섀도우 구성thingName입니다.
classic-
(선택 사항) 클래식 디바이스 섀도를 thingName 디바이스와 동기화하지 않으려면 이를 false로 설정합니다.
namedShadows-
동기화하려는 이름이 지정된 섀도의 목록. 섀도의 정확한 이름을 지정해야 합니다.
shadowDocuments-
(선택 사항) 동기화할 추가 디바이스 섀도의 목록. shadowDocumentsMap 파라미터를 대신 사용하는 것이 좋습니다.
shadowDocuments 객체를 지정하는 경우 shadowDocumentsMap 객체를 지정해서는 안 됩니다.
이 목록의 각 객체에는 다음 정보가 포함되어 있습니다.
thingName-
섀도를 동기화할 디바이스의 사물 이름.
classic-
(선택 사항) 클래식 디바이스 섀도를 thingName 디바이스와 동기화하지 않으려면 이를 false로 설정합니다.
기본값: true
namedShadows-
(선택 사항) 동기화하려는 이름이 지정된 디바이스 섀도의 목록. 섀도의 정확한 이름을 지정해야 합니다.
rateLimits-
(선택 사항) 섀도 서비스 요청의 속도 제한을 결정하는 설정.
이 객체에는 다음 정보가 포함됩니다.
maxOutboundSyncUpdatesPerSecond-
(선택 사항) 디바이스가 전송하는 초당 최대 동기화 요청 수.
기본값: 초당 100개 요청
maxTotalLocalRequestsRate-
(선택 사항) 코어 디바이스로 전송되는 초당 최대 로컬 IPC 요청 수입니다.
기본값: 초당 200개 요청
maxLocalRequestsPerSecondPerThing-
(선택 사항) 연결된 각 IoT 사물에 대해 전송되는 초당 최대 로컬 IPC 요청 수입니다.
기본값: 각 사물에 대해 초당 20개 요청
이러한 속도 제한 파라미터는 로컬 섀도 서비스에 대한 초당 최대 요청 수를 정의합니다. AWS IoT Device Shadow 서비스에 대한 초당 최대 요청 수는에 따라 다릅니다 AWS 리전. 자세한 내용은의 AWS IoT 디바이스 섀도우 서비스에 API 대한 제한을 참조하세요Amazon Web Services 일반 참조.
shadowDocumentSizeLimitBytes-
(선택 사항) 로컬 섀도우에 대해 허용되는 각 JSON 상태 문서의 최대 크기입니다.
이 값을 늘리면 클라우드 섀도우에 대한 JSON 상태 문서의 리소스 한도도 늘려야 합니다. 자세한 내용은의 AWS IoT 디바이스 섀도우 서비스에 API 대한 제한을 참조하세요Amazon Web Services 일반 참조.
기본값: 8,192바이트
최대: 30,720바이트
예: 구성 병합 업데이트
다음 예제에서는 섀도 관리자 구성 요소에 사용 가능한 모든 구성 파라미터가 포함된 샘플 구성 병합 업데이트를 보여줍니다.
{
"strategy":{
"type":"periodic",
"delay":300
},
"synchronize":{
"shadowDocumentsMap":{
"MyDevice1":{
"classic":false,
"namedShadows":[
"MyShadowA",
"MyShadowB"
]
},
"MyDevice2":{
"classic":true,
"namedShadows":[]
}
},
"direction":"betweenDeviceAndCloud"
},
"rateLimits":{
"maxOutboundSyncUpdatesPerSecond":100,
"maxTotalLocalRequestsRate":200,
"maxLocalRequestsPerSecondPerThing":20
},
"shadowDocumentSizeLimitBytes":8192
}
- 2.0.x
-
synchronize-
(선택 사항) 섀도가 AWS 클라우드와 동기화되는 방법을 결정하는 동기화 설정.
섀도를 AWS 클라우드와 동기화하려면 이 속성으로 구성 업데이트를 생성해야 합니다.
이 객체에는 다음 정보가 포함됩니다.
coreThing-
(선택 사항) 동기화할 코어 디바이스 섀도. 이 객체에는 다음 정보가 포함됩니다.
classic-
(선택 사항) 기본적으로 섀도 관리자는 코어 디바이스에 대한 클래식 섀도의 로컬 상태를 AWS 클라우드와 동기화합니다. 클래식 디바이스 섀도를 동기화하지 않으려면 이를 false로 설정합니다.
기본값: true
namedShadows-
(선택 사항) 동기화할 이름이 지정된 코어 디바이스 섀도의 목록. 섀도의 정확한 이름을 지정해야 합니다.
AWS IoT Greengrass 서비스는 AWSManagedGreengrassV2Deployment명명된 섀도우를 사용하여 개별 코어 디바이스를 대상으로 하는 배포를 관리합니다. 이 명명된 섀도우는 AWS IoT Greengrass 서비스에서 사용하도록 예약되어 있습니다. 이 이름이 지정된 섀도를 업데이트하거나 삭제하지 마세요.
shadowDocumentsMap-
(선택 사항) 동기화할 추가 디바이스 섀도. 이 구성 파라미터를 사용하면 섀도 문서를 더 간편하게 지정할 수 있습니다. 이 파라미터를 shadowDocuments 객체 대신 사용하는 것이 좋습니다.
shadowDocumentsMap 객체를 지정하는 경우 shadowDocuments 객체를 지정해서는 안 됩니다.
각 객체에는 다음 정보가 포함되어 있습니다.
thingName-
이 섀도우 구성에 대한 섀도우 구성thingName입니다.
classic-
(선택 사항) 클래식 디바이스 섀도를 thingName 디바이스와 동기화하지 않으려면 이를 false로 설정합니다.
namedShadows-
동기화하려는 이름이 지정된 섀도의 목록. 섀도의 정확한 이름을 지정해야 합니다.
shadowDocuments-
(선택 사항) 동기화할 추가 디바이스 섀도의 목록. shadowDocumentsMap 파라미터를 대신 사용하는 것이 좋습니다.
shadowDocuments 객체를 지정하는 경우 shadowDocumentsMap 객체를 지정해서는 안 됩니다.
이 목록의 각 객체에는 다음 정보가 포함되어 있습니다.
thingName-
섀도를 동기화할 디바이스의 사물 이름.
classic-
(선택 사항) 클래식 디바이스 섀도를 thingName 디바이스와 동기화하지 않으려면 이를 false로 설정합니다.
기본값: true
namedShadows-
(선택 사항) 동기화하려는 이름이 지정된 디바이스 섀도의 목록. 섀도의 정확한 이름을 지정해야 합니다.
rateLimits-
(선택 사항) 섀도 서비스 요청의 속도 제한을 결정하는 설정.
이 객체에는 다음 정보가 포함됩니다.
maxOutboundSyncUpdatesPerSecond-
(선택 사항) 디바이스가 전송하는 초당 최대 동기화 요청 수.
기본값: 초당 100개 요청
maxTotalLocalRequestsRate-
(선택 사항) 코어 디바이스로 전송되는 초당 최대 로컬 IPC 요청 수입니다.
기본값: 초당 200개 요청
maxLocalRequestsPerSecondPerThing-
(선택 사항) 연결된 각 IoT 사물에 대해 전송되는 초당 최대 로컬 IPC 요청 수입니다.
기본값: 각 사물에 대해 초당 20개 요청
이러한 속도 제한 파라미터는 로컬 섀도 서비스에 대한 초당 최대 요청 수를 정의합니다. AWS IoT Device Shadow 서비스에 대한 초당 최대 요청 수는에 따라 다릅니다 AWS 리전. 자세한 내용은의 AWS IoT 디바이스 섀도우 서비스에 API 대한 제한을 참조하세요Amazon Web Services 일반 참조.
shadowDocumentSizeLimitBytes-
(선택 사항) 로컬 섀도우에 대해 허용되는 각 JSON 상태 문서의 최대 크기입니다.
이 값을 늘리면 클라우드 섀도우에 대한 JSON 상태 문서의 리소스 한도도 늘려야 합니다. 자세한 내용은의 AWS IoT 디바이스 섀도우 서비스에 API 대한 제한을 참조하세요Amazon Web Services 일반 참조.
기본값: 8,192바이트
최대: 30,720바이트
예: 구성 병합 업데이트
다음 예제에서는 섀도 관리자 구성 요소에 사용 가능한 모든 구성 파라미터가 포함된 샘플 구성 병합 업데이트를 보여줍니다.
{
"synchronize": {
"coreThing": {
"classic": true,
"namedShadows": [
"MyCoreShadowA",
"MyCoreShadowB"
]
},
"shadowDocuments": [
{
"thingName": "MyDevice1",
"classic": false,
"namedShadows": [
"MyShadowA",
"MyShadowB"
]
},
{
"thingName": "MyDevice2",
"classic": true,
"namedShadows": []
}
]
},
"rateLimits": {
"maxOutboundSyncUpdatesPerSecond": 100,
"maxTotalLocalRequestsRate": 200,
"maxLocalRequestsPerSecondPerThing": 20
},
"shadowDocumentSizeLimitBytes": 8192
}
로컬 로그 파일
이 구성 요소는 Greengrass nucleus 구성요소와 동일한 로그 파일을 사용합니다.
- Linux
-
/greengrass/v2
- Windows
-
C:\greengrass\v2\logs\greengrass.log
Changelog
다음 표에는 각 구성 요소 버전의 변경 사항이 설명되어 있습니다.
|
버전
|
변경 사항
|
|
2.3.10
|
Greengrass 핵 버전 2.14.0 릴리스에 대한 버전이 업데이트되었습니다. |
|
2.3.9
|
Greengrass nucleus 버전 2.13.0 릴리스용으로 업데이트된 버전입니다. |
|
2.3.8
|
|
|
2.3.7
|
|
|
2.3.6
|
|
|
2.3.5
|
Greengrass nucleus 버전 2.12.0 릴리스용으로 업데이트된 버전입니다. |
|
2.3.4
|
|
|
2.3.3
|
Greengrass nucleus 버전 2.11.0 릴리스용으로 업데이트된 버전입니다. |
|
2.3.2
|
|
|
2.3.1
|
|
|
2.3.0
|
|
|
2.2.4
|
|
|
2.2.3
|
Greengrass nucleus 버전 2.9.0 릴리스용으로 업데이트된 버전입니다. |
|
2.2.2
|
Greengrass nucleus 버전 2.8.0 릴리스용으로 업데이트된 버전입니다. |
|
2.2.1
|
Greengrass nucleus 버전 2.7.0 릴리스용으로 업데이트된 버전입니다.
|
|
2.2.0
|
- 새로운 특성
-
-
코어 디바이스에서 섀도우를 가져오고 업데이트하고 삭제하기 위해 섀도우 MQTT 주제에 대한 로컬 publish/subscribe interface. You can now communicate with the local publish/subscribe 메시지 브로커를 통해 로컬 섀도우 서비스에 대한 지원을 추가합니다. 이 기능을 사용하면 MQTT 브리지를 사용하여 클라이언트 디바이스와 로컬 게시/구독 인터페이스 간에 섀도우 주제에 대한 메시지를 릴레이하여 클라이언트 디바이스를 로컬 섀도우 서비스에 연결할 수 있습니다.
이 기능을 사용하려면 Greengrass nucleus 구성 요소의 v2.6.0 이상이 필요합니다. 클라이언트 디바이스를 로컬 섀도우 서비스에 연결하려면 MQTT 브리지 구성 요소의 v2.2.0 이상도 사용해야 합니다.
-
로컬 섀도 서비스와 AWS 클라우드간에 섀도를 동기화하는 방향을 사용자 지정하도록 구성할 수 있는 direction 옵션을 추가합니다. AWS 클라우드에 대한 대역폭 및 연결을 줄이도록 이 옵션을 구성할 수 있습니다.
|
|
2.1.1
|
|
|
2.1.0
|
|
|
2.0.6
|
이 버전에는 버그 수정과 개선 사항이 포함되어 있습니다.
|
|
2.0.5
|
Greengrass nucleus 버전 2.5.0 릴리스용으로 업데이트된 버전입니다.
|
|
2.0.4
|
|
|
2.0.3
|
Greengrass nucleus 버전 2.4.0 릴리스용으로 업데이트된 버전입니다.
|
|
2.0.2
|
|
|
2.0.1
|
Greengrass nucleus 버전 2.3.0 릴리스용으로 업데이트된 버전입니다.
|
|
2.0.0
|
초기 버전입니다.
|
