최신 Device Update for IoT Hub 릴리스로 디바이스 및 그룹 마이그레이션

아티클
06/01/2023

Device Update for IoT Hub 서비스가 새 버전을 릴리스함에 따라 최신 기능 및 보안 개선 사항을 위해 디바이스를 업데이트하고 싶을 것입니다. 이 문서에서는 [PPR(공개 미리 보기 새로 고침) 릴리스]에서 현재 GA 릴리스로 마이그레이션하는 방법에 대한 정보를 제공합니다. 이 문서에서는 이러한 릴리스의 그룹 및 UX 동작도 설명합니다. 공개 미리 보기 새고 고침 릴리스를 사용하는 디바이스, 그룹 및 배포가 없는 경우 이 페이지를 무시할 수 있습니다.

성공적으로 마이그레이션하려면 디바이스에서 실행 중인 DU 에이전트를 업그레이드해야 합니다. GA 릴리스에는 주요 변경 내용이 있으므로 오류를 방지하기 위해 지침을 자세히 따르는 것이 좋습니다.

참고 항목

만든 모든 PPR 디바이스 그룹은 자동으로 GA 그룹으로 변경됩니다. 그룹 및 디바이스는 마이그레이션 후에 사용할 수 있습니다. 배포 기록은 업데이트된 GA 그룹으로 이월되지 않습니다.

Device Update 에이전트 업데이트

GA 릴리스의 경우 Device Update 에이전트를 수동으로 업데이트하거나 apt 매니페스트 또는 이미지 업데이트를 사용하는 Device Update 서비스를 사용하여 업데이트할 수 있습니다. 이미지 업데이트를 사용하는 경우 업데이트에 GA Device Update 에이전트를 포함할 수 있습니다.

수동 DU 에이전트 업그레이드

디바이스를 업데이트하기 전에 디바이스 특성에 PPR PnP 모델 세부 정보가 포함됩니다. 계약 모델 이름에 디바이스 업데이트 모델 V1이 표시되고 계약 모델 ID에 dtmi:azure:iot:deviceUpdateContractModel;1이 표시됩니다.

SSH를 통해 디바이스에 연결하고 Device Update 에이전트를 업데이트합니다.

sudo apt install deviceupdate-agent
sudo systemctl restart deviceupdate-agent
sudo systemctl status deviceupdate-agent

DU 에이전트가 올바르게 실행되고 있는지 확인합니다. 'HealthCheck 통과됨'을 찾습니다.
```
sudo -u adu /usr/bin/AducIotAgent -h  
```
Device Update 포털에서 업데이트된 디바이스를 참조하세요. 이제 디바이스 특성에 업데이트된 PnP 모델 세부 정보가 표시됩니다. 계약 모델 이름에 디바이스 업데이트 모델 V2가 표시되고 계약 모델 ID에 dtmi:azure:iot:deviceUpdateContractModel;2가 표시됩니다.

APT 매니페스트를 통해 OTA DU 에이전트 업그레이드

디바이스를 업데이트하기 전에 디바이스 특성에 PPR PnP 모델 세부 정보가 포함됩니다. 계약 모델 이름에 디바이스 업데이트 모델 V1이 표시되고 계약 모델 ID에 dtmi:azure:iot:deviceUpdateContractModel;1이 표시됩니다.

업데이트의 마지막 단계로 디바이스 업데이트 에이전트 업그레이드를 추가합니다. 가져오기 매니페스트 버전은 올바른 디바이스를 대상으로 하려면 "4.0"이어야 합니다. 아래 샘플 가져오기 매니페스트 및 APT 매니페스트를 참조하세요.

매니페스트 가져오기 예제

{
   "manifestVersion": "4",
   "updateId": {
     "provider": "Contoso",
     "name": "Sensor",
     "version": "1.0"
   },
   "compatibility": [
     {
       "manufacturer": "Contoso",
       "model": "Sensor"
     }
   ],
   "instructions": {
     "steps": [
       {
     "handler": "microsoft/apt:1",
     "handlerProperties": {
       "installedCriteria": "1.0"
     },
     "files": [
       "fileId0"
     ]
       }
     ]
   },
   "files": {
     "fileId0": {
       "filename": "sample-upgrade-apt-manifest.json",
       "sizeInBytes": 210,
       "hashes": {
     "sha256": "mcB5SexMU4JOOzqmlJqKbue9qMskWY3EI/iVjJxCtAs="
       }
     }
   },
   "createdDateTime": "2022-08-20T18:32:01.8404544Z"
 }

예제 APT 매니페스트

  {
    "name": "Sample DU agent upgrade update",
    "version": "1.0.0",
    "packages": [
    {
        "name": "deviceupdate-agent"
    }
    ]
}

참고 항목

에이전트 업그레이드를 마지막 단계로 수행해야 합니다. 에이전트 업그레이드 전에 다른 단계가 있을 수 있습니다. 에이전트 업그레이드 후에 추가된 모든 단계는 디바이스가 DU 서비스와 다시 연결될 때 실행되지 않고 올바르게 보고되지 않습니다.

업데이트를 배포합니다.
업데이트가 성공적으로 배포되면 이제 디바이스 특성에 업데이트된 PnP 모델 세부 정보가 표시됩니다. 계약 모델 이름에 디바이스 업데이트 모델 V2가 표시되고 계약 모델 ID에 dtmi:azure:iot:deviceUpdateContractModel;2가 표시됩니다.

릴리스 전반의 그룹화 및 배포 동작

공개 미리 보기 새로 고침 DU 에이전트(0.8.x) 및 GA DU 에이전트(1.0.x)가 있는 디바이스는 Device Update 포털을 통해 관리할 수 있습니다.
이전 에이전트(0.7.0/0.6.0)가 있는 디바이스는 이 그룹에 추가할 수 없습니다.

다음 단계

디바이스 업데이트 에이전트 구성 파일 이해

Device Update for IoT Hub의 간단한 데모를 위해 다음 자습서를 사용할 수 있습니다.

다음을 통해 공유