Rövid útmutató: Az első IoT Edge modul üzembe helyezése Windows eszközön

A következőre vonatkozik: IoT Edge 1.5

Fontos

IoT Edge 1.5 LTS a támogatott kiadás. IoT Edge 1,4 LTS 2024. november 12-én véget ért. Ha korábbi kiadást használ, tekintse meg a Update IoT Edge című témakört.

Próbálja ki Azure IoT Edge ebben a rövid útmutatóban, ha tárolóalapú kódot helyez üzembe egy Linuxon Windows IoT Edge eszközön. IoT Edge lehetővé teszi a kód távolról történő kezelését az eszközökön, hogy több számítási feladatot küldjön a peremhálózatra. Ebben a gyorsútmutatóban azt javasoljuk, hogy használja saját Windows ügyféleszközét, hogy megtapasztalja, milyen egyszerűen használható az Azure IoT Edge Linuxhoz, amely Windows rendszereken fut. Ha Windows Server vagy Azure virtuális gépet szeretne használni az üzembe helyezés létrehozásához, kövesse a linuxos Azure IoT Edge telepítésével és kiépítésével kapcsolatos útmutató lépéseit egy Windows eszközön.

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 a linuxos IoT Edge Windows futtatókörnyezetben az eszközön.
• Modul távoli üzembe helyezése IoT Edge eszközön, és telemetriai adatok küldése.

Ez a rövid útmutató bemutatja, hogyan állíthatja be a linuxos Azure IoT Edge Windows eszközön. Ezután üzembe helyez egy modult a Azure portálon az eszközén. A használt modul egy szimulált érzékelő, amely hőmérséklet-, páratartalom- és nyomásadatokat hoz létre. Az egyéb Azure IoT Edge oktatóanyagok az itt végzett munkára épülnek olyan modulok üzembe helyezésével, 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 felszabadító fiókot.

Előfeltételek

Az Azure CLI környezetének előkészítése.

• Használja a Bash-környezetet a Azure Cloud Shell. További információért lásd: Ismerkedés az Azure Cloud Shell-lel.

  

• Ha helyileg szeretné futtatni a CLI-referenciaparancsokat, telepítse az Azure CLI-t. Ha Windows vagy macOS rendszeren fut, érdemes lehet Azure CLI egy Docker-tárolóban futtatni. További információ: A Azure CLI futtatása Docker-tárolóban.

  • Ha helyi telepítést használ, jelentkezzen be az Azure CLI-be az az login paranccsal. A hitelesítési folyamat befejezéséhez kövesse a terminálon megjelenő lépéseket. További bejelentkezési lehetőségekért lásd: Az Azure CLI használatával történő Azure-hitelesítést.

  • Amikor a rendszer kéri, először telepítse a 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.

Hozzon létre egy felhőbeli erőforráscsoportot az ebben a rövid útmutatóban használt összes erőforrás kezeléséhez.

az group create --name IoTEdgeResources --location westus2

Győződjön meg arról, hogy a IoT Edge eszköz megfelel a következő követelményeknek:

• Rendszerkövetelmények

  • Windows 10¹/11 (Pro, Enterprise, IoT Enterprise) _{¹ Windows 10 minimális 17763-as build az összes jelenlegi kumulatív frissítéssel telepítve.}

• Hardverkövetelmények

  • Minimális szabad memória: 1 GB
  • Minimális szabad lemezterület: 10 GB

IoT Hub létrehozása

Először hozzon létre egy IoT Hubot a Azure CLI használatával.

Ehhez a rövid útmutatóhoz a Azure IoT Hub ingyenes szintje használható. Ha korábban IoT Hub-ot használt, és már rendelkezik hubbal, használhatja ezt az IoT hubot.

Az alábbi kód egy ingyenes F1-központot hoz létre az erőforráscsoportban IoTEdgeResources. 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üzenet jelenik meg, mert már van egy ingyenes központ az előfizetésében, módosítsa az SKU-t a következőre S1: . Ha hibaüzenet jelenik meg, hogy az IoT Hub neve nem érhető el, 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 újonnan létrehozott IoT Hubon.

Hozzon létre egy eszközidentitást a szimulált eszközhöz, hogy az kommunikálhasson az IoT Hubbal. Az eszközidentitás a felhőben található, és az eszközhöz való társítás során egyedi eszközkapcsolati karakterláncot használunk egy fizikai eszköz eszközidentitásához való hozzárendeléséhez.

IoT Edge eszközök a tipikus IoT-eszközöknél eltérően viselkednek és kezelhetők. A --edge-enabled jelző használatával deklarálhatja, hogy ez az identitás egy IoT Edge eszközhöz tartozik.

1. A Azure Cloud Shell írja be a következő parancsot 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 iothubowner házirendkulcsokkal kapcsolatos hibaüzenet jelenik meg, győződjön meg arról, hogy Cloud Shell a Azure IoT bővítmény legújabb verzióját futtatja.

2. Tekintse meg az eszközéhez tartozó csatlakozási karakterláncot, amely összekapcsolja a fizikai eszközt az IoT Hub-lal lévő identitásával. Tartalmazza az IoT Hub nevét, az eszköz nevét és egy megosztott kulcsot, amely hitelesíti a kettő közötti kapcsolatokat.

   az iot hub device-identity connection-string show --device-id myEdgeDevice --hub-name {hub_name}
   

3. Másolja le a connectionString kulcs értékét a JSON-kimenetből, és mentse. Ez az érték az eszköz kapcsolati karakterlánca. Ezzel konfigurálhatja a IoT Edge futtatókörnyezetet a következő szakaszban.

   A connection string például a HostName=contoso-hub.azure-devices.net;DeviceId=myEdgeDevice;SharedAccessKey=<DEVICE_SHARED_ACCESS_KEY>-hoz hasonlóan kell kinéznie.

A IoT Edge futtatókörnyezet telepítése és indítása

Telepítse az IoT Edge-t a Linux alrendszerhez Windows rendszeren a saját eszközén, és konfigurálja az eszköz kapcsolati karakterláncával.

Futtassa a következő PowerShell-parancsokat azon a céleszközön, amelyen az Azure IoT Edge for Linux on Windows rendszert szeretné üzembe helyezni. Távoli céleszközre a PowerShell használatával történő üzembe helyezéshez a Távoli PowerShell használatával hozzon létre kapcsolatot egy távoli eszközzel, és futtassa ezeket a parancsokat távolról az eszközön.

1. Egy emelt szintű PowerShell-munkamenetben futtassa a következő parancsot a Hyper-V engedélyezéséhez. További információ: Hyper-V Windows 10.

   Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All
   

2. Egy emelt szintű PowerShell-munkamenetben futtassa az alábbi parancsokat a linuxos IoT Edge letöltéséhez Windows.

   • X64/AMD64

     $msiPath = $([io.Path]::Combine($env:TEMP, 'AzureIoTEdge.msi'))
     $ProgressPreference = 'SilentlyContinue'
     Invoke-WebRequest "https://aka.ms/AzEFLOWMSI_1_5_LTS_X64" -OutFile $msiPath
     

   • ARM64

     $msiPath = $([io.Path]::Combine($env:TEMP, 'AzureIoTEdge.msi'))
     $ProgressPreference = 'SilentlyContinue'
     Invoke-WebRequest "https://aka.ms/AzEFLOWMSI_1_5_LTS_ARM64" -OutFile $msiPath
     

3. Telepítse a Linuxra készült IoT Edge-et Windows rendszeren az eszközére.

   Start-Process -Wait msiexec -ArgumentList "/i","$([io.Path]::Combine($env:TEMP, 'AzureIoTEdge.msi'))","/qn"
   

4. Állítsa be a végrehajtási szabályzatot AllSigned a céleszközön, ha még nem tette meg. Az aktuális végrehajtási szabályzatot egy emelt szintű PowerShell-parancssorban ellenőrizheti a következő használatával:

   Get-ExecutionPolicy -List
   

   Ha a végrehajtási szabályzat local machine nem AllSigned, állítsa be a végrehajtási szabályzatot az alábbi paranccsal:

   Set-ExecutionPolicy -ExecutionPolicy AllSigned -Force
   

5. Hozzon létre egy IoT Edge telepítést Linuxhoz Windowsra.

   Deploy-Eflow
   

6. A licencfeltételek elfogadásához írja be az Y értéket.

7. Adja meg az O vagy az R kapcsolót a választható diagnosztikai adatok be- vagy kikapcsolásához a beállításoktól függően. A sikeres üzembe helyezés az alábbi képen látható.

   

8. Használja az előző szakaszban lekért eszközkapcsolati karakterláncot az eszköz kiépítéséhez. Cserélje le a helyőrző szöveget a saját értékére.

   Provision-EflowVm -provisioningType ManualConnectionString -devConnString "<CONNECTION_STRING_HERE>"
   

A IoT Edge eszköz most már konfigurálva van. Az eszköz készen áll a felhőben üzembe helyezett modulok futtatására.

Modul üzembe helyezése

Az Azure IoT Edge eszköz felhőalapú kezelése érdekében helyezzen üzembe egy modult, amely telemetriai adatokat küld az IoT Hub számára.

A Azure IoT Edge egyik legfontosabb képessége a kód üzembe helyezése a IoT Edge-eszközökre a felhőből. IoT Edge modulok tárolókként megvalósított végrehajtható csomagok. Ebben a szakaszban egy előre összeállított modult fog üzembe helyezni 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 a IoT Edge használatbavételekor, mivel a szimulált adatokat fejlesztési és tesztelési célokra használhatja. Ha pontosan szeretné látni a modult, megtekintheti a szimulált hőmérséklet-érzékelő forráskódját.

Az első modul üzembe helyezéséhez kövesse az alábbi lépéseket.

1. Jelentkezzen be az Azure portálra, és menjen az IoT Hubhoz.

2. A bal oldali menüben válassza az Eszközök lehetőséget az Eszközfelügyelet menüben.

3. Válassza ki a céleszköz eszközazonosítóját az eszközök listájából.

   Feljegyzés

   Amikor új IoT Edge eszközt hoz létre, az Azure portálon megjeleníti a 417 -- The device's deployment configuration is not set állapotkódot. 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 a már létrehozott modulok, a Microsoft Artifact Registry moduljai vagy a saját maga által létrehozott modulok közül. Ebben a rövid útmutatóban üzembe helyez egy modult a Microsoft Artifact Registryből.

5. A IoT Edge modulok szakaszban válassza a Add majd a IoT Edge Modul lehetőséget.

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

   Beállítás	Érték
   IoT-modul neve	SimulatedTemperatureSensor
   Kép URI-ja	mcr.microsoft.com/azureiotedge-simulated-temperature-sensor:latest
   Újraindítási szabályzat	mindig
   Kívánt állapot	futtatás

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 a IoT Hub.

   Beállítás	Érték
   Név	SimulatedTemperatureSensorToIoTHub
   Érték	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 határozza meg az IoT Edge eszközön üzembe helyezendő összes modult.

    Feljegyzés

    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 IoT Hub az új utasításokat. 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 a Specified in Deployment alatt Yes értékkel rendelkezik, de az Reported by Device alatt nem, az IoT Edge eszköz továbbra is elindítja őket. Várjon néhány percet, majd frissítse a lapot.

Ha problémákat tapasztal a modulok üzembe helyezésében, tekintse meg a Troubleshoot IoT Edge eszközöket a Azure portálról.

A létrejött adatok megtekintése

Ebben a rövid útmutatóban létrehozott egy új IoT Edge eszközt, és telepítette a IoT Edge futtatókörnyezetet. Ezután az Azure portálon egy IoT Edge modult helyezett üzembe, amely az eszközön fut, anélkül hogy magát az eszközt módosítania kellene.

A leküldéses modul mintakörnyezeti adatokat hoz létre, amelyeket később tesztelhet. A szimulált érzékelő monitorozza a gépet és a környezetet is a gép körül. Ez az érzékelő lehet például egy kiszolgálóteremben, egy üzemben vagy akár szélturbinán. Az általa küldött üzenetek közé tartozik a környezeti hőmérséklet és a páratartalom, a gép hőmérséklete és nyomása, valamint az időbélyeg. IoT Edge oktatóanyagok a modul által létrehozott adatokat használják elemzési tesztadatokként.

1. Jelentkezzen be a Windows rendszeren futó Linuxos IoT Edge virtuális gépébe a következő parancs használatával a PowerShell munkamenetben:

   Connect-EflowVm
   

   Feljegyzés

   Csak annak a felhasználónak az SSH-fiókja engedélyezett a virtuális géphez való hozzáférésre, aki létrehozta azt.

2. Bejelentkezés után ellenőrizze a futó IoT Edge modulok listáját a következő Linux-paranccsal:

   sudo iotedge list
   

   

3. Tekintse meg a hőmérséklet-érzékelő modulból a felhőbe küldött üzeneteket a következő Linux-paranccsal:

   sudo iotedge logs SimulatedTemperatureSensor -f
   

   

   Tipp.

   IoT Edge parancsok megkülönböztetik a kis- és nagybetűket, amikor modulnevekre hivatkoznak.

Az erőforrások tisztítása

Ha folytatni szeretné a IoT Edge oktatóanyagokat, hagyja ki ezt a lépést. Ebben a rövid útmutatóban használhatja a 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 a virtuális gépet és az IoT Hubot egy új erőforráscsoportban hozta létre, törölje a csoportot és az összes társított erőforrást. Ha nem szeretné törölni a teljes csoportot, törölje az egyes erőforrásokat.

Fontos

Ellenőrizze az erőforráscsoport tartalmát, és győződjön meg arról, hogy semmit sem szeretne megtartani. Az erőforráscsoport törlése nem vonható vissza.

Az alábbi paranccsal távolítsa el az IoTEdgeResources csoportot. A törlés eltarthat néhány percig.

az group delete --name IoTEdgeResources

Ezzel a paranccsal ellenőrizheti, hogy az erőforráscsoport el lett-e távolítva az erőforráscsoportok listájának megtekintéséhez.

az group list

Linux IoT Edge eltávolítása Windows

Ha el szeretné távolítani a Linux Azure IoT Edge Windows telepítéséről az eszközről, kövesse az alábbi lépéseket.

1. Nyissa meg Settings a Windows.
2. Válassza a Programok hozzáadása vagy törlése lehetőséget.
3. Válassza ki a Azure IoT Edge alkalmazást.
4. Válassza Eltávolításlehetőséget.

Következő lépések

Ebben a rövid útmutatóban létrehozott egy IoT Edge eszközt, és a Azure IoT Edge felhőfelület használatával kódot telepít az eszközre. Most már rendelkezik egy teszteszközrel, 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 a Azure portálon.

Az IoT Edge eszközök monitorozása