Olvasás angol nyelven

Megosztás a következőn keresztül:

Az IoT Edge frissítése

  • Cikk

A következőkre vonatkozik:IoT Edge 1.5 pipa IoT Edge 1.5 IoT Edge 1.4 pipa IoT Edge 1.4

Fontos

Az IoT Edge 1.5 LTS a támogatott kiadás. Az IoT Edge 1.4 LTS 2024. november 12-én megszűnik.

Ahogy a IoT Edge szolgáltatás új verziókat ad ki, frissítse az IoT Edge-eszközöket, hogy rendelkezzenek a legújabb funkciókkal és biztonsági fejlesztésekkel. Ez a cikk az IoT Edge-eszközök frissítéséről nyújt tájékoztatást, ha új verzió érhető el.

Az IoT Edge-eszköz két logikai összetevőjét frissíteni kell, ha újabb verzióra szeretne váltani.

  • Biztonsági alrendszer – Az eszközön fut, kezeli a biztonsági alapú feladatokat, és az eszköz indításakor elindítja a modulokat. A biztonsági alrendszer csak az eszközről frissíthető.

  • IoT Edge-futtatókörnyezet – Az IoT Edge-futtatókörnyezet az IoT Edge hub (edgeHub) és az IoT Edge-ügynök (edgeAgent) moduljaiból áll. Az üzembe helyezés szerkezetétől függően a futtatókörnyezet frissíthető az eszközről vagy távolról.

Frissítés

A cikk szakaszaiban frissítheti a biztonsági alrendszert és a futtatókörnyezeti tárolókat az eszközön.

Javításkiadások

A javításkiadások (például 1.5.1 és 1.5.2) közötti frissítéskor a frissítési sorrend nem fontos. A biztonsági alrendszert vagy a futtatókörnyezeti tárolókat a másik előtt vagy után is frissítheti. Frissítés a javításkiadások között:

  1. A biztonsági alrendszer frissítése
  2. A futtatókörnyezeti tárolók frissítése
  3. Verziók egyeztetésének ellenőrzése

A frissítési folyamatot bármikor elháríthatja.

Nagyobb vagy kisebb kiadások

Ha nagyobb vagy kisebb kiadások között frissít, például 1.4-ről 1.5-re, frissítse a biztonsági alrendszert és a futtatókörnyezeti tárolókat is. A kiadás előtt teszteljük a biztonsági alrendszert és a futtatókörnyezeti tároló verziókombinációt. A nagyobb vagy kisebb termékkiadások közötti frissítéshez:

  1. Az eszközön állítsa le az IoT Edge-et a paranccsal sudo systemctl stop iotedge és távolítsa el.

  2. Az eszközön frissítse a tárolómotort a Docker vagy a Moby használatával.

  3. Telepítse az IoT Edge-et az eszközön.

    Ha régi konfigurációt iotedge config importimportál, módosítsa a létrehozott /etc/aziot/config.toml fájl [agent.config] rendszerképét az edgeAgent 1.5-ös rendszerképének használatára.

    További információ: IoT Edge-eszközbeállítások konfigurálása.

  4. Az IoT Hubban frissítse a modul üzembe helyezését, hogy hivatkozzon a legújabb rendszermodulra.

  5. Az eszközön indítsa el az IoT Edge-et a következővel sudo iotedge config apply: .

A frissítési folyamatot bármikor elháríthatja.

A biztonsági alrendszer frissítése

Az IoT Edge biztonsági alrendszere natív összetevőket tartalmaz, amelyeket frissíteni kell az IoT Edge-eszköz csomagkezelőjével.

Ellenőrizze az eszközön futó biztonsági alrendszer verzióját a parancs iotedge versionhasználatával. Ha Az IoT Edge for Linuxot Windows rendszeren használja, a verzió ellenőrzéséhez SSH-t kell használnia a Linux rendszerű virtuális gépre.

Linux x64-eszközökön használja apt-get vagy a megfelelő csomagkezelővel frissítse a biztonsági alrendszert a legújabb verzióra.

Frissítés apt:

Bash 
sudo apt-get update

Megjegyzés

Az IoT Edge telepítéséhez szükséges előzetes lépések a Microsofttól a legújabb adattárkonfiguráció lekéréséhez szükségesek.

Ellenőrizze, hogy az IoT Edge mely verziói érhetők el:

Bash 
apt list -a aziot-edge

IoT Edge frissítése:

Bash 
sudo apt-get install aziot-edge

A futtatás apt-get install aziot-edge frissíti a biztonsági alrendszert, és telepíti az identitásszolgáltatást, aziot-identity-servicemint szükséges függőséget.

Ezután alkalmazza újra a konfigurációt a rendszer teljes frissítésének biztosítása érdekében.

Bash 
sudo iotedge config apply

A futtatókörnyezeti tárolók frissítése

Az IoT Edge-ügynök és az IoT Edge Hub-tárolók frissítésének módja attól függ, hogy használ-e működés közbeni címkéket (például 1.5) vagy adott címkéket (például 1.5.1-et) az üzembe helyezés során.

Ellenőrizze az IoT Edge-ügynök és az IoT Edge Hub-modulok aktuális verzióját az eszközön a parancsok vagy iotedge logs edgeHuba parancsok iotedge logs edgeAgent használatával. Ha Windowson az IoT Edge for Linuxot használja, a futtatókörnyezeti modul verzióinak ellenőrzéséhez SSH-t kell használnia a Linux rendszerű virtuális gépre.

Képernyőkép arról, hogy hol található a tároló verziója a konzolnaplókban.

Az IoT Edge-címkék ismertetése

Az IoT Edge-ügynök és az IoT Edge hub lemezképei a hozzájuk társított IoT Edge-verzióval vannak megjelölve. A futtatókörnyezeti rendszerképekkel kétféleképpen használhat címkéket:

  • Gördülő címkék – A verziószámnak csak az első két értékével szerezheti be a számjegyeknek megfelelő legújabb képet. Az 1.5 például mindig frissül, amikor új kiadás jelenik meg, hogy a legújabb 1.5.x verzióra mutasson. Ha az IoT Edge-eszköz tároló-futtatókörnyezete ismét lekéri a lemezképet, a futtatókörnyezet moduljai a legújabb verzióra frissülnek. Az Azure Portal alapértelmezett üzembe helyezései működés közbeni címkékre. Ezt a megközelítést fejlesztési célokra javasoljuk.

  • Adott címkék – A verziószám mindhárom értékével explicit módon állíthatja be a képverziót. Az 1.5.0 például nem változik a kezdeti kiadás után. Ha készen áll a frissítésre, deklarálhat egy új verziószámot az üzembe helyezési jegyzékben. Ez a megközelítés éles környezetben javasolt.

Gördülő címke lemezképének frissítése

Ha üzemelő címkéket használ az üzemelő példányban (például mcr.microsoft.com/azureiotedge-hub:1.5), akkor az eszközön a tároló futtatókörnyezetét kell kikényszerítenie a lemezkép legújabb verziójának lekéréséhez.

Törölje a rendszerkép helyi verzióját az IoT Edge-eszközről. Windows rendszerű gépeken a biztonsági alrendszer eltávolítása a futtatókörnyezeti rendszerképeket is eltávolítja, így nem kell újra elvégeznie ezt a lépést.

Bash 
docker rmi mcr.microsoft.com/azureiotedge-hub:1.5
docker rmi mcr.microsoft.com/azureiotedge-agent:1.5

Előfordulhat, hogy a képek eltávolításához az erőjelzőt -f kell használnia.

Az IoT Edge szolgáltatás lekéri a futtatókörnyezeti rendszerképek legújabb verzióit, és automatikusan elindítja őket az eszközön.

Adott címkekép frissítése

Ha adott címkéket használ az üzemelő példányban (például mcr.microsoft.com/azureiotedge-hub:1.5), csak frissítenie kell a címkét az üzembe helyezési jegyzékben, és alkalmaznia kell a módosításokat az eszközre.

  1. Az Azure Portal IoT Hubján válassza ki az IoT Edge-eszközt, és válassza a Modulok beállítása lehetőséget.

  2. A Modulok lapon válassza a Futtatókörnyezet beállításai lehetőséget.

  3. A futtatókörnyezet beállításaiban frissítse a Rendszerkép URI értékét az Edge Agent szakaszban a kívánt verzióval. Például mcr.microsoft.com/azureiotedge-agent:1.5 még ne válassza az Alkalmaz lehetőséget.

  4. Válassza az Edge Hub lapot, és frissítse a Kép URI értékét ugyanazzal a kívánt verzióval. Például: mcr.microsoft.com/azureiotedge-hub:1.5.

  5. Kattintson az Alkalmaz gombra a módosítások mentéséhez.

  6. Válassza a Véleményezés + létrehozás lehetőséget, tekintse át az üzembe helyezést a JSON-fájlban látható módon, majd válassza a Létrehozás lehetőséget.

Partnermodul URI-k frissítése

Ha partnermodulokat használ, frissítse a modultelepítéseket a partner által biztosított rendszerkép URI-kkal. Lépjen kapcsolatba az IoT Edge-modul közzétevővel a frissített tárolólemezkép URI-jának beszerzéséhez. Frissítse az eszközkonfigurációkat a közzétevő által biztosított új kép URI-val.

  1. Jelentkezzen be az Azure Portalra , és lépjen az IoT Hubra.
  2. A bal oldali panelen válassza az Eszközök lehetőséget az Eszközfelügyelet menüben.
  3. Válassza ki a partnermodult használó IoT Edge-eszközt a listából.
  4. A felső sávon válassza a Modulok beállítása lehetőséget.
  5. Válassza ki azt az IoT Edge-partnermodult, amelyet frissíteni szeretne az új kép URI-val.
  6. Frissítse a kép URI-értékét a közzétevő által biztosított új kép URI-val.
  7. Kattintson az Alkalmaz gombra a módosítások mentéséhez.
  8. Válassza a Véleményezés + létrehozás lehetőséget, tekintse át az üzembe helyezést a JSON-fájlban látható módon, majd válassza a Létrehozás lehetőséget.

Verziók egyeztetésének ellenőrzése

  1. Az eszközön iotedge version ellenőrizze a biztonsági alrendszer verzióját. A kimenet tartalmazza a fő-, al- és változatverziószámokat. Például: iotedge 1.5.13.

  2. Az eszköz központi telepítési futtatókörnyezeti beállításaiban ellenőrizze, hogy az edgeHub és az edgeAgent rendszerkép URI-verziói megfelelnek-e a biztonsági alrendszer fő- és alverziójának. Ha a biztonsági alrendszer verziója 1.5.15, a rendszerképek verziója 1.5 lesz. Például mcr.microsoft.com/azureiotedge-hub:1.5 és mcr.microsoft.com/azureiotedge-agent:1.5.

Megjegyzés

Frissítse az IoT Edge biztonsági alrendszerét és a futtatókörnyezeti tárolókat ugyanarra a támogatott kiadási verzióra. Bár a nem egyező verziók támogatottak, nem teszteltük az összes verziókombinációt.

Az Azure IoT Edge legújabb verziójának megkereséséhez tekintse meg az Azure IoT Edge kiadásait.

Hibaelhárítás

A rendszer naplóit bármikor megtekintheti az alábbi parancsok eszközről való futtatásával.

  • Kezdje el a hibaelhárítást az ellenőrző paranccsal. Konfigurációs és kapcsolati tesztek gyűjteményét futtatja a gyakori problémákhoz.

    Bash 
    sudo iotedge check --verbose

  • Az IoT Edge-rendszer állapotának megtekintéséhez futtassa a következőt:

    Bash 
    sudo iotedge system status

  • A gazdagép-összetevők naplóinak megtekintéséhez futtassa a következőt:

    Bash 
    sudo iotedge system logs

  • Az edgeAgenttel és az edgeHubbal jelentett ismétlődő problémák ellenőrzéséhez futtassa a következőt:

    Mindenképpen cserélje le <module> a saját modulnevét. Ha nincsenek problémák, akkor nem jelenik meg kimenet.

    Bash 
    sudo iotedge logs <module>

További információ: Az IoT Edge-eszköz hibaelhárítása.

Következő lépések

Tekintse meg a legújabb Azure IoT Edge-kiadásokat.

Naprakészen tarthatja a legújabb frissítéseket és bejelentéseket az Eszközök internetes blogján