Oktatóanyag: Azure Device Update for IoT Hub az Ubuntu 22.04 csomagügynök használatával

Az Azure IoT Hub eszközfrissítése támogatja a rendszerképalapú, csomagalapú és szkriptalapú frissítéseket. Ez az oktatóanyag az Azure IoT Edge frissítéséhez az Ubuntu Server 22.04 x64-csomagügynökkel végzett, végpontok közötti csomagfrissítést mutatja be.

A csomagalapú frissítések célja csak egy adott eszközösszetevő vagy -alkalmazás módosítása. Ezek a frissítések kisebb sávszélesség-használattal és rövidebb letöltési és telepítési idővel rendelkeznek, mint a képalapú frissítések, ami kevesebb eszköz állásidőt eredményez, és elkerüli a képek létrehozásának többletterhelését. Egy csomagalapú frissítésben az APT-jegyzék tartalmazza az eszközfrissítési ügynök számára a megadott csomagok és függőségeik egy kijelölt adattárból való letöltéséhez és telepítéséhez szükséges információkat.

Ez az oktatóanyag végigvezeti a Microsoft Defender for IoT telepítésén, de más csomagokat is frissíthet hasonló lépésekkel, például magát az IoT Edge-et vagy az általa használt tárolómotort. Az oktatóanyagban szereplő eszközök és fogalmak akkor is érvényesek, ha más operációsrendszer-platformkonfigurációt használ.

Az oktatóanyag során az alábbi lépéseket fogja végrehajtani:

• Töltse le és telepítse az eszközfrissítési ügynököt és annak függőségeit.
• Csoportcímke hozzáadása az eszközhöz.
• Importálja a csomagfrissítést.
• Telepítse a csomagfrissítést.
• Tekintse meg a frissítés üzembehelyezési előzményeit.

Előfeltételek

• IoT Hubbal konfigurált eszközfrissítési fiók és példány.
• Az IoT Hubban regisztrált Azure IoT Edge-eszköz a másolt kapcsolati sztring.

Az eszköz előkészítése

Ez az oktatóanyag egy felhőalapú Azure Resource Manager-sablont(ARM) használ az Ubuntu 22.04 LTS virtuális gép (VM) gyors beállításához. A sablon telepíti az IoT Edge-futtatókörnyezetet és az Eszközfrissítés csomagügynököt is, és automatikusan konfigurálja az eszközt kiépítési információkkal a megadott IoT Edge-eszköz kapcsolati sztring használatával. Az ARM-sablon használata esetén nem szükséges biztonságos rendszerhéj-munkamenetet (SSH) elindítani a telepítés befejezéséhez.

1. A sablon futtatásához válassza a következő Üzembe helyezés az Azure-ban gombot:

   .

2. Töltse ki a következő információkat:

   • Előfizetés: A virtuális gép üzembe helyezéséhez szükséges aktív Azure-előfizetés.
   • Erőforráscsoport: A virtuális gépet és erőforrásait tartalmazó meglévő vagy új erőforráscsoport.
   • Régió: A virtuális gép üzembe helyezéséhez szükséges földrajzi régió , amely alapértelmezés szerint az erőforráscsoport helyére kerül.
   • Dns Label Prefix: A virtuális gép gazdagépnevének előtagja.
   • Rendszergazdai felhasználónév: Az üzembe helyezéskor a legfelső szintű jogosultságokat biztosító felhasználónév.
   • Hitelesítési típus: Válassza az sshPublicKey vagy a jelszó lehetőséget.
   • Rendszergazdai jelszó vagy SSH nyilvános kulcs forrása, SSH-kulcs típusa, kulcspár neve: A jelszó vagy az SSH nyilvános kulcsának információja a hitelesítési típustól függően.
   • Virtuális gép mérete: Az üzembe helyezendő virtuális gép mérete .
   • Ubuntu operációs rendszer verziója: Hagyja meg a 22_04-lts.
   • Eszközkapcsolati sztring: A korábban másolt IoT Edge kapcsolati sztring.

3. Válassza a Véleményezés + létrehozás lehetőséget a lap alján. Ha az ellenőrzés sikeres, válassza a Létrehozás lehetőséget a sablon üzembe helyezésének megkezdéséhez.

4. Győződjön meg arról, hogy az üzembe helyezés sikeresen befejeződött, és a telepítés után néhány perccel engedélyezze, hogy a telepítést és a konfigurációt követően befejeződjön az IoT Edge és az eszközcsomag-frissítési ügynök telepítése.

5. A kijelölt erőforráscsoportban virtuálisgép-erőforrásnak kell megjelennie. Jegyezze fel a gép nevét, amely formátuma vm-0000000000000. Válassza ki a virtuális gép nevét, és a virtuális gép áttekintési lapján jegyezze fel a DNS-nevet, amely formátuma <dnsLabelPrefix>.<location>.cloudapp.azure.com.

   

Tipp.

Ha a telepítés után szeretne SSH-t létrehozni ebbe a virtuális gépbe, használja a társított DNS-nevet a paranccsal ssh <admin username>@<DNS name>.

Az Eszközfrissítési ügynök telepítése a virtuális gépen

Fontos

Az Azure Device Update for IoT Hub szoftverre a következő licencfeltételek vonatkoznak:

• IoT Hub-licenc eszközfrissítése
• Kézbesítésoptimalizálási ügyféllicenc

Az ügynök használata előtt olvassa el a licencfeltételeket. Az ügynök telepítése és használata a jelen feltételek elfogadását jelenti. Ha nem ért egyet a licencfeltételekkel, ne használja az eszközfrissítési ügynököt.

1. Az eszközfrissítési ügynök virtuális gépre való telepítéséhez futtassa a következő parancsot.

   sudo apt-get install deviceupdate-agent
   

2. Nyissa meg a du-config.json konfiguráció részleteit tartalmazó fájlt az alábbi paranccsal.

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

3. A fájlban cserélje le az összes <placeholder> értéket a saját konfigurációra. Állítsa be az connectionType"AIS"connectionData üres sztringet. Példafájl esetén lásd: Példa du-config.json fájl tartalmára.

4. Indítsa újra az eszközfrissítési ügynököt az alábbi parancs futtatásával.

   sudo systemctl restart deviceupdate-agent
   

Feljegyzés

Ha korábban ezen az eszközön használta a szimulátorügynököt , futtassa a következő parancsot az APT-kezelő meghívásához és az oktatóanyaghoz tartozó csomagfrissítések üzembe helyezéséhez.

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

Csoportcímke hozzáadása az eszközhöz

Az Eszközfrissítés automatikusan csoportokba rendezi az eszközöket a hozzájuk rendelt címkék és kompatibilitási tulajdonságok alapján. Minden eszköz csak egy csoporthoz tartozhat, de a csoportok több alcsoporttal is rendelkezhetnek a különböző eszközosztályok rendezéséhez. További információ a címkékről és csoportokról: Eszközcsoportok kezelése.

1. Az Eszközfrissítési példány Azure Portal IoT Hub lapján válassza az Eszközfelügyeleti>eszközök lehetőséget a bal oldali navigációs sávon.

2. Nyissa meg az eszköz ikereszközét vagy modulidentitás-ikerpéldányát .

3. Az ikereszköz- vagy eszközfrissítési ügynök modul identitási ikerfájljában törölje a meglévő eszközfrissítési címkeértékeket a beállításukkal null, majd adja hozzá az alábbi új eszközfrissítési csoportcímkét.

   Ha eszközidentitást használ az Eszközfrissítési ügynökkel, végezze el ezeket a módosításokat az ikereszközön. Ha modulidentitást használ az Eszközfrissítési ügynök modullal, adja hozzá a címkét a Modulidentitás-ikerprogramhoz.

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

   Az alábbi képernyőképen látható, hogy a fájlban hol szeretné hozzáadni a címkét.

   

4. Válassza a Mentés lehetőséget.

A frissítés importálása

A Tutorial_IoTEdge_PackageUpdate.zip fájl tartalmazza az oktatóanyaghoz szükséges fájlokat.

1. Töltse le a Tutorial_IoTEdge_PackageUpdate.zip fájlt a legújabb kiadás Eszközök szakaszából a GitHub Eszközfrissítési kiadások lapján.

2. Bontsa ki a fájlt. A kinyert Tutorial_IoTEdge_PackageUpdate mappa tartalmazza a sample-defender-iot-apt-manifest.json APT-mintajegyzéket és annak megfelelő sample-defender-iot--importManifest.json importálási jegyzékfájlt.

3. Az Eszközfrissítési példány Azure Portal IoT Hub lapján válassza Eszközkezelés >Updates elemet a bal oldali navigációs sávon.

4. A Frissítések lapon válassza az Új frissítés importálása lehetőséget.

5. A Frissítés importálása lapon válassza a Kiválasztás a tárolóból lehetőséget.

6. A Tárfiókok lapon válasszon ki egy meglévő tárfiókot, vagy hozzon létre egy új fiókot a Storage-fiók kiválasztásával.

7. A Tárolók lapon válasszon ki egy meglévő tárolót, vagy hozzon létre egy új tárolót a Tároló kiválasztásával. A tárolóval a frissítési fájlokat importálhatja.

   

   Tipp.

   A korábbi frissítésekből származó fájlok véletlen importálásának elkerülése érdekében minden egyes frissítés importálásakor használjon egy új tárolót. Ha nem használ új tárolót, mindenképpen törölje a fájlokat a meglévő tárolóból.

8. A tárolólapon válassza a Feltöltés lehetőséget, húzza az egérrel vagy tallózással keresse meg a letöltött frissítési fájlokat, majd válassza a Feltöltés lehetőséget. A feltöltés után a fájlok megjelennek a tárolólapon.

9. Tekintse át és jelölje ki az importálni kívánt fájlokat, majd válassza a Kiválasztás lehetőséget.

   

10. A Frissítés importálása képernyőn válassza a Frissítés importálása lehetőséget.

    

Az importálási folyamat megkezdődik, és a képernyő a Frissítések képernyőre vált. Az importálás sikeres végrehajtása után megjelenik a Frissítések lapon. Az importálási folyamatról további információt az Eszközfrissítés frissítésének importálása című témakörben talál.

Válassza ki az eszközcsoportot

Az eszközre alkalmazott csoportcímkével telepítheti a frissítést az eszközcsoporton. A Csoportok és üzemelő példányok lapfülre kattintva a Frissítések lap tetején megtekintheti a csoportok és üzemelő példányok listáját, valamint a frissítési megfelelőségi diagramot.

A frissítésmegfelelőségi diagram a különböző megfelelőségi állapotokban lévő eszközök számát mutatja: a legújabb frissítés, az elérhető új frissítések és a folyamatban lévő frissítések. További információ: Eszközfrissítések megfelelősége.

A Csoportnév csoportban megjelenik az IoT Hubhoz csatlakoztatott eszközök összes eszközcsoportjának és az elérhető frissítéseknek a listája, amelyek hivatkozásokkal telepíthetik a frissítéseket az Állapot területen. Minden olyan eszköz, amely nem felel meg egy csoport eszközosztály-követelményeinek, érvénytelen csoportban jelenik meg. További információ a címkékről és csoportokról: Eszközcsoportok kezelése.

Látnia kell az oktatóanyagban beállított eszközt tartalmazó eszközcsoportot, valamint a csoport eszközeinek elérhető frissítéseit. Lehetséges, hogy frissítenie kell az oldalt. Ha ebből a nézetből szeretné üzembe helyezni a csoport számára elérhető legjobb frissítést, válassza az Üzembe helyezés lehetőséget a csoport mellett.

A frissítés üzembe helyezése

1. A Csoport részletei lapon válassza az Aktuális üzembe helyezés lapot, majd az Elérhető frissítések szakaszban válassza a kívánt frissítés melletti Üzembe helyezés lehetőséget. A csoport számára elérhető legjobb frissítés a legjobb kiemeléssel van jelölve.

   

2. Az Üzembe helyezés létrehozása lapon ütemezze az üzembe helyezés azonnali vagy jövőbeli indítását, majd válassza a Létrehozás lehetőséget.

   

   Tipp.

   Alapértelmezés szerint a kezdési dátum és időpont az aktuális időponttól számított 24 óra. Mindenképpen válasszon másik dátumot és időpontot, ha azt szeretné, hogy az üzembe helyezés hamarabb kezdődjön.

3. Az Üzembe helyezés részletei csoportban a Csoport részletei lapon az Állapot aktív állapotúvá válik. Az Elérhető frissítések területen a kijelölt frissítés megjelölése (üzembe helyezés).

   

4. A Frissítések lap Csoportok és üzemelő példányok lapján tekintse meg a megfelelőségi diagramot, és ellenőrizze, hogy a frissítés folyamatban van-e. Az eszköz sikeres frissítése után a megfelelőségi diagram és az üzembe helyezés részletei frissülnek, hogy tükrözzék ezt az állapotot.

   

Frissítéstelepítési előzmények megtekintése

1. Válassza az Üzembe helyezési előzmények lapot a Csoport részletei lap tetején, és válassza a létrehozott üzembe helyezés melletti részletes hivatkozást.

   

2. Az Üzembe helyezés részletei lapon válassza a Frissítés ikont a legújabb állapotadatok megtekintéséhez.

   

Az erőforrások eltávolítása

Ha már nincs szüksége az oktatóanyaghoz létrehozott erőforrásokra, törölheti őket.

1. Az Azure Portalon keresse meg az erőforrásokat tartalmazó erőforráscsoportot.
2. Ha törölni szeretné a csoport összes erőforrását, válassza az Erőforráscsoport törlése lehetőséget.
3. Ha csak néhány erőforrást szeretne törölni, jelölje ki az erőforrásokat a jelölőnégyzetek használatával, majd válassza a Törlés lehetőséget.

Kapcsolódó tartalom

• Eszközfrissítés az IoT Hubhoz szimulátorügynök használatával
• Eszközfrissítés és IoT Plug and Play
• Eszközösszetevők vagy csatlakoztatott érzékelők frissítése az Eszközfrissítéssel