Vytvoření a zřízení IoT Edge pro Linux na zařízení s Windows pomocí symetrických klíčů

Bezplatné nebo standardní centrum IoT ve vašem předplatném Azure.

• Bezplatné nebo standardní centrum IoT ve vašem předplatném Azure
• Visual Studio Code
• Rozšíření Azure IoT Hubu
• Azure IoT Edge pro Visual Studio Code

• Bezplatné nebo standardní centrum IoT ve vašem předplatném Azure

• Azure CLI ve vašem prostředí

  Minimálně vaše verze Azure CLI musí být 2.0.70 nebo novější. Ke kontrole použijte příkaz az --version. Tato verze podporuje příkazy rozšíření az a zavádí příkazové rozhraní Knack.

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:

1. Nastavte zásadu spouštění na cílovém zařízení na AllSignedhodnotu . 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 -List
   

   Pokud zásady provádění local machine nejsou AllSigned, můžete nastavit zásady spuště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.

Pokud chcete použít Centrum pro správu Windows, stáhněte a nainstalujte centrum Windows Admin Center a nainstalujte rozšíření Windows Admin Center Azure IoT Edge pomocí následujícího postupu:

1. Stáhněte a spusťte instalační program Windows Admin Center. Postupujte podle pokynů průvodce instalací a nainstalujte Windows Admin Center.

2. Po instalaci otevřete Windows Admin Center pomocí podporovaného prohlížeče. Mezi podporované prohlížeče patří Microsoft Edge (Windows 10 verze 1709 nebo novější), Google Chrome a Microsoft Edge Insider.

3. Při prvním použití centra Windows Admin Center se zobrazí výzva k výběru certifikátu, který chcete použít. Jako certifikát vyberte klienta centra Windows Admin Center.

4. Nainstalujte rozšíření Azure IoT Edge. V pravém horním rohu řídicího panelu Centra pro správu Windows vyberte ikonu ozubeného kola.

   

5. V nabídce Nastavení v části Brána vyberte Rozšíření.

6. Na kartě Dostupná rozšíření vyhledejte Azure IoT Edge v seznamu rozšíření. Zvolte ho a vyberte příkaz Nainstalovat nad seznamem rozšíření.

7. Po dokončení instalace byste měli vidět Azure IoT Edge v seznamu nainstalovaných rozšíření na kartě Nainstalovaná rozšíření .

V centru IoT na webu Azure Portal se zařízení IoT Edge vytvářejí a spravují odděleně od zařízení IoT, která nejsou povolená.

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

2. V levém podokně vyberte v nabídce zařízení a pak vyberte Přidat zařízení.

3. 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.

4. Zvolte Uložit.

Přihlášení pro přístup ke službě IoT Hub

K provádění operací s centrem IoT můžete použít rozšíření Azure IoT pro Visual Studio Code. Aby tyto operace fungovaly, musíte se přihlásit ke svému účtu Azure a vybrat centrum.

1. V editoru Visual Studio Code otevřete zobrazení Průzkumníka.

2. V dolní části Průzkumníka rozbalte část Azure IoT Hub .

   

3. Klikněte na ... v hlavičce oddílu Azure IoT Hub . Pokud tři tečky nevidíte, klikněte nebo najeďte myší na záhlaví.

4. Zvolte Vybrat IoT Hub.

5. Pokud nejste přihlášení ke svému účtu Azure, postupujte podle pokynů.

6. Vyberte své předplatné Azure.

7. Vyberte centrum IoT.

Registrace nového zařízení v editoru Visual Studio Code

1. V Průzkumníku editoru Visual Studio Code rozbalte část Azure IoT Hub .
2. Klikněte na ... v hlavičce oddílu Azure IoT Hub . Pokud tři tečky nevidíte, klikněte nebo najeďte myší na záhlaví.
3. Vyberte Vytvořit zařízení IoT Edge.
4. Do textového pole, které se otevře, zadejte ID zařízení.

Na výstupní obrazovce se zobrazí výsledek příkazu. Vytiskne se informace o zařízení, včetně ID zařízení, které jste zadali, a připojovací řetězec, který můžete použít k připojení fyzického zařízení k centru IoT.

Pomocí příkazu az iot hub device-identity create vytvořte novou identitu zařízení ve službě IoT Hub. Příklad:

az iot hub device-identity create --device-id device_id_here --hub-name hub_name_here --edge-enabled

Tento příkaz obsahuje tři parametry:

• --device-id nebo -d: Zadejte popisný název, který je jedinečný v rámci vašeho centra IoT.

• --hub-name nebo -n: Zadejte název ioT Hubu.

• --edge-enabled nebo --ee: Deklarujte, že se jedná o zařízení IoT Edge.

  

Hraniční zařízení, která se připojují k centru IoT, jsou uvedená 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.

1. Na stránce Zařízení na portálu vyberte ze seznamu ID zařízení IoT Edge.
2. Zkopírujte hodnotu primárního připojovacího řetězce nebo sekundárního připojovacího řetězce.

Všechna zařízení, která se připojují k centru IoT, jsou uvedená v části Azure IoT Hub v Průzkumníku editoru Visual Studio Code. Zařízení IoT Edge se liší od jiných zařízení než Edge s jinou ikonou a skutečností, že se na každé zařízení IoT Edge nasazují moduly $edgeAgent a $edgeHub .

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.

1. V části Azure IoT Hub klikněte pravým tlačítkem na ID vašeho zařízení.

2. Vyberte Kopírovat připojovací řetězec zařízení.

   Připojovací řetězec se zkopíruje do schránky.

V nabídce zobrazené po kliknutí pravým tlačítkem myši můžete také vybrat Možnost Získat informace o zařízení, aby se v okně výstupu zobrazily všechny informace o zařízení, včetně připojovací řetězec.

Pomocí příkazu az iot hub device-identity list zobrazte všechna zařízení ve službě IoT Hub. Příklad:

az iot hub device-identity list --hub-name hub_name_here

Jakékoli zařízení zaregistrované jako zařízení IoT Edge bude mít vlastnost capabilities.iotEdge nastavenou na hodnotu true.

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. Pomocí příkazu az iot hub device-identity connection-string show vrátíte připojovací řetězec pro jedno zařízení:

az iot hub device-identity connection-string show --device-id [device_id] --hub-name [hub_name]

Hodnota parametru device-id rozlišují malá a velká písmena.

Při kopírování připojovací řetězec, které chcete použít na zařízení, nezahrnujte uvozovky kolem připojovací řetězec.

Nainstalujte Na cílové zařízení IoT Edge pro Linux ve Windows.

1. 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 $msiPath
   

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

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

   Vlastní IoT Edge pro Linux můžete zadat v instalaci systému Windows a adresáře VHDX přidáním INSTALLDIR="<FULLY_QUALIFIED_PATH>" parametrů VHDXDIR="<FULLY_QUALIFIED_PATH>" do příkazu install. 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"
   

3. Nastavte zásadu spouštění na cílovém zařízení na AllSigned to, jestli ještě není. Projděte si požadavky PowerShellu pro příkazy, které kontrolují aktuální zásady spouštění a nastavují zásady spouštění na AllSignedhodnotu .

4. Vytvořte IoT Edge pro Linux v nasazení s Windows. Nasazení vytvoří virtuální počítač s Linuxem a nainstaluje za vás modul runtime IoT Edge.

   Deploy-Eflow
   

   Tip

   Ve výchozím nastavení příkaz Deploy-Eflow vytvoří 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-Eflow volitelný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 20
   

   Informace o všech dostupných volitelných parametrech najdete v tématu Funkce PowerShellu pro IoT Edge pro Linux ve Windows.

   Upozorňující

   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-Eflow parametry 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.

   Upozorňující

   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í.

5. Zadejte Y a přijměte licenční podmínky.

6. Pokud chcete v závislosti na předvolbách zapnout nebo vypnout volitelná diagnostická data , zadejte O nebo R.

7. Po dokončení nasazení se v okně PowerShellu zobrazí zpráva o úspěšném nasazení.

   

   Po úspěšném nasazení můžete zařízení zřídit.

1. Nainstalujte a otevřete Centrum pro správu Systému Windows.

   Na úvodní stránce Centra pro správu Windows se v seznamu připojení zobrazí místní hostitelské připojení představující počítač, na kterém používáte Windows Admin Center. Tady se zobrazí také všechny další servery, počítače nebo clustery, které spravujete.

   Centrum pro správu Windows můžete použít ke správě Azure IoT Edge pro Linux ve Windows na místním zařízení nebo na vzdálených spravovaných zařízeních. V této příručce bude místní hostitelské připojení sloužit jako cílové zařízení pro nasazení Azure IoT Edge pro Linux ve Windows.

2. Ověřte, že je vaše místní zařízení uvedené v části Všechna připojení, jak je znázorněno níže.

   

   Pokud chcete nasadit na vzdálené cílové zařízení místo místního zařízení a v seznamu nevidíte požadované cílové zařízení, přidejte ho podle pokynů.

3. Vyberte + Přidat a začněte vytvářet nasazení. Nasazení vytvoří virtuální počítač s Linuxem a nainstaluje za vás modul runtime IoT Edge.

4. V podokně Přidat nebo vytvořit prostředky vyhledejte dlaždici Azure IoT Edge. Vyberte Vytvořit nový , aby se na zařízení nainstalovala nová instance Azure IoT Edge pro Linux.

   Pokud už ioT Edge pro Linux ve Windows běží na zařízení, můžete vybrat Přidat , abyste se připojili k danému existujícímu zařízení IoT Edge a mohli ho spravovat pomocí Centra pro správu Windows.

   

5. Otevře se podokno Vytvoření Azure IoT Edge pro Linux v systému Windows. Na 1. Karta Začínáme, zkontrolujte minimální požadavky a vyberte Další.

6. Přečtěte si licenční podmínky, zaškrtněte políčko Přijmout a vyberte Další.

7. Volitelná diagnostická data můžete zapnout nebo vypnout v závislosti na vašich preferencích.

8. Vyberte Další: Nasadit.

   

9. Na 2. Nasaďte kartu v části Vybrat cílové zařízení a kliknutím na uvedené zařízení ověřte, že splňuje minimální požadavky. Jakmile se stav potvrdí jako podporovaný, vyberte Další.

   

10. Na kartě Nastavení 2.2 zkontrolujte nastavení konfigurace vašeho nasazení. Následující tabulka ukazuje nastavení a jejich výchozí hodnoty.

    Nastavení	Default value
    Velikost virtuálního disku v GB	16
    Paměť v MB (sudé číslo)	1024
    Počet jader	2
    Verze Azure IoT Edge	1.1 (LTS)

    Poznámka:

    IoT Edge pro Linux ve Windows používá výchozí přepínač, který přiřadí virtuálnímu počítači s Linuxem interní IP adresu. Tuto interní IP adresu nelze získat mimo počítač s Windows. K virtuálnímu počítači se můžete připojit místně při přihlášení k počítači s Windows.

    Pokud používáte Windows Server, nastavte výchozí přepínač před nasazením IoT Edge pro Linux ve Windows.

    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 v tomto okamžiku v procesu nasazení instalujete jenom tyto požadavky, budete muset začít znovu od začátku.

    K dispozici jsou dvě možnosti předávání GPU: přímé přiřazení zařízení (DDA) a paravirtualizace GPU (GPU-PV) v závislosti na adaptéru GPU, který přiřadíte k nasazení.

    Pro metodu přiřazení přímého zařízení vyberte počet procesorů GPU, které se mají přidělit virtuálnímu počítači s Linuxem.

    Pro metodu paravirtualizace nejsou nutná žádná další nastavení.

    Upozorňující

    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í.

    Jakmile budete s nastavením spokojeni, vyberte Další.

11. Na kartě Nasazení 2.3 můžete sledovat průběh nasazení. Celý proces zahrnuje stažení azure IoT Edge pro Linux v balíčku s Windows, instalaci balíčku, konfiguraci hostitelského zařízení a nastavení virtuálního počítače s Linuxem. Dokončení tohoto procesu může trvat několik minut. Níže je znázorněno úspěšné nasazení.

    

12. Po dokončení nasazení můžete zařízení zřídit. Vyberte Další: Připojte se a pokračujte ke 3. Karta Připojení , která zpracovává zřizování zařízení Azure IoT Edge

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-EflowVM pro IoT Edge pro Linux ve Windows.

1. V podokně zřizování zařízení Azure IoT Edge vyberte v rozevíracím seznamu metody zřizování připojovací řetězec (ruční ).

2. Po registraci zařízení zadejte připojovací řetězec zařízení, které jste získali ze služby IoT Hub.

3. Vyberte Zřizování s vybranou metodou.

   

4. Po dokončení zřizování vyberte Dokončit. Vrátíte se zpět na hlavní řídicí panel. Teď by se mělo zobrazit nové zařízení s typem IoT Edge Devices. Můžete vybrat zařízení IoT Edge, ke kterému se chcete připojit. Jakmile budete na stránce Přehled , můžete zobrazit seznam modulů IoT Edge a stav ioT Edge vašeho zařízení.

1. Přihlaste se k ioT Edge pro Linux na virtuálním počítači s Windows pomocí následujícího příkazu v relaci PowerShellu:

   Connect-EflowVm
   

   Poznámka:

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

2. 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 list
   

3. Pokud potřebujete řešit potíže se službou IoT Edge, použijte následující linuxové příkazy.

   1. Načtěte protokoly služby.

      sudo journalctl -u iotedge
      

   2. check Pomocí 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 Hubu.

1. Vyberte zařízení IoT Edge ze seznamu připojených zařízení v Centru pro správu Windows a připojte se k němu.

2. Na stránce přehledu zařízení se zobrazí některé informace o zařízení:

   • V části Seznam modulů IoT Edge se zobrazují spuštěné moduly na zařízení. Když se služba IoT Edge spustí poprvé, měli byste vidět jenom spuštěný modul edgeAgent . Modul edgeAgent běží ve výchozím nastavení a pomáhá nainstalovat a spustit všechny další moduly, které nasadíte do zařízení.

   • V části Stav IoT Edge se zobrazuje stav služby a měl by se hlásit jako aktivní (spuštěný).