Azure Device Update for IoT Hub에 대한 디바이스 그룹 관리

IoT Hub용 Azure Device Update를 사용하면 사용자 정의 IoT 디바이스 그룹에 업데이트를 배포할 수 있습니다. 모든 디바이스 업데이트 관리 디바이스는 디바이스 그룹의 구성원이지만 디바이스 그룹을 정의하는 것은 선택 사항입니다. 또는 디바이스 업데이트에서 제공하는 기본 디바이스 그룹에 배포할 수 있습니다.

사용자 정의 디바이스 업데이트 태그 값을 만들고 디바이스에 할당하는 경우 Device Update는 할당된 태그 및 디바이스 호환성 속성에 따라 그룹을 자동으로 만듭니다. 각 디바이스 그룹에 대해 디바이스 업데이트는 디바이스 클래스가 다른 여러 하위 그룹을 만들 수 있습니다. 디바이스 업데이트는 디바이스 그룹에 태그가 없는 디바이스를 default 배치합니다.

이 문서에서는 Azure Portal 또는 Azure CLI를 사용하여 사용자 정의 디바이스 업데이트 디바이스 태그 및 그룹을 만들고 관리하는 방법을 설명합니다. 사용자 정의 또는 기본 디바이스 그룹에 업데이트를 배포하려면 디바이스 업데이트 배포를 참조하세요.

필수 조건

Azure Portal

• IoT Hub용 디바이스 업데이트를 사용하도록 설정된 Azure IoT Hub 의 표준(S1) 이상 인스턴스입니다.
• IoT 허브 내에서 디바이스 업데이트를 위해 프로비전된 IoT 디바이스 또는 시뮬레이터입니다.
• 디바이스 업데이트 에이전트가 설치되어 디바이스에서 모듈 또는 디바이스 수준 ID로 시작되었습니다.
• 프로비저닝된 디바이스에 대해 가져온 업데이트

Azure CLI

• IoT Hub용 디바이스 업데이트를 사용하도록 설정된 Azure IoT Hub 의 표준(S1) 이상 인스턴스입니다.

• IoT 허브 내에서 디바이스 업데이트를 위해 프로비전된 IoT 디바이스 또는 시뮬레이터입니다.

• 디바이스 업데이트 에이전트가 설치되어 디바이스에서 모듈 또는 디바이스 수준 ID로 시작되었습니다.

• 프로비저닝된 디바이스에 대해 가져온 업데이트

• Azure CLI 명령을 실행하는 Azure Cloud Shell의 Bash 환경입니다. Cloud Shell 시작을 선택하여 Cloud Shell을 열거나 Azure Portal의 위쪽 도구 모음에서 Cloud Shell 아이콘을 선택합니다.

  

  참고 항목

  원하는 경우 Azure CLI 명령을 로컬로 실행할 수 있습니다.

  1. Azure CLI 설치. az 버전을 실행하여 설치된 Azure CLI 버전 및 종속 라이브러리를 확인하고 az upgrade를 실행하여 최신 버전을 설치합니다.
  2. az login을 실행하여 Azure에 로그인합니다.
  3. azure-iot 처음 사용할 때 메시지가 표시되면 확장을 설치합니다. 최신 버전의 확장을 사용하고 있는지 확인하려면 다음을 실행합니다 az extension update --name azure-iot.

디바이스에 태그 추가

디바이스 업데이트 디바이스 그룹을 할당하려면 IoT Hub에서 디바이스 업데이트 연결된 디바이스의 대상 집합에 태그를 추가 ADUGroup 합니다. 디바이스 업데이트 에이전트가 디바이스 ID로 프로비전된 경우 디바이스 쌍에 태그를 추가하거나, 디바이스 업데이트 에이전트가 모듈 ID로 프로비전된 경우 해당 모듈 쌍에 태그를 추가합니다.

디바이스 업데이트 ADUGroup 태그는 다음 디바이스 또는 모듈 쌍 예제와 같이 키-값 형식을 사용합니다.

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

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

태그 ADUGroup 에는 다음과 같은 속성 및 제한 사항이 있습니다.

• 디바이스는 태그를 하나 ADUGroup 만 가질 수 있으며 한 번에 하나의 디바이스 업데이트 그룹에만 속할 수 있습니다. 명명된 ADUGroup 다른 태그를 추가하면 기존 ADUGroup 값이 재정의됩니다.
• 예약된 값 및 을 제외한 태그에 대한 모든 값을 Uncategorized 사용할 수 있습니다 $default.
• 태그 값은 200자를 초과할 수 없습니다.
• 태그 값에는 영숫자 문자와 다음과 같은 특수 문자 . - _ ~가 포함될 수 있습니다.
• ADUGroup 태그 이름 및 그룹 이름 값은 대/소문자를 구분합니다.

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

SDK를 사용하여 태그 추가

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

• .NET을 사용하여 디바이스 쌍 시작
• 태그 및 속성 형식 이해

작업을 사용하여 태그 추가

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

참고 항목

이 작업은 IoT Hub 메시지 할당량에 대해 계산됩니다. 한 번에 50,000개 이상의 디바이스 또는 모듈 쌍 태그를 변경하는 경우 일일 IoT Hub 메시지 할당량을 초과하여 더 많은 IoT Hub 단위를 구입해야 할 수 있습니다. 자세한 내용은 할당량 및 제한을 참조하세요.

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

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

Azure Portal

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

2. 왼쪽 탐색 창에서 디바이스 관리에서 디바이스를 선택합니다. IoT Edge 디바이스가 있는 경우 대신 IoT Edge를 선택합니다.

3. 디바이스 페이지에서 디바이스를 선택합니다.

4. 디바이스 페이지의 위쪽 메뉴에서 디바이스 쌍을 선택하거나 모듈 ID에서 모듈 ID를 선택한 다음 모듈 쌍을 선택합니다.

5. 트윈에서 다음과 같이 사용자 정의 값이 있는 태그를 추가 ADUGroup 합니다. 기존 ADUGroup 태그 값을 업데이트하려면 다른 사용자 정의 값으로 덮어씁 수 있습니다.

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

6. 저장을 선택합니다.

Azure CLI

az iot hub device-twin update 또는 az iot hub module-twin update를 사용하여 적절한 값을 가진 디바이스 또는 모듈 쌍에 태그를 추가 ADUGroup합니다. 두 명령 모두에서 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"}'

디바이스 그룹 보기

Azure Portal

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

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

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

   

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

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

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. 그룹 내에서 개별 디바이스를 선택하여 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>
    --best-updates
    --update-compliance

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

디바이스 그룹에서 디바이스를 제거하려면 태그 값을 null 쌍으로 변경 ADUGroup 하고 저장을 선택합니다.

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

이 작업은 디바이스 쌍에서 그룹 태그를 삭제하고 디바이스 그룹에서 디바이스를 제거합니다.

디바이스 그룹 삭제

디바이스 업데이트는 자동으로 디바이스 그룹을 만들고 기록 레코드 또는 기타 사용자 요구 사항에 대한 디바이스 그룹, 디바이스 클래스 및 배포를 자동으로 정리하는 대신 유지합니다. 개별적으로 그룹을 선택하고 삭제하거나 그룹에서 Azure CLI 명령을 호출 az iot du device group delete 하여 Azure Portal을 통해 디바이스 그룹을 삭제할 수 있습니다.

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

• 그룹이 아니어야 default 합니다.
• 멤버 디바이스가 없어야 합니다. 즉, 디바이스 업데이트 인스턴스에 프로비전된 디바이스에는 그룹 이름과 일치하는 값이 있는 태그가 있을 ADUGroup 수 없습니다.
• 연결된 활성 또는 취소된 배포가 없어야 합니다.

참고 항목

이전 요구 사항을 충족하는 그룹을 삭제할 수 없는 경우 비정상 디바이스가 그룹의 일부로 태그가 지정되어 있는지 확인합니다. 비정상 디바이스는 배포를 받을 수 없으므로 그룹의 구성원 디바이스 목록에 직접 표시되지 않습니다.

비정상 디바이스가 있는지 확인하려면 다음을 수행합니다.

1. Azure Portal에서 IoT Hub로 이동합니다.
2. 왼쪽 탐색 영역에서 업데이트를 선택한 다음 진단 탭을 선택합니다.
3. 누락된 디바이스 찾기 섹션을 펼칩니다.

비정상 디바이스에 그룹의 일부로 태그가 지정된 경우 그룹을 삭제하려면 먼저 태그 값을 변경하거나 디바이스를 삭제해야 합니다.

디바이스가 삭제된 그룹 이름에 다시 할당된 경우 디바이스 업데이트는 자동으로 그룹을 다시 만들지만 연결된 디바이스 또는 배포 기록은 없습니다.

관련 콘텐츠

• 디바이스 그룹
• 디바이스 업데이트 준수
• 업데이트 배포