Eszközfrissítési ügynök kiépítése

  • Cikk

Az Eszközfrissítési modul ügynök más rendszerfolyamatokkal és az IoT Edge-modulokkal együtt is futtatható, amelyek ugyanannak a logikai eszköznek a részeként csatlakoznak az IoT Hubhoz. Ez a szakasz azt ismerteti, hogyan építheti ki az eszközfrissítési ügynököt modulidentitásként.

Eszközfrissítési ügynök módosítása a GA-kiadásnál

Ha az Eszközfrissítési ügynök verzióit használja, migráljon az ügynök legújabb 1.0.0-s verziójára, amely a GA-verzió. A módosításokról és a frissítés módjáról lásd a GA-ügynököt

Az IoT-eszköz ikereszközének Eszköztulajdonságok szakaszában ellenőrizheti az Eszközfrissítési ügynök és a Kézbesítésoptimalizálás ügynök telepített verzióját. További információ az eszköztulajdonságokról az ADU Core Interface alatt.

Modulidentitás és eszközidentitás

Az IoT Hubban az egyes eszközidentitások alatt legfeljebb 50 modulidentitás hozható létre. Minden modulidentitás implicit módon létrehoz egy modul ikerpéldányt. Az eszközoldalon az IoT Hub eszközoldali SDK-jai lehetővé teszik olyan modulok létrehozását, amelyek mindegyike független kapcsolatot nyit meg az IoT Hubbal. A modulidentitás és a modul ikerpéldánya hasonló képességeket biztosít, mint az eszközidentitás és az ikereszköz, de részletesebben. További információ az IoT Hub modulidentitásairól

Ha egy eszközszintű ügynökről migrál, hogy az ügynök moduli identitásként legyen hozzáadva az eszközön, távolítsa el az ikereszközön keresztül kommunikáló régebbi ügynököt. Amikor az Eszközfrissítési ügynököt modulidentitásként helyezi üzembe, az eszköz és az Eszközfrissítési szolgáltatás közötti kommunikáció a Modul ikerpéldányán keresztül történik, ezért ne felejtse el megjelölni az eszköz ikermodulját csoportok létrehozásakor, és minden kommunikációnak a modul ikerpéldányán keresztül kell történnie.

Eszközfrissítés támogatása

Az eszközfrissítés jelenleg az alábbi IoT-eszközt támogatja a levegőfrissítési típusokon keresztül:

Előfeltételek

Ha csomagalapú frissítésekhez állítja be az IoT-eszközt/IoT Edge-eszközt, adja hozzá a packages.microsoft.com a gép adattáraihoz az alábbi lépések végrehajtásával:

  1. Jelentkezzen be arra a gépre vagy IoT-eszközre, amelyre telepíteni kívánja az eszközfrissítési ügynököt.

  2. Nyisson meg egy terminálablakot.

  3. Telepítse az eszköz operációs rendszerének megfelelő adattár-konfigurációt.

    curl https://packages.microsoft.com/config/ubuntu/18.04/multiarch/prod.list > ./microsoft-prod.list

  4. Másolja a létrehozott listát a sources.list.d könyvtárba.

    sudo cp ./microsoft-prod.list /etc/apt/sources.list.d/

  5. Telepítse a Microsoft GPG nyilvános kulcsát.

    curl https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.gpg

    sudo cp ./microsoft.gpg /etc/apt/trusted.gpg.d/

Az eszközfrissítési ügynök kiépítése modulidentitásként

Ez a szakasz azt ismerteti, hogyan építheti ki az eszközfrissítési ügynököt modulidentitásként a

  • IoT Edge-kompatibilis eszközök vagy
  • Nem Edge IoT-eszközök vagy
  • Egyéb IoT-eszközök.

Annak ellenőrzéséhez, hogy engedélyezve van-e az IoT Edge az eszközön, tekintse meg az IoT Edge telepítési utasításait.

Kövesse az alábbi szakaszok mindegyikét vagy bármelyikét az eszközfrissítési ügynök hozzáadásához a kezelt IoT-eszköz típusa alapján.

IoT Edge-kompatibilis eszközökön

Kövesse az alábbi utasításokat az Eszközfrissítési ügynök üzembe helyezéséhez az IoT Edge-kompatibilis eszközökön.

  1. Kövesse az utasításokat egyetlen Linux IoT Edge-eszköz manuális kiépítéséhez.

  2. Telepítse az Eszközfrissítés képfrissítési ügynököt.

    Mintaképeket biztosítunk az Itt található eszközök adattárban. A swUpdate fájl az alap kép, amelyet egy Raspberry Pi B3+ táblára villoghat. A .gz fájl az IoT Hub eszközfrissítésén keresztül importálandó frissítés. Példa: Hogyan villoghat a kép az IoT Hub-eszközén.

  3. Telepítse az Eszközfrissítés csomagfrissítési ügynökét.

    • Az packages.microsoft.com legújabb ügynökverziói esetén: Frissítse a csomaglistákat az eszközön, és telepítse az Eszközfrissítés ügynökcsomagot és függőségeit a következő használatával:

      sudo apt-get update

      sudo apt-get install deviceupdate-agent

    • Bármely "rc", azaz kiadásra jelölt ügynökverzió esetében az Artifactsből : Töltse le a .deb fájlt arra a gépre, amelyen telepíteni szeretné az Eszközfrissítési ügynököt, majd:

      sudo apt-get install -y ./"<PATH TO FILE>"/"<.DEB FILE NAME>"

    • Ha leválasztott eszközhelyzethez állít be MCC-t, telepítse a Kézbesítésoptimalizálás APT beépülő modult:

      sudo apt-get install deliveryoptimization-plugin-apt

  4. Az eszközfrissítési ügynök telepítése után az alábbi parancs futtatásával szerkesztenie kell az eszközfrissítés konfigurációs fájlját.

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

    Módosítsa a connectionType értékét "AIS" értékre azon ügynökök esetében, akik az IoT Identity Service-t fogják használni a kiépítéshez. A Csatlakozás ionData mezőnek üres sztringnek kell lennie. Vegye figyelembe, hogy a "Hely érték itt" címkével ellátott összes értéket be kell állítani. Lásd : DU-ügynök konfigurálása.

  5. Most már készen áll az eszközfrissítési ügynök elindítására az IoT-eszközön.

IoT Edge nélküli Iot Linux-eszközökön

Kövesse ezeket az utasításokat az eszközfrissítési ügynök üzembe helyezéséhez az IoT Linux-eszközökön.

  1. Telepítse az IoT Identity Service-t, és adja hozzá a legújabb verziót az IoT-eszközhöz az Azure IoT Identity Service telepítésével kapcsolatos utasításokat követve.

  2. Konfigurálja az IoT Identity Service-t az Azure IoT Identity Service konfigurálásával.

  3. Végül telepítse az Eszközfrissítési ügynököt. Itt az eszközökben biztosítunk mintaképeket, a swUpdate fájl az alaprendszerkép, amelyet egy Raspberry Pi B3+ táblára lehet villogni, és a .gz fájl az IoT Hub eszközfrissítésén keresztül importálandó frissítés. Tekintse meg a kép IoT Hub-eszközre való felvillanását szemléltető példát.

  4. Az eszközfrissítési ügynök telepítése után az alábbi parancs futtatásával szerkesztenie kell az eszközfrissítés konfigurációs fájlját.

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

    Módosítsa a connectionType értékét "AIS" értékre azon ügynökök esetében, akik az IoT Identity Service-t fogják használni a kiépítéshez. A Csatlakozás ionData mezőnek üres sztringnek kell lennie. Vegye figyelembe, hogy a "Hely érték itt" címkével ellátott összes értéket be kell állítani. Lásd : DU-ügynök konfigurálása.

  5. Most már készen áll az eszközfrissítési ügynök elindítására az IoT-eszközön.

Egyéb IoT-eszközök

Az eszközfrissítési ügynök az IoT Identity szolgáltatás nélkül is konfigurálható teszteléshez vagy korlátozott eszközökhöz. Az eszközfrissítési ügynök üzembe helyezéséhez kövesse az alábbi lépéseket egy kapcsolati sztring használatával (a modulból vagy az eszközről).

  1. Mintaképeket biztosítunk az Itt található eszközök adattárban. A swUpdate fájl az alap kép, amelyet egy Raspberry Pi B3+ táblára villoghat. A .gz fájl az IoT Hub eszközfrissítésén keresztül importálandó frissítés. Példa: Hogyan villoghat a kép az IoT Hub-eszközén.

  2. Jelentkezzen be a gépre vagy az IoT Edge-eszközre/IoT-eszközre.

  3. Nyisson meg egy terminálablakot.

  4. Adja hozzá a kapcsolati sztring az Eszközfrissítés konfigurációs fájlhoz:

    1. Írja be az alábbiakat a terminálablakba:

    2. Az elsődleges kapcsolati sztring másolása

      • Ha az Eszközfrissítési ügynök modulként van konfigurálva, másolja a modul elsődleges kapcsolati sztring.
      • Ellenkező esetben másolja az eszköz elsődleges kapcsolati sztring.

    3. Adja meg a másolt elsődleges kapcsolati sztring a du-config.json fájl "connectionData" mezőjének értékére. Vegye figyelembe, hogy a "Hely érték itt" címkével ellátott összes értéket be kell állítani. Lásd : DU-ügynök konfigurálása

  5. Most már készen áll az eszközfrissítési ügynök elindítására az IoT-eszközön.

Az eszközfrissítési ügynök indítása

Ez a szakasz azt ismerteti, hogyan indíthatja el és ellenőrizheti az Eszközfrissítési ügynököt az IoT-eszközön sikeresen futó modulidentitásként.

  1. Jelentkezzen be az eszközfrissítési ügynököt tartalmazó gépre vagy eszközre.

  2. Nyisson meg egy terminálablakot, és írja be az alábbi parancsot.

    sudo systemctl restart deviceupdate-agent

  3. Az ügynök állapotát az alábbi paranccsal ellenőrizheti. Ha bármilyen problémát tapasztal, tekintse meg ezt a hibaelhárítási útmutatót.

    sudo systemctl status deviceupdate-agent

    Az állapot okának kell megjelennie.

  4. Az IoT Hub portálon lépjen az IoT-eszközre vagy az IoT Edge-eszközökre az Eszközfrissítési ügynökkel konfigurált eszköz megkereséséhez. Itt az eszközfrissítési ügynök modulként fog futni. Példa:

    Az Eszközfrissítés modul nevének diagramja.

Eszközfrissítési ügynök létrehozása és futtatása

Saját ügyféleszköz-frissítési ügynököt is létrehozhat és módosíthat. Kövesse az utasításokat az eszközfrissítési ügynök forrásból való létrehozásához .

Miután az ügynök sikeresen elkészült, ideje futtatni az ügynököt. Most végezze el az ügynök képbe való beépítéséhez szükséges módosításokat. Útmutatásért tekintse meg, hogyan módosíthatja az eszközfrissítési ügynököt.

Hibaelhárítási útmutató

Ha problémákba ütközik, tekintse át az IoT Hub eszközfrissítésének hibaelhárítási útmutatóját , amely segít feloldani a lehetséges problémákat, és összegyűjteni a Microsoftnak nyújtandó szükséges információkat.

Következő lépések

Az IoT Hub eszközfrissítésének egyszerű bemutatásához az alábbi oktatóanyagokat használhatja: