Kurz: Dokončení aktualizace proxy serveru pomocí aktualizace zařízení pro Azure IoT Hub

Článek
03/24/2023

Pokud jste to ještě neudělali, přečtěte si téma Používání aktualizací proxy serveru se službou 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í

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

Nainstalujte na zařízení IoT agent deviceupdate-agent . 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 následující příkaz prostředí:
```
scp <path to the .deb file> tester@<your vm's ip address>:~
```
Pak se vzdáleně přejděte k virtuálnímu počítači a v domovské složce spusťte následující příkaz prostředí:
```
#go to home folder 
cd ~
#install latest Device Update agent
sudo apt-get install ./<debian file name from the previous step>
```
Přejděte na Azure IoT Hub a zkopírujte primární připojovací řetězec pro modul Device Update vašeho zařízení IoT. Nahraďte výchozí hodnotu connectionData pole 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. Informace o nastavení modulu najdete v tématu Zřizování agenta aktualizace zařízení.

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

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

Restartujte agenta aktualizace zařízení:

sudo systemctl restart deviceupdate-agent

Nastavení komponent napodobení

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

Tři motory
Dvě kamery
"hostfs"
"rootfs"

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 napodobení datového souboru inventáře komponent: /usr/local/contoso-devices/components-inventory.json.

Zkopírujte složku s ukázkou do svého 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 provede za vás následující kroky:
- Zkopíruje soubor components-inventory.json a přidá ho do složky /usr/local/contoso-devices .
- Zkopíruje rozšíření Enumerator komponent Contoso (libcontoso-component-enumerator.so) ze složky Assets a přidá ho do složky /var/lib/adu/extensions/sources .
- Zaregistruje rozšíření:
```
sudo /usr/bin/AducIotAgent -E /var/lib/adu/extensions/sources/libcontoso-component-enumerator.so
```

Import ukázkové aktualizace

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

V nejnovější verzi aktualizace zařízení si v části Prostředky stáhněte manifesty importu a image pro aktualizace proxy serveru.
Přihlaste se k Azure Portal a přejděte do centra IoT pomocí aktualizace zařízení. V levém podokně vyberte Správa zařízení>Aktualizace.
Vyberte kartu Aktualizace.
Vyberte + Importovat novou aktualizaci.
Vyberte + Vybrat z kontejneru úložiště a pak zvolte svůj účet úložiště a kontejner.
Vyberte Nahrát a přidejte soubory, které jste stáhli v kroku 1.
Nahrajte do kontejneru nadřazený manifest importu, podřízený manifest importu a soubory datové části.

Následující příklad ukazuje ukázkové soubory nahrané pro aktualizaci fotoaparátů připojených k inteligentnímu zařízení s vysavačem. Obsahuje také skript před instalací, který vypne kamery před aktualizací.

V tomto příkladu je nadřazený manifest importu contoso. Virtual-Vacuum-virtual-camera.1.4.importmanifest.json. Podřízený manifest importu s podrobnostmi o aktualizaci kamery je Contoso.Virtual-Vacuum.3.3.importmanifest.json. Oba názvy souborů manifestu mají požadovaný formát a končí na .importmanifest.json.
Zvolte Vybrat.
Uživatelské rozhraní teď zobrazuje seznam souborů, které se naimportují do služby Device Update. Vyberte Importovat aktualizaci.
Spustí se proces importu a obrazovka se změní na část Historie importu . Výběrem možnosti Aktualizovat zobrazte průběh, dokud se proces importu nedokončí. V závislosti na velikosti aktualizace může import trvat několik minut nebo může trvat déle.
Pokud sloupec Stav označuje, že import proběhl úspěšně, vyberte kartu K dispozici 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 seřadí zařízení do skupin na základě přiřazených značek a vlastností kompatibility. Každé zařízení patří pouze do jedné skupiny, ale skupiny můžou mít více podskupin pro řazení různých tříd zařízení.

V horní části stránky přejděte na kartu Skupiny a nasazení .
Zobrazte si 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, jsou k dispozici nové aktualizace a probíhá Aktualizace. Přečtěte si o dodržování předpisů aktualizací.
Měli byste vidět skupinu zařízení, která obsahuje 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é uživatelem definované skupiny 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

Po vytvoření skupiny by se pro skupinu zařízení měla zobrazit nová aktualizace s odkazem na aktualizaci v části Nejlepší aktualizace (možná budete muset aktualizovat jednou).

Další informace o dodržování předpisů najdete v tématu Dodržování předpisů službou Device Update.
Kliknutím na název skupiny vyberte cílovou skupinu. Budete přesměrováni na podrobnosti o skupině v části Základy skupiny.
Pokud chcete zahájit 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 bude označena zvýrazněním "Nejlepší".
Naplánujte nasazení tak, aby se spustilo okamžitě nebo v budoucnu a pak vyberte Vytvořit.
Stav v části Podrobnosti nasazení by se měl změnit na Aktivní a nasazená aktualizace by měla být označená "(nasazením)".
Podívejte se na graf dodržování předpisů. Měli byste vidět, že aktualizace právě probíhá.
Po úspěšné aktualizaci zařízení byste měli vidět graf dodržování předpisů a podrobnosti o nasazení se aktualizují tak, aby odrážely totéž.