Rövid útmutató: Az első IoT Edge-modul üzembe helyezése virtuális Linux-eszközön

A következőkre vonatkozik: IoT Edge 1.5

Important

Az IoT Edge 1.5 LTS a támogatott kiadás. Az IoT Edge 1.4 LTS 2024. november 12-én megszűnik. Ha egy korábbi kiadáson dolgozik, olvassa el az IoT Edge frissítése című témakört.

Ebben a rövid útmutatóban próbálja ki az Azure IoT Edge-et tárolóalapú kód virtuális Linux IoT Edge-eszközön való üzembe helyezésével. Az IoT Edge segítségével távolról kezelheti az eszközökön lévő kódokat, így több számítási feladatot küldhet a peremhálózatra. Ebben a rövid útmutatóban egy Azure-beli virtuális gépet használhat az IoT Edge-eszközéhez. Ezzel gyorsan létrehozhat egy tesztgépet, és törölheti azt, ha elkészült.

Ezen rövid útmutató segítségével megtanulhatja a következőket:

• IoT Hub létrehozása
• Regisztráljon egy IoT Edge-eszközt az IoT Hubon.
• Telepítse és indítsa el az IoT Edge-futtatókörnyezetet egy virtuális eszközön.
• Modul távoli üzembe helyezése IoT Edge-eszközön.

Ez a rövid útmutató végigvezeti egy IoT Edge-eszközre konfigurált Linux rendszerű virtuális gép létrehozásán. Ezután üzembe helyez egy modult az Azure Portalról az eszközére. Ez a rövid útmutató egy szimulált érzékelőmodult használ, amely hőmérséklet-, páratartalom- és nyomásadatokat hoz létre. A többi Azure IoT Edge-oktatóanyag az itt végzett munkára épül, és további modulokat helyez üzembe, amelyek elemzik a szimulált adatokat az üzleti elemzésekhez.

Ha nem rendelkezik aktív Azure-előfizetéssel, a kezdés előtt hozzon létre egy ingyenes fiókot .

Prerequisites

A környezet beállítása az Azure CLI-hez.

• Használja a Bash-környezetet az Azure Cloud Shellben. További információ: Az Azure Cloud Shell használatának első lépései.

  

• Ha a CLI referencia parancsokat helyben szeretnéd futtatni, telepítsd az Azure CLI-t. Ha Windows vagy macOS rendszeren fut, fontolja meg az Azure CLI-t egy Docker-konténerben futtatni. További információkért lásd: Az Azure CLI használata Docker-konténerben.

  • Ha egy helyileg telepített verziót használ, jelentkezzen be az Azure CLI-be az az login parancs futtatásával. Az azonosítási folyamat befejezéséhez kövesse a terminálján megjelenő lépéseket. További bejelentkezési lehetőségekért lásd: Hitelesítés az Azure-ba az Azure CLI használatával.

  • Amikor megjelenik a felszólítás, az első használatkor telepítse az Azure CLI bővítményt. További információ a bővítményekről: Bővítmények használata és kezelése az Azure CLI-vel.

  • Futtasd a az version parancsot, hogy megtudd a telepített verziót és függő könyvtárakat. A legújabb verzióra való frissítéshez futtassa a az upgrade parancsot.

Egy erőforráscsoport, amely az ebben a rövid útmutatóban használt összes erőforrást kezeli. Ez a rövid útmutató és az alábbi oktatóanyagok az IoTEdgeResources nevű példa erőforráscsoport nevét használják.

az group create --name IoTEdgeResources --location westus2

IoT Hub létrehozása

Indítsa el a rövid útmutatót egy IoT Hub azure CLI-vel való létrehozásával.

Ebben a rövid útmutatóban az IoT Hub ingyenes szintje működik. Ha korábban már használta az IoT Hubot, és már létrehozott egy központot, használhatja ezt az IoT Hubot.

Az alábbi kód egy ingyenes F1-központot hoz létre az IoTEdgeResources erőforráscsoportban. Cserélje le <hub-name> az IoT Hub egyedi nevére. Az IoT Hub létrehozása eltarthat néhány percig.

az iot hub create --resource-group IoTEdgeResources --name <hub-name> --sku F1 --partition-count 2

Ha hibaüzenetet kap, mert már van egy ingyenes IoT Hub az előfizetésében, módosítsa az SKU-t S1-re. Mindegyik előfizetés csak egy ingyenes IoT-központtal rendelkezhet. Ha hibaüzenet jelenik meg, hogy az IoT Hub neve nem érhető el, az azt jelenti, hogy valaki más már rendelkezik ezzel a névvel. Próbálkozzon új névvel.

IoT Edge-eszköz regisztrálása

Regisztráljon egy IoT Edge-eszközt az imént létrehozott IoT Hubon.

Hozzon létre egy eszközidentitást az IoT Edge-eszközhöz, hogy kommunikálhasson az IoT Hubbal. Az eszközidentitás a felhőben található, és egy egyedi eszközkapcsolati sztring használatával társítja a fizikai eszközt egy eszközidentitáshoz.

Mivel az IoT Edge-eszközök viselkedése és kezelése eltér a tipikus IoT-eszközöktől, deklarálja ezt az identitást IoT Edge-eszközként a --edge-enabled jelölő használatával.

1. Adja meg a következő parancsot az Azure Cloud Shellben egy myEdgeDevice nevű eszköz létrehozásához a központban.

   az iot hub device-identity create --device-id myEdgeDevice --edge-enabled --hub-name <hub-name>
   

   Ha hibaüzenetet kap az iothubowner szabályzatkulcsairól, győződjön meg arról, hogy a Cloud Shell az Azure-iot bővítmény legújabb verzióját futtatja.

2. Ellenőrizze az eszköz kapcsolati sztringjét, amely összekapcsolja a fizikai eszközt az IoT Hub identitásával. Tartalmazza az IoT Hub nevét, az eszköz nevét, valamint egy megosztott kulcsot, amely hitelesíti a köztük lévő kapcsolatokat. A következő szakaszban ismét ezt a kapcsolati sztringet használja az IoT Edge-eszköz beállításához.

   az iot hub device-identity connection-string show --device-id myEdgeDevice --hub-name <hub-name>
   

   A kapcsolati sztringnek például a következőhöz hasonlónak HostName=contoso-hub.azure-devices.net;DeviceId=myEdgeDevice;SharedAccessKey=<DEVICE-SHARED-ACCESS-KEY>kell lennie.

Az IoT Edge-eszköz konfigurálása

Hozzon létre egy virtuális gépet az Azure IoT Edge-futtatókörnyezettel.

Az IoT Edge-futtatókörnyezet minden IoT Edge-eszközön üzembe van helyezve, és három összetevőből áll. Az IoT Edge biztonsági démon minden alkalommal elindul, amikor egy IoT Edge-eszköz elindul, és elindítja az eszközt az IoT Edge-ügynök elindításával. Az IoT Edge-ügynök megkönnyíti a modulok üzembe helyezését és monitorozását az IoT Edge-eszközön, beleértve az IoT Edge hubot is. Az IoT Edge Hub kezeli az IoT Edge-eszköz moduljai, valamint az eszköz és az IoT Hub közötti kommunikációt.

A futtatókörnyezet konfigurálása során adjon meg egy eszközkapcsolati sztringet. Ez a sztring az Azure CLI-ből lesz lekérve. Ez a sztring társítja a fizikai eszközt az IoT Edge-eszköz identitásával az Azure-ban.

Az IoT Edge-eszköz üzembe helyezése

Ez a szakasz egy Azure Resource Manager-sablonnal hoz létre egy új virtuális gépet, és telepíti az IoT Edge-futtatókörnyezetet. Ha inkább saját Linux-eszközt szeretne használni, kövesse az egyetlen Linux IoT Edge-eszköz manuális kiépítésének telepítési lépéseit, majd térjen vissza ehhez a rövid útmutatóhoz.

Az Üzembe helyezés az Azure-ban gomb vagy a CLI-parancsok használatával hozzon létre egy IoT Edge-eszközt az előre összeállított iotedge-vm-deploy sablon alapján.

• Üzembe helyezés az IoT Edge Azure Resource Manager-sablonnal.

  

• Bash- vagy Cloud Shell-felhasználók esetén másolja a következő parancsot egy szövegszerkesztőbe, cserélje le a helyőrző szöveget az adataira, majd másolja a bash vagy a Cloud Shell ablakba:

  az deployment group create \
  --resource-group IoTEdgeResources \
  --template-uri "https://raw.githubusercontent.com/Azure/iotedge-vm-deploy/main/edgeDeploy.json" \
  --parameters dnsLabelPrefix='<REPLACE_WITH_VM_NAME>' \
  --parameters adminUsername='azureUser' \
  --parameters deviceConnectionString=$(az iot hub device-identity connection-string show --device-id myEdgeDevice --hub-name <REPLACE_WITH_HUB_NAME> -o tsv) \
  --parameters authenticationType='password' \
  --parameters adminPasswordOrKey="<REPLACE_WITH_PASSWORD>"
  

• PowerShell-felhasználók esetén másolja a következő parancsot a PowerShell-ablakba, majd cserélje le a helyőrző szöveget a saját adataira:

  az deployment group create `
  --resource-group IoTEdgeResources `
  --template-uri "https://raw.githubusercontent.com/Azure/iotedge-vm-deploy/main/edgeDeploy.json" `
  --parameters dnsLabelPrefix='<REPLACE_WITH_VM_NAME>' `
  --parameters adminUsername='azureUser' `
  --parameters deviceConnectionString=$(az iot hub device-identity connection-string show --device-id myEdgeDevice --hub-name <REPLACE_WITH_HUB_NAME> -o tsv) `
  --parameters authenticationType='password' `
  --parameters adminPasswordOrKey="<REPLACE_WITH_PASSWORD>"
  

Ez a sablon a következő paramétereket használja:

Parameter	Description
resource-group	Az az erőforráscsoport, amelyben az erőforrások létrejönnek. Használja a cikk során használt alapértelmezett IoTEdgeResource-eket , vagy adja meg egy meglévő erőforráscsoport nevét az előfizetésben.
template-uri	Mutató a használt Resource Manager-sablonra.
dnsLabelPrefix	A virtuális gép gazdagépnevének létrehozásához használt sztring. Cserélje le a helyőrző szöveget a virtuális gép nevére.
adminUsername	A virtuális gép rendszergazdai fiókjának felhasználóneve. Használja az azureUser példát, vagy adjon meg egy új felhasználónevet.
deviceConnectionString	Az IoT Hub eszközidentitásából származó kapcsolati sztring, amely az IoT Edge-futtatókörnyezet virtuális gépen való konfigurálására szolgál. A parancssori felület ezen a paraméteren belüli parancsa megragadja a kapcsolati sztringet. Cserélje le a helyőrző szöveget az IoT Hub nevére.
authenticationType	A rendszergazdai fiók hitelesítési módszere. Ez a rövid útmutató jelszó-hitelesítést használ, de ezt a paramétert sshPublicKey értékre is beállíthatja.
adminPasswordOrKey	A rendszergazdai fiók SSH-kulcsának jelszava vagy értéke. Cserélje le a helyőrző szöveget egy biztonságos jelszóra. A jelszónak legalább 12 karakter hosszúságúnak kell lennie, és a következők közül háromnak kell lennie: kisbetűk, nagybetűk, számjegyek és speciális karakterek.

Az üzembe helyezés befejezése után a PARANCSSOR JSON-formátumú kimenete tartalmazza a virtuális géphez való csatlakozáshoz szükséges SSH-adatokat. Másolja ki a kimenetek szakasz nyilvános SSH-bejegyzésének értékét. Az SSH-parancsnak például a következőhöz ssh azureUser@edge-vm.westus2.cloudapp.azure.comhasonlónak kell lennie.

Az IoT Edge-futtatókörnyezet állapotának megtekintése

A rövid útmutató többi parancsa az IoT Edge-eszközön történik, így láthatja, mi történik az eszközön. Ha virtuális gépet használ, csatlakozzon a géphez most a beállított rendszergazdai felhasználónév és az üzembe helyezési parancs által létrehozott DNS-név használatával. A DNS-nevet a virtuális gép áttekintő lapján is megtalálhatja az Azure Portalon. Használja a következő parancsot a virtuális géphez való csatlakozásra. Cserélje le a <admin-username> és <DNS-name> helyére a saját értékeit.

ssh <admin-username>@<DNS-name>

Miután csatlakozott a virtuális géphez, ellenőrizze, hogy a futtatókörnyezet telepítése és konfigurálása sikeresen megtörtént-e az IoT Edge-eszközön.

1. Ellenőrizze, hogy fut-e az IoT Edge. Az alábbi parancs ok állapotot ad vissza, ha az IoT Edge fut, vagy bármilyen szolgáltatáshibát jelez.

   sudo iotedge system status
   

   Tip

   A parancsok futtatásához iotedge emelt szintű jogosultságokra van szüksége. Ha kijelentkezik a gépről, és az IoT Edge-futtatókörnyezet telepítése után először jelentkezik be újra, az engedélyek automatikusan frissülnek. Addig is használja sudo a parancsok előtt.

2. Ha hibaelhárításra van szükség, kérje le a szolgáltatás naplóit.

   sudo iotedge system logs
   

3. Tekintse meg az IoT Edge-eszközön futó összes modult. Mivel a szolgáltatás először indult el, csak az edgeAgent modul fut. Az edgeAgent modul alapértelmezés szerint fut, és segít az eszközön üzembe helyezendő további modulok telepítésében és elindításában.

   sudo iotedge list
   

Ezzel konfigurálta az IoT Edge-eszközt. Készen áll a felhőalapú modulok futtatására.

Modul üzembe helyezése

Az Azure IoT Edge-eszköz kezelése a felhőből egy olyan modul üzembe helyezéséhez, amely eszköztelemetriaadatokat küld az IoT Hubnak.

Az Azure IoT Edge egyik fő képessége a kód üzembe helyezése az IoT Edge-eszközökön a felhőből. Az IoT Edge-modulok tárolókként implementálható végrehajtható csomagok. Ebben a szakaszban egy előre összeállított modult helyez üzembe a Microsoft Artifact Registry IoT Edge-modulok szakaszából.

Az ebben a szakaszban üzembe helyezhető modul egy érzékelőt szimulál, és generált adatokat küld. Ez a modul hasznos kódrészlet az IoT Edge használatbavételekor, mivel a szimulált adatokat fejlesztési és tesztelési célokra használhatja. Ha pontosan meg szeretné tekinteni a modult, megtekintheti a szimulált hőmérséklet-érzékelő forráskódját.

Az alábbi lépésekkel üzembe helyezheti az első modult.

1. Jelentkezzen be az Azure Portalra , és lépjen az IoT Hubra.

2. A bal oldali menü Eszközkezelés területén válassza az Eszközök lehetőséget.

3. Válassza ki a cél IoT Edge-eszköz eszközazonosítóját a listából.

   Új IoT Edge-eszköz létrehozásakor az állapotkódot 417 -- The device's deployment configuration is not set az Azure Portalon jeleníti meg. Ez az állapot normális, és azt jelenti, hogy az eszköz készen áll a modul üzembe helyezésére.

4. A felső sávon válassza a Modulok beállítása lehetőséget.

   Válassza ki az eszközön futtatni kívánt modulokat. Választhat azokból a modulokból, amelyeket saját maga készített, vagy lemezképeket egy tárolóregisztrációs adatbázisban. Ebben a rövid útmutatóban üzembe helyez egy modult a Microsoft tárolóregisztrációs adatbázisából.

5. Az IoT Edge-modulok szakaszban válassza a Hozzáadás lehetőséget, majd válassza az IoT Edge-modult.

6. Frissítse a következő modulbeállításokat:

   Setting	Value
   IoT-modul neve	SimulatedTemperatureSensor
   Kép URI-ja	mcr.microsoft.com/azureiotedge-simulated-temperature-sensor:latest
   Újraindítási szabályzat	always
   Kívánt állapot	running

7. Válassza a Tovább elemet: Útvonalak az útvonalak konfigurálásához.

8. Adjon hozzá egy útvonalat, amely a szimulált hőmérsékleti modul összes üzenetét elküldi az IoT Hubnak.

   Setting	Value
   Name	SimulatedTemperatureSensorToIoTHub
   Value	FROM /messages/modules/SimulatedTemperatureSensor/* INTO $upstream

9. Válassza a Tovább: Áttekintés és létrehozás lehetőséget.

10. Tekintse át a JSON-fájlt, majd válassza a Létrehozás lehetőséget. A JSON-fájl meghatározza az IoT Edge-eszközön üzembe helyezendő összes modult.

    Note

    Amikor új üzembe helyezést küld egy IoT Edge-eszközre, a rendszer semmit sem küld le az eszközére. Ehelyett az eszköz rendszeresen lekérdezi az IoT Hubot az új utasításokért. Ha az eszköz talál egy frissített üzembehelyezési jegyzékfájlt, az új üzembe helyezés adataival lekéri a modul lemezképeit a felhőből, majd helyileg elkezdi futtatni a modulokat. Ez a folyamat eltarthat néhány percig.

A modul üzembe helyezési adatainak létrehozása után a varázsló visszaküldi Az eszköz részletei lapra. Tekintse meg az üzembe helyezés állapotát a Modulok lapon.

Három modulnak kell megjelennie: $edgeAgent, $edgeHub és SimulatedTemperatureSensor. Ha egy vagy több modul igennel rendelkezik az üzembe helyezésben megadott , de az Eszköz által jelentett területen nem, az IoT Edge-eszköz továbbra is elindítja őket. Várjon néhány percet, és frissítse az oldalt.

Ha problémákat tapasztal a modulok üzembe helyezésében, az IoT Edge-eszközök hibaelhárításáról az Azure Portalon tudhat meg többet.

Létrehozott adatok megtekintése

Ebben a rövid útmutatóban létrehoz egy új IoT Edge-eszközt, és telepíti az IoT Edge-futtatókörnyezetet. Ezután az Azure Portal használatával üzembe helyezhet egy IoT Edge-modult az eszközön való futtatáshoz anélkül, hogy magát az eszközt módosítanák.

Ebben az esetben a leküldéses modul mintakörnyezeti adatokat hoz létre, amelyeket később tesztelhet. A szimulált érzékelő a gépet és a környezetet is figyeli a gép körül. Ez az érzékelő lehet például egy kiszolgálóteremben, egy gyár padlóján vagy egy szélturbinán. Az üzenet tartalmazza a környezeti hőmérsékletet és a páratartalmat, a gép hőmérsékletét és nyomását, valamint az időbélyeget. Az IoT Edge-oktatóanyagok a modul által létrehozott adatokat használják elemzési tesztadatokként.

Nyissa meg a parancssort az IoT Edge-eszközön, vagy használja az SSH-kapcsolatot az Azure CLI-ből. Ellenőrizze, hogy a felhőből üzembe helyezett modul fut-e az IoT Edge-eszközön:

sudo iotedge list

Tekintse meg a hőmérséklet-érzékelő modulból küldött üzeneteket:

sudo iotedge logs SimulatedTemperatureSensor -f

Tip

Az IoT Edge-parancsok megkülönböztetik a kis- és nagybetűket a modulnevekre való hivatkozáskor.

Erőforrások tisztítása

Az IoT Edge-oktatóanyagok folytatásához használja az ebben a rövid útmutatóban regisztrált és beállított eszközt. Ellenkező esetben törölje a díjak elkerülése érdekében létrehozott Azure-erőforrásokat.

Ha egy új erőforráscsoportban hozta létre a virtuális gépet és az IoT Hubot, törölheti a csoportot és az összes társított erőforrást. Ellenőrizze duplán az erőforráscsoport tartalmát, és győződjön meg arról, hogy semmit sem szeretne megtartani. Ha nem szeretné törölni a teljes csoportot, törölheti az egyes erőforrásokat.

Important

Egy erőforráscsoport törlése visszafordíthatatlan.

Törölje az IoTEdgeResources csoportot. Egy erőforráscsoport törlése eltarthat néhány percig.

az group delete --name IoTEdgeResources --yes

Ellenőrizze, hogy az erőforráscsoport törölve lett-e az erőforráscsoportok listájának megtekintésével.

az group list

Következő lépések

Ebben a rövid útmutatóban létrehozott egy IoT Edge-eszközt, és az Azure IoT Edge felhőfelületével kódot telepít az eszközön. Most egy teszteszközt használ, amely nyers adatokat hoz létre a környezetéről.

A következő oktatóanyagban megtudhatja, hogyan figyelheti az eszköz tevékenységét és állapotát az Azure Portalon.

IoT Edge-eszközök monitorozása