Rychlý start: Nasazení prvního modulu IoT Edge do zařízení Windows

Použitelné pro: IoT Edge 1.5

Důležité

IoT Edge 1.5 LTS je podporovaná verze. IoT Edge 1,4 LTS dosáhl konce životnosti 12. listopadu 2024. Pokud používáte starší verzi, přečtěte si téma Update IoT Edge.

Vyzkoušejte Azure IoT Edge v tomto rychlém startu nasazením kontejnerizovaného kódu do Linuxu na Windows IoT Edge zařízení. IoT Edge umožňuje vzdáleně spravovat kód na vašich zařízeních, abyste mohli posílat více pracovních úloh na hranu. V tomto rychlém startu se doporučuje použít vlastní klientské zařízení Windows, abyste zjistili, jak snadné je používat Azure IoT Edge pro Linux na Windows. Pokud chcete k vytvoření nasazení použít Windows Server nebo virtuální počítač Azure, postupujte podle pokynů v průvodci instalace a zřizování Azure IoT Edge pro Linux na zařízení Windows.

V tomto rychlém startu se naučíte:

Vytvořte centrum IoT.
Zaregistrujte zařízení IoT Edge do centra IoT.
Nainstalujte a spusťte IoT Edge pro Linux na Windows runtime na vašem zařízení.
Vzdáleně nasaďte modul do IoT Edge zařízení a odešlete telemetrii.

Diagram znázorňující architekturu tohoto rychlého startu pro vaše zařízení a cloud

Tento rychlý start vás provede nastavením Azure IoT Edge pro Linux na Windows zařízení. Pak do zařízení nasadíte modul z portálu Azure. Modul, který používáte, je simulovaný senzor, který generuje data o teplotě, vlhkosti a tlaku. Další Azure IoT Edge kurzy vycházejí z práce, kterou tady děláte, nasazením modulů, které analyzují simulovaná data pro obchodní přehledy.

Pokud nemáte aktivní předplatné Azure, vytvořte si účet free, než začnete.

Požadavky

Připravte prostředí na Azure CLI.

Použijte prostředí Bash v Azure Cloud Shell. Další informace najdete v tématu Začínáme s Azure Cloud Shell.
Pokud dáváte přednost místnímu spouštění referenčních příkazů CLI, nainstalujte Azure CLI. Pokud používáte Windows nebo macOS, zvažte spuštění Azure CLI v kontejneru Dockeru. Další informace najdete v tématu Jak spustit Azure CLI v kontejneru Docker.
- Pokud používáte místní instalaci, přihlaste se k Azure CLI pomocí příkazu az login. Pokud chcete dokončit proces ověřování, postupujte podle kroků zobrazených na terminálu. Další možnosti přihlášení najdete v tématu Authenticate pro Azure pomocí Azure CLI.
- Po zobrazení výzvy nainstalujte rozšíření Azure CLI při prvním použití. Další informace o rozšířeních najdete v tématu Použití a správa rozšíření pomocí Azure CLI.
- Spusťte az version, abyste zjistili verzi a závislé knihovny, které jsou nainstalovány. Pokud chcete upgradovat na nejnovější verzi, spusťte az upgrade.

Vytvořte cloudovou skupinu prostředků pro správu všech prostředků, které používáte v tomto rychlém startu.

az group create --name IoTEdgeResources --location westus2

Ujistěte se, že vaše zařízení IoT Edge splňuje následující požadavky:

Požadavky na systém
- Windows 10¹/11 (Pro, Enterprise, IoT Enterprise) _{¹ Windows 10 minimální build 17763 se všemi aktuálními kumulativními aktualizacemi nainstalovanými.}
Požadavky na hardware
- Minimální volné paměti: 1 GB
- Minimální volné místo na disku: 10 GB

Vytvoření centra IoT

Začněte vytvořením centra IoT pomocí Azure CLI.

Diagram znázorňující krok vytvoření centra I o T

Bezplatná úroveň Azure IoT Hub funguje pro tento rychlý začátek. Pokud jste dříve použili IoT Hub a už máte centrum, můžete použít tuto IoT hub.

Následující kód vytvoří bezplatné centrum F1 ve skupině IoTEdgeResourcesprostředků . Nahraďte {hub_name} jedinečným názvem vašeho centra IoT. Vytvoření centra IoT může trvat několik minut.

az iot hub create --resource-group IoTEdgeResources --name {hub_name} --sku F1 --partition-count 2

Pokud se zobrazí chyba, protože už máte ve svém předplatném jedno bezplatné centrum, změňte skladovou položku na S1. Pokud se zobrazí chyba, že název centra IoT není dostupný, někdo jiný už má centrum s tímto názvem. Zkuste nový název.

Registrace zařízení IoT Edge

Zaregistrujte zařízení IoT Edge pomocí nově vytvořeného centra IoT.

Diagram znázorňující krok registrace zařízení s identitou centra I o T

Vytvořte identitu simulovaného zařízení, aby mohla komunikovat s centrem IoT. Identita zařízení se nachází v cloudu a pro přidružení fyzického zařízení k identitě zařízení použijete jedinečný připojovací řetězec.

IoT Edge zařízení se chovají a dají se spravovat jinak než typická zařízení IoT. Pomocí příznaku --edge-enabled deklarujte, že tato identita je pro zařízení IoT Edge.

V Azure Cloud Shell zadejte následující příkaz, který ve vašem centru vytvoří zařízení s názvem myEdgeDevice.
```
az iot hub device-identity create --device-id myEdgeDevice --edge-enabled --hub-name {hub_name}
```
Pokud se zobrazí chyba týkající se klíčů zásad iothubowner, ujistěte se, že Cloud Shell používá nejnovější verzi rozšíření Azure IoT.
Zobrazte si řetězec připojení pro své zařízení, který propojuje fyzické zařízení s jeho identitou v IoT Hub. Obsahuje název vašeho centra IoT, název vašeho zařízení a sdílený klíč, který ověřuje připojení mezi těmito dvěma zařízeními.
```
az iot hub device-identity connection-string show --device-id myEdgeDevice --hub-name {hub_name}
```
Zkopírujte hodnotu klíče connectionString z výstupu JSON a uložte ji. Tato hodnota je připojovací řetězec zařízení. Použijte ho ke konfiguraci modulu IoT Edge runtime v další části.

Vaše connection string by například měla vypadat podobně jako HostName=contoso-hub.azure-devices.net;DeviceId=myEdgeDevice;SharedAccessKey=<DEVICE_SHARED_ACCESS_KEY>.

Instalace a spuštění modulu IoT Edge runtime

Nainstalujte IoT Edge pro Linux na Windows na svém zařízení a nakonfigurujte jej s připojovacím řetězcem zařízení.

Diagram znázorňující krok spuštění modulu runtime I o T Edge

Na cílovém zařízení, na kterém chcete nasadit Azure IoT Edge pro Linux, spusťte na Windows následující příkazy PowerShellu. Pokud chcete nasadit do vzdáleného cílového zařízení pomocí PowerShellu, pomocí vzdáleného PowerShellu vytvořte připojení ke vzdálenému zařízení a spusťte na daném zařízení tyto příkazy vzdáleně.

Spuštěním následujícího příkazu v relaci PowerShellu se zvýšenými oprávněními povolte Hyper-V. Další informace najdete v tématu Hyper-V o Windows 10.
```
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All
```

V relaci PowerShellu se zvýšenými oprávněními spusťte každý z následujících příkazů a stáhněte IoT Edge pro Linux na 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

Nainstalujte IoT Edge pro Linux na Windows na zařízení.

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

Nastavte politiku spuštění na cílovém zařízení na AllSigned, pokud ještě není. Aktuální zásady spouštění můžete zkontrolovat na příkazovém řádku PowerShellu se zvýšenými oprávněními pomocí:
```
Get-ExecutionPolicy -List
```
Pokud zásady provádění local machine nejsou AllSigned, nastavte zásady spouštění pomocí následujícího příkazu:
```
Set-ExecutionPolicy -ExecutionPolicy AllSigned -Force
```
Vytvořte IoT Edge pro Linux při nasazení Windows.
```
Deploy-Eflow
```
Zadejte Y a přijměte licenční podmínky.
Pokud chcete v závislosti na předvolbách zapnout nebo vypnout volitelná diagnostická data, zadejte O nebo R. Úspěšné nasazení je znázorněno na následujícím obrázku.
Zprovozněte zařízení pomocí řetězce pro připojení zařízení, který jste získali v předchozí části. Zástupný text nahraďte vlastní hodnotou.
```
Provision-EflowVm -provisioningType ManualConnectionString -devConnString "<CONNECTION_STRING_HERE>"
```

Vaše zařízení IoT Edge je teď nakonfigurované. Je připravené na spouštění modulů nasazených v cloudu.

Nasadit modul

Spravujte Azure IoT Edge zařízení z cloudu a nasaďte modul, který odesílá telemetrická data do IoT Hub.

Diagram znázorňující krok nasazení modulu

Jednou z klíčových funkcí Azure IoT Edge je nasazení kódu do IoT Edge zařízení z cloudu. moduly IoT Edge jsou spustitelné balíčky implementované jako kontejnery. V této části nasadíte předem připravený modul z oddílu IoT Edge Moduly služby Microsoft Artifact Registry.

Modul, který v této části nasadíte, simuluje senzor a odesílá vygenerovaná data. Tento modul je užitečným kódem, když začínáte s IoT Edge, protože můžete použít simulovaná data pro vývoj a testování. Pokud chcete přesně zjistit, co tento modul dělá, můžete zobrazit zdrojový kód simulovaný zdrojový kód senzoru teploty.

Pokud chcete nasadit první modul, postupujte podle těchto kroků.

Přihlaste se k portálu Azure a přejděte na svůj IoT Hub.
V nabídce vlevo vyberte Zařízení v nabídce Správa zařízení.
V seznamu zařízení vyberte ID zařízení cílového zařízení.

Poznámka:

Když vytvoříte nové zařízení IoT Edge, zobrazí se na portálu Azure stavový kód 417 -- The device's deployment configuration is not set. Tento stav je normální a znamená, že zařízení je připravené přijmout nasazení modulu.
Na horním panelu vyberte Nastavit moduly.

Zvolte moduly, které chcete na svém zařízení spustit. Můžete si vybrat z modulů, které jste už vytvořili, modulů z Microsoft Artifact Registry nebo modulů, které jste sami vytvořili. V tomto rychlém startu nasadíte modul z registru Microsoft Artifact Registry.
V části IoT Edge moduly vyberte Přidat pak zvolte IoT Edge Modul.

Aktualizujte následující nastavení modulu:

Nastavení	Hodnota
Název modulu IoT	`SimulatedTemperatureSensor`
Identifikátor URI obrázku	`mcr.microsoft.com/azureiotedge-simulated-temperature-sensor:latest`
Zásada restartování	vždy
Požadovaný stav	běží

Vyberte Další: Trasy pro pokračování v konfiguraci tras.
Přidejte trasu, která odesílá všechny zprávy z modulu simulované teploty do IoT Hub.

Nastavení Hodnota

Name SimulatedTemperatureSensorToIoTHub

Hodnota FROM /messages/modules/SimulatedTemperatureSensor/* INTO $upstream
Vyberte Další: Zkontrolovat a vytvořit.
Zkontrolujte soubor JSON a pak vyberte Vytvořit. Soubor JSON definuje všechny moduly, které nasadíte do IoT Edge zařízení.

Poznámka:

Když odešlete nové nasazení do IoT Edge zařízení, nic se neposílá do vašeho zařízení. Místo toho se zařízení pravidelně dotazuje IoT Hub na jakékoli nové pokyny. Pokud zařízení najde aktualizovaný manifest nasazení, použije informace o novém nasazení k načtení imagí modulů z cloudu a pak spustí moduly místně. Tento proces může trvat několik minut.

Nastavení	Hodnota
Name	`SimulatedTemperatureSensorToIoTHub`
Hodnota	`FROM /messages/modules/SimulatedTemperatureSensor/* INTO $upstream`

Po vytvoření podrobností o nasazení modulu vás průvodce vrátí na stránku s podrobnostmi o zařízení. Zobrazení stavu nasazení na kartě Moduly

Měly by se zobrazit tři moduly: $edgeAgent, $edgeHub a SimulatedTemperatureSensor. Pokud jeden nebo více modulů obsahuje Yes v části Zadané v nasazení, ale ne pod Reportováno zařízením, zařízení IoT Edge je stále spouští. Počkejte několik minut a pak aktualizujte stránku.

Pokud máte problémy s nasazováním modulů, podívejte se na Troubleshoot IoT Edge zařízení na portálu Azure.

Zobrazení vygenerovaných dat

V tomto rychlém startu jste vytvořili nové IoT Edge zařízení a nainstalovali jste do něj modul runtime IoT Edge. Pak jste použili portál Azure k nasazení modulu IoT Edge ke spuštění na zařízení, aniž byste museli provádět změny samotného zařízení.

Modul, který nasdílíte, generuje ukázková data prostředí, která můžete použít k pozdějšímu testování. Simulovaný senzor monitoruje počítač i prostředí kolem počítače. Tento senzor může být například v serverové místnosti, v továrně nebo na větrné turbíně. Zprávy, které odesílá, zahrnují okolní teplotu a vlhkost, teplotu stroje a tlak a časové razítko. IoT Edge kurzy používají data vytvořená v tomto modulu jako testovací data pro analýzu.

Přihlaste se do svého virtuálního počítače IoT Edge for Linux on Windows pomocí následujícího příkazu v relaci PowerShell:
```
Connect-EflowVm
```
Poznámka:

Jediným účtem povoleným SSH k virtuálnímu počítači je uživatel, který ho vytvořil.
Po přihlášení zkontrolujte seznam spuštěných modulů IoT Edge pomocí následujícího příkazu Linuxu:
```
sudo iotedge list
```
Pomocí následujícího příkazu Linuxu zobrazte zprávy odeslané z modulu senzoru teploty do cloudu:
```
sudo iotedge logs SimulatedTemperatureSensor -f
```
Tip

IoT Edge příkazy rozlišují malá a velká písmena, když odkazují na názvy modulů.

Vyčištění prostředků

Pokud chcete pokračovat v kurzech IoT Edge, přeskočte tento krok. V tomto rychlém startu můžete použít zařízení, které jste zaregistrovali a nastavili. V opačném případě odstraňte prostředky Azure, které jste vytvořili, abyste se vyhnuli poplatkům.

Pokud jste vytvořili virtuální počítač a centrum IoT v nové skupině prostředků, odstraňte tuto skupinu a všechny přidružené prostředky. Pokud nechcete odstranit celou skupinu, odstraňte místo toho jednotlivé prostředky.

Důležité

Zkontrolujte obsah skupiny prostředků a ujistěte se, že není nic, co chcete zachovat. Odstranění skupiny prostředků je nevratné.

Pomocí následujícího příkazu odeberte skupinu IoTEdgeResources . Odstranění může trvat několik minut.

az group delete --name IoTEdgeResources

Pomocí tohoto příkazu můžete ověřit, že je skupina prostředků odebrána, abyste zobrazili seznam skupin prostředků.

az group list

Odinstalace IoT Edge pro Linux na Windows

Pokud chcete ze zařízení odebrat Azure IoT Edge pro Linux na Windows instalaci, postupujte následovně.

Na Windows otevřete Settings.
Vyberte Přidat nebo odebrat programy.
Vyberte aplikaci Azure IoT Edge.
Vyberte Odinstalovat.

Další kroky

V tomto rychlém startu jste vytvořili IoT Edge zařízení a použili jste cloudové rozhraní Azure IoT Edge k nasazení kódu do zařízení. Teď máte testovací zařízení, které generuje nezpracovaná data o jeho prostředí.

V dalším kurzu se dozvíte, jak monitorovat aktivitu a stav zařízení z portálu Azure.

Monitor IoT Edge zařízení

Váš názor

Byla tato stránka užitečná?

Last updated on 2026-03-11