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

Platí pro: IoT Edge 1.1

Vyzkoušejte si Azure IoT Edge 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 zařízeních, abyste mohli do hraničního zařízení odesílat více úloh. V tomto rychlém startu doporučujeme použít vlastní zařízení, abyste viděli, jak snadné je použít Azure IoT Edge pro Linux na Windows.

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

• Vytvořte centrum IoT.
• Zaregistrovat zařízení IoT Edge do centra IoT Hub.
• Nainstalujte a spusťte IoT Edge pro Linux Windows modulu runtime na vašem zařízení.
• Vzdáleně nasadit modul do IoT Edge zařízení a odesílat telemetrii.

Tento rychlý start vás provede tím, jak nastavit Azure IoT Edge pro Linux na Windows zařízení. Pak nasadíte modul z virtuálního Azure Portal do zařízení. Modul, který použijete, je simulovaný senzor, který generuje údaje o teplotě, vlhkosti a tlaku. Další Azure IoT Edge kurzy staví na práci, 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 bezplatný účet před tím, než začnete.

Požadavky

Připravte si prostředí pro Azure CLI.

• V nástroji použijte prostředí Bash Azure Cloud Shell.

  

• Pokud tomu dáváte přednost, můžete nainstalovat Azure CLI a spouštět referenční příkazy CLI.

  • 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í jsou popsané v tématu Přihlášení 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 Využití rozšíření v Azure CLI.

  • Spuštěním příkazu az version zjistěte verzi a závislé knihovny, které jsou nainstalované. 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é budete používat v tomto rychlém startu.

az group create --name IoTEdgeResources --location westus2

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

• Požadavky na systém

  • Windows 10 11/11 (Pro, Enterprise, IoT Enterprise)
  • Windows Server 2019/2022
    _{Při Windows 10 a Windows 17763 pro Server 2019 jsou nainstalované všechny aktuální kumulativní aktualizace.}

• Požadavky na hardware

  • Minimální volná paměť: 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.

V tomto rychlém startu Azure IoT Hub bezplatná úroveň služeb. Pokud jste použili IoT Hub a už máte vytvořené centrum, můžete použít toto centrum IoT.

Následující kód vytvoří bezplatné centrum F1 ve skupině prostředků IoTEdgeResources . 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 jedno bezplatné centrum ve vašem předplatném, změňte SKU na S1 . Pokud se zobrazí chyba, že název centra IoT není k dispozici, má už centrum s tímto názvem někdo jiný. Zkuste nový název.

Zaregistrovat zařízení IoT Edge

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

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

IoT Edge zařízení se chovají a je možné je spravovat jinak než typická zařízení IoT. Pomocí --edge-enabled příznaku můžete deklarovat, že tato identita je pro IoT Edge zařízení.

1. 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, ujistěte se, Cloud Shell používá nejnovější verzi rozšíření iothubowner Azure IoT.

2. Prohlédněte si připojovací řetězec pro vaše zařízení, který provádí vaše 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}
   

3. Zkopírujte hodnotu klíče connectionString z výstupu JSON a uložte ji. Tato hodnota je připojovací řetězec zařízení. Použijete ho ke konfiguraci modulu runtime IoT Edge v další části.

   

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

Nainstalujte IoT Edge pro Linux na Windows zařízení a nakonfigurujte ho pomocí připojovacího řetězce zařízení.

Na cílovém zařízení, na které chcete nasadit Azure IoT Edge Linuxu, spusťte následující příkazy PowerShellu Windows. Pokud chcete nasazení do vzdáleného cílového zařízení pomocí PowerShellu, pomocí vzdáleného PowerShellu navázání připojení ke vzdálenému zařízení a vzdálenému spuštění těchto příkazů na tomto zařízení.

1. V relaci PowerShellu se zvýšenými oprávněními spusťte každý z následujících příkazů a IoT Edge pro Linux na Windows.

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

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

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

3. Nastavte zásady spouštění na cílovém zařízení na AllSigned , pokud to 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 spouštění local machine pro nejsou , můžete zásady spouštění nastavit AllSigned pomocí:

   Set-ExecutionPolicy -ExecutionPolicy AllSigned -Force
   

4. Vytvořte IoT Edge pro Linux v Windows nasazení.

   Deploy-Eflow
   

5. Zadáním "Y" přijměte licenční podmínky.

6. Zadáním "O" nebo "R" přepínáte volitelná diagnostická data podle toho, čemu dáváte přednost. Úspěšné nasazení je na obrázku níže.

   

7. Ke zřízení zařízení můžete použít připojovací řetězec 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>"
   

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

Nasazení modulu

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

Jednou z klíčových funkcí služby Azure IoT Edge nasazení kódu do vašich IoT Edge zařízení z cloudu. IoT Edge moduly jsou spustitelné balíčky implementované jako kontejnery. V této části nasadíte předem sestavený modul z oddílu IoT Edge Modules v Azure Marketplace přímo z Azure IoT Hub.

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

Pomocí těchto kroků nasaďte svůj první modul z Azure Marketplace.

1. Přihlaste se k Azure Portal a přejděte do centra IoT.

2. V nabídce na levé straně v části Automatické Správa zařízení vyberte IoT Edge.

3. V seznamu zařízení vyberte ID cílového zařízení.

   Když vytvoříte novou IoT Edge zařízení, zobrazí se stavový kód v 417 -- The device's deployment configuration is not set Azure Portal. Tento stav je normální a znamená, že zařízení je připravené přijmout nasazení modulu.

4. Na horním panelu vyberte Nastavit moduly.

   

5. V IoT Edge Module(Moduly) otevřete rozevírací nabídku Add (Přidat) a pak vyberte Marketplace Module (Modul Marketplace).

   

6. V IoT Edge Module Marketplace vyhledejte a vyberte modul Simulated Temperature Sensor .

   Modul se přidá do části IoT Edge Modules s požadovaným stavem spuštění.

7. Vyberte Další: Trasy a pokračujte dalším krokem průvodce.

   

8. Na kartě Trasy odeberte výchozí trasu, trasu a pak vyberte Další: Zkontrolovat a vytvořit. Pokračujte dalším krokem průvodce.

   Poznámka

   Trasy se konstruuje pomocí párů název-hodnota. Na této stránce byste měli vidět dvě trasy. Výchozí trasa, trasa, odesílá všechny zprávy do IoT Hub (která se nazývá $upstream ). Druhá trasa SimulatedTemperatureSensorToIoTHub se vytvořila automaticky při přidání modulu z Azure Marketplace. Tato trasa odesílá všechny zprávy ze simulovaného modulu teploty do IoT Hub. Výchozí trasu můžete odstranit, protože je v tomto případě redundantní.

   

9. Zkontrolujte soubor JSON a pak vyberte Vytvořit. Soubor JSON definuje všechny moduly, které nasadíte do svého IoT Edge zařízení. Zobrazí se modul SimulatedTemperatureSensor a dva moduly runtime edgeAgent a edgeHub.

   Poznámka

   Když do zařízení IoT Edge odešlete nové nasazení, do zařízení se nic nevloží. Zařízení místo toho pravidelně odesílá do IoT Hubu dotazy týkající se nových pokynů. Pokud zařízení najde aktualizovaný manifest nasazení, použije informace o novém nasazení k vyžádání imagí modulu z cloudu a potom začne spouštět moduly místně. Tento proces může trvat několik minut.

10. Po vytvoření podrobností o nasazení modulu vás průvodce vrátí na stránku s podrobnostmi o zařízení. Podívejte se na stav nasazení na kartě Moduly.

    Měly by se zobrazit tři moduly: $edgeAgent, $edgeHub a SimulatedTemperatureSensor. Pokud má jeden nebo více modulů v části ZADANÉ V NASAZENÍ hodnotu ANO, ale ne v části HLÁŠENO ZAŘÍZENÍM , IoT Edge zařízení stále spouští. Počkejte několik minut a pak aktualizujte stránku.

    

Zobrazení vygenerovaných dat

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

Modul, který jste nasadili, generuje ukázková data prostředí, která můžete použít pro pozdější 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ě. Mezi zprávy, které odesílá, patří okolní teplota a vlhkost, teplota a tlak počítače a časové razítko. IoT Edge kurzech používají data vytvořená v tomto modulu jako testovací data pro analýzu.

1. Přihlaste se ke svému IoT Edge linuxu na Windows počítači pomocí následujícího příkazu v relaci PowerShellu:

   Connect-EflowVm
   

   Poznámka

   Jediný účet, který má přístup k virtuálnímu počítači pomocí SSH, je uživatel, který ho vytvořil.

2. Po přihlášení můžete zkontrolovat seznam spuštěných modulů IoT Edge pomocí následujícího linuxového příkazu:

   sudo iotedge list
   

   

3. Pomocí následujícího linuxového příkazu zobrazte zprávy odesílané z modulu senzoru teploty do cloudu:

   sudo iotedge logs SimulatedTemperatureSensor -f
   

   Důležité

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

   

Můžete také použít rozšíření Azure IoT Hub pro Visual Studio Code ke sledování zpráv přicházejíných do služby IoT Hub.

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

Pokud chcete pokračovat k dalším IoT Edge kurzům, tento krok přeskočte. Můžete použít zařízení, které jste zaregistrovali a nastavili v tomto rychlém startu. Jinak můžete vytvořené prostředky Azure odstranit, abyste se vyhnuli poplatkům.

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

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

az group delete --name IoTEdgeResources

Odebrání skupiny prostředků můžete ověřit pomocí tohoto příkazu, který zobrazí seznam skupin prostředků.

az group list

Odebrání Azure IoT Edge pro Linux v Windows

Pomocí rozšíření řídicího panelu v centru Windows Admin Center odinstalujte Azure IoT Edge pro Linux na Windows.

1. Připojení k IoT Edge v centru Windows pro správu. Načte se rozšíření nástroje řídicího panelu Azure.

2. Vyberte Odinstalovat. Po Azure IoT Edge odebere Windows Admin Center položku připojení Azure IoT Edge zařízení ze stránky Start.

Další kroky

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

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