Kurz: Aktualizace zařízení pro Azure IoT Hub pomocí agenta balíčku na Ubuntu Serveru 18.04 x64

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

Aktualizace založené na balíčcích jsou cílené aktualizace, které mění jenom určitou komponentu nebo aplikaci v zařízení. Vedou k nižší spotřebě šířky pásma a pomáhají zkrátit dobu stahování a instalace aktualizace. Aktualizace založené na balíčcích také obvykle umožňují menší výpadky zařízení při instalaci aktualizace a vyhněte se režii spojenou s vytvářením imagí. Používají manifest APT, který agentu aktualizace zařízení poskytne informace, které potřebuje ke stažení a instalaci balíčků zadaných v souboru manifestu APT (a jejich závislostech) z určeného úložiště.

Tento kurz vás provede aktualizací Azure IoT Edge na Ubuntu Serveru 18.04 x64 pomocí agenta balíčku Aktualizace zařízení. I když tento kurz ukazuje aktualizaci IoT Edge, pomocí podobných kroků můžete aktualizovat i další balíčky, například modul kontejnerů, který používá.

Nástroje a koncepty v tomto kurzu stále platí i v případě, že plánujete použít jinou konfiguraci platformy operačního systému. Dokončete tento úvod do kompletního procesu aktualizace. Pak zvolte preferovanou formu aktualizace platformy operačního systému a probírejte podrobnosti.

V tomto kurzu se naučíte:

• Stáhněte a nainstalujte agenta aktualizace zařízení a jeho závislosti.
• Přidejte do zařízení značku.
• Importujte aktualizaci.
• Vytvořte skupinu zařízení.
• Nasazení aktualizace balíčku
• Monitorujte nasazení aktualizací.

Požadavky

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

• Potřebujete připojovací řetězec pro IoT Edge zařízení.

• Pokud jste pro předchozí testování použili kurz agenta simulátoru , spuštěním následujícího příkazu vyvolejte obslužnou rutinu APT a nasaďte aktualizace balíčků prostřednictvím vzduchu v tomto kurzu:

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

Příprava zařízení

Připravte zařízení automaticky nebo ručně.

Použití automatizovaného tlačítka Deploy to Azure (Nasadit do Azure)

Pro usnadnění práce tento kurz používá šablonu azure Resource Manager založenou na cloudu, která vám pomůže rychle nastavit virtuální počítač s Ubuntu 18.04 LTS. Nainstaluje modul runtime Azure IoT Edge i agenta balíčku Device Update. Pak automaticky nakonfiguruje zařízení se zřizovacími informacemi pomocí připojovacího řetězce zařízení pro IoT Edge zařízení (předpoklad), které zadáte. Šablona Resource Manager také předejde nutnosti spustit relaci SSH, aby se dokončilo nastavení.

1. Začněte tím, že vyberete toto tlačítko:

   

2. Vyplňte dostupná textová pole:

   

   • Předplatné: Aktivní předplatné Azure, do které se má virtuální počítač nasadit.
   • Skupina prostředků: Existující nebo nově vytvořená skupina prostředků, která bude obsahovat virtuální počítač a jeho přidružené prostředky.
   • Oblast: Geografická oblast , do které se má virtuální počítač nasadit. Výchozí hodnota této hodnoty je umístění vybrané skupiny prostředků.
   • Předpona popisku DNS: Požadovaná hodnota podle vašeho výběru, která se použije k předponě názvu hostitele virtuálního počítače.
   • Správa Uživatelské jméno: Uživatelské jméno, které má při nasazení udělená oprávnění uživatele root.
   • Připojovací řetězec zařízení: Připojovací řetězec zařízení pro zařízení, které bylo vytvořeno v rámci zamýšleného centra IoT.
   • Velikost virtuálního počítače: Velikost virtuálního počítače, který se má nasadit.
   • Verze operačního systému Ubuntu: Verze operačního systému Ubuntu, která se nainstaluje na základní virtuální počítač. Ponechte výchozí hodnotu beze změny, protože už bude nastavená na Ubuntu 18.04-LTS.
   • Typ ověřování: Zvolte sshPublicKey nebo heslo podle svých preferencí.
   • Správa Heslo nebo klíč: Hodnota veřejného klíče SSH nebo hodnota hesla na základě volby typu ověřování.

   Po vyplnění všech políček přijměte podmínky zaškrtnutím políčka v dolní části stránky. Výběrem možnosti Koupit zahajte nasazení.

3. Ověřte, že se nasazení úspěšně dokončilo. Počkejte několik minut po dokončení nasazení, aby se po instalaci a konfiguraci dokončila instalace IoT Edge a agenta aktualizace balíčku zařízení.

   Do vybrané skupiny prostředků by měl být nasazený prostředek virtuálního počítače. Poznamenejte si název počítače, který je ve formátu vm-0000000000000. Všimněte si také přidruženého názvu DNS, který je ve formátu <dnsLabelPrefix>.<location>. cloudapp.azure.com.

   Název DNS můžete získat v části Přehled nově nasazeného virtuálního počítače v Azure Portal.

   

   Tip

   Pokud chcete po instalaci připojit k tomuto virtuálnímu počítači SSH, použijte přidružený název DNS s následujícím příkazem: ssh <adminUsername>@<DNS_Name>.

4. Otevřete podrobnosti o konfiguraci (postup nastavení konfiguračního souboru najdete tady pomocí následujícího příkazu. Nastavte connectionType na AIS a connectionData jako prázdný řetězec.

/etc/adu/du-config.json

5. Restartujte agenta Aktualizace zařízení spuštěním následujícího příkazu:

 sudo systemctl restart adu-agent

Aktualizace zařízení pro Azure IoT Hub softwarové balíčky podléhají následujícím licenčním podmínkám:

• Aktualizace zařízení pro licenci IoT Hub
• Klientská licence pro optimalizaci doručení

Před použitím balíčku si přečtěte licenční podmínky. Instalace a použití balíčku představuje váš souhlas s těmito podmínkami. Pokud s licenčními podmínkami nesouhlasíte, balíček nepoužívejte.

Ruční příprava zařízení

Podobně jako u kroků automatizovaných skriptem cloud-init se k instalaci a konfiguraci zařízení používají následující ruční kroky. Tento postup použijte k přípravě fyzického zařízení.

1. Podle pokynů nainstalujte modul runtime Azure IoT Edge.

   Poznámka

   Agent aktualizace zařízení nezávisí na IoT Edge. Spoléhá ale na proces démon služby IoT Identity Service, který je nainstalovaný s IoT Edge (1.2.0 a novější), aby získal identitu a připojil se k IoT Hub.

   I když to tento kurz nezabývá, démon služby IoT Identity Service se dá nainstalovat samostatně na zařízeních IoT se systémem Linux. Pořadí instalace je důležité. Agent balíčku aktualizace zařízení musí být nainstalovaný po službě IoT Identity Service. Jinak se agent balíčku nezaregistruje jako autorizovaná komponenta pro navázání připojení k IoT Hub.

2. Nainstalujte balíčky .deb agenta aktualizace zařízení:

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

3. Spuštěním následujícího příkazu zadejte do konfiguračního souboru primární připojovací řetězec modulu vašeho zařízení IoT (nebo zařízení v závislosti na tom, jak jste zařízení s aktualizací zařízení zřídili):

   /etc/adu/du-config.json
   

4. Restartujte agenta Aktualizace zařízení spuštěním následujícího příkazu:

    sudo systemctl restart adu-agent
   

Aktualizace zařízení pro Azure IoT Hub softwarové balíčky podléhají následujícím licenčním podmínkám:

• Aktualizace zařízení pro licenci IoT Hub
• Klientská licence pro optimalizaci doručení

Před použitím balíčku si přečtěte licenční podmínky. Instalace a použití balíčku představuje váš souhlas s těmito podmínkami. Pokud s licenčními podmínkami nesouhlasíte, balíček nepoužívejte.

Přidání značky do zařízení

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

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

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

4. Přidejte novou hodnotu značky Device Update, jak je znázorněno níže:

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

Import aktualizace

1. Na GitHubu přejděte do vydání služby Device Update a vyberte rozevírací seznam Prostředky . Stáhněte Tutorial_IoTEdge_PackageUpdate.zip ho tak, že ho vyberete. Extrahováním obsahu složky zjistíte ukázkový manifest APT (sample-1.0.2-aziot-edge-apt-manifest.json) a odpovídající manifest importu (sample-1.0.2-aziot-edge-importManifest.json).

2. Přihlaste se k 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 + Vybrat z kontejneru úložiště. Vyberte existující účet nebo vytvořte nový účet pomocí + Účet úložiště. Pak vyberte existující kontejner nebo vytvořte nový kontejner pomocí + Kontejner. Tento kontejner se používá k rozfázování souborů aktualizací 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.

   

6. V kontejneru vyberte Nahrát a přejděte k souborům, 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 vraťte na stránku Import aktualizace .

   

   Tento snímek obrazovky ukazuje krok importu. Názvy souborů se nemusí shodovat s názvy souborů použitými v příkladu.

7. Na stránce Importovat aktualizaci zkontrolujte soubory, které se mají importovat. Potom vyberte Importovat aktualizaci a spusťte proces importu.

   

8. Spustí se proces importu a obrazovka se přepne do části Historie importu . Když sloupec Stav indikuje, že import proběhl úspěšně, vyberte záhlaví Dostupné aktualizace . Importovaná aktualizace by se teď měla zobrazit v seznamu.

   

Přečtěte si další informace o importu aktualizací.

Vytvoření skupiny aktualizací

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

   

2. Výběrem tlačítka Přidat skupinu vytvořte novou skupinu.

   

3. V seznamu vyberte značku IoT Hub a Třídu zařízení. Pak vyberte Vytvořit skupinu.

   

4. Po vytvoření skupiny uvidíte, že se aktualizuje graf dodržování předpisů aktualizací a seznam skupin. Graf dodržování předpisů aktualizací zobrazuje počet zařízení v různých stavech dodržování předpisů: při nejnovější aktualizaci, dostupné nové aktualizace a probíhající Aktualizace. Přečtěte si o dodržování předpisů pro aktualizace.

   

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é skupiny definované uživatelem z tohoto zobrazení, vyberte Nasadit vedle skupiny.

Přečtěte si další informace o tom, jak přidávat značky a vytvářet skupiny aktualizací.

Nasazení aktualizace

1. Po vytvoření skupiny by se měla zobrazit nová aktualizace s odkazem na aktualizaci v části Nejlepší aktualizace. Možná budete muset provést aktualizaci jednou. Přečtěte si další informace o dodržování předpisů pro aktualizace.

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

   

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

   

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

   Tip

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

   

5. V části Podrobnosti nasazení se Stav změní na Aktivní. Nasazená aktualizace je označená (nasazuje se).

   

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

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

   

Monitorování nasazení aktualizací

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

   

2. Vyberte odkaz podrobnosti vedle vytvořeného nasazení.

   

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

Dokončili jste úspěšnou kompletní aktualizaci balíčku pomocí služby Device Update pro IoT Hub na zařízení s Ubuntu Serverem 18.04 x64.

Vyčištění prostředků

Pokud už je nepotřebujete, vyčistěte účet aktualizace zařízení, instanci a centrum IoT. Pokud jste vytvořili virtuální počítač pomocí tlačítka Nasadit do Azure, vyčistěte také IoT Edge zařízení. Pokud chcete vyčistit prostředky, přejděte ke každému jednotlivému prostředku a vyberte Odstranit. Před vyčištěním účtu aktualizace zařízení vyčistěte instanci aktualizace zařízení.

Další kroky

V následujících kurzech najdete jednoduchou ukázku aktualizace zařízení pro IoT Hub:

• Aktualizace image: Začínáme s referenčními informacemi o imagi Raspberry Pi 3 B+ rozšiřitelné prostřednictvím open source, abyste podle potřeby vytvořili vlastní image pro jinou architekturu.
• Aktualizace proxy serveru: Začínáme používat binárního agenta aktualizace zařízení pro podřízená zařízení.
• Začínáme používat referenčního agenta simulátoru Ubuntu (18.04 x64).
• Kurz aktualizace zařízení pro Azure IoT Hub pro operační systém Azure v reálném čase