Az IoT Edge frissítése

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

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.

sudo apt-get update

apt list -a aziot-edge

sudo apt-get install aziot-edge

yum list aziot-edge

sudo yum install aziot-edge

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

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.

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.

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.

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.

  sudo iotedge check --verbose
  

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

  sudo iotedge system status 
  

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

  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.

  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