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

Zjistěte, jak nasadit aktualizaci do zařízení IoT pomocí služby Device Update pro Azure IoT Hub.

Požadavky

• Přístup ke službě IoT Hub s povolenou službou Device Update pro IoT Hub Pro službu IoT Hub doporučujeme použít úroveň S1 (Standard) nebo vyšší.
• Importovaná aktualizace zřízeného zařízení
• Zařízení IoT (nebo simulátor) zřízené pro službu Device Update ve službě IoT Hub.
• Zařízení je součástí alespoň jedné výchozí skupiny nebo skupiny aktualizací vytvořené uživatelem.

Azure Portal

Podporované prohlížeče:

• Microsoft Edge
• Google Chrome

Azure CLI

Prostředí Azure CLI:

• Použijte prostředí Bash v Azure Cloud Shellu.

  

• Nebo pokud dáváte přednost místnímu spouštění referenčních příkazů rozhraní příkazového řádku, nainstalujte Azure CLI.

  1. Přihlaste se k Azure CLI pomocí příkazu az login .
  2. Spuštěním příkazu az version zjistěte verzi a závislé knihovny, které jsou nainstalované. Pokud chcete upgradovat na nejnovější verzi, spusťte az upgrade.
  3. Po zobrazení výzvy nainstalujte rozšíření Azure CLI při prvním použití. Příkazy v tomto článku používají rozšíření azure-iot . Spusťte, az extension update --name azure-iot abyste měli jistotu, že používáte nejnovější verzi rozšíření.

Tip

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

Nasazení aktualizace

Azure Portal

1. Na webu Azure Portal přejděte do svého centra IoT.

2. V navigační nabídce vyberte Aktualizace a otevřete stránku Aktualizace zařízení vaší instance IoT Hubu.

   

3. V horní části stránky vyberte kartu Skupiny a nasazení. Další informace naleznete v tématu Skupiny zařízení.

   

4. 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.

5. Vyberte Nasadit vedle jedné nebo více dostupných aktualizací a ověřte, že popisný popisek, který jste přidali při importu, a vypadá správně.

6. Potvrďte, že je vybraná správná skupina jako cílová skupina, a vyberte Nasadit.

7. Pokud chcete spustit nasazení, přejděte na kartu Aktuální nasazení. V části Dostupné aktualizace vyberte odkaz Nasadit vedle požadované aktualizace. Nejlepší dostupná aktualizace pro danou skupinu je označena nejlepším zvýrazněním.

   

8. 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 nastavené na Hodnotu Okamžitě. Pokud chcete, aby nasazení začalo později, nezapomeňte vybrat jiné datum a čas.

   

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

10. V podrobnostech o nasazení se stav změní na Aktivní. Nasazená aktualizace se označí (nasazuje).

    

11. Prohlédněte si graf dodržování předpisů a podívejte se, že aktualizace právě probíhá.

    

12. Po úspěšné aktualizaci zařízení uvidíte, že se graf dodržování předpisů a podrobnosti nasazení aktualizovaly tak, aby odrážely stejné.

    

Azure CLI

Ověření az iot du device group list 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 při tomto nasazení. Toto ID je hodnota značky ADUGroup nebo $default pro zařízení bez značky.
• --best-updates: Tento příznak označuje, že příkaz by měl načíst nejlepší dostupné aktualizace pro skupinu zařízení, včetně počtu zařízení, které potřebují každou aktualizaci.
• --resource-group -g: Název skupiny prostředků účtu aktualizace zařízení
• --update-compliance: Tento příznak označuje, že příkaz by měl načíst informace o kompatibilitě aktualizací skupiny zařízení, například kolik zařízení je na nejnovější aktualizaci, kolik je potřeba nových aktualizací a kolik probíhá při přijetí nové aktualizace.

az iot du device group list \
    --account <Device Update account name> \
    --instance <Device Update instance name>\
    --gid <device group id>\
    --best-updates {false, true}

Pomocí příkazu az iot du device deployment create vytvořte nasazení pro skupinu zařízení.

Příkaz device deployment create 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 při tomto nasazení. Toto ID je hodnota značky ADUGroup nebo $default pro zařízení bez značky.
• --deployment-id: ID pro identifikaci tohoto nasazení.
• --update-name, --update-providera --update-version: Tyto tři parametry definují objekt updateId , který je jedinečný identifikátor aktualizace, kterou používáte v tomto nasazení.

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>

Volitelné argumenty umožňují nakonfigurovat nasazení. Úplný seznam najdete v části 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á aktivují 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: UpdateID pro aktualizaci, kterou skupina zařízení použije, pokud se zahájí vrácení zpět.

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, aby se nasazení spustilo v budoucnu, použijte --start-time parametr k zadání cílového data a času nasazení.

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"

Monitorování nasazení aktualizací

Azure Portal

1. Vyberte skupinu, do které jste nasadili, a přejděte na kartu Aktuální aktualizace nebo Historie nasazení a ověřte, že nasazení probíhá.

   

2. Vyberte Podrobnosti vedle vytvořeného nasazení. Tady můžete zobrazit podrobnosti o nasazení, aktualizovat podrobnosti a podrobnosti o cílové třídě zařízení. Volitelně můžete přidat popisný název třídy zařízení.

   

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

4. Pokud chcete vyhledat stav konkrétního zařízení, můžete přejít do základního zobrazení skupiny nebo můžete filtrovat zobrazení zařízení, u kterých nasazení selhalo.

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>

--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 vaše nasazení z nějakého důvodu selže, můžete zkusit nasazení zopakovat pro neúspěšná zařízení.

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ý se generuje 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>

Další kroky

Řešení běžných potíží