디바이스 업데이트 구성 파일
Azure Device Update for IoT Hub 에이전트는 디바이스의 du-config.json 파일에서 구성 정보를 사용합니다. 에이전트는 파일을 읽고 디바이스 업데이트 서비스에 다음 값을 보고합니다.
- AzureDeviceUpdateCore: 4. ClientMetadata: 4 deviceProperties ["manufacturer"]
- AzureDeviceUpdateCore: 4. ClientMetadata: 4 deviceProperties ["manufacturer"]
- DeviceInformation. 제조업체
- DeviceInformation. 모델
- additionalProperties
- connectionData
- connectionType
du-config.json 구성 파일을 업데이트하거나 만들려면 다음을 수행합니다.
- Linux OS를 사용하여 IoT 디바이스에 Debian 에이전트를 설치하는 경우 /etc/adu/du-config.json 파일을 수정하여 값을 업데이트합니다.
- Yocto 빌드 시스템의 경우 /adu/du-config.json 파티션 또는 디스크에
adu
JSON 파일을 만듭니다.
구성 파일 필드 및 값
속성 | 설명 |
---|---|
SchemaVersion | 현재 구성 파일 형식 버전을 매핑하는 스키마 버전입니다. |
aduShellTrustedUsers | 다양한 업데이트 작업을 수행하는 broker 프로그램인 adu-shell을 시작할 수 있는 사용자 목록입니다 'root' . 디바이스 업데이트 기본 콘텐츠 업데이트 처리기는 adu-shell을 호출하여 권한 있는 스크립트 실행과 같이 apt-get install 슈퍼 사용자 권한이 필요한 작업을 수행합니다. |
iotHubProtocol | Azure IoT Hub에 연결하는 데 사용되는 프로토콜입니다. 허용되는 값은 mqtt 또는 mqtt/ws 입니다. 기본값은 'mqtt' 여야 합니다. |
compatPropertyNames | 업데이트 배포를 대상으로 하는 디바이스 호환성을 확인하는 데 사용되는 속성입니다. 모든 값은 소문자여야 합니다. |
제조업체 | 업데이트 배포를 AzureDeviceUpdateCore:4.ClientMetadata:4 대상으로 하는 디바이스를 분류하기 위해 인터페이스에서 보고한 값입니다. |
model | 업데이트 배포를 AzureDeviceUpdateCore:4.ClientMetadata:4 대상으로 하는 디바이스를 분류하기 위해 인터페이스에서 보고한 값입니다. |
additionalProperties | 선택 사항으로, 호환성 검사에 사용할 소문자 전용 디바이스 보고 속성이 최대 5개 이상 있습니다. |
agents | 유형 및 데이터를 포함하여 connectionSource 각 디바이스 업데이트 에이전트에 대한 정보입니다. |
name | 디바이스 업데이트 에이전트 이름입니다. |
실행 계정 | 디바이스 업데이트 에이전트를 실행할 사용자 ID입니다. |
connectionType | 디바이스를 IoT Hub에 연결하는 데 사용할 연결 유형입니다. 허용되는 값은 string 또는 AIS 입니다. IoT ID 서비스를 사용하여 연결하는 프로덕션 시나리오에 사용합니다 AIS . 테스트 목적으로 연결 문자열 사용하여 연결하는 데 사용합니다string . |
connectionData | 디바이스를 IoT Hub에 연결하는 데 사용할 데이터입니다. 이면 connectionType = "AIS" 빈 문자열"connectionData": "" 로 설정합니다connectionData . 이 경우 connectionType = "string" IoT 디바이스의 디바이스 또는 모듈 연결 문자열 제공합니다. |
제조업체 | 디바이스 업데이트 에이전트가 인터페이스의 일부로 보고한 DeviceInformation 값입니다. |
model | 디바이스 업데이트 에이전트가 인터페이스의 일부로 보고한 DeviceInformation 값입니다. |
additionalDeviceProperties | 선택 사항으로 최대 5개의 디바이스 속성이 추가됩니다. |
extensionsFolder | 선택 사항으로 디바이스 업데이트 확장 폴더의 경로를 설정합니다. 기본 경로는 '/var/lib/adu/extensions' 입니다. |
downloadsFolder | 선택 사항으로, 디바이스 업데이트 다운로드 폴더의 경로를 설정합니다. 기본 경로는 '/var/lib/adu/downloads' 입니다. |
dataFolder | 선택 사항으로 디바이스 업데이트 데이터 폴더의 경로를 설정합니다. 기본 경로는 '/var/lib/adu' 입니다. 구성 파일에서 이 값을 업데이트하는 경우 그에 따라 상태 관리 검사에서 업데이트 CheckDataDir() 해야 합니다. |
aduShellFilePath | 선택 사항으로 디바이스 업데이트 셸의 경로를 설정합니다. 기본 경로는 '/usr/lib/adu' 입니다. |
downloadTimeoutInMinutes | 선택 사항으로 업데이트 다운로드 시간 제한(분)을 설정합니다. 값 0 은 기본값인 8시간을 의미합니다. |
예제 "du-config.json" 파일
{
"schemaVersion": "1.1",
"aduShellTrustedUsers": [
"adu",
"do"
],
"iotHubProtocol": "mqtt",
"compatPropertyNames":"manufacturer,model,location,environment",
"manufacturer": "contoso",
"model": "virtual-vacuum-2",
"agents": [
{
"name": "main",
"runas": "adu",
"connectionSource": {
"connectionType": "string",
"connectionData": "HostName=<hub_name>.azure-devices.net;DeviceId=<device_id>;SharedAccessKey=<device_key>"
},
"manufacturer": "contoso",
"model": "virtual-vacuum-2",
"additionalDeviceProperties": {
"location": "usa",
"environment": "development"
}
}
]
}