Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Platí pro:
IoT Edge 1.1
Důležité
Datum ukončení podpory ioT Edge 1.1 bylo 13. prosince 2022. Informace o tom, jak se tento produkt, služba, technologie nebo rozhraní API podporují, najdete v životním cyklu produktů Společnosti Microsoft . Další informace o aktualizaci na nejnovější verzi IoT Edge najdete v tématu Aktualizace IoT Edge.
Tento článek obsahuje kompletní pokyny k registraci a zřízení IoT Edge pro Linux na zařízení s Windows.
Každé zařízení, které se připojuje k centru IoT, má ID zařízení, které se používá ke sledování komunikace typu cloud-zařízení nebo komunikace typu zařízení-cloud. Zařízení nakonfigurujete s informacemi o připojení, mezi které patří název hostitele centra IoT, ID zařízení a informace, které zařízení používá k ověření ve službě IoT Hub.
Kroky v tomto článku vás provedou procesem označovaným jako ruční zřizování, kdy připojíte jedno zařízení ke svému centru IoT. Pro ruční zřizování máte dvě možnosti ověřování zařízení IoT Edge:
Symetrické klíče: Když ve službě IoT Hub vytvoříte novou identitu zařízení, služba vytvoří dva klíče. Umístíte na zařízení jeden z klíčů a při ověřování ho předá službě IoT Hub.
Tato metoda ověřování je rychlejší na spuštění, ale není tak zabezpečená.
X.509 samopodepsané: Vytvoříte dva certifikáty identity X.509 a umístíte je do zařízení. Když ve službě IoT Hub vytvoříte novou identitu zařízení, poskytnete kryptografické otisky z obou certifikátů. Když se zařízení ověří ve službě IoT Hub, zobrazí jeden certifikát a IoT Hub ověří, že certifikát odpovídá jeho kryptografickému otisku.
Tato metoda ověřování je bezpečnější a doporučuje se pro produkční scénáře.
Tento článek popisuje použití symetrických klíčů jako metody ověřování. Pokud chcete používat certifikáty X.509, přečtěte si téma Vytvoření a zřízení IoT Edge pro Linux na zařízení s Windows pomocí certifikátů X.509.
Poznámka:
Pokud máte mnoho zařízení k nastavení a nechcete je zřizovat ručně, pomocí jednoho z následujících článků se dozvíte, jak IoT Edge funguje se službou zřizování zařízení IoT Hub:
Požadavky
Tento článek popisuje registraci zařízení IoT Edge a instalaci IoT Edge pro Linux ve Windows. Tyto úlohy mají různé požadavky a nástroje používané k jejich provedení. Ujistěte se, že máte splněné všechny předpoklady, než budete pokračovat.
Nástroje pro správu zařízení
Postup registrace zařízení můžete provést pomocí webu Azure Portal, editoru Visual Studio Code nebo Azure CLI . Každý nástroj má vlastní požadavky:
Bezplatné nebo standardní centrum IoT ve vašem předplatném Azure.
Požadavky na zařízení
Zařízení s Windows s následujícími minimálními požadavky:
Požadavky na systém
- Windows 10/11 (Pro, Enterprise, IoT Enterprise)
- Windows Server 20191/2022
1 Windows 10 a Windows Server 2019 minimálně build 17763 s nainstalovanými všemi aktuálními kumulativními aktualizacemi.
Požadavky na hardware
- Minimální volné paměti: 1 GB
- Minimální volné místo na disku: 10 GB
Podpora virtualizace
- Ve Windows 10 povolte Hyper-V. Další informace najdete v tématu Instalace Hyper-V ve Windows 10.
- Na Windows Serveru nainstalujte roli Hyper-V a vytvořte výchozí síťový přepínač. Další informace najdete v tématu Vnořené virtualizace pro Azure IoT Edge pro Linux ve Windows.
- Na virtuálním počítači nakonfigurujte vnořenou virtualizaci. Další informace najdete v části Vnořená virtualizace.
Podpora sítí
- Windows Server nemá výchozí přepínač. Než budete moct nasadit EFLOW na zařízení s Windows Serverem, musíte vytvořit virtuální přepínač. Další informace najdete v tématu Vytvoření virtuálního přepínače pro Linux ve Windows.
- Desktopové verze Windows mají výchozí přepínač, který lze použít pro instalaci EFLOW. V případě potřeby můžete vytvořit vlastní virtuální přepínač.
Návod
Pokud chcete v nasazení Azure IoT Edge pro Linux ve Windows používat moduly s akcelerovanými gpu , zvažte několik možností konfigurace.
V závislosti na architektuře GPU budete muset nainstalovat správné ovladače a možná budete potřebovat přístup k sestavení programu Windows Insider. Pokud chcete určit potřeby konfigurace a splnit tyto požadavky, podívejte se na akceleraci GPU pro Azure IoT Edge pro Linux ve Windows.
Ujistěte se, že teď potřebujete čas, abyste splnili požadavky na akceleraci GPU. Pokud se rozhodnete, že chcete akceleraci GPU během instalace, budete muset restartovat proces instalace.
Vývojářské nástroje
Ke správě zařízení IoT Edge můžete použít PowerShell nebo Centrum pro správu Windows . Každý nástroj má vlastní požadavky:
Pokud chcete použít PowerShell, pomocí následujících kroků připravte cílové zařízení na instalaci Azure IoT Edge pro Linux ve Windows a nasazení virtuálního počítače s Linuxem:
Nastavte zásadu spouštění na cílovém zařízení na
AllSigned. 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í následujícího příkazu:Get-ExecutionPolicy -ListPokud zásady provádění
local machinenejsouAllSigned, můžete nastavit zásady provádění pomocí:Set-ExecutionPolicy -ExecutionPolicy AllSigned -Force
Další informace o modulu Azure IoT Edge pro Linux v prostředí Windows PowerShell najdete v referenčních informacích k funkcím PowerShellu.
Registrace zařízení
K registraci zařízení můžete použít Azure Portal, Visual Studio Code nebo Azure CLI v závislosti na vašich preferencích.
V centru IoT na portálu Azure se zařízení IoT Edge vytvářejí a spravují odděleně od zařízení IoT, která nemají aktivovanou funkci Edge.
Přihlaste se k webu Azure Portal a přejděte do centra IoT.
V levém podokně vyberte v nabídce zařízení a pak vyberte Přidat zařízení.
Na stránce Vytvořit zařízení zadejte následující informace:
- Vytvořte popisné ID zařízení. Poznamenejte si toto ID zařízení, protože ho použijete později.
- Zaškrtněte políčko Zařízení IoT Edge .
- Jako typ ověřování vyberte symetrický klíč .
- Pomocí výchozího nastavení můžete automaticky generovat ověřovací klíče a připojit nové zařízení k centru.
Vyberte Uložit.
Teď, když máte zařízení zaregistrované ve službě IoT Hub, načtěte informace potřebné k dokončení instalace a nasazení modulu runtime IoT Edge.
Zobrazit registrovaná zařízení a získat informace o nastavení zařízení
Zařízení, která k ověřování používají symetrické klíče, potřebují své připojovací řetězce k dokončení instalace a zřizování modulu runtime IoT Edge.
Zařízení s podporou edge, která se připojují k vašemu centru IoT, jsou uvedena na stránce Zařízení. Seznam můžete filtrovat podle typu zařízení IoT Edge .
Až budete připravení zařízení nastavit, budete potřebovat připojovací řetězec, která propojí fyzické zařízení s jeho identitou v IoT Hubu.
Zařízení, která se ověřují pomocí symetrických klíčů, mají své připojovací řetězec k dispozici ke kopírování na portálu.
- Na stránce Zařízení na portálu vyberte ze seznamu ID zařízení IoT Edge.
- Zkopírujte hodnotu primárního připojovacího řetězce nebo sekundárního připojovacího řetězce.
Nainstalujte IoT Edge
Nasaďte Azure IoT Edge pro Linux ve Windows na cílovém zařízení.
Nainstalujte IoT Edge pro Linux ve Windows na své cílové zařízení.
Poznámka:
Následující proces PowerShellu popisuje, jak nasadit IoT Edge pro Linux ve Windows na místní zařízení. Pokud chcete nasadit do vzdáleného cílového zařízení pomocí PowerShellu, můžete pomocí Vzdáleného PowerShellu navázat připojení ke vzdálenému zařízení a vzdáleně na daném zařízení spouštět tyto příkazy.
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 si IoT Edge pro Linux ve Windows.
$msiPath = $([io.Path]::Combine($env:TEMP, 'AzureIoTEdge.msi')) $ProgressPreference = 'SilentlyContinue' Invoke-WebRequest "https://aka.ms/AzEflowMSI" -OutFile $msiPathNainstalujte na zařízení IoT Edge pro Linux ve Windows.
Start-Process -Wait msiexec -ArgumentList "/i","$([io.Path]::Combine($env:TEMP, 'AzureIoTEdge.msi'))","/qn"Můžete určit vlastní adresáře pro instalaci IoT Edge pro Linux ve Windows a VHDX přidáním parametrů
INSTALLDIR="<FULLY_QUALIFIED_PATH>"aVHDXDIR="<FULLY_QUALIFIED_PATH>"k instalačnímu příkazu. Pokud například chcete použít složku D:\EFLOW pro instalaci a D:\EFLOW-VHDX pro VHDX , můžete použít následující rutinu PowerShellu.Start-Process -Wait msiexec -ArgumentList "/i","$([io.Path]::Combine($env:TEMP, 'AzureIoTEdge.msi'))","/qn","INSTALLDIR=D:\EFLOW", "VHDXDIR=D:\EFLOW-VHDX"Nastavte na cílovém zařízení zásadu spouštění na
AllSigned, pokud již není nastavena. Podívejte se na požadavky na PowerShell pro příkazy, které kontrolují aktuální zásady spouštění a nastavují zásady spouštění naAllSigned.Vytvořte IoT Edge pro Linux v nasazení s Windows. Nasazení vytvoří váš virtuální počítač s Linuxem a automaticky nainstaluje IoT Edge runtime.
Deploy-EflowNávod
Ve výchozím nastavení příkaz
Deploy-Eflowvytvoří virtuální počítač s Linuxem s 1 GB paměti RAM, jádrem 1 vCPU a 16 GB místa na disku. Prostředky, které virtuální počítač potřebuje, jsou ale vysoce závislé na úlohách, které nasadíte. Pokud váš virtuální počítač nemá dostatek paměti pro podporu úloh, nepodaří se spustit.Dostupné prostředky virtuálního počítače můžete přizpůsobit pomocí
Deploy-Eflowvolitelných parametrů příkazu.Následující příkaz například vytvoří virtuální počítač se 4 jádry vCPU, 4 GB paměti RAM (reprezentované v MB) a 20 GB místa na disku:
Deploy-Eflow -cpuCount 4 -memoryInMB 4096 -vmDiskSize 20Informace o všech dostupných volitelných parametrech najdete v tématu Funkce PowerShellu pro IoT Edge pro Linux ve Windows.
Výstraha
Ve výchozím nastavení nemá virtuální počítač EFLOW s Linuxem žádnou konfiguraci DNS. Nasazení používající protokol DHCP se pokusí získat konfiguraci DNS šířenou serverem DHCP. Zkontrolujte konfiguraci DNS a ujistěte se, že máte připojení k internetu. Další informace najdete v tématu AzEFLOW-DNS.
Ke svému nasazení můžete přiřadit GPU, abyste povolili moduly s akcelerovanými GPU pro Linux. Pokud chcete získat přístup k těmto funkcím, budete muset nainstalovat požadavky podrobně popsané v akceleraci GPU pro Azure IoT Edge pro Linux ve Windows.
Pokud chcete použít průchod GPU, přidejte do příkazu
Deploy-Eflowparametry gpuName, gpuPassthroughType a gpuCount. Informace o všech dostupných volitelných parametrech najdete v tématu Funkce PowerShellu pro IoT Edge pro Linux ve Windows.Výstraha
Povolení průchodu hardwarovým zařízením může zvýšit bezpečnostní rizika. Microsoft doporučuje ovladač pro zmírnění rizik zařízení od dodavatele GPU, pokud je to možné. Další informace naleznete v tématu Nasazení grafických zařízení pomocí samostatného přiřazení zařízení.
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.
Po dokončení nasazení se v okně PowerShellu zobrazí zpráva o úspěšném nasazení.
Po úspěšném nasazení jste připraveni zařízení připravit.
Poskytněte zařízení jeho cloudovou identitu
Jste připraveni nastavit zařízení s jeho cloudovou identitou a ověřovacími informacemi.
Pokud chcete zřídit zařízení pomocí symetrických klíčů, budete potřebovat připojovací řetězec vašeho zařízení.
K zřízení zařízení můžete použít Centrum pro správu Windows nebo PowerShell s vyššími oprávněními.
V relaci PowerShellu se zvýšenými oprávněními na cílovém zařízení spusťte následující příkaz. Zástupný text nahraďte vlastními hodnotami.
Provision-EflowVm -provisioningType ManualConnectionString -devConnString "PASTE_DEVICE_CONNECTION_STRING_HERE"
Další informace o příkazu najdete v tématu Funkce PowerShellu Provision-EflowVMpro IoT Edge pro Linux ve Windows.
Ověření úspěšné konfigurace
Ověřte, že se ioT Edge pro Linux ve Windows úspěšně nainstaloval a nakonfiguroval na zařízení IoT Edge.
Přihlaste se do vašeho IoT Edge pro Linux běžícího na virtuálním počítači s Windows pomocí tohoto příkazu ve vaší relaci PowerShellu:
Connect-EflowVmPozná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í můžete pomocí následujícího příkazu Linuxu zkontrolovat seznam spuštěných modulů IoT Edge:
sudo iotedge listPokud potřebujete řešit potíže se službou IoT Edge, použijte následující linuxové příkazy.
Načtěte protokoly služby.
sudo journalctl -u iotedgecheckPomocí nástroje ověřte konfiguraci a stav připojení zařízení.sudo iotedge check
Poznámka:
Na nově zřízeném zařízení se může zobrazit chyba související se službou IoT Edge Hub:
× provozní připravenosti: Adresář úložiště Edge Hubu je trvalý v systému souborů hostitele – chyba
Nepodařilo se zkontrolovat aktuální stav kontejneru EdgeHub.
Tato chyba se očekává na nově zřízeném zařízení, protože modul IoT Edge Hub není spuštěný. Pokud chcete tuto chybu vyřešit, nastavte v IoT Hubu moduly pro zařízení a vytvořte nasazení. Vytvoření nasazení pro zařízení spustí moduly na zařízení, včetně modulu IoT Edge Hub.
Když vytvoříte nové zařízení IoT Edge, zobrazí se na webu Azure Portal 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.
Odinstalujte IoT Edge pro Linux ve Windows
Pokud chcete ze zařízení odebrat instalaci Azure IoT Edge pro Linux ve Windows, použijte následující příkazy.
- Otevřít nastavení ve Windows
- Vyberte Přidat nebo odebrat programy.
- Výběr aplikace LTS pro Azure IoT Edge
- Vyberte Odinstalovat.
Další kroky
- Pokračujte v nasazování modulů IoT Edge a zjistěte, jak do zařízení nasadit moduly.
- Zjistěte, jak spravovat certifikáty ve službě IoT Edge pro Linux na virtuálním počítači s Windows a přenášet soubory z hostitelského operačního systému do virtuálního počítače s Linuxem.
- Zjistěte, jak nakonfigurovat zařízení IoT Edge tak, aby komunikovali přes proxy server.