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

Článek
06/24/2023

Pomocí Azure IoT Hub můžete plánovat a sledovat úlohy, které aktualizují miliony zařízení. Úlohy můžete použít k:

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

Koncepčně úloha zabalí jednu z těchto akcí a sleduje průběh provádění na 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 použít úlohu k vyvolání metody restartování na 10 000 zařízeních určených dotazem dvojčete zařízení a naplánovaných na budoucí dobu. Tato aplikace pak může sledovat průběh, jak každé z těchto zařízení přijme a spustí metodu restartování.

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

Vlastnosti a dvojče zařízení: Začínáme s dvojčaty zařízení a Principy a používání dvojčat zařízení v IoT Hub
Přímé metody: IoT Hub příručka pro vývojáře – přímé metody

Poznámka

Funkce popsané v tomto článku jsou k dispozici pouze na úrovni Standard IoT Hub. Další informace o úrovních IoT Hub Basic a Standard/Free najdete v tématu Volba správné IoT Hub úrovně 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 vracelo stavový kód a datovou část JSON při vyvolání jakékoli přímé metody.
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

Azure CLI Příkazy v tomto článku můžete také spustit pomocí prostředí Azure Cloud Shell, interaktivního prostředí rozhraní příkazového řádku, které běží ve vašem prohlížeči nebo v aplikaci, jako je Terminál Windows. Pokud používáte Cloud Shell, nemusíte nic instalovat. Pokud dáváte přednost místnímu používání rozhraní příkazového řádku, 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.
IoT Hub ve vašem předplatném Azure. Vytvořte ho pomocí rozhraní příkazového řádku nebo Azure Portal.
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 v některých podnikových a vzdělávacích síťových prostředích blokovaný. Další informace a způsoby, jak tento problém obejít, najdete v tématu Připojení k IoT Hub (MQTT).

Příprava Cloud Shell

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

V záhlaví stránky v Azure Portal vyberte ikonu Cloud Shell.

Poznámka

Pokud Cloud Shell používáte poprvé, zobrazí se výzva k vytvoření úložiště, které je potřeba k použití Cloud Shell. 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í PowerShell .

Poznámka

Některé příkazy vyžadují v prostředích Bash a PowerShell jinou syntaxi nebo formátování. Další informace najdete v tématu Tipy pro úspěšné používání 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, spouštíte tyto relace na samostatných Cloud Shell kartách. Pokud používáte místního klienta rozhraní příkazového řádku, spustíte samostatné instance rozhraní příkazového řádku. Samostatné relace rozhraní příkazového řádku použijte pro následující úlohy:

První relace simuluje zařízení IoT, které komunikuje s vaším centrem IoT.
Druhá relace naplá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, budete 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 například připojovací řetězec. Další informace o přihlašování 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á rozšíření Microsoft Azure IoT pro Azure CLI do prostředí rozhraní příkazového řádku. Rozšíření přidává do Azure CLI příkazy specifické pro IoT Hub, IoT Edge a IoT Device Provisioning Service (DPS). Po instalaci rozšíření ho nemusíte instalovat znovu v žádné Cloud Shell relaci.
```
az extension add --name azure-iot
```
Poznámka

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

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

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

Pokud chcete zjistit, jaká rozšíření máte nainstalovaná, 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 ikonu Otevřít novou relaci na panelu nástrojů první relace rozhraní příkazového řádku. 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 pomocí této identity zařízení simulujete zařízení. Simulované zařízení reaguje na úlohy, které naplá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 nakonfigurované tak, aby při vyvolání přímé metody vracelo 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

Příkaz az iot device simulate ve výchozím nastavení odesílá 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í parametru --msg-count zadat více zpráv nebo pomocí parametru --msg-interval 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 v 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 části Vytvořit a simulovat zařízení.
Ve 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ředchozí metoda pro zařízení. Příkaz naplánuje úlohu, která volá ukázkový název metody na simulovaném zařízení a poskytne 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é, takže 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í příkazu úlohy az iot hub job create , který vyvolá přímou metodu, musíte zadat hodnoty pro parametry i --method-name--method-payload volitelné parametry. Pro přímé metody, 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 v az iot hub job create příkazu rozhraní příkazového řádku z předchozího kroku použili SampleDevice pro {DeviceName} zástupné symboly aSampleMethod{MethodName} a .

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 části Vytvořit a simulovat zařízení.
Ve 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é, takže 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 zobrazuje úspěšnou aktualizaci vlastnosti hlášeného dvojčete zařízení, což znamená, že se aktualizovala také požadovaná vlastnost dvojčete zařízení.

Další kroky

V tomto článku jste použili Azure CLI k simulaci zařízení a naplánování úloh ke 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 služby IoT Hub a zařízení, aktualizujte image ve službě Device Update pro Azure IoT Hub pomocí referenční image Raspberry Pi 3 B+.