IoT Hub용 디바이스 업데이트를 사용하면 IoT 디바이스 그룹에 업데이트를 배포할 수 있습니다.
비고
사용자가 만든 그룹 대신 기본 그룹에 배포하려는 경우 업데이트를 배포하는 방법으로 직접 이동할 수 있습니다.
필수 조건
- IoT Hub용 디바이스 업데이트가 활성화된 IoT Hub에 대한 액세스. IoT Hub에 대해 S1(표준) 계층 이상을 사용하는 것이 좋습니다.
- IoT Hub 내에서 디바이스 업데이트를 위해 프로비전된 IoT 디바이스(또는 시뮬레이터)입니다.
- 프로비전된 디바이스에 대해 하나 이상의 업데이트를 가져왔습니다.
- 모듈 또는 디바이스 수준 ID로 IoT 디바이스에 디바이스 업데이트 에이전트 설치 및 시작
디바이스에 태그 추가
IoT Hub용 디바이스 업데이트를 사용하면 IoT 디바이스 그룹에 업데이트를 배포할 수 있습니다. 그룹을 만들기 위해 첫 번째 단계는 IoT Hub의 대상 디바이스 집합에 태그를 추가하는 것입니다. 태그는 디바이스 업데이트에 연결된 후에만 디바이스에 성공적으로 추가할 수 있습니다.
아래 설명서에서는 태그를 추가하고 업데이트하는 방법을 설명합니다.
프로그래밍 방식으로 디바이스 트윈 업데이트
디바이스 업데이트를 사용하여 디바이스를 등록한 후 RegistryManager를 사용하여 적절한 태그로 디바이스 트윈을 업데이트할 수 있습니다.
디바이스 업데이트 태그 형식
"tags": {
"ADUGroup": "<CustomTagValue>"
}
작업 활용
디바이스 업데이트 태그를 추가하거나 업데이트하기 위해 여러 디바이스에서 작업을 예약할 수 있습니다. 예를 들어, 여러 디바이스에서 작업 예약을 참조하려면 을 참조하세요. 작업을 사용하여 디바이스 쌍 또는 모듈 쌍(디바이스 업데이트 에이전트가 모듈 ID로 설정된 경우)을 업데이트할 수 있습니다. 자세한 내용은 작업 예약 및 브로드캐스트를 참조하세요.
비고
이 작업은 IoT Hub 메시지 할당량에 대해 계산되며 한 번에 최대 50,000개의 디바이스 또는 모듈 쌍 태그만 변경하는 것이 좋습니다. 그렇지 않으면 일일 IoT Hub 메시지 할당량을 초과하는 경우 더 많은 IoT Hub 단위를 구입해야 할 수 있습니다. 자세한 내용은 할당량 및 제한에서 찾을 수 있습니다.
쌍방향 업데이트
디바이스 쌍 또는 모듈 쌍에서 직접 태그를 추가하거나 업데이트할 수도 있습니다.
Azure Portal에 로그인하고 IoT Hub로 이동합니다.
탐색 메뉴에서 디바이스 를 선택하고 IoT 디바이스를 선택하여 디바이스 세부 정보를 엽니다.
쌍둥이 세부 정보를 엽니다.
- 디바이스 업데이트 에이전트가 디바이스 ID로 구성된 경우 디바이스 쌍 선택합니다.
- 디바이스 업데이트 에이전트가 모듈 ID로 구성된 경우 디바이스 업데이트 모듈 및 모듈 ID 쌍을 선택합니다.
디바이스 쌍 또는 모듈 쌍에서 기존 디바이스 업데이트 태그 값을 null로 설정하여 삭제합니다.
아래와 같이 새 디바이스 업데이트 태그 값을 추가합니다. 태그가 있는 디바이스 쌍 JSON 문서 예제입니다.
"tags": {
"ADUGroup": "<CustomTagValue>"
}
제한점
- 예약된 값인 '분류되지 않은'을 제외하고 태그에 값을 추가할 수 있습니다.
- 태그 값은 255자를 초과할 수 없습니다.
- 태그 값은 영숫자 문자와 다음 특수 문자 ".","-","_","~"를 포함할 수 있습니다.
- 태그 및 그룹 이름은 대/소문자를 구분합니다.
- 디바이스에는 ADUGroup이라는 태그가 하나만 있을 수 있으며, 이후에 해당 이름을 가진 태그를 추가하면 태그 이름 ADUGroup에 대한 기존 값이 재정의됩니다.
- 하나의 디바이스는 하나의 그룹에만 속할 수 있습니다.
기존 IoT Hub 태그를 선택하여 디바이스 그룹 만들기
Azure Portal로 이동합니다.
이전에 디바이스 업데이트 인스턴스에 연결한 IoT Hub를 선택합니다.
왼쪽 탐색 모음에서 디바이스 관리에서 업데이트 옵션을 선택합니다.
페이지 맨 위에 있는 그룹 및 배포 탭을 선택합니다.
그룹 추가를 선택하여 새 그룹을 만듭니다.
목록에서 IoT Hub 태그 및 디바이스 클래스를 선택한 다음 그룹 만들기를 선택합니다.
그룹이 만들어지면 업데이트 준수 차트 및 그룹 목록이 업데이트되는 것을 볼 수 있습니다. 업데이트 준수 차트는 다양한 준수 상태의 디바이스 수를 보여 줍니다. 최신 업데이트, 사용 가능한 새 업데이트 및 업데이트 진행 중. 업데이트 준수에 대해 알아봅니다.
새로 만든 그룹과 새 그룹의 디바이스에 대해 사용 가능한 업데이트가 표시됩니다. 그룹의 디바이스 클래스 요구 사항을 충족하지 않는 디바이스가 있는 경우 해당 잘못된 그룹에 표시됩니다. 그룹 옆에 있는 "배포" 단추를 클릭하여 이 보기에서 새 사용자 정의 그룹에 가장 적합한 업데이트를 배포할 수 있습니다. 자세한 내용은 다음 단계: 업데이트 배포를 참조하세요.
만든 그룹에 대한 디바이스 세부 정보 보기
새로 만든 그룹으로 이동하고 그룹 이름을 클릭합니다.
그룹의 일부인 디바이스 목록이 해당 디바이스 업데이트 속성과 함께 표시됩니다. 이 보기에서는 그룹의 구성원인 모든 디바이스에 대한 업데이트 준수 정보를 볼 수도 있습니다. 업데이트 준수 차트는 다양한 준수 상태의 디바이스 수를 보여 줍니다. 최신 업데이트에서는 사용 가능한 새 업데이트와 진행 중인 업데이트가 있습니다.
그룹 내의 각 개별 디바이스를 클릭하여 IoT Hub의 디바이스 세부 정보 페이지로 리디렉션할 수도 있습니다.
