IoT Hub용 디바이스 업데이트에서 디바이스 그룹 관리

IoT Hub에 대한 디바이스 업데이트를 통해 IoT 디바이스 그룹에 업데이트를 배포할 수 있습니다. 이 단계는 관리되는 디바이스에 업데이트를 배포할 때 선택 사항입니다. 자동으로 만들어진 기본 그룹을 사용하여 디바이스에 업데이트를 배포할 수 있습니다. 또는 사용자 정의 태그를 디바이스에 할당할 수 있습니다. 그러면 디바이스는 태그 및 디바이스 호환성 속성에 따라 자동으로 그룹화됩니다.

참고 항목

사용자가 만든 그룹 대신 기본 그룹에 배포하려는 경우 업데이트를 배포하는 방법을 계속 진행합니다.

필수 조건

• Device Update for IoT Hub를 사용하도록 설정하여 IoT Hub에 액세스합니다. IoT Hub에서는 S1(표준) 계층 이상을 사용하는 것이 좋습니다.
• IoT Hub에서 디바이스 업데이트를 위해 프로비저닝된 IoT 디바이스(또는 시뮬레이터).
  • IoT 디바이스에 모듈 또는 디바이스 수준 ID로 디바이스 업데이트 에이전트를 설치하고 시작합니다.
• 프로비저닝된 디바이스에 대해 가져온 업데이트

Azure Portal

지원되는 브라우저:

• Microsoft Edge
• Google Chrome

Azure CLI

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를 실행하여 최신 버전의 확장을 사용하고 있는지 확인합니다.

디바이스에 태그 추가

디바이스 그룹 만들기의 첫 번째 단계는 IoT Hub의 대상 디바이스 집합에 태그를 추가하는 것입니다. 태그는 디바이스 업데이트에 연결된 후에만 디바이스에 추가될 수 있습니다.

디바이스 업데이트 태그는 다음 예제에서 형식을 사용합니다.

"etag": "",
"deviceId": "",
"deviceEtag": "",
"version": <version>,
"tags": {
   "ADUGroup": "<CustomTagValue>"
}

쌍 JSON 구문의 자세한 내용과 예제는 디바이스 쌍 이해 및 사용 또는 모듈 쌍 이해 및 사용을 참조하세요.

다음 섹션에서는 태그를 추가하고 업데이트하는 다양한 방법을 설명합니다.

SDK를 사용하여 태그 추가

디바이스 업데이트를 사용하여 디바이스를 등록한 후에 RegistryManager를 사용하여 디바이스 또는 모듈 쌍을 적절한 태그로 업데이트할 수 있습니다. 자세한 내용은 다음 문서를 참조하세요.

• 샘플 .NET 앱을 사용하여 태그를 추가하는 방법을 알아봅니다.
• 태그 속성에 대해 알아봅니다.

디바이스 업데이트 에이전트가 디바이스 ID로 프로비저닝된 경우 디바이스 쌍에 태그를 추가하고, 디바이스 업데이트 에이전트가 모듈 ID로 프로비저닝된 경우 해당 모듈 쌍에 태그를 추가합니다.

작업을 사용하여 태그 추가

디바이스 업데이트 태그를 추가하거나 업데이트하기 위해 여러 디바이스에서 작업을 예약할 수 있습니다. 작업의 예는 여러 디바이스에서 작업 예약을 참조하세요. 디바이스 업데이트 에이전트가 디바이스 또는 모듈 ID 중 어떤 항목으로 프로비저닝되었는지에 따라 작업을 사용하여 디바이스 쌍 또는 모듈 쌍을 업데이트할 수 있습니다.

자세한 내용은 작업 예약 및 브로드캐스트를 참조하세요.

참고 항목

이 작업은 IoT Hub 메시지 할당량에 따라 계산됩니다. 한 번에 최대 5만 개의 디바이스 또는 모듈 쌍 태그만 변경하는 것이 좋습니다. 일일 IoT Hub 메시지 할당량을 초과하는 경우, IoT Hub 단위를 추가로 구입해야 할 수 있습니다. 자세한 내용은 할당량 및 제한을 참조하세요.

쌍을 업데이트하여 태그 추가

태그를 디바이스 또는 모듈 쌍에서 직접 추가하거나 업데이트할 수도 있습니다.

Azure Portal

1. Azure Portal에서 IoT Hub로 이동합니다.

2. 디바이스 또는 왼쪽 탐색 창의 IoT Edge에서 IoT 디바이스를 찾습니다. 디바이스 업데이트 에이전트가 디바이스 또는 모듈 ID 중 어떤 항목으로 프로비저닝되는지에 따라 디바이스 쌍 또는 디바이스 업데이트 모듈로 이동한 후 해당 모듈 쌍으로 이동합니다.

3. 쌍 세부 정보에서 기존 디바이스 업데이트 태그 값을 null로 설정하여 삭제합니다.

4. 아래와 같이 새 디바이스 업데이트 태그 값을 추가합니다.

       "tags": {
               "ADUGroup": "<CustomTagValue>"
               }
   

Azure CLI

az iot hub device-twin update 또는 az iot hub module-twin update를 사용하여 디바이스 또는 모듈 쌍에 태그를 추가합니다.

두 update 명령 모두 --tags 인수는 인라인 json 또는 json 콘텐츠에 대한 파일 경로를 허용합니다.

예시:

az iot hub module-twin update \
    --hub-name <IoT Hub name> \
    --device-id <device name> \
    --module-id <module name> \
    --tags '{"ADUGroup": "<custom_tag_value"}'

제한 사항

• 예약된 값인 Uncategorized 및 $default을 제외하고 어떤 값도 태그에 추가할 수 있습니다.
• 태그 값은 200자를 초과할 수 없습니다.
• 태그 값에는 영숫자 문자와 특수 문자 . - _ ~을 사용할 수 있습니다.
• 태그 및 그룹 이름은 대/소문자를 구분합니다.
• 디바이스에는 이름이 ADUGroup인 태그가 하나만 있을 수 있습니다. 해당 이름의 태그를 추가하면 태그 이름 ADUGroup의 기존 값이 재정의됩니다.
• 한 디바이스는 하나의 그룹에만 속할 수 있습니다.

디바이스 그룹 보기

그룹은 할당된 태그와 디바이스의 호환성 속성에 따라 자동으로 만들어집니다. 한 그룹에는 여러 디바이스 클래스가 있는 여러 하위 그룹이 있을 수 있습니다.

Azure Portal

1. Azure Portal에서 이전에 디바이스 업데이트 인스턴스에 연결한 IoT Hub로 이동합니다.

2. 왼쪽 탐색 모음에서 장치 관리 아래에 있는 업데이트 옵션을 선택합니다.

3. 그룹 및 배포 탭을 선택합니다.

   

4. 그룹이 생성되면 업데이트된 규정 준수 차트와 그룹 목록이 표시됩니다. 디바이스 업데이트 규정 준수 차트에는 최신 업데이트, 사용 가능한 새 업데이트 및 진행 중인 업데이트 등 다양한 준수 상태의 디바이스 수가 표시됩니다. 자세한 내용은 디바이스 업데이트 규정 준수를 참조하세요.

   

5. 기존 그룹 및 그룹 목록에 있는 해당 그룹의 디바이스에 대한 업데이트가 표시됩니다. 그룹의 디바이스 클래스 요구 사항을 충족하지 않는 디바이스가 있는 경우 해당하는 잘못된 그룹에 표시됩니다. 그룹 옆에 있는 배포 단추를 선택하여 이 보기에서 그룹에 가장 적합한 사용 가능한 업데이트를 배포할 수 있습니다.

Azure CLI

az iot du device group list를 사용하여 디바이스 업데이트 인스턴스의 모든 디바이스 그룹을 봅니다.

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

--order-by 인수를 사용하여 새 업데이트를 사용할 수 있는 그룹 ID, 디바이스 수 또는 하위 그룹 수 등에 따라 반환된 그룹을 정렬할 수 있습니다.

그룹에 대한 디바이스 세부 정보 보기

Azure Portal

1. 그룹 및 배포 탭에서 보려는 그룹의 이름을 선택합니다.

2. 그룹 세부 정보 페이지에서 디바이스 업데이트 속성과 함께 그룹의 일부인 디바이스 목록을 볼 수 있습니다. 이 보기에서 해당 그룹의 구성 요소인 모든 디바이스의 업데이트 규정 준수 정보를 볼 수도 있습니다. 규정 준수 차트는 다양한 규정 준수 상태의 디바이스 수를 보여 줍니다.

   

3. 그룹 내의 개별 디바이스를 선택하여 IoT Hub의 디바이스 세부 정보 페이지로 리디렉션할 수도 있습니다.

   

   

Azure CLI

az iot du device group show를 사용하여 특정 디바이스 그룹의 세부 정보를 봅니다.

선택적 --best-updates 플래그는 각 업데이트가 필요한 디바이스 수를 포함하여 디바이스 그룹에 사용할 수 있는 가장 적합한 업데이트 목록을 반환합니다.

선택적 --update-compliance 플래그는 최신 업데이트에 있는 디바이스 수, 새 업데이트가 필요한 디바이스 수, 새 업데이트가 진행 중인 디바이스 수를 포함하여 디바이스 그룹에 대한 규정 준수 정보를 반환합니다.

az iot du device group show \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <value of the ADUGroup tag for this group>

디바이스 그룹에서 디바이스 제거

디바이스 그룹에서 디바이스를 제거하려면 ADUGroup 태그 값을 "null"로 변경해야 합니다.

    "tags": {
            "ADUGroup": "null"
            }

그러면 디바이스 쌍에서 ADUGroup 태그가 삭제되고 디바이스 그룹에서 디바이스가 제거됩니다.

디바이스 그룹 삭제

디바이스 그룹이 자동으로 만들어지는 동안 그룹, 디바이스 클래스 및 배포는 기록 레코드 또는 기타 사용자 요구 사항에 맞게 유지되도록 자동으로 정리되지 않습니다. 원하는 그룹을 개별적으로 선택하고 삭제하거나 그룹에서 DELETE API를 호출하여 Azure Portal를 통해 디바이스 그룹을 삭제할 수 있습니다. 자세한 정보

그룹이 삭제된 후 디바이스가 이 그룹에 대해 다시 연결된 경우 그룹이 자동으로 다시 만들어지는 동안 연결된 디바이스 또는 배포 기록이 없습니다.

삭제하려면 그룹이 다음 요구 사항을 충족해야 합니다.

• 그룹에 멤버 디바이스가 없어야 합니다. 즉, Device Update 인스턴스에 프로비전된 디바이스에는 선택한 그룹의 이름과 일치하는 값이 있는 ADUGroup 태그가 있어야 합니다.
• 이 그룹은 기본 그룹이 아니어야 합니다.
• 그룹에 연결된 활성 또는 취소된 배포가 없어야 합니다.

참고 항목

위의 요구 사항을 충족한 후에도 그룹을 삭제할 수 없는 경우 그룹의 일부가 태그로 지정된 비정상 디바이스가 있는지 확인합니다. 비정상 디바이스는 배포를 받을 수 없는 디바이스이므로 그룹 내의 멤버 디바이스 목록에 직접 표시되지 않습니다. Device Update Portal 환경의 진단 탭 내에서 "누락된 디바이스 찾기"로 이동하여 비정상 디바이스가 있는지 여부를 확인할 수 있습니다. 그룹의 일부가 태그로 지정된 비정상 디바이스가 있는 경우 그룹 삭제를 시도하기 전에 태그 값을 수정하거나 디바이스를 완전히 삭제해야 합니다.

다음 단계

• 업데이트 배포

• 디바이스 그룹에 대해 자세히 알아보기

• 디바이스 업데이트 규정 준수에 대해 자세히 알아보기