Device Update for Azure IoT Hub를 사용하여 업데이트 배포

아티클
02/12/2024

Device Update for Azure IoT Hub를 사용하여 IoT 디바이스에 업데이트를 배포하는 방법을 알아봅니다.

필수 조건

Device Update for IoT Hub를 사용하도록 설정하여 IoT Hub에 액세스합니다. IoT Hub에서는 S1(표준) 계층 이상을 사용하는 것이 좋습니다.
프로비저닝된 디바이스에 대해 가져온 업데이트
IoT Hub에서 디바이스 업데이트를 위해 프로비저닝된 IoT 디바이스(또는 시뮬레이터).
디바이스는 하나 이상의 기본 그룹 또는 사용자가 만든 업데이트 그룹의 일부입니다.

Azure Portal
Azure CLI

지원되는 브라우저:

Microsoft Edge
Google Chrome

Azure CLI 환경:

Azure Cloud Shell에서 Bash 환경을 사용합니다.
또는 CLI 참조 명령을 로컬에서 실행하려면 Azure CLI를 설치합니다.
1. az login 명령을 사용하여 Azure CLI에 로그인합니다.
2. az version을 실행하여 설치된 버전과 종속 라이브러리를 찾습니다. 최신 버전으로 업그레이드하려면 az upgrade를 실행합니다.
3. 메시지가 표시되면 처음 사용할 때 Azure CLI 확장을 설치합니다. 이 문서의 명령은 azure-iot 확장을 사용합니다. az extension update --name azure-iot를 실행하여 최신 버전의 확장을 사용하고 있는지 확인합니다.

팁

이 문서의 Azure CLI 명령은 명령 인수를 더 쉽게 읽을 수 있도록 줄 연속에 백슬래시 \ 문자를 사용합니다. 이 구문은 Bash 환경에서 작동합니다. PowerShell에서 이 명령을 실행하는 경우 각 백슬래시를 백틱(```)으로 바꾸거나 완전히 제거합니다.

Azure Portal에서 IoT Hub로 이동합니다.
탐색 메뉴에서 업데이트를 선택하여 IoT Hub 인스턴스의 디바이스 업데이트 페이지를 엽니다.
페이지 맨 위에 있는 그룹 및 배포 탭을 선택합니다. 자세한 내용은 디바이스 그룹을 참조하세요.
업데이트 규정 준수 차트 및 그룹 목록을 표시합니다. 태그 기반 또는 기본 그룹에 사용할 수 있는 새 업데이트가 표시됩니다. 한 번 새로 고쳐야 할 수도 있습니다. 자세한 내용은 디바이스 업데이트 규정 준수를 참조하세요.
사용 가능한 하나 이상의 업데이트 옆에 있는 ‘배포’를 선택하고 가져오기를 할 때 추가한 설명 레이블이 있고 이것이 맞는지 확인합니다.
올바른 그룹이 대상 그룹으로 선택되었는지 확인하고, 배포를 선택합니다.
배포를 시작하려면 현재 배포 탭으로 이동합니다. 사용 가능한 업데이트 섹션에서 원하는 업데이트 옆에 있는 배포 링크를 선택합니다. 지정된 그룹에서 사용할 수 있는 최상의 업데이트는 최상이라는 강조 표시로 나타납니다.
즉시 또는 나중에 시작하도록 배포를 예약합니다.

팁

기본적으로 시작 날짜 및 시간은 즉시로 설정됩니다. 배포를 나중에 시작하려면 다른 날짜/시간을 선택해야 합니다.
필요한 경우 자동 롤백 정책을 만듭니다. 다음으로 만들기를 선택합니다.
배포 세부 정보에서 상태가 활성으로 바뀝니다. 배포된 업데이트는 (배포 중)으로 표시됩니다.
업데이트가 현재 진행 중인지 확인하려면 준수 차트를 봅니다.
디바이스가 성공적으로 업데이트되면 규정 준수 차트 및 배포 세부 정보가 동일하게 반영되도록 업데이트된 것을 볼 수 있습니다.

그룹에 가장 적합한 업데이트를 확인하기 위한 az iot du device group list. 명령은 다음과 같은 인수를 사용합니다.

--account: 디바이스 업데이트 계정 이름입니다.
--instance: 디바이스 업데이트 인스턴스 이름입니다.
--group-id: 이 배포를 대상으로 하는 디바이스 그룹 ID입니다. 이 ID는 ADUGroup 태그의 값이거나 태그가 없는 디바이스용 $default입니다.
--best-updates: 이 플래그는 명령이 각 업데이트가 필요한 디바이스 수를 포함하여 디바이스 그룹에 가장 적합한 업데이트를 가져와야 함을 나타냅니다.
`--resource-group -g': Device Update 계정 리소스 그룹 이름입니다.
'--update-compliance': 이 플래그는 명령이 최신 업데이트에 있는 디바이스 수, 새 업데이트가 필요한 디바이스 수, 새 업데이트 수신을 진행 중인 디바이스 수와 같은 디바이스 그룹 업데이트 준수 정보를 가져와야 함을 나타냅니다.

az iot du device group list \
    --account <Device Update account name> \
    --instance <Device Update instance name>\
    --gid <device group id>\
    --best-updates {false, true}

az iot du device deployment create를 사용하여 디바이스 그룹용 배포를 만듭니다.

device deployment create 명령은 다음과 같은 인수를 사용합니다.

--account: 디바이스 업데이트 계정 이름입니다.
--instance: 디바이스 업데이트 인스턴스 이름입니다.
--group-id: 이 배포를 대상으로 하는 디바이스 그룹 ID입니다. 이 ID는 ADUGroup 태그의 값이거나 태그가 없는 디바이스용 $default입니다.
--deployment-id: 이 배포를 식별하는 ID입니다.
--update-name, --update-provider및 --update-version: 이 세 매개 변수로 이 배포에서 사용 중인 업데이트의 고유 식별자인 updateId 개체가 정의됩니다.

az iot du device deployment create \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group id> \
    --deployment-id <deployment id> \
    --update-name <update name> \
    --update-provider <update provider> \
    --update-version <update version>

선택적 인수를 사용해 배포를 구성할 수 있습니다. 전체 목록은 선택적 매개 변수를 참조하세요.

자동 롤백 정책을 만들려면 다음 매개 변수를 추가합니다.

--failed-count: 롤백을 트리거하는 배포에서 실패한 디바이스의 수입니다.
--failed-percentage: 롤백을 트리거하는 배포에서 실패한 디바이스의 백분율입니다.
--rollback-update-name, --rollback-update-provider, --rollback-update-version: 롤백이 시작될 경우에 디바이스 그룹에서 사용할 업데이트에 대한 updateID입니다.

az iot du device deployment create \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group id> \
    --deployment-id <deployment id> \
    --update-name <update name> \
    --update-provider <update provider> \
    --update-version <update version> \
    --failed-count 10 \
    --failed-percentage 5 \
    --rollback-update-name <rollback update name> \
    --rollback-update-provider <rollback update provider> \
    --rollback-update-version <rollback update version>

나중에 배포를 시작하려면 --start-time 매개 변수를 사용하여 배포에 대한 대상 날짜/시간을 제공합니다.

az iot du device deployment create \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group id> \
    --deployment-id <deployment id> \
    --update-name <update name> \
    --update-provider <update provider> \
    --update-version <update version> \
    --start-time "2022-12-20T01:00:00"

업데이트 배포 모니터링

Azure Portal
Azure CLI

배포한 대상 그룹을 선택하고 현재 업데이트 또는 배포 기록 탭으로 이동하여 배포가 진행 중인지 확인합니다.
만든 배포 옆에 있는 세부 정보를 선택합니다. 여기에서 배포 세부 정보, 업데이트 세부 정보 및 대상 디바이스 클래스 세부 정보를 볼 수 있습니다. 필요에 따라 디바이스 클래스의 이름을 추가할 수 있습니다.
최신 상태 세부 정보를 보려면 새로 고침을 선택합니다.
그룹 기본 보기로 이동해 특정 디바이스의 상태를 검색하거나, 필터링하여 배포에 실패한 디바이스를 볼 수 있습니다.

az iot du device deployment list를 사용하여 디바이스 그룹에 대한 모든 배포를 봅니다.

az iot du device deployment list \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group id>

az iot du device deployment show를 사용하여 특정 배포의 세부 정보를 확인합니다.

az iot du device deployment show \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group ID> \
    --deployment-id <deployment ID>

배포 진행 중, 배포 완료 또는 배포 실패 디바이스의 수에 대한 정보를 반환하는 --status 플래그를 추가합니다.

az iot du device deployment show \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group ID> \
    --deployment-id <deployment ID> \
    --status

업데이트 배포 다시 시도

어떤 이유로 배포가 실패하는 경우, 실패한 디바이스에 배포를 다시 시도할 수 있습니다.

Azure Portal
Azure CLI

그룹 세부 정보 화면의 현재 배포 탭으로 이동합니다.
실패한 디바이스 다시 시도를 선택하고 확인 알림을 승인합니다.

az iot du device deployment retry를 사용하여 디바이스의 대상 하위 그룹에 대한 배포를 다시 시도합니다.

이 명령은 디바이스 업데이트 에이전트에서 보고한 모델 ID 및 호환성 속성에서 생성된 --class-id 인수를 사용합니다.

az iot du device deployment retry \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --deployment-id <deployment ID> \
    --group-id <device group ID> \
    --class-id <device class ID>

다음 단계

일반 문제 해결