Azure CLI용 IoT 확장을 사용하여 Azure IoT Hub 디바이스 관리
이 문서에서는 개발 머신에서 다양한 관리 옵션으로 Azure CLI용 IoT 확장을 사용하는 방법에 대해 알아봅니다. Azure CLI용 IoT 확장은 Azure CLI의 기능에 추가되는 오픈 소스 IoT 확장입니다. Azure CLI에는 Azure Resource Manager 및 관리 엔드포인트와 상호 작용하기 위한 명령이 포함되어 있습니다. 예를 들어 Azure CLI를 사용하여 Azure VM 또는 IoT 허브를 만들 수 있습니다. CLI 확장을 사용하면 Azure 서비스는 Azure CLI를 확대하여, 사용자에게 추가적인 서비스별 기능에 대한 액세스 권한을 부여할 수 있습니다. IoT 확장은 IoT 개발자가 명령줄을 통해 모든 IoT Hub, IoT Edge, IoT Hub Device Provisioning Service 기능에 액세스할 수 있도록 합니다.
| 관리 옵션 | Task |
|---|---|
| 직접 메서드 | 메시지 보내기 시작 또는 중지, 디바이스 다시 부팅 등의 디바이스 작업을 수행합니다. |
| Twin desired 속성 | 디바이스를 특정 상태(예: LED를 녹색으로 설정 또는 원격 분석 전송 간격을 30 분으로 설정)로 지정합니다. |
| Twin reported 속성 | 디바이스의 보고된 상태를 가져옵니다. 예를 들어 디바이스에서 지금 LED가 깜박이고 있다고 보고합니다. |
| Twin tags | 클라우드에서 디바이스 전용 메타데이터를 저장합니다. 예를 들어 자동 판매기의 배포 위치입니다. |
| 디바이스 쌍 쿼리 | 모든 디바이스 쌍을 쿼리하여 사용할 수 있는 디바이스를 식별하는 등 임의의 조건에 해당하는 디바이스 쌍을 검색합니다. |
이러한 옵션을 사용하는 방법에 대한 차이점과 지침에 대한 자세한 내용은 디바이스-클라우드 통신 지침 및 클라우드-디바이스 통신 지침을 참조하세요.
디바이스 쌍은 디바이스의 상태 정보(메타데이터, 상태 및 조건)를 저장하는 JSON 문서입니다. IoT Hub는 여기에 연결하는 각 디바이스에 대해 하나의 디바이스 쌍을 유지합니다. 디바이스 쌍에 대한 자세한 내용은 디바이스 쌍 시작을 참조하세요.
참고
이 문서에서는 azure-iot라는 최신 버전의 Azure IoT 확장이 사용됩니다. 레거시 버전은 azure-cli-iot-ext라고 합니다. 한 번에 하나의 버전만 설치해야 합니다. az extension list 명령을 사용하여 현재 설치된 확장의 유효성을 검사할 수 있습니다.
az extension remove --name azure-cli-iot-ext를 사용하여 레거시 버전의 확장을 제거합니다.
az extension add --name azure-iot를 사용하여 새 버전의 확장을 추가합니다.
설치한 확장을 확인하려면 az extension list를 사용합니다.
참고
이 문서에서 설명하는 기능은 IoT Hub의 표준 계층에서만 사용할 수 있습니다. 기본 및 표준/무료 IoT Hub 계층에 대한 자세한 내용은 솔루션에 적합한 IoT Hub 계층 선택을 참조하세요.
사전 요구 사항
Raspberry Pi 온라인 시뮬레이터 자습서 또는 디바이스 자습서 중 하나를 완료합니다. 예를 들어 Node.js를 사용하는 Raspberry Pi로 이동하거나 원격 분석 전송 빠른 시작 중 하나로 이동할 수 있습니다. 이러한 문서는 다음 요구 사항을 다룹니다.
- 활성화된 Azure 구독.
- 구독 중인 Azure IoT Hub
- 메시지를 Azure IoT Hub로 보내는 클라이언트 애플리케이션
이 자습서를 진행하는 동안 디바이스가 클라이언트 애플리케이션을 사용해서 실행되고 있어야 합니다.
Azure CLI Azure CLI를 설치해야 하는 경우 Azure CLI 설치를 참조하세요. Azure CLI 버전이 2.0.70 이상이어야 합니다.
az –version명령을 사용하여 유효성을 검사합니다.
참고
이 문서에서는 azure-iot라는 최신 버전의 Azure IoT 확장이 사용됩니다. 레거시 버전은 azure-cli-iot-ext라고 합니다. 한 번에 하나의 버전만 설치해야 합니다. az extension list 명령을 사용하여 현재 설치된 확장의 유효성을 검사할 수 있습니다.
az extension remove --name azure-cli-iot-ext를 사용하여 레거시 버전의 확장을 제거합니다.
az extension add --name azure-iot를 사용하여 새 버전의 확장을 추가합니다.
설치한 확장을 확인하려면 az extension list를 사용합니다.
- IoT 확장을 설치합니다. 가장 간단한 방법은
az extension add --name azure-iot명령을 사용하는 것입니다. IoT 확장 추가 정보에는 확장을 설치하는 여러 가지 방법이 설명되어 있습니다.
Azure 계정에 로그인
다음 명령을 실행하여 Azure 계정에 로그인합니다.
az login
직접 메서드
az iot hub invoke-device-method --device-id <your device id> \
--hub-name <your hub name> \
--method-name <the method name> \
--method-payload <the method payload>
디바이스 쌍 desired 속성
다음 명령을 실행하여 desired 속성의 간격(interval = 3000)을 설정합니다.
az iot hub device-twin update -n <your hub name> \
-d <your device id> --set properties.desired.interval=3000
이 속성은 디바이스에서 읽을 수 있습니다.
디바이스 쌍 reported 속성
다음 명령을 실행하여 디바이스의 reported 속성을 가져옵니다.
az iot hub device-twin show -n <your hub name> -d <your device id>
트윈 reported 속성 중 하나는 $metadata.$lastUpdated로서, 디바이스 앱이 해당 reported 속성 집합을 업데이트한 마지막 시간을 나타냅니다.
디바이스 쌍 태그
다음 명령을 실행하여 디바이스의 태그와 속성을 표시합니다.
az iot hub device-twin show --hub-name <your hub name> --device-id <your device id>
다음 명령을 실행하여 디바이스에 필드 역할 = temperature&humidity를 추가합니다.
az iot hub device-twin update \
--hub-name <your hub name> \
--device-id <your device id> \
--set tags='{"role":"temperature&humidity"}'
디바이스 쌍 쿼리
다음 명령을 실행하여 역할 태그 = 'temperature&humidity'가 지정된 디바이스를 쿼리합니다.
az iot hub query --hub-name <your hub name> \
--query-command "SELECT * FROM devices WHERE tags.role = 'temperature&humidity'"
다음 명령을 실행하여 역할 태그 = 'temperature&humidity'가 지정된 디바이스를 제외한 모든 디바이스를 쿼리합니다.
az iot hub query --hub-name <your hub name> \
--query-command "SELECT * FROM devices WHERE tags.role != 'temperature&humidity'"
다음 단계
IoT 디바이스와 Azure IoT Hub 간에 디바이스-클라우드 메시지를 모니터링하고 클라우드-디바이스 메시지를 보내는 방법을 알아보았습니다.
Azure IoT Hub를 계속 시작하고 모든 확장 IoT 시나리오를 살펴보려면 다음을 참조하세요.