Sdílet prostřednictvím

Zřizování agenta aktualizace zařízení

Agent modulu Device Update může běžet společně s dalšími systémovými procesy a moduly IoT Edge , které se připojují ke službě IoT Hub jako součást stejného logického zařízení. Tato část popisuje, jak zřídit agenta Device Update jako identitu modulu.

Změny agenta Device Update při obnově Public Preview

Do agenta služby Device Update jsme přidali mnoho nových funkcí v nejnovějším agentu aktualizace Public Preview (verze 0.8.0). Podrobnosti najdete v seznamu nových funkcí .

Pokud používáte agenta Device Update verze 0.6.0 nebo 0.7.0, migrujte na nejnovější verzi agenta 0.8.0. Informace o změnách a postupu upgradu najdete v agentu aktualizace Public Preview.

Verzi nainstalovaného agenta Device Update a agenta Optimalizace doručení můžete zkontrolovat v části Vlastnosti dvojče zařízení IoT. Další informace o vlastnostech zařízení pod rozhraním ADU Core.

Identita modulu vs. identita zařízení

V IoT Hubu můžete v rámci každé identity zařízení vytvořit až 50 identit modulů. Každá identita modulu implicitně generuje dvojče modulu. Na straně zařízení umožňují sady SDK pro zařízení ioT Hub vytvářet moduly, ve kterých každý otevře nezávislé připojení ke službě IoT Hub. Identita modulu a dvojče modulu poskytují podobné funkce jako identita zařízení a dvojče zařízení, ale s jemnější úrovní detailů. Další informace o identitách modulů ve službě IoT Hub

Pokud přecházíte z agenta na úrovni zařízení na to, aby agent fungoval jako identita modulu na zařízení, odstraňte staršího agenta, který komunikoval prostřednictvím dvojčete zařízení. Když zřídíte agenta Device Update jako identitu modulu, veškerá komunikace mezi zařízením a službou Device Update probíhá prostřednictvím dvojčete modulu, takže nezapomeňte při vytváření skupin označit dvojče modulu zařízení a veškerá komunikace musí probíhat přes dvojče modulu.

Podpora pro službu Device Update

V současné době jsou v rámci služby Device Update podporovány následující typy bezdrátových aktualizací pro zařízení IoT:

Požadavky

Pokud nastavujete zařízení IoT nebo zařízení IoT Edge pro aktualizace založené na balíčcích, přidejte do úložišť vašeho počítače packages.microsoft.com pomocí následujícího postupu:

  1. Přihlaste se k počítači nebo zařízení IoT, na kterém chcete nainstalovat agenta Device Update.

  2. Otevřete okno terminálu.

  3. Nainstalujte konfiguraci úložiště, která odpovídá operačnímu systému vašeho zařízení.

    curl https://packages.microsoft.com/config/ubuntu/18.04/multiarch/prod.list > ./microsoft-prod.list

  4. Zkopírujte vygenerovaný seznam do adresáře sources.list.d.

    sudo cp ./microsoft-prod.list /etc/apt/sources.list.d/

  5. Nainstalujte veřejný klíč Microsoft GPG.

    curl https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.gpg

    sudo cp ./microsoft.gpg /etc/apt/trusted.gpg.d/

Jak zřídit agenta Device Update jako identitu modulu

Tato část popisuje, jak nastavit agenta Device Update jako identitu modulu pro zařízení.

  • Zařízení s podporou IoT Edge nebo
  • Zařízení IoT mimo Edge nebo
  • Další zařízení IoT

Pokud chcete zkontrolovat, jestli máte na zařízení povolený IoT Edge, přečtěte si pokyny k instalaci IoT Edge.

Postupujte podle všech nebo kterékoli z následujících částí a přidejte agenta aktualizace zařízení podle typu zařízení, které spravujete.

Na zařízeních s povolenou službou IoT Edge

Podle těchto pokynů zřiďte agenta Device Update na zařízeních s podporou IoT Edge.

  1. Postupujte podle pokynů k ručnímu zřízení jednoho zařízení IoT Edge s Linuxem.

  2. Nainstalujte agenta aktualizace obrazu zařízení.

    V úložišti Assets tady poskytujeme ukázkové obrázky. Soubor swUpdate je základní obraz, který můžete nahrát do desky Raspberry Pi B3+. Soubor .gz je aktualizace, kterou byste naimportovala prostřednictvím služby Device Update pro IoT Hub. Příklad naleznete v tématu Jak nahrát obraz do zařízení IoT Hubu.

  3. Nainstalujte agenta aktualizace balíčku Device Update.

    • Nejnovější verze agentů z packages.miscrosoft.com: Aktualizujte seznamy balíčků na vašem zařízení a nainstalujte balíček agenta Device Update a jeho závislosti pomocí:

      sudo apt-get update

      sudo apt-get install deviceupdate-agent deliveryoptimization-plugin-apt

    • Pro libovolnou verzi rc, tj. verze agenta release candidate z Artifacts : Stáhněte soubor .deb do počítače, na který chcete nainstalovat agenta Device Update, a pak:

      sudo apt-get install -y ./"<PATH TO FILE>"/"<.DEB FILE NAME>"

  4. Teď jste připraveni spustit agenta Device Update na zařízení IoT Edge.

Na zařízeních IoT s Linuxem bez nainstalovaného IoT Edge

Podle těchto pokynů zřiďte agenta Device Update na zařízeních IoT s Linuxem.

  1. Nainstalujte službu Azure IoT Identity a přidejte do svého zařízení IoT nejnovější verzi podle pokynů v instalaci služby Azure IoT Identity.

  2. Nakonfigurujte službu IoT Identity Service podle pokynů v Configuring the Azure IoT Identity Service.

  3. Nakonec nainstalujte agenta Device Update. Poskytujeme vzorové snímky v Assets, soubor swUpdate je základní obraz, který můžete nahrát na desku Raspberry Pi B3+ a soubor .gz je aktualizace, kterou byste importovali prostřednictvím služby Device Update pro IoT Hub. Podívejte se na příklad jak nahrát obraz na zařízení IoT Hub.

  4. Po instalaci agenta aktualizace zařízení budete muset upravit konfigurační soubor pro službu Device Update spuštěním následujícího příkazu.

     sudo nano /etc/adu/du-config.json

    Změňte typ připojení na "AIS" pro agenty, kteří budou ke zařízení používat službu Identita IoT. Pole ConnectionData musí být prázdný řetězec.

  5. Teď jste připraveni spustit agenta Device Update na zařízení IoT.

Další zařízení IoT

Agenta Device Update je možné nakonfigurovat také bez služby IoT Identity pro účely testování nebo na omezených zařízeních. Pomocí následujících kroků zřiďte agenta Device Update pomocí připojovacího řetězce (z modulu nebo zařízení).

  1. V úložišti Assets tady poskytujeme ukázkové obrázky. Soubor swUpdate je základní obraz, který můžete nahrát do desky Raspberry Pi B3+. Soubor .gz je aktualizace, kterou byste naimportovala prostřednictvím služby Device Update pro IoT Hub. Příklad naleznete v tématu Jak nahrát obraz do zařízení IoT Hubu.

  2. Přihlaste se k počítači nebo zařízení IoT Edge nebo zařízení IoT.

  3. Otevřete okno terminálu.

  4. Přidejte připojovací řetězec do konfiguračního souboru služby Device Update:

    1. V okně terminálu zadejte následující:

    2. Zkopírování primárního připojovacího řetězce

      • Pokud je agent Device Update nakonfigurovaný jako modul, zkopírujte primární připojovací řetězec modulu.
      • Jinak zkopírujte primární připojovací řetězec zařízení.

    3. Do souboru du-config.json zadejte zkopírovaný primární připojovací řetězec do hodnoty pole connectionData. Pak soubor uložte a zavřete ho.

  5. Teď jste připraveni spustit agenta Device Update na zařízení IoT.

Jak spustit agenta aktualizace zařízení

Tato část popisuje, jak spustit a ověřit agenta aktualizace zařízení jako identitu modulu, která se úspěšně spouští na vašem zařízení IoT.

  1. Přihlaste se k počítači nebo zařízení s nainstalovaným agentem Device Update.

  2. Otevřete okno terminálu a zadejte následující příkaz.

    sudo systemctl restart adu-agent

  3. Stav agenta můžete zkontrolovat pomocí následujícího příkazu. Pokud se zobrazí nějaké problémy, projděte si tohoto průvodce odstraňováním potíží.

    sudo systemctl status adu-agent

    Měl by se zobrazit stav OK.

  4. Na portálu IoT Hub přejděte na zařízení IoT nebo zařízení IoT Edge a vyhledejte zařízení, které jste nakonfigurovali pomocí agenta Device Update. Zobrazí se agent Device Update spuštěný jako modul. Například:

    Diagram názvu modulu aktualizace zařízení

Postup sestavení a spuštění agenta aktualizace zařízení

Můžete také vytvořit a upravit vlastního agenta Device Update pro zákazníka.

Podle pokynů sestavte agenta Aktualizace zařízení ze zdroje.

Jakmile se agent úspěšně sestaví, je čas spustit agenta.

Teď proveďte změny potřebné k začlenění agenta do image. Pokyny najdete v tom, jak upravit agenta aktualizace zařízení.

Příručka pro řešení problémů

Pokud narazíte na problémy, projděte si průvodce odstraňováním potíží se službou Device Update for IoT Hub a odblokujte případné problémy a shromážděte potřebné informace, které microsoftu poskytne.

Další kroky

Následující kurzy můžete použít k jednoduché ukázce služby Device Update pro IoT Hub:

  • Last updated on