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

Platí pro:  Ikona ano IoT Edge 1.1

tento článek popisuje kompletní pokyny k registraci a zřízení IoT Edge pro Linux v Windowsm zařízení.

Každé zařízení, které se připojuje ke IoT Hub, má ID zařízení, které se používá ke sledování komunikace z cloudu na zařízení nebo ze zařízení do cloudu. Zařízení nakonfigurujete s informacemi o připojení, které zahrnují název hostitele IoT Hub, ID zařízení a informace, které zařízení používá k ověření IoT Hub.

Kroky v tomto článku vás provedou procesem, který se nazývá ruční zřizování, kde připojíte jedno zařízení ke službě IoT Hub. Pro ruční zřizování máte dvě možnosti ověřování IoT Edge zařízení:

  • Symetrické klíče: když v IoT Hub vytvoříte novou identitu zařízení, služba vytvoří dva klíče. Do zařízení umístíte jeden z klíčů a při ověřování se zobrazí klíč, který se IoT Hub.

    Tato metoda ověřování je rychlejší, aby se dala začít, ale ne tak bezpečné.

  • X. 509 podepsaný svým držitelem: vytvoříte dva certifikáty identit x. 509 a umístíte je na zařízení. Když v IoT Hub vytvoříte novou identitu zařízení, zadáváte kryptografické otisky z obou certifikátů. Když se zařízení ověří 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 v Windows zařízení pomocí certifikátů x. 509.

Poznámka

Pokud máte k dispozici mnoho zařízení a nechcete je ručně zřídit, použijte jeden z následujících článků a zjistěte, jak IoT Edge pracuje se službou IoT Hub Device Provisioning:

Požadavky

Tento článek popisuje registraci zařízení IoT Edge a instalaci IoT Edge pro Linux na Windows. Tyto úlohy mají různé požadavky a nástroje, které se používají k jejich splnění. Před pokračováním se ujistěte, že máte všechny požadované předpoklady.

Nástroje pro správu zařízení

k postupu registrace zařízení můžete použít Azure Portal, Visual Studio Code nebo rozhraní příkazového řádku Azure . Každý nástroj má své vlastní požadavky:

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

Požadavky na zařízení

Zařízení Windows s následujícími minimálními požadavky:

  • Požadavky na systém

    • Windows 101/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ěť: 1 GB
    • Minimální volné místo na disku: 10 GB
  • Podpora virtualizace

  • Podpora sítí

    • Windows Server nemá výchozí přepínač. Než budete moci nasadit EFLOW na Windows Server, 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 na Windows.
    • Windows Desktop se dodá s výchozím přepínačem, který se může použít pro instalaci EFLOW. V případě potřeby můžete vytvořit vlastní virtuální přepínač.

Tip

Pokud chcete používat linuxové moduly akcelerované pomocí GPU ve vašem Azure IoT Edge linuxovém nasazení Windows, je třeba zvážit 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 Windows Insider Program sestavení. Pokud chcete určit potřeby konfigurace a splnit tyto požadavky, podívejte se na akceleraci GPU pro Azure IoT Edge Linux na Windows.

Ujistěte se, že teď máte čas splnit požadavky na akceleraci GPU. Pokud se rozhodnete, že chcete během instalace akcelerovat GPU, budete muset proces instalace restartovat.

Vývojářské nástroje

Ke správě zařízení s Windows můžete použít PowerShell nebo centrum IoT Edge správy. Každý nástroj má své vlastní požadavky:

Pokud chcete použít PowerShell, pomocí následujícího postupu připravte cílové zařízení na instalaci Azure IoT Edge pro Linux na Windows a nasazení virtuálního počítače s Linuxem:

  1. Nastavte zásady 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 -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
    

Další informace o modulu Azure IoT Edge linuxu v Windows PowerShell najdete v tématu Referenční informace k funkcím PowerShellu.

Registrace zařízení

Zařízení můžete zaregistrovat pomocí Azure Portal, Visual Studio Code nebo Azure CLI.

Ve službě IoT Hub v Azure Portal se IoT Edge zařízení vytvářejí a spravují odděleně od zařízení IoT, která nemají povolené hraniční zařízení.

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

  2. V levém podokně vyberte IoT Edge a pak vyberte Přidat IoT Edge zařízení.

    Přidání IoT Edge zařízení z Azure Portal

  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.
    • Jako typ ověřování vyberte Symetrický klíč.
    • Pomocí výchozího nastavení můžete automaticky vygenerovat ověřovací klíče a připojit nové zařízení k centru.
  4. Vyberte Uložit.

Teď, když máte zařízení zaregistrované v IoT Hub, načtěte informace, které použijete k dokončení instalace a zřízení modulu runtime IoT Edge runtime.

Zobrazení registrovaných zařízení a načtení informací o zřizování

Zařízení, která používají ověřování pomocí symetrického klíče, potřebují své připojovací řetězce k dokončení instalace a IoT Edge modulu runtime.

Všechna hraniční zařízení, která se připojují k centru IoT, jsou uvedená na IoT Edge portálu.

Pomocí Azure Portal můžete zobrazit všechna IoT Edge zařízení ve vašem centru IoT.

Až budete připraveni nastavit zařízení, budete potřebovat připojovací řetězec, který prováže vaše fyzické zařízení s jeho identitou v centru IoT.

Zařízení, která se ověřují pomocí symetrických klíčů, mají své připojovací řetězce k dispozici ke kopírování na portálu.

  1. Na IoT Edge portálu klikněte v seznamu zařízení na ID IoT Edge zařízení.
  2. Zkopírujte hodnotu primárního připojovacího řetězce nebo sekundárního připojovacího řetězce.

Nainstalovat IoT Edge

nasaďte Azure IoT Edge pro Linux na Windows na cílovém zařízení.

nainstalujte IoT Edge pro Linux na Windows na cílovém zařízení.

Poznámka

následující proces powershellu popisuje, jak nasadit IoT Edge pro Linux v Windows na místní zařízení. K nasazení na vzdálené cílové zařízení pomocí PowerShellu můžete použít vzdálené prostředí PowerShell k navázání připojení ke vzdálenému zařízení a spuštění těchto příkazů na tomto zařízení vzdáleně.

  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 IoT Edge pro Linux v 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 v Windows na svém zařízení.

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

    můžete zadat vlastní IoT Edge pro Linux v Windows instalaci a adresáře VHDX přidáním INSTALLDIR="<FULLY_QUALIFIED_PATH>" VHDXDIR="<FULLY_QUALIFIED_PATH>" parametrů a do příkazu install.

  3. Nastavte zásady spouštění na cílovém zařízení na, pokud ještě není AllSigned . Pokud chcete kontrolovat aktuální zásady spouštění a nastavit zásady spouštění na, přečtěte si téma předpoklady prostředí PowerShell pro příkazy AllSigned .

  4. vytvořte IoT Edge pro Linux při nasazení Windows. Nasazení vytvoří virtuální počítač se systémem Linux a nainstaluje IoT Edge modul runtime za vás.

    Deploy-Eflow
    

    Tip

    Ve výchozím nastavení Deploy-Eflow příkaz vytvoří virtuální počítač se systémem Linux s 1 GB paměti RAM, 1 vCPU jádrem a 16 GB místa na disku. Prostředky, které váš virtuální počítač potřebuje, jsou vysoce závislé na zatíženích, která nasazujete. Pokud váš virtuální počítač nemá dostatek paměti pro podporu vašich úloh, spuštění se nezdaří.

    Dostupné prostředky virtuálního počítače můžete přizpůsobit pomocí Deploy-Eflow volitelných parametrů příkazu.

    Například následující příkaz vytvoří virtuální počítač se 4 vCPU jádry, 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 naleznete v tématu funkce PowerShellu pro IoT Edge pro Linux v Windows.

    K nasazení můžete přiřadit GPU a povolit moduly Linux podporující GPU. Pokud chcete získat přístup k těmto funkcím, budete muset nainstalovat požadavky popsané v akceleraci GPU pro Azure IoT Edge pro Linux v Windows.

    Pokud chcete použít průchozí GPU, přidejte do příkazu parametry gpuName, gpuPassthroughType a gpuCount Deploy-Eflow . Informace o všech dostupných volitelných parametrech naleznete v tématu funkce PowerShellu pro IoT Edge pro Linux v Windows.

    Upozornění

    Povolení průchozího hardwarového zařízení může zvýšit bezpečnostní riziko. Microsoft doporučuje od dodavatele GPU ovladač pro zmírnění zařízení, pokud je k dispozici. Další informace najdete v tématu nasazení grafických zařízení pomocí diskrétního přiřazení zařízení.

  5. Pokud souhlasíte s licenčními podmínkami, zadejte ' Y '.

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

  7. Po dokončení nasazení sestaví okno PowerShellu úspěšné nasazení.

    Po úspěšném nasazení se na konci zpráv (PNG) říká úspěšné nasazení.

    Po úspěšném nasazení budete připraveni zřídit své zařízení.

Zřízení zařízení pomocí cloudové identity

Jste připravení nastavit zařízení pomocí své cloudové identity a ověřovacích informací.

Pokud chcete zařízení zřídit pomocí symetrických klíčů, budete potřebovat připojovací řetězec vašeho zařízení.

k zřizování zařízení můžete použít centrum pro správu Windows nebo relaci powershellu se zvýšenými oprávněními.

Spusťte následující příkaz v relaci PowerShellu se zvýšenými oprávněními na cílovém zařízení. 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 Provision-EflowVM tématu funkce PowerShellu pro IoT Edge pro Linux v Windows.

Ověřit úspěšnou konfiguraci

ověřte, že IoT Edge pro Linux v Windows byl úspěšně nainstalován a nakonfigurován na zařízení IoT Edge.

  1. přihlaste se ke svému IoT Edge pro Linux na Windows virtuálním počítači pomocí následujícího příkazu v relaci powershellu:

    Connect-EflowVm
    

    Poznámka

    Jediným účtem povoleným pro 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 pro Linux vyhledat seznam spuštěných IoT Edge modulů:

    sudo iotedge list
    
  3. Pokud potřebujete řešit potíže se službou IoT Edge, použijte následující příkazy systému Linux.

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

      sudo journalctl -u iotedge
      
    2. Použijte check Nástroj k ověření stavu konfigurace a připojení zařízení.

      sudo iotedge check
      

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

Další kroky