기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
섀도우 매니저
섀도우 관리자 구성 요소 (aws.greengrass.ShadowManager) 는 코어 디바이스에서 로컬 섀도우 서비스를 활성화합니다. 로컬 섀도우 서비스를 사용하면 구성 요소가 프로세스 간 통신을 사용하여 로컬 섀도우와 상호 작용할 수 있습니다. 섀도우 관리자 구성 요소는 로컬 섀도우 문서의 저장을 관리하고 로컬 섀도우 상태와 AWS IoT Device Shadow 서비스의 동기화도 처리합니다.
Greengrass 코어 장치가 그림자와 상호 작용하는 방식에 대한 자세한 내용은 을 참조하십시오. 디바이스 섀도우와 상호작용
버전
이 구성 요소의 버전은 다음과 같습니다.
유형
이 구성 요소는 플러그인 구성 요소 () aws.greengrass.plugin 입니다. Greengrass 핵은 핵과 동일한 자바 가상 머신 (JVM) 에서 이 컴포넌트를 실행합니다. 코어 디바이스에서 이 구성 요소의 버전을 변경하면 NUCLEUS가 다시 시작됩니다.
이 구성 요소는 Greengrass 핵과 동일한 로그 파일을 사용합니다. 자세한 내용은 모니터 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 정책
-
섀도우 관리자 구성 요소는 a에서 실행되도록 지원됩니다VPC.
의존성
구성 요소를 배포하면 호환되는 버전의 종속 AWS IoT Greengrass 항목도 배포됩니다. 즉, 구성 요소를 성공적으로 배포하려면 구성 요소 및 해당 종속성에 대한 요구 사항을 모두 충족해야 합니다. 이 섹션에는 이 구성 요소의 릴리스된 버전에 대한 종속성과 각 종속성에 대한 구성 요소 버전을 정의하는 시맨틱 버전 제약 조건이 나열되어 있습니다. 콘솔에서 구성 요소의 각 버전에 대한 종속성을 볼 수도 있습니다.AWS IoT Greengrass 구성 요소 세부 정보 페이지에서 종속성 목록을 찾아보십시오.
- 2.3.9
-
다음 표에는 이 구성 요소의 버전 2.3.9에 대한 종속성이 나와 있습니다.
| 종속성 |
호환되는 버전 |
종속성 유형 |
| 그린그래스 핵 |
>=2.5.0 <2.14.0 |
소프트 |
- 2.3.5 – 2.3.8
-
다음 표에는 이 구성 요소의 버전 2.3.5~2.3.8에 대한 종속성이 나와 있습니다.
| 종속성 |
호환되는 버전 |
종속성 유형 |
| 그린그래스 핵 |
>=2.5.0 <2.13.0 |
소프트 |
- 2.3.3 and 2.3.4
-
다음 표에는 이 구성 요소의 버전 2.3.3 및 2.3.4에 대한 종속성이 나와 있습니다.
| 종속성 |
호환되는 버전 |
종속성 유형 |
| 그린그래스 핵 |
>=2.5.0 <2.12.0 |
소프트 |
- 2.3.2
-
다음 표에는 이 구성 요소의 버전 2.3.2에 대한 종속성이 나와 있습니다.
| 종속성 |
호환되는 버전 |
종속성 유형 |
| 그린그래스 핵 |
>=2.5.0 <2.11.0 |
소프트 |
- 2.3.0 and 2.3.1
-
다음 표에는 이 구성 요소의 버전 2.3.0 및 2.3.1에 대한 종속성이 나와 있습니다.
| 종속성 |
호환되는 버전 |
종속성 유형 |
| 그린그래스 핵 |
>=2.5.0 <2.10.0 |
소프트 |
- 2.2.3 and 2.2.4
-
다음 표에는 이 구성 요소의 버전 2.2.3 및 2.2.4에 대한 종속성이 나와 있습니다.
| 종속성 |
호환되는 버전 |
종속성 유형 |
| 그린그래스 핵 |
>=2.2.0 <3.0.0 |
소프트 |
- 2.2.2
-
다음 표에는 이 구성 요소의 버전 2.2.2에 대한 종속성이 나와 있습니다.
| 종속성 |
호환되는 버전 |
종속성 유형 |
| 그린그래스 핵 |
>=2.2.0 <2.9.0 |
소프트 |
- 2.2.1
-
다음 표에는 이 구성 요소의 버전 2.2.1에 대한 종속성이 나열되어 있습니다.
| 종속성 |
호환되는 버전 |
종속성 유형 |
| 그린그래스 핵 |
>=2.2.0 <2.8.0 |
소프트 |
- 2.1.1 and 2.2.0
-
다음 표에는 이 구성 요소의 버전 2.1.1 및 2.2.0에 대한 종속성이 나와 있습니다.
| 종속성 |
호환되는 버전 |
종속성 유형 |
| 그린그래스 핵 |
>=2.2.0 <2.7.0 |
소프트 |
- 2.0.5 - 2.1.0
-
다음 표에는 이 구성 요소의 버전 2.0.5~2.1.0에 대한 종속성이 나와 있습니다.
| 종속성 |
호환되는 버전 |
종속성 유형 |
| 그린그래스 핵 |
>=2.2.0 <2.6.0 |
소프트 |
- 2.0.3 and 2.0.4
-
다음 표에는 이 구성 요소의 버전 2.0.3 및 2.0.4에 대한 종속성이 나와 있습니다.
| 종속성 |
호환되는 버전 |
종속성 유형 |
| 그린그래스 핵 |
>=2.2.0 <2.5.0 |
소프트 |
- 2.0.1 and 2.0.2
-
다음 표에는 이 구성 요소의 버전 2.0.1 및 2.0.2에 대한 종속성이 나와 있습니다.
| 종속성 |
호환되는 버전 |
종속성 유형 |
| 그린그래스 핵 |
>=2.2.0 <2.4.0 |
소프트 |
- 2.0.0
-
다음 표에는 이 구성 요소의 버전 2.0.0에 대한 종속성이 나와 있습니다.
| 종속성 |
호환되는 버전 |
종속성 유형 |
| 그린그래스 핵 |
>=2.2.0 <2.3.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-
(선택 사항) 디바이스의 클래식 디바이스 섀도를 동기화하지 않으려면 이 설정을 로 설정하십시오false. thingName
namedShadows-
동기화하려는 명명된 섀도우 목록. 섀도우의 정확한 이름을 지정해야 합니다.
shadowDocuments-
(선택 사항) 동기화할 추가 장치 섀도 목록. 대신 shadowDocumentsMap 파라미터를 사용하는 것이 좋습니다.
shadowDocuments개체를 지정하는 경우 개체를 지정해서는 안 됩니다. shadowDocumentsMap
이 목록의 각 개체에는 다음 정보가 포함됩니다.
thingName-
섀도우를 동기화할 장치의 사물 이름.
classic-
(선택 사항) 디바이스의 클래식 디바이스 섀도를 동기화하지 않으려면 이 옵션을 로 설정하십시오false. thingName
기본값: 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 Device Shadow 서비스에 API 대한 제한을 참조하십시오 Amazon Web Services 일반 참조.
shadowDocumentSizeLimitBytes-
(선택 사항) 로컬 섀도우에 대한 각 JSON 상태 문서의 최대 허용 크기입니다.
이 값을 늘리면 구름 그림자에 대한 JSON 상태 문서의 리소스 제한도 늘려야 합니다. 자세한 내용은 의 AWS IoT
Device Shadow 서비스에 API 대한 제한을 참조하십시오 Amazon Web Services 일반 참조.
기본값: 8192바이트
최대: 30720바이트
예: 구성 병합 업데이트
다음 예제는 섀도우 관리자 구성 요소에 사용 가능한 모든 구성 매개 변수가 포함된 샘플 구성 병합 업데이트를 보여줍니다.
{
"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-
(선택 사항) 디바이스의 클래식 디바이스 섀도를 동기화하지 않으려면 이 설정을 로 설정하십시오false. thingName
namedShadows-
동기화하려는 명명된 섀도우 목록. 섀도우의 정확한 이름을 지정해야 합니다.
shadowDocuments-
(선택 사항) 동기화할 추가 장치 섀도 목록. 대신 shadowDocumentsMap 파라미터를 사용하는 것이 좋습니다.
shadowDocuments개체를 지정하는 경우 개체를 지정해서는 안 됩니다. shadowDocumentsMap
이 목록의 각 개체에는 다음 정보가 포함됩니다.
thingName-
섀도우를 동기화할 장치의 사물 이름.
classic-
(선택 사항) 디바이스의 클래식 디바이스 섀도를 동기화하지 않으려면 이 옵션을 로 설정하십시오false. thingName
기본값: 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 Device Shadow 서비스에 API 대한 제한을 참조하십시오 Amazon Web Services 일반 참조.
shadowDocumentSizeLimitBytes-
(선택 사항) 로컬 섀도우에 대한 각 JSON 상태 문서의 최대 허용 크기입니다.
이 값을 늘리면 구름 그림자에 대한 JSON 상태 문서의 리소스 제한도 늘려야 합니다. 자세한 내용은 의 AWS IoT
Device Shadow 서비스에 API 대한 제한을 참조하십시오 Amazon Web Services 일반 참조.
기본값: 8192바이트
최대: 30720바이트
예: 구성 병합 업데이트
다음 예제는 섀도우 관리자 구성 요소에 사용 가능한 모든 구성 매개 변수가 포함된 샘플 구성 병합 업데이트를 보여줍니다.
{
"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-
(선택 사항) 디바이스의 클래식 디바이스 섀도를 동기화하지 않으려면 이 설정을 로 설정하십시오false. thingName
namedShadows-
동기화하려는 명명된 섀도우 목록. 섀도우의 정확한 이름을 지정해야 합니다.
shadowDocuments-
(선택 사항) 동기화할 추가 장치 섀도 목록. 대신 shadowDocumentsMap 파라미터를 사용하는 것이 좋습니다.
shadowDocuments개체를 지정하는 경우 개체를 지정해서는 안 됩니다. shadowDocumentsMap
이 목록의 각 개체에는 다음 정보가 포함됩니다.
thingName-
섀도우를 동기화할 장치의 사물 이름.
classic-
(선택 사항) 디바이스의 클래식 디바이스 섀도를 동기화하지 않으려면 이 옵션을 로 설정하십시오false. thingName
기본값: true
namedShadows-
(선택 사항) 동기화하려는 이름이 지정된 장치 섀도 목록. 섀도우의 정확한 이름을 지정해야 합니다.
rateLimits-
(선택 사항) 섀도우 서비스 요청의 속도 제한을 결정하는 설정입니다.
이 개체에는 다음 정보가 들어 있습니다.
maxOutboundSyncUpdatesPerSecond-
(선택 사항) 장치가 전송하는 초당 최대 동기화 요청 수입니다.
기본값: 초당 요청 100개
maxTotalLocalRequestsRate-
(선택 사항) 코어 디바이스로 전송되는 초당 최대 로컬 IPC 요청 수입니다.
기본값: 초당 요청 200개
maxLocalRequestsPerSecondPerThing-
(선택 사항) 연결된 각 IoT 사물에 대해 전송되는 초당 최대 로컬 IPC 요청 수입니다.
기본값: 각 사물에 대해 초당 요청 20개
이러한 속도 제한 매개변수는 로컬 섀도우 서비스에 대한 초당 최대 요청 수를 정의합니다. AWS IoT Device Shadow 서비스에 대한 초당 최대 요청 수는 사용자에 따라 다릅니다 AWS 리전. 자세한 내용은 의 AWS IoT Device Shadow 서비스에 API 대한 제한을 참조하십시오 Amazon Web Services 일반 참조.
shadowDocumentSizeLimitBytes-
(선택 사항) 로컬 섀도우에 대한 각 JSON 상태 문서의 최대 허용 크기입니다.
이 값을 늘리면 구름 그림자에 대한 JSON 상태 문서의 리소스 제한도 늘려야 합니다. 자세한 내용은 의 AWS IoT
Device Shadow 서비스에 API 대한 제한을 참조하십시오 Amazon Web Services 일반 참조.
기본값: 8192바이트
최대: 30720바이트
예: 구성 병합 업데이트
다음 예제는 섀도우 관리자 구성 요소에 사용 가능한 모든 구성 매개 변수가 포함된 샘플 구성 병합 업데이트를 보여줍니다.
{
"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-
(선택 사항) 디바이스의 클래식 디바이스 섀도를 동기화하지 않으려면 이 설정을 로 설정하십시오false. thingName
namedShadows-
동기화하려는 명명된 섀도우 목록. 섀도우의 정확한 이름을 지정해야 합니다.
shadowDocuments-
(선택 사항) 동기화할 추가 장치 섀도 목록. 대신 shadowDocumentsMap 파라미터를 사용하는 것이 좋습니다.
shadowDocuments개체를 지정하는 경우 개체를 지정해서는 안 됩니다. shadowDocumentsMap
이 목록의 각 개체에는 다음 정보가 포함됩니다.
thingName-
섀도우를 동기화할 장치의 사물 이름.
classic-
(선택 사항) 디바이스의 클래식 디바이스 섀도를 동기화하지 않으려면 이 옵션을 로 설정하십시오false. thingName
기본값: true
namedShadows-
(선택 사항) 동기화하려는 이름이 지정된 장치 섀도 목록. 섀도우의 정확한 이름을 지정해야 합니다.
rateLimits-
(선택 사항) 섀도우 서비스 요청의 속도 제한을 결정하는 설정입니다.
이 개체에는 다음 정보가 들어 있습니다.
maxOutboundSyncUpdatesPerSecond-
(선택 사항) 장치가 전송하는 초당 최대 동기화 요청 수입니다.
기본값: 초당 요청 100개
maxTotalLocalRequestsRate-
(선택 사항) 코어 디바이스로 전송되는 초당 최대 로컬 IPC 요청 수입니다.
기본값: 초당 요청 200개
maxLocalRequestsPerSecondPerThing-
(선택 사항) 연결된 각 IoT 사물에 대해 전송되는 초당 최대 로컬 IPC 요청 수입니다.
기본값: 각 사물에 대해 초당 요청 20개
이러한 속도 제한 매개변수는 로컬 섀도우 서비스에 대한 초당 최대 요청 수를 정의합니다. AWS IoT Device Shadow 서비스에 대한 초당 최대 요청 수는 사용자에 따라 다릅니다 AWS 리전. 자세한 내용은 의 AWS IoT Device Shadow 서비스에 API 대한 제한을 참조하십시오 Amazon Web Services 일반 참조.
shadowDocumentSizeLimitBytes-
(선택 사항) 로컬 섀도우에 대한 각 JSON 상태 문서의 최대 허용 크기입니다.
이 값을 늘리면 구름 그림자에 대한 JSON 상태 문서의 리소스 제한도 늘려야 합니다. 자세한 내용은 의 AWS IoT
Device Shadow 서비스에 API 대한 제한을 참조하십시오 Amazon Web Services 일반 참조.
기본값: 8192바이트
최대: 30720바이트
예: 구성 병합 업데이트
다음 예제는 섀도우 관리자 구성 요소에 사용 가능한 모든 구성 매개 변수가 포함된 샘플 구성 병합 업데이트를 보여줍니다.
{
"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 핵 구성 요소와 동일한 로그 파일을 사용합니다.
- Linux
-
/greengrass/v2
- Windows
-
C:\greengrass\v2\logs\greengrass.log
Changelog
다음 표에는 각 구성 요소 버전의 변경 사항이 설명되어 있습니다.
|
버전
|
변경
|
|
2.3.9
|
그린그래스 뉴클리어스 버전 2.13.0 릴리스를 위해 버전이 업데이트되었습니다. |
|
2.3.8
|
|
|
2.3.7
|
|
|
2.3.6
|
|
|
2.3.5
|
그린그래스 뉴클리어스 버전 2.12.0 릴리스를 위해 버전이 업데이트되었습니다. |
|
2.3.4
|
|
|
2.3.3
|
그린그래스 뉴클리어스 버전 2.11.0 릴리스를 위해 버전이 업데이트되었습니다. |
|
2.3.2
|
|
|
2.3.1
|
|
|
2.3.0
|
|
|
2.2.4
|
|
|
2.2.3
|
Greengrass 뉴클리어스 버전 2.9.0 릴리스를 위해 버전이 업데이트되었습니다. |
|
2.2.2
|
Greengrass 뉴클리어스 버전 2.8.0 릴리스를 위해 버전이 업데이트되었습니다. |
|
2.2.1
|
Greengrass 뉴클리어스 버전 2.7.0 릴리스를 위해 버전이 업데이트되었습니다.
|
|
2.2.0
|
|
|
2.1.1
|
|
|
2.1.0
|
|
|
2.0.6
|
이 버전에는 버그 수정 및 개선 사항이 포함되어 있습니다.
|
|
2.0.5
|
Greengrass 뉴클리어스 버전 2.5.0 릴리스를 위해 버전이 업데이트되었습니다.
|
|
2.0.4
|
|
|
2.0.3
|
그린그래스 뉴클리어스 버전 2.4.0 릴리스를 위해 버전이 업데이트되었습니다.
|
|
2.0.2
|
|
|
2.0.1
|
그린그래스 뉴클리어스 버전 2.3.0 릴리스를 위해 버전이 업데이트되었습니다.
|
|
2.0.0
|
초기 버전
|
