Úlohy plánování a vysílání (Azure CLI)

Článek
07/17/2024

Pomocí služby Azure IoT Hub můžete plánovat a sledovat úlohy, které aktualizují miliony zařízení. Použití úloh k:

Aktualizace požadovaných vlastností
Aktualizace značek
Vyvolání přímých metod

Úloha zabalí jednu z těchto akcí a sleduje průběh provádění v sadě zařízení. Sada zařízení, se kterými úloha komunikuje, je definována dotazem dvojčete zařízení. Back-endová aplikace může například pomocí úlohy vyvolat metodu restartování na 10 000 zařízeních určených dotazem dvojčete zařízení a naplánovat ji v budoucnu. Tato aplikace pak může sledovat průběh, když každé z těchto zařízení přijme a spustí metodu restartování.

Další informace o jednotlivých funkcích najdete v těchto článcích:

Dvojče zařízení a vlastnosti: Začínáme s dvojčaty zařízení a principy a používání dvojčat zařízení ve službě IoT Hub
Přímé metody: Příručka pro vývojáře ioT Hubu – přímé metody

Poznámka:

Funkce popsané v tomto článku jsou k dispozici pouze na úrovni Standard služby IoT Hub. Další informace o úrovních Služby IoT Hub úrovně Basic a Standard/Free najdete v tématu Volba správné úrovně IoT Hubu pro vaše řešení.

V tomto článku se dozvíte, jak vytvořit dvě relace Azure CLI:

Relace, která vytvoří simulované zařízení. Simulované zařízení je nakonfigurované tak, aby při vyvolání jakékoli přímé metody vrátilo stavový kód a datovou část JSON.
Relace, která vytvoří dvě naplánované úlohy. První úloha vyvolá přímou metodu a druhá úloha aktualizuje požadovanou vlastnost dvojčete zařízení na simulovaném zařízení vytvořeném v druhé relaci.

Požadavky

Rozhraní příkazového řádku Azure. Příkazy v tomto článku můžete spustit také pomocí azure Cloud Shellu, interaktivního prostředí cli, které běží v prohlížeči nebo v aplikaci, jako je Terminál Windows. Pokud používáte Cloud Shell, nemusíte nic instalovat. Pokud raději používáte rozhraní příkazového řádku místně, tento článek vyžaduje Azure CLI verze 2.36 nebo novější. Verzi zjistíte spuštěním příkazu az --version. Pokud chcete místně nainstalovat nebo upgradovat Azure CLI, přečtěte si téma Instalace Azure CLI.
Centrum IoT ve vašem předplatném Azure Pokud centrum ještě nemáte, můžete postupovat podle kroků v tématu Vytvoření centra IoT.
Ujistěte se, že je v bráně firewall otevřený port 8883. Ukázka zařízení v tomto článku používá protokol MQTT, který komunikuje přes port 8883. Tento port může být blokovaný v některých podnikových a vzdělávacích síťových prostředích. Další informace a způsoby řešení tohoto problému najdete v tématu Připojení ke službě IoT Hub (MQTT).

Příprava Cloud Shellu

Pokud chcete použít Azure Cloud Shell, musíte ho nejprve spustit a nakonfigurovat. Pokud používáte rozhraní příkazového řádku místně, přejděte do části Příprava dvou relací rozhraní příkazového řádku.

V záhlaví stránky na webu Azure Portal vyberte ikonu Cloud Shellu.

Poznámka:

Pokud jste Cloud Shell použili poprvé, zobrazí se výzva k vytvoření úložiště, které je potřeba k použití Cloud Shellu. Vyberte předplatné, abyste vytvořili účet úložiště, a sdílenou složku služby Microsoft Azure Files.
Pomocí selektoru prostředí na panelu nástrojů Cloud Shell vyberte upřednostňované prostředí rozhraní příkazového řádku. Tento článek používá prostředí Bash . Můžete také použít prostředí PowerShellu .

Poznámka:

Některé příkazy vyžadují jinou syntaxi nebo formátování v prostředích Bash a PowerShellu . Další informace najdete v tématu Tipy pro úspěšné použití Azure CLI.

Příprava dvou relací rozhraní příkazového řádku

Dále musíte připravit dvě relace Azure CLI. Pokud používáte Cloud Shell, spustíte tyto relace na samostatných kartách Cloud Shellu. Pokud používáte místního klienta rozhraní příkazového řádku, spustíte samostatné instance rozhraní příkazového řádku. Pro následující úlohy použijte samostatné relace rozhraní příkazového řádku:

První relace simuluje zařízení IoT, které komunikuje s centrem IoT.
Druhá relace plánuje úlohy pro simulované zařízení s centrem IoT.

Poznámka:

Azure CLI vyžaduje, abyste se přihlásili ke svému účtu Azure. Pokud používáte Cloud Shell, jste automaticky přihlášeni ke svému účtu Azure. Pokud používáte místního klienta rozhraní příkazového řádku, musíte se přihlásit ke každé relaci rozhraní příkazového řádku. Veškerá komunikace mezi relací prostředí Azure CLI a centrem IoT se ověřuje a šifruje. V důsledku toho tento článek nepotřebuje další ověřování, které byste použili se skutečným zařízením, jako je připojovací řetězec. Další informace o přihlášení pomocí Azure CLI najdete v tématu Přihlášení pomocí Azure CLI.

V první relaci rozhraní příkazového řádku spusťte příkaz az extension add . Příkaz přidá do prostředí CLI rozšíření Microsoft Azure IoT pro Azure CLI. Rozšíření přidá příkazy specifické pro IoT Hub, IoT Edge a IoT Device Provisioning Service (DPS) do Azure CLI. Po instalaci rozšíření ho nemusíte znovu instalovat v žádné relaci Cloud Shellu.
```
az extension add --name azure-iot
```
Poznámka:

Tento článek používá nejnovější verzi rozšíření Azure IoT, která se nazývá azure-iot. Starší verze se nazývá azure-cli-iot-ext. Najednou byste měli mít nainstalovanou jenom jednu verzi. Pomocí příkazu az extension list můžete ověřit aktuálně nainstalovaná rozšíření.

Slouží az extension remove --name azure-cli-iot-ext k odebrání starší verze rozšíření.

Slouží az extension add --name azure-iot k přidání nové verze rozšíření.

Pokud chcete zjistit, jaká rozšíření jste nainstalovali, použijte az extension list.
Otevřete druhou relaci rozhraní příkazového řádku. Pokud používáte Cloud Shell v prohlížeči, vyberte na panelu nástrojů první relace rozhraní příkazového řádku ikonu Otevřít novou relaci. Pokud používáte rozhraní příkazového řádku místně, otevřete druhou instanci rozhraní příkazového řádku.

Vytvoření a simulace zařízení

V této části vytvoříte identitu zařízení pro centrum IoT v první relaci rozhraní příkazového řádku a pak simulujete zařízení pomocí této identity zařízení. Simulované zařízení reaguje na úlohy, které plánujete v druhé relaci rozhraní příkazového řádku.

Vytvoření a spuštění simulovaného zařízení:

V první relaci rozhraní příkazového řádku spusťte příkaz az iot hub device-identity create a nahraďte následující zástupné symboly odpovídajícími hodnotami. Tento příkaz vytvoří identitu zařízení pro simulované zařízení.

{DeviceName}. Název simulovaného zařízení.

{HubName}. Název vašeho centra IoT.
```
az iot hub device-identity create --device-id {DeviceName} --hub-name {HubName} 
```
V první relaci rozhraní příkazového řádku spusťte příkaz az iot device simulate a nahraďte následující zástupné symboly odpovídajícími hodnotami. Tento příkaz simuluje zařízení, které jste vytvořili v předchozím kroku. Simulované zařízení je nakonfigurováno tak, aby při vyvolání přímé metody vrátilo stavový kód a datovou část.

{DeviceName}. Název simulovaného zařízení.

{HubName}. Název vašeho centra IoT.
```
az iot device simulate --device-id {DeviceName} --hub-name {HubName} \
                       --method-response-code 201 \
                       --method-response-payload '{"result":"Direct method successful"}'
```
Tip

Ve výchozím nastavení odešle příkaz az iot device simulate 100 zpráv typu zařízení-cloud s intervalem 3 sekund mezi zprávami. Simulace skončí po odeslání všech zpráv. Pokud chcete, aby simulace běžela déle, můžete pomocí --msg-count parametru --msg-interval zadat více zpráv nebo parametr určit delší interval mezi zprávami. Můžete také spustit příkaz znovu a restartovat simulované zařízení.

Naplánování úlohy pro vyvolání přímé metody

V této části naplánujete úlohu ve druhé relaci rozhraní příkazového řádku, která vyvolá přímou metodu na simulovaném zařízení spuštěném v první relaci rozhraní příkazového řádku.

Ověřte, že je simulované zařízení v první relaci rozhraní příkazového řádku spuštěné. Pokud ne, restartujte ho opětovným spuštěním příkazu az iot device simulate z příkazu Vytvořit a simulovat zařízení.
V druhé relaci rozhraní příkazového řádku spusťte příkaz az iot hub job create a nahraďte následující zástupné symboly odpovídajícími hodnotami. V tomto příkladu neexistuje žádná předem existující metoda pro zařízení. Příkaz naplánuje úlohu, která volá ukázkový název metody na simulovaném zařízení a poskytuje hodnotu null pro datovou část metody. Metoda poskytuje stavový kód a datovou část v odpovědi.

{HubName}. Název vašeho centra IoT.

{JobName}. Název naplánované úlohy. Názvy úloh jsou jedinečné, proto při každém spuštění tohoto příkazu zvolte jiný název úlohy.

{MethodName}. Název přímé metody. Simulované zařízení nemá předem existující metodu, takže pro tento příkaz můžete zvolit libovolný název.

{DeviceName}. Název simulovaného zařízení.
```
az iot hub job create --hub-name {HubName} --job-id {JobName} \
                      --job-type scheduleDeviceMethod \
                      --method-name {MethodName} --method-payload 'null' \
                      --query-condition "deviceId = '{DeviceName}'"
```
Tip

Při plánování úlohy az iot hub job create příkaz, který vyvolá přímou metodu, musíte zadat hodnoty pro parametry --method-name i --method-payload volitelné parametry. U přímých metod, které nepřijímají datovou část, zadejte null parametr --method-payload .
V první relaci rozhraní příkazového řádku ověřte, že výstup zobrazuje vyvolání metody. Na následujícím snímku obrazovky jsme použili SampleDevice aSampleMethod {MethodName} pro {DeviceName} zástupné symboly v příkazu ROZHRANÍ příkazového az iot hub job create řádku z předchozího kroku.

Naplánování úlohy pro aktualizaci vlastností dvojčete zařízení

V této části naplánujete úlohu v druhé relaci rozhraní příkazového řádku, která aktualizuje požadovanou vlastnost dvojčete zařízení na simulovaném zařízení spuštěném v první relaci rozhraní příkazového řádku.

Ověřte, že je simulované zařízení v první relaci rozhraní příkazového řádku spuštěné. Pokud ne, restartujte ho opětovným spuštěním příkazu az iot device simulate z příkazu Vytvořit a simulovat zařízení.
V druhé relaci rozhraní příkazového řádku spusťte příkaz az iot hub job create a nahraďte následující zástupné symboly odpovídajícími hodnotami. V tomto příkladu plánujeme úlohu, která nastaví hodnotu požadované vlastnosti BuildingNo dvojčete na 45 pro naše simulované zařízení.

{HubName}. Název vašeho centra IoT.

{JobName}. Název naplánované úlohy. Názvy úloh jsou jedinečné, proto při každém spuštění tohoto příkazu zvolte jiný název úlohy.

{DeviceName}. Název simulovaného zařízení.
```
az iot hub job create --hub-name {HubName} --job-id {JobName} \
                      --job-type scheduleUpdateTwin \
                      --twin-patch '{"properties":{"desired": {"BuildingNo": 45}}}' \
                      --query-condition "deviceId = '{DeviceName}'"
```
V první relaci rozhraní příkazového řádku ověřte, že výstup ukazuje úspěšnou aktualizaci ohlášené vlastnosti dvojčete zařízení, což znamená, že byla také aktualizována požadovaná vlastnost dvojčete zařízení.

Další kroky

V tomto článku jste použili Azure CLI k simulaci zařízení a plánování úloh pro spuštění přímé metody a aktualizaci vlastností dvojčete zařízení pro toto simulované zařízení.

Pokud chcete pokračovat ve zkoumání vzorů správy ioT Hubu a zařízení, aktualizujte image ve službě Device Update pro Azure IoT Hub pomocí referenční image Raspberry Pi 3 B+.

Sdílet prostřednictvím