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í pouze konkrétní komponentu nebo aplikaci v zařízení. Vedou k nižší spotřebě šířky pásma a zkracují dobu stahování a instalace aktualizace. Aktualizace založené na balíčcích také obvykle umožňují menší výpadky zařízení při použití aktualizace a vyhýbají se režijním nákladům na vytváření imagí. Používají manifest APT, který agentu aktualizace zařízení poskytne informace potřebné 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ž kurz ukazuje aktualizaci IoT Edge, pomocí podobných kroků byste mohli aktualizovat další balíčky, například modul kontejneru, který používá.

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

V tomto kurzu se naučíte:

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

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 k předchozímu testování použili kurz agenta simulátoru , spusťte následující příkaz, který v tomto kurzu vyvolá obslužnou rutinu APT a nasadí aktualizace balíčků přes air:

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

Příprava zařízení

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

Použití tlačítka automatizovaného nasazení do Azure

Pro usnadnění práce používá tento kurz cloudovou šablonu Azure Resource Manager, 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 Aktualizace zařízení. Pak zařízení automaticky nakonfiguruje s informacemi o zřizování 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 tak, že vyberete 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. Tato hodnota je ve výchozím nastavení umístění vybrané skupiny prostředků.
   • Předpona popisku DNS: Požadovaná hodnota 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á kořenová oprávnění.
   • 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 má nainstalovat 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 vašich preferencí.
   • Správa Heslo nebo klíč: Hodnota veřejného klíče SSH nebo hodnota hesla na základě výběru 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

   K připojení SSH k tomuto virtuálnímu počítači po instalaci 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. Upozorňujeme, že musí být nastaveny všechny hodnoty se značkou Umístit hodnotu sem. Viz Konfigurace agenta DU.

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

5. Restartujte agenta Aktualizace zařízení.

   sudo systemctl restart deviceupdate-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
• Licence klienta optimalizace doručení

Před použitím balíčku si přečtěte licenční podmínky. Vaše instalace a použití balíčku představuje vaše přijetí těchto podmínek. Pokud s licenčními podmínkami nesouhlasíte, nepoužívejte tento balíček.

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

Podobně jako u kroků automatizovaných pomocí skriptu cloud-init se k instalaci a konfiguraci zařízení používají následující ruční kroky. Pomocí těchto kroků připravte fyzické zařízení.

1. Postupujte podle pokynů k instalaci modulu runtime Azure IoT Edge.

   Poznámka

   Agent aktualizace zařízení nezávisí na IoT Edge. K získání identity a připojení k IoT Hub se ale spoléhá na démon služby Identity Service IoT, který je nainstalovaný s IoT Edge (1.2.0 a novější).

   I když se tento kurz nezabývá démonem služby Identity Service IoT, je možné 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. V opačném případě nebude agent balíčku zaregistrovaný 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 
   

3. Do konfiguračního souboru zadejte primární připojovací řetězec vašeho zařízení IoT (nebo zařízení v závislosti na tom, jak jste zařízení s aktualizací zařízení zřídili). Upozorňujeme, že musí být nastaveny všechny hodnoty se značkou Umístit hodnotu sem. Viz Konfigurace agenta DU.

   sudo /etc/adu/du-config.json
   

4. Restartujte agenta Aktualizace zařízení.

   sudo systemctl restart deviceupdate-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
• Licence klienta optimalizace doručení

Před použitím balíčku si přečtěte licenční podmínky. Vaše instalace a použití balíčku představuje vaše přijetí těchto podmínek. Pokud s licenčními podmínkami nesouhlasíte, nepoužívejte tento balíček.

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 Aktualizace zařízení 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 na dvojčeti zařízení.

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

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

   

   Tento snímek obrazovky ukazuje oddíl, do kterého je potřeba přidat značku do dvojčete.

Import aktualizace

1. Na GitHubu přejděte na vydání aktualizace zařízení 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.

   

Další informace o procesu importu najdete v tématu Import aktualizace do služby Device Update.

Zobrazení skupin zařízení

Služba Device Update používá k uspořádání zařízení skupiny. Device Update automaticky řadí zařízení do skupin na základě přiřazených značek a vlastností kompatibility. Každé zařízení patří jenom do jedné skupiny, ale skupiny můžou mít více podskupin pro řazení různých tříd zařízení.

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

   

2. Zobrazte seznam skupin a graf dodržování předpisů aktualizací. 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.

   

3. Měli byste vidět skupinu zařízení obsahující simulované zařízení, které jste nastavili v tomto kurzu, spolu se všemi dostupnými aktualizacemi 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.

Další informace o značkách a skupinách najdete v tématu Správa skupin zařízení.

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.

   Další informace o dodržování předpisů najdete v tématu Dodržování předpisů službou Device Update.

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í aktualizují 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ž ho nepotřebujete, vyčistěte účet aktualizace zařízení, instanci a centrum IoT. Pokud jste virtuální počítač vytvořili 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

Aktualizace součástí zařízení nebo připojených senzorů pomocí aktualizace zařízení