다음을 통해 공유


디바이스 업데이트 구성 파일

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"
      }
    }
  ]
}