Vytvoření a zřízení IoT Edge pro Linux na zařízeních s Windows ve velkém měřítku pomocí symetrických klíčů

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

Vytvoření jednotlivé registrace DPS

1. Na webu Azure Portal přejděte do vaší instance služby IoT Hub device provisioning.

2. V části Nastavení vyberte Spravovat registrace.

3. Vyberte Přidat jednotlivé registrace a pak proveďte následující kroky a nakonfigurujte registraci:

   1. V případě mechanismu vyberte symetrický klíč.

   2. Zadejte jedinečné ID registrace pro vaše zařízení.

   3. Volitelně můžete zadat ID zařízení ioT Hubu pro vaše zařízení. ID zařízení můžete použít k cílení na jednotlivá zařízení pro nasazení modulu. Pokud nezadáte ID zařízení, použije se ID registrace.

   4. Výběrem možnosti True deklarujte, že registrace je pro zařízení IoT Edge.

   5. Volitelně můžete do stavu počátečního dvojčete zařízení přidat hodnotu značky. Značky můžete použít k cílovým skupinám zařízení pro nasazení modulu. Příklad:

      {
         "tags": {
            "environment": "test"
         },
         "properties": {
            "desired": {}
         }
      }
      

   6. Zvolte Uložit.

4. Zkopírujte hodnotu primárního klíče jednotlivé registrace, kterou chcete použít při instalaci modulu runtime IoT Edge.

Teď, když pro toto zařízení existuje registrace, může modul runtime IoT Edge během instalace zařízení automaticky zřídit.

Vytvoření skupinové registrace DPS

1. Na webu Azure Portal přejděte do vaší instance služby IoT Hub device provisioning.

2. V části Nastavení vyberte Spravovat registrace.

3. Vyberte Přidat jednotlivé registrace a pak proveďte následující kroky a nakonfigurujte registraci:

   1. Zadejte název skupiny.

   2. Jako typ ověření identity vyberte symetrický klíč .

   3. Výběrem možnosti True deklarujte, že registrace je pro zařízení IoT Edge. U skupinové registrace musí být všechna zařízení IoT Edge nebo žádná z nich nemůže být.

   4. Volitelně můžete do stavu počátečního dvojčete zařízení přidat hodnotu značky. Značky můžete použít k cílovým skupinám zařízení pro nasazení modulu. Příklad:

      {
         "tags": {
            "environment": "test"
         },
         "properties": {
            "desired": {}
         }
      }
      

   5. Zvolte Uložit.

4. Zkopírujte hodnotu primárního klíče skupiny registrací, kterou chcete použít při vytváření klíčů zařízení pro použití s registrací skupiny.

Teď, když existuje skupina registrací, může modul runtime IoT Edge během instalace automaticky zřizovat zařízení.

Odvození klíče zařízení

Každé zařízení, které je zřízené jako součást skupinové registrace, potřebuje odvozený klíč zařízení k ověření symetrického klíče s registrací během zřizování.

Pokud chcete vygenerovat klíč zařízení, použijte klíč, který jste zkopírovali ze skupiny registrací DPS, k výpočtu HMAC-SHA256 jedinečného ID registrace zařízení a převeďte výsledek do formátu Base64.

Ve Windows můžete pomocí PowerShellu vygenerovat odvozený klíč zařízení, jak je znázorněno v následujícím příkladu.

Nahraďte hodnotu KEY primárním klíčem , který jste si poznamenali dříve.

Nahraďte hodnotu REG_ID ID registrace vašeho zařízení.

$KEY='PASTE_YOUR_ENROLLMENT_KEY_HERE'
$REG_ID='PASTE_YOUR_REGISTRATION_ID_HERE'

$hmacsha256 = New-Object System.Security.Cryptography.HMACSHA256
$hmacsha256.key = [Convert]::FromBase64String($KEY)
$sig = $hmacsha256.ComputeHash([Text.Encoding]::ASCII.GetBytes($REG_ID))
$derivedkey = [Convert]::ToBase64String($sig)
echo "`n$derivedkey`n"

Níže je ukázkový výstup odvozeného klíče zařízení:

Jsm0lyGpjaVYVP2g3FnmnmG9dI/9qU24wNoykUmermc=

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 případě PowerShellu spusťte následující příkaz se zástupnými hodnotami aktualizovanými vlastními hodnotami:

Provision-EflowVm -provisioningType DpsSymmetricKey -​scopeId PASTE_YOUR_ID_SCOPE_HERE -registrationId PASTE_YOUR_REGISTRATION_ID_HERE -symmKey PASTE_YOUR_PRIMARY_KEY_OR_DERIVED_KEY_HERE

V Centru pro správu Windows použijte následující kroky:

1. V podokně zřizování zařízení Azure IoT Edge vyberte v rozevíracím seznamu metody zřizování symetrický klíč (DPS ).

2. Na webu Azure Portal přejděte k vaší instanci DPS.

3. Do polí Windows Admin Center zadejte ID oboru DPS, ID registrace zařízení a primární klíč registrace nebo odvozený klíč.

4. Zvolte Zřizování s vybranou metodou.

   

5. 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í, jehož typ je 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í.

Můžete ověřit, že se použila jednotlivá registrace, kterou jste vytvořili ve službě device Provisioning. Na webu Azure Portal přejděte k instanci služby zřizování zařízení. Otevřete podrobnosti o registraci pro jednotlivou registraci, kterou jste vytvořili. Všimněte si, že se přiřadí stav registrace a zobrazí se ID zařízení.

Můžete ověřit, jestli se použila registrace skupiny, kterou jste vytvořili ve službě device Provisioning. Na webu Azure Portal přejděte k instanci služby zřizování zařízení. Otevřete podrobnosti o registraci skupiny, kterou jste vytvořili. Přejděte na kartu Registrační záznamy a zobrazte všechna zařízení zaregistrovaná v této skupině.

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ý).