Nasazení aktualizace pomocí služby Azure Device Update pro IoT Hub

V tomto článku se dozvíte, jak nasadit aktualizaci na zařízení IoT pomocí služby Azure Device Update pro IoT Hub na webu Azure Portal nebo pomocí Azure CLI.

Important

Migrujte na verzi 2026-06-01 API pro Data Plane Device před plánovanými daty vyřazení: 28. února 2027 pro preview verze API a 31. srpna 2029 pro verzi 2022-10-01API. Tato verze přidává zabezpečení stahování, které vám umožňuje pro každé nové nasazení zvolit, zda zařízení stahují aktualizační obsah přes HTTPS (výchozí) nebo přes HTTP. Pro více informací viz Pochopení bezpečnosti stahování (TLS) v Aktualizace zařízení pro IoT Hub.

Požadavky

• Instance Azure IoT Hubu úrovně Standard (S1) nebo vyšší s povolenou aktualizací zařízení pro IoT Hub.
• Zařízení IoT nebo simulátor zřízený pro službu Device Update v centru IoT. Zřízené zařízení může být členem skupiny zařízení vytvořené uživatelem nebo výchozí skupiny.
• Importovaná aktualizace zřízeného zařízení

Nasazení aktualizace

Tato část popisuje, jak nasadit aktualizaci pomocí webu Azure Portal nebo Azure CLI.

Azure Portal

1. Na portálu Azure přejděte do centra IoT.

2. V levém navigačním panelu vyberte Možnosti Aktualizacev části Správa zařízení.

   

3. Na stránce Aktualizace vyberte kartu Skupiny a nasazení a zobrazte graf dodržování předpisů aktualizací a seznam skupin zařízení. Možná budete muset aktualizovat zobrazení, abyste viděli nedávno importované aktualizace dostupné pro vaši skupinu zařízení.

4. V části Stav v seznamu skupin vyberte Nasadit vedle jedné nebo více nových aktualizací, které jsou pro tuto skupinu k dispozici.

   

5. Zobrazte graf dodržování předpisů aktualizací a seznam skupin. Měla by se zobrazit nová aktualizace, která je dostupná pro vaši značku založenou nebo výchozí skupinu. Možná budete muset provést aktualizaci jednou. Další informace najdete v tématu Dodržování předpisů ve službě Device Update.

6. Vedle jednoho nebo více dostupných aktualizací vyberte Nasadit.

7. V seznamu vpravo vyberte požadovanou aktualizaci, která se má nasadit.

   

8. Pro bezpečnost stahování vyberte HTTPS (doporučeno) nebo HTTP. Toto nastavení řídí protokol, který zařízení používají ke stažení obsahu aktualizace. HTTPS je výchozí a šifruje obsah aktualizací během přenosu.

   Pro rady ohledně výběru protokolu a přípravy zařízení viz Pochopení bezpečnosti stahování (TLS) v Aktualizace zařízení pro IoT Hub.

9. Naplánujte nasazení tak, aby se spustilo okamžitě nebo v budoucnu.

   Tip

   Ve výchozím nastavení je počáteční datum a čas od aktuálního času 24 hodin. Pokud chcete, aby nasazení začalo dříve nebo později, nezapomeňte vybrat jiné datum a čas.

   

10. V případě potřeby vytvořte zásadu automatického vrácení zpět. Pak vyberte Vytvořit.

11. Na kartě Aktuální aktualizace můžete zobrazit stav nasazení.

    

12. V zobrazení Základy skupiny graf dodržování předpisů ukazuje, že aktualizace právě probíhá.

    Po úspěšné aktualizaci zařízení se graf dodržování předpisů a podrobnosti nasazení aktualizují tak, aby odrážely tento stav.

Azure CLI

Ke spuštění následujících příkazů můžete použít prostředí Bash v Azure Cloud Shellu . Výběrem možnosti Spustit Cloud Shell otevřete Cloud Shell nebo na horním panelu nástrojů webu Azure Portal vyberte ikonu Cloud Shellu.

Pokud chcete, můžete příkazy Azure CLI spustit místně:

1. Nainstalovat rozhraní příkazového řádku Azure CLI. Spuštěním příkazu az version zobrazte nainstalovanou verzi Azure CLI a závislé knihovny a spuštěním příkazu az upgrade nainstalujte nejnovější verzi.
2. Přihlaste se k Azure spuštěním příkazu az login.
3. Po zobrazení výzvy k prvnímu azure-iot použití nainstalujte rozšíření. Pokud chcete mít jistotu, že používáte nejnovější verzi rozšíření, spusťte az extension update --name azure-iotpříkaz .

Tip

Příkazy Azure CLI v tomto článku používají zpětné lomítko \ znak pro pokračování řádku, aby byly argumenty příkazu snadněji čitelné. Tato syntaxe funguje v prostředích Bash. Pokud tyto příkazy spustíte v PowerShellu, nahraďte každé zpětné lomítko zpětným lomítkem nebo je úplně odeberte.

Ověření dostupnosti aktualizací

1. az iot du device group list Pomocí příkazu identifikujte skupinu zařízení.

   az iot du device group list \
       --account <Device Update account name> \
       --instance <Device Update instance name>\
   

2. Pak použijte az iot du device group show k zobrazení nejlepší dostupné aktualizace pro vaši skupinu. Příkaz přijímá následující argumenty:

   • --account: Název účtu aktualizace zařízení.
   • --instance: Název instance služby Device Update.
   • --group-id: ID skupiny zařízení, na které cílíte s tímto nasazením, což je buď hodnota ADUGroup značky, nebo $default pro zařízení bez značky.
   • --resource-group: Název skupiny prostředků účtu služby Device Update.
   • --best-updates: Vrátí nejlepší dostupné aktualizace pro skupinu zařízení, včetně počtu zařízení, které potřebují každou aktualizaci.
   • --update-compliance: Vrátí informace o kompatibilitě aktualizací skupiny zařízení, například kolik zařízení je na nejnovější aktualizaci, kolik potřebuje nové aktualizace a kolik aktuálně dostává novou aktualizaci.

   Pokud chcete ověřit nejlepší dostupnou aktualizaci pro vaši skupinu, spusťte následující příkaz:

   az iot du device group show \
       --account <Device Update account name> \
       --instance <Device Update instance name>\
       --group-id <device group ID>\
       --best-updates
   

Vytvoření nasazení

Slouží az iot du device deployment create k vytvoření nasazení pro skupinu zařízení. Příkaz přijímá následující argumenty:

• --account: Název účtu aktualizace zařízení.
• --instance: Název instance služby Device Update.
• --group-id: ID skupiny zařízení, na které cílíte s tímto nasazením, což je buď hodnota ADUGroup značky, nebo $default pro zařízení bez značky.
• --deployment-id: ID pro identifikaci tohoto nasazení.
• --update-name, --update-providera --update-version: Parametry, které definují updateId objekt, jedinečný identifikátor aktualizace v tomto nasazení.

Spusťte příkaz následujícím způsobem:

az iot du device deployment create \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group ID> \
    --deployment-id <deployment ID> \
    --update-name <update name> \
    --update-provider <update provider> \
    --update-version <update version>

Zařízení stahují aktualizační obsah přes HTTPS ve výchozím nastavení. Pro použití HTTP přidejte volitelný --download-security parametr popsaný v Použít volitelné argumenty.

Použití volitelných argumentů

Volitelné argumenty umožňují další konfiguraci nasazení. Úplný seznam volitelných argumentů najdete v tématu Volitelné parametry.

Pokud chcete vytvořit zásadu automatického vrácení zpět, přidejte následující parametry:

• --failed-count: Počet neúspěšných zařízení v nasazení, které aktivuje vrácení zpět.
• --failed-percentage: Procento neúspěšných zařízení v nasazení, které aktivuje vrácení zpět.
• --rollback-update-name, , --rollback-update-provider--rollback-update-version: Parametry pro aktualizaci, které se mají použít, pokud je zahájeno vrácení zpět.

Spusťte příkaz následujícím způsobem:

az iot du device deployment create \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group ID> \
    --deployment-id <deployment ID> \
    --update-name <update name> \
    --update-provider <update provider> \
    --update-version <update version> \
    --failed-count 10 \
    --failed-percentage 5 \
    --rollback-update-name <rollback update name> \
    --rollback-update-provider <rollback update provider> \
    --rollback-update-version <rollback update version>

Pokud chcete nastavit čas spuštění nasazení, pomocí parametru --start-time zadejte cílové datum a čas nasazení následujícím způsobem:

az iot du device deployment create \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group id> \
    --deployment-id <deployment id> \
    --update-name <update name> \
    --update-provider <update provider> \
    --update-version <update version> \
    --start-time "2022-12-20T01:00:00"

Pro výběr protokolu, který zařízení používají ke stažení obsahu aktualizace, přidejte volitelný --download-security parametr. Přijímané hodnoty jsou HTTPS (doporučené) a HTTP. Pokud parametr vynecháte, nasazení použije výchozí HTTPS. Pro rady ohledně výběru protokolu a přípravy zařízení viz Pochopení bezpečnosti stahování (TLS) v Aktualizace zařízení pro IoT Hub.

az iot du device deployment create \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group ID> \
    --deployment-id <deployment ID> \
    --update-name <update name> \
    --update-provider <update provider> \
    --update-version <update version> \
    --download-security <HTTPS or HTTP>

Monitorování stavu nasazení

Azure Portal

1. Na kartě Skupiny a nasazení na stránce Aktualizace vyberte skupinu, do které jste nasadili.

2. Na stránce Podrobnosti skupiny přejděte na kartu Aktuální nasazení nebo Historie nasazení a ověřte, že probíhá nasazení.

   

3. Výběrem možnosti Podrobnosti vedle nasazení zobrazíte podrobnosti o nasazení, podrobnosti o aktualizaci a podrobnosti cílové třídy zařízení. Volitelně můžete přidat popisný název třídy zařízení.

4. Výběrem možnosti Aktualizovat zobrazíte nejnovější podrobnosti o stavu.

   

Note

Detaily nasazení ukazují nastavení bezpečnosti stahování. Podrobnosti o nasazení můžete otevřít v záložkách Aktuální nasazení a Historie nasazení . Toto nastavení po vytvoření nasazení změnit nemůžeš. Pro použití jiného protokolu vytvořte nové nasazení.

Přejděte na kartu Základy skupiny na stránce Podrobnosti skupiny a vyhledejte stav konkrétního zařízení nebo vyfiltrujte zobrazení zařízení, která nasazení selhala.

Azure CLI

Pomocí příkazu az iot du device deployment list zobrazte všechna nasazení pro skupinu zařízení.

az iot du device deployment list \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group id>

Pomocí příkazu az iot du device deployment show zobrazte podrobnosti o konkrétním nasazení.

az iot du device deployment show \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group ID> \
    --deployment-id <deployment ID>

Note

Výstup příkazu az iot du device deployment show obsahuje vlastnost downloadSecurity , která ukazuje protokol, který jste pro nasazení zvolil. Toto nastavení po vytvoření nasazení změnit nemůžeš. Pro použití jiného protokolu vytvořte nové nasazení.

--status Přidejte příznak pro vrácení informací o tom, kolik zařízení v nasazení probíhá, dokončeno nebo selhalo.

az iot du device deployment show \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group ID> \
    --deployment-id <deployment ID> \
    --status

Opakování nasazení aktualizace

Pokud se nasazení nezdaří, můžete zkusit nasazení neúspěšných zařízení zopakovat.

Azure Portal

1. Na obrazovce Podrobnosti skupiny přejděte na kartu Aktuální nasazení.

2. Vyberte Opakovat neúspěšná zařízení a potvrďte potvrzovací oznámení.

Azure CLI

Pomocí příkazu az iot du device deployment retry to retry a retry a deployment for a target subgroup of devices.

Tento příkaz přebírá --class-id argument, který je generován z ID modelu a vlastností kompatibility hlášených agentem aktualizace zařízení:

az iot du device deployment retry \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --deployment-id <deployment ID> \
    --group-id <device group ID> \
    --class-id <device class ID>

Související obsah

• Nasazení služby Device Update
• Průvodce odstraňováním potíží s aktualizací zařízení