Kurz: Dokončení aktualizace proxy serveru pomocí služby Device Update pro Azure IoT Hub

Pokud jste to ještě neudělali, projděte si Použití aktualizací proxy serveru ve službě Device Update pro azure IoT Hub.

Nastavení testovacího zařízení nebo virtuálního počítače

V tomto kurzu se jako příklad používá virtuální počítač s Ubuntu Serverem 18.04 LTS.

Instalace agenta aktualizace zařízení a závislostí

1. Zaregistrujte packages.microsoft.com v úložišti balíčků APT:

   sudo apt-get update
   
   sudo apt install curl
   
   curl https://packages.microsoft.com/config/ubuntu/18.04/multiarch/prod.list > ~/microsoft-prod.list
   
   sudo cp ~/microsoft-prod.list /etc/apt/sources.list.d/
   
   curl https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > ~/microsoft.gpg
   
   sudo cp ~/microsoft.gpg /etc/apt/trusted.gpg.d/
   
   sudo apt-get update
   

2. Nainstalujte deviceupdate-agent na zařízení IoT. Stáhněte si nejnovější soubor Device Update Debian z packages.microsoft.com:

   sudo apt-get install deviceupdate-agent
   

   Případně zkopírujte stažený soubor Debianu do testovacího virtuálního počítače. Pokud na počítači používáte PowerShell, spusťte tento příkaz v prostředí PowerShell:

     scp <path to the .deb file> tester@<your vm's ip address>:~
   

   Pak se vzdáleně připojte k virtuálnímu počítači a zadejte následující příkaz shellu ve složce home:

         #go to home folder 
         cd ~
         #install latest Device Update agent
         sudo apt-get install ./<debian file name from the previous step>
   

3. Přejděte do Azure IoT Hub a zkopírujte primární připojovací řetězec pro modul Aktualizace zařízení vašeho IoT zařízení. Nahraďte výchozí hodnotu pole connectionData primárním připojovacím řetězcem v souboru du-config.json:

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

   Poznámka:

   Místo toho můžete zkopírovat primární připojovací řetězec pro zařízení, ale doporučujeme použít řetězec pro modul Device Update. Podívejte se na informace o nastavení modulu v tématu Agenta pro aktualizaci zařízení.

4. Ujistěte se, že /etc/adu/du-diagnostics-config.json obsahuje správná nastavení pro shromažďování protokolů. Například:

   {
     "logComponents":[
       {
         "componentName":"adu",
          "logPath":"/var/log/adu/"
       },
       {
         "componentName":"do",
         "logPath":"/var/log/deliveryoptimization-agent/"
       }
     ],
     "maxKilobytesToUploadPerLogPath":50
   }
   

5. Restartujte agenta Device Update:

   sudo systemctl restart adu-agent
   

Nastavení testovacích komponent

Pro účely testování a předvádění vytvoříme na zařízení následující napodobené komponenty:

• Tři motory
• Dvě kamery
• hostfs
• "rootfs (kořenový souborový systém)"

Důležité

Předchozí konfigurace komponenty je založena na implementaci ukázkového rozšíření enumerátoru komponent s názvem libcontoso-component-enumerator.so. Vyžaduje také tento simulovaný datový soubor inventáře komponent: /usr/local/contoso-devices/components-inventory.json.

1. Zkopírujte složku demo do domovského adresáře na testovacím virtuálním počítači. Potom spuštěním následujícího příkazu zkopírujte požadované soubory do správných umístění:

   `~/demo/tools/reset-demo-components.sh` 
   

   Příkaz reset-demo-components.sh vaším jménem provede následující kroky:

   1. Zkopíruje components-inventory.json a přidá ji do složky /usr/local/contoso-devices.

   2. Zkopíruje rozšíření enumerátoru komponenty Contoso (libcontoso-component-enumerator.so) ze složky Assets a přidá ho do složky /var/lib/adu/extensions/sources.

   3. Zaregistruje rozšíření:

      sudo /usr/bin/AducIotAgent -E /var/lib/adu/extensions/sources/libcontoso-component-enumerator.so
      

2. Zobrazte a poznamenejte si verzi softwaru aktuálních komponent pomocí následujícího příkazu a nastavte virtuální počítač tak, aby podporoval aktualizace proxy serveru:

   ~/demo/show-demo-components.sh
   

Import ukázkové aktualizace

Pokud jste to ještě neudělali, vytvořte účet ainstance služby Device Update, včetně konfigurace centra IoT. Pak spusťte následující postup.

1. Z nejnovější verzeaktualizace zařízení v části Assetsstáhněte manifesty importu a image pro aktualizace proxy serveru.

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

3. Vyberte kartu Aktualizace.

4. Vyberte + Importovat novou aktualizaci.

5. Vyberte , vyberte z kontejneru úložiště, a pak zvolte svůj účet úložiště a kontejner.

   

6. Vyberte Nahrát a přidejte soubory, které jste stáhli v kroku 1.

7. Nahrajte nadřazený manifest importu, podřízený manifest importu a soubory užitečného zatížení do svého kontejneru.

   Následující příklad ukazuje ukázkové soubory nahrané k aktualizaci fotoaparátů připojených k inteligentnímu vysavači zařízení. Obsahuje také předpřipravený skript pro vypnutí fotoaparátů před přeletovou aktualizací.

   V příkladu je nadřazený importní manifest contoso.Virtual-Vacuum-virtual-camera.1.4.importmanifest.json. Dceřiný manifest importu s detaily pro aktualizaci kamery je Contoso.Virtual-Vacuum.3.3.importmanifest.json. Všimněte si, že oba názvy souborů manifestu se řídí požadovaným formátem a končí .importmanifest.json.

   

8. Zvolte Vybrat.

9. Uživatelské rozhraní teď zobrazuje seznam souborů, které se naimportují do služby Device Update. Vyberte možnost importu aktualizace .

   

10. Zahájí se proces importu a obrazovka se změní na sekci Historie importu . Vyberte Obnovit pro zobrazení průběhu, dokud se proces importu neukončí. V závislosti na velikosti aktualizace může import trvat několik minut nebo déle.

11. Když sloupec Stav indikuje, že import proběhl úspěšně, vyberte kartu Dostupné aktualizace. V seznamu by se teď měla zobrazit importovaná aktualizace.

    

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 Hubu a třídu zařízení a pak vyberte Vytvořit skupinu.

4. Po vytvoření skupiny uvidíte, že graf shody aktualizací a seznam skupin budou aktualizovány. Graf shody aktualizací zobrazuje počet zařízení v různých stavech shody: Na nejnovější aktualizaci, Dostupné nové aktualizace a Aktualizace v průběhu. Seznámení se s dodržováním předpisů u aktualizací

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ě. Nejlepší dostupnou aktualizaci můžete nasadit do nové uživatelem definované skupiny z tohoto zobrazení kliknutím na tlačítko Nasadit vedle skupiny.

Další informace o přidávání značek a vytváření skupin aktualizací

Nasazení aktualizace

1. Po vytvoření skupiny by se měla zobrazit nová aktualizace dostupná pro vaši skupinu zařízení s odkazem na aktualizaci v části Nejlepší aktualizace (možná budete muset aktualizovat jednou). Další informace o dodržování aktualizace předpisů

2. Vyberte cílovou skupinu kliknutím na název skupiny. Budete přesměrováni na podrobnosti skupiny v části Základy skupiny.

podrobnosti skupiny

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

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

5. Stav v části Podrobnosti o nasazení by měl být aktivní a nasazená aktualizace by měla být označena písmenem (nasazení).

nasazení aktivníDeployment activeDeployment active

6. Zobrazte graf dodržování předpisů. Měli byste vidět, že aktualizace právě probíhá.

7. Po úspěšné aktualizaci zařízení by se měl zobrazit graf souladu a podrobnosti o nasazení se aktualizují, aby to odrážely.

   

Monitorování nasazení aktualizací

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

   

2. Vyberte odkaz podrobností vedle nasazení, které jste vytvořili.

   podrobnosti o nasazení

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

Dokončili jste úspěšnou komplexní aktualizaci proxy serveru pomocí služby Device Update pro IoT Hub.

Uklidit zdroje

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

Další kroky

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

• kurz Device Update pro Azure IoT Hub s využitím referenční image Raspberry Pi 3 B+ (rozšiřitelný prostřednictvím open source pro vytvoření vlastních imagí pro jiné architektury podle potřeby)

• kurz Device Update pro Azure IoT Hub pomocí agenta balíčků na Ubuntu Serveru 18.04 x64

• Návod týkající se aktualizace zařízení pro Azure IoT Hub pomocí referenčního agenta simulátoru Ubuntu (18.04 x64)

• Návod na aktualizaci zařízení pro Azure IoT Hub pomocí operačního systému Azure v reálném čase