Sdílet prostřednictvím

Kurz: Aktualizace zařízení pro Azure IoT Hub pomocí referenčního agenta simulátoru Ubuntu (18.04 x64)

Aktualizace zařízení pro Azure IoT Hub podporuje aktualizace založené na imagích, na balíčcích a skriptech.

Aktualizace obrázků poskytují vyšší úroveň spolehlivosti v koncovém stavu zařízení. Obvykle je jednodušší replikovat výsledky aktualizace image mezi předprodukčním prostředím a produkčním prostředím, protože nepředstavuje stejné výzvy jako balíčky a jejich závislosti. Z důvodu jejich atomické povahy můžete také snadno přijmout model převzetí služeb při selhání A/B.

Tento kurz vás provede jednotlivými kroky k dokončení kompletní aktualizace založené na imagích pomocí služby Device Update pro IoT Hub.

V tomto kurzu se naučíte:

  • Stáhněte a nainstalujte image.
  • Přidejte štítek k vašemu zařízení IoT.
  • Naimportujte aktualizaci.
  • Vytvořte skupinu zařízení.
  • Nasazení aktualizace obrazu.
  • Monitorujte nasazení aktualizací.

Požadavky

Pokud jste to ještě neudělali, vytvořte účet a instanci služby Device Update a nakonfigurujte centrum IoT.

Stáhněte si soubor ZIP s názvem Tutorial_Simulator.zip ze složek vydání v nejnovějším vydání a rozbalte ho.

Přidání zařízení do Azure IoT Hubu

Po spuštění agenta Device Update na zařízení IoT musíte zařízení přidat do IoT Hubu. Ze služby IoT Hub se pro konkrétní zařízení vygeneruje připojovací řetězec.

  1. Na webu Azure Portal spusťte aktualizaci zařízení pro IoT Hub.

  2. Vytvořte nové zařízení.

  3. V levém podokně přejděte na Zařízení. Pak vyberte Nová.

  4. V části ID zařízení zadejte název zařízení. Ujistěte se, že je zaškrtnuté políčko Automaticky vygenerovat klíče .

  5. Zvolte Uložit.

  6. Teď se vrátíte na stránku Zařízení a zařízení, které jste vytvořili, by mělo být v seznamu. Vyberte toto zařízení.

  7. V zobrazení zařízení vyberte ikonu Kopírovat vedle primárního připojovacího řetězce.

  8. Zkopírujte zkopírované znaky někam pro pozdější použití v následujících krocích:

    Tento zkopírovaný řetězec je připojovací řetězec vašeho zařízení.

Instalace agenta služby Device Update, který ho otestuje jako simulátor

  1. Postupujte podle pokynů k instalaci prostředí Azure IoT Edge runtime.

    Poznámka:

    Agent aktualizace zařízení nezávisí na IoT Edge. Spoléhá ale na démona služby IoT Identity Service, který je nainstalovaný se službou IoT Edge (1.2.0 a vyšší), aby získal identitu a připojil se ke službě IoT Hub.

    I když to tento kurz nepokrývá, démon IoT Identity Service lze nainstalovat samostatně na Linuxových zařízeních IoT. Na sekvenci instalace záleží. Agent balíčku Device Update musí být nainstalován po instalaci služby IoT Identity Service. Jinak se agent balíčku nezaregistruje jako autorizovaná komponenta pro navázání připojení ke službě IoT Hub.

  2. Poté nainstalujte balíčky agentů aktualizací zařízení ve formátu ".deb".

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

  3. Zadejte do konfiguračního souboru primární připojovací řetězec modulu zařízení IoT (nebo zařízení, v závislosti na tom, jak jste zařízení zřídili pomocí Device Update) spuštěním následujícího příkazu:

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

  4. Nastavte agenta tak, aby běžel jako simulátor. Spusťte na zařízení IoT následující příkaz, aby agent aktualizace zařízení vyvolal obslužnou rutinu simulátoru pro zpracování aktualizace balíčku pomocí APT ('microsoft/apt:1'):

    sudo /usr/bin/AducIotAgent --register-content-handler /var/lib/adu/extensions/sources/libmicrosoft_simulator_1.so --update-type 'microsoft/apt:1'

    Pokud chcete zaregistrovat a vyvolat obslužnou rutinu simulátoru, použijte následující formát a vyplňte zástupné symboly:

    sudo /usr/bin/AducIotAgent --register--content-handler <full path to the handler file> --update-type <update type name>

  5. Budete potřebovat soubor sample-du-simulator-data.json z adresáře Tutorial_Simulator.zip se staženými předpoklady.

    Otevřete soubor sample-du-simulator-data.json a zkopírujte obsah do schránky:

    nano sample-du-simulator-data.json

    Vyberte obsah souboru a stiskněte Ctrl+C. Stisknutím kombinace kláves Ctrl+X soubor zavřete a neuložíte změny.

    Spuštěním následujícího příkazu vytvořte a upravte du-simulator-data.json soubor ve složce tmp:

    sudo nano /tmp/du-simulator-data.json

    Stisknutím kombinace kláves Ctrl+V vložte obsah do editoru. Stisknutím kombinace kláves Ctrl+X uložte změny a pak Y.

    Změnit oprávnění:

    sudo chown adu:adu /tmp/du-simulator-data.json
sudo chmod 664 /tmp/du-simulator-data.json

    Pokud /tmp neexistuje, pak:

     sudo mkdir/tmp
 sudo chown root:root/tmp
 sudo chmod 1777/tmp

  6. Restartujte agenta Device Update spuštěním následujícího příkazu:

     sudo systemctl restart adu-agent

Aktualizace zařízení pro software Azure IoT Hub podléhá následujícím licenčním podmínkám:

Přečtěte si licenční podmínky před použitím agenta. Vaše instalace a použití tvoří vaše přijetí těchto podmínek. Pokud s licenčními podmínkami nesouhlasíte, nepoužívejte agenta Služby Device Update pro IoT Hub.

Poznámka:

Po testování pomocí simulátoru spusťte následující příkaz, který vyvolá obslužnou rutinu APT a nasadí aktualizace balíčků přes bezdrátové připojení:

# sudo /usr/bin/AducIotAgent --register-content-handler /var/lib/adu/extensions/sources/libmicrosoft_apt_1.so --update-type 'microsoft/a pt:1'

Přidejte značku ke svému zařízení

  1. Přihlaste se k webu Azure Portal a přejděte do centra IoT.

  2. Na levém panelu v části Zařízení najděte své zařízení IoT a přejděte na dvojče zařízení nebo dvojče modulu.

  3. Ve dvojčeti modulu agenta Device Update odstraňte všechny existující hodnoty značek Device Update tak, že je nastavíte na hodnotu null. Pokud používáte identitu zařízení s agentem Device Update, proveďte tyto změny ve dvojčeti zařízení.

  4. Přidejte novou hodnotu značky Device Update, jak je znázorněno na obrázku:

        "tags": {
            "ADUGroup": "<CustomTagValue>"
            }

Import aktualizace

  1. Budete potřebovat soubory TutorialImportManifest_Sim.importmanifest.json a adu-update-image-raspberrypi3.swu ze staženého Tutorial_Simulator.zip v požadavcích. Soubor s aktualizací je znovu použit z návodu pro Raspberry Pi. Vzhledem k tomu, že aktualizace v tomto kurzu je simulovaná, na konkrétním obsahu souboru nezáleží.

  2. Přihlaste se k webu Azure Portal a přejděte do centra IoT pomocí služby Device Update. V levém podokně v části Automatické Správa zařízení vyberte Aktualizace.

  3. Vyberte kartu Aktualizace.

  4. Vyberte + Importovat novou aktualizaci.

  5. Vyberte + Vyberte z úložného kontejneru. Vyberte existující účet nebo vytvořte nový účet pomocí + Úložiště účet. Pak vyberte existující kontejner nebo vytvořte nový kontejner pomocí + Kontejner. Tento kontejner se použije k vytvoření aktualizačních souborů pro import.

    Poznámka:

    Doporučujeme, abyste při každém importu aktualizace použili nový kontejner, abyste se vyhnuli náhodnému importu souborů z předchozích aktualizací. Pokud nepoužíváte nový kontejner, nezapomeňte před dokončením tohoto kroku odstranit všechny soubory z existujícího kontejneru.

    Snímek obrazovky znázorňující účty úložiště a kontejnery

  6. V kontejneru vyberte Nahrát a přejděte na soubory, které jste stáhli v kroku 1. Po výběru všech souborů aktualizací vyberte Nahrát. Pak se výběrem tlačítka Vybrat vrátíte na stránku Import update .

    Snímek obrazovky znázorňující výběr nahraných souborů

    Tento snímek obrazovky ukazuje krok importu. Názvy souborů nemusí odpovídat názvům souborů použitým v příkladu.

  7. Na stránce Importovat aktualizaci zkontrolujte soubory, které se mají importovat. Potom výběrem možnosti Importovat aktualizaci spusťte proces importu.

    Snímek obrazovky znázorňující aktualizaci importu

  8. Proces importu začíná a obrazovka se přepne do oddílu Historie importu. Když sloupec Stav indikuje, že import proběhl úspěšně, vyberte záhlaví Dostupné aktualizace. V seznamu by se teď měla zobrazit importovaná aktualizace.

    Snímek obrazovky znázorňující stav úlohy

Další informace o importu aktualizací.

Vytvoření skupiny aktualizací

  1. V horní části stránky přejděte na kartu Skupiny a nasazení .

    Snímek obrazovky znázorňující neseskupené zařízení

  2. Vyberte Přidat skupinu a vytvořte novou skupinu.

    snímek obrazovky znázorňující přidání skupiny zařízení

  3. Ze seznamu vyberte značku IoT Hubu a třídy zařízení. Pak vyberte Vytvořit skupinu.

    Snímek obrazovky znázorňující výběr značek

  4. Po vytvoření skupiny se aktualizuje graf dodržování aktualizací a seznam skupin. Graf souladu s aktualizacemi zobrazuje počet zařízení v různých stavech souladu: Na nejnovější aktualizaci, Nové aktualizace jsou k dispozici a Probíhající aktualizace. Zjistěte více o dodržování aktualizací.

    Snímek obrazovky, který zobrazuje zobrazení souladu s aktualizacemi.

  5. Měli byste vidět nově vytvořenou skupinu a všechny dostupné aktualizace pro zařízení v nové skupině. Pokud existují zařízení, která nesplňují požadavky na třídu zařízení skupiny, zobrazí se v odpovídající neplatné skupině. Pokud chcete nasadit nejlepší dostupnou aktualizaci do nové uživatelem definované skupiny z tohoto zobrazení, vyberte Nasadit vedle skupiny.

Další informace o tom, jak přidat značky a vytvářet skupiny aktualizací.

Nasazení aktualizace

  1. Po vytvoření skupiny by se měla zobrazit nová aktualizace, která je dostupná pro vaši skupinu zařízení. Odkaz na aktualizaci by měl být v části Nejlepší aktualizace. Možná budete muset provést aktualizaci jednou. Přečtěte si další informace o shodě aktualizací.

  2. Vyberte cílovou skupinu tak, že vyberete název skupiny. Budete přesměrováni na podrobnosti skupiny v části Základy skupiny.

    Snímek obrazovky s podrobnostmi o skupině

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

    Snímek obrazovky znázorňující výběr aktualizace

  4. Naplánujte nasazení tak, aby se spustilo okamžitě nebo v budoucnu. Pak vyberte Vytvořit.

    Snímek obrazovky, který ukazuje Vytvořit nasazení.

  5. V části Podrobnosti o nasazení se stav změní na aktivní. Nasazená aktualizace je označena jako (nasazeno).

    Snímek obrazovky znázorňující aktivní nasazení

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

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

    Snímek obrazovky znázorňující úspěšné aktualizace

Monitorování nasazení aktualizací

  1. V horní části stránky vyberte kartu Historie nasazení.

    Snímek obrazovky znázorňující historii nasazení

  2. Vyberte Podrobnosti vedle vytvořeného nasazení.

    Snímek obrazovky znázorňující podrobnosti nasazení

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

Nyní jste dokončili úspěšnou kompletní aktualizaci obrazu pomocí služby Update pro zařízení IoT Hub prostřednictvím referenčního agenta simulátoru Ubuntu (18.04 x64).

Uklidit zdroje

Pokud už ho nepotřebujete, vyčistěte účet služby Device Update, instanci, centrum IoT a zařízení IoT.

Další kroky

Řešení potíží

  • Last updated on