Skapa och etablera en IoT Edge för Linux på Windows-enhet med hjälp av symmetriska nycklar

En kostnadsfri eller standard-IoT-hubb i din Azure-prenumeration.

• En kostnadsfri IoT-hubb eller standard-IoT-hubb i din Azure-prenumeration
• Visual Studio Code
• Azure IoT Hub-tillägg
• Azure IoT Edge för Visual Studio Code

• En kostnadsfri IoT-hubb eller standard-IoT-hubb i din Azure-prenumeration

• Azure CLI i din miljö

  Azure CLI-versionen måste minst vara 2.0.70 eller senare. Använd az --version för att verifiera. Den här versionen har stöd för az-tilläggskommandon och introducerar kommandoramverket Knack.

Om du vill använda PowerShell använder du följande steg för att förbereda målenheten för installationen av Azure IoT Edge för Linux i Windows och distributionen av den virtuella Linux-datorn:

1. Ange exekveringsprincipen på målenheten till AllSigned. Du kan kontrollera den aktuella körningsprincipen i en upphöjd PowerShell-prompt med hjälp av följande kommando:

   Get-ExecutionPolicy -List
   

   Om körningsprincipen för local machine inte är AllSigned, kan du ange körningsprincipen med hjälp av AllSigned.

   Set-ExecutionPolicy -ExecutionPolicy AllSigned -Force
   

Mer information om Azure IoT Edge för Linux i Windows PowerShell-modulen finns i PowerShell-funktionsreferensen.

Om du vill använda Windows Admin Center använder du följande steg för att ladda ned och installera Windows Admin Center och installera Windows Admin Center Azure IoT Edge-tillägget:

1. Ladda ned och kör installationsprogrammet för Windows Admin Center. Följ installationsguidens uppmaningar om att installera Windows Admin Center.

2. När du har installerat den använder du en webbläsare som stöds för att öppna Administrationscenter för Windows. Webbläsare som stöds är Microsoft Edge (Windows 10, version 1709 eller senare), Google Chrome och Microsoft Edge Insider.

3. Vid den första användningen av Administrationscenter för Windows uppmanas du att välja ett certifikat som ska användas. Välj Windows Admin Center Client som certifikat.

4. Installera Azure IoT Edge-tillägget. Välj kugghjulsikonen längst upp till höger på instrumentpanelen för Windows Administrationscenter.

   

5. På menyn Inställningar går du till Gateway och väljer Tillägg.

6. På fliken Tillgängliga tillägg hittar du Azure IoT Edge i listan över tillägg. Välj den och välj kommandotolken Installera ovanför listan med tillägg.

7. När installationen är klar bör du se Azure IoT Edge i listan över installerade tillägg på fliken Installerade tillägg .

I din IoT-hubb i Azure Portal skapas och hanteras IoT Edge-enheter separat från IoT-enheter som inte är edge-aktiverade.

1. Logga in på Azure-portalen och gå till din IoT-hubb.

2. I den vänstra rutan väljer du Enheter på menyn och väljer sedan Lägg till enhet.

3. På sidan Skapa en enhet anger du följande information:

   • Skapa ett beskrivande enhets-ID. Anteckna det här enhets-ID:t eftersom du kommer att använda det senare.
   • Markera kryssrutan IoT Edge-enhet .
   • Välj Symmetrisk nyckel som autentiseringstyp.
   • Använd standardinställningarna för att generera autentiseringsnycklar automatiskt och ansluta den nya enheten till hubben.

4. Välj Spara.

Logga in för att komma åt din IoT-hubb

Du kan använda Azure IoT-tilläggen för Visual Studio Code för att utföra åtgärder med din IoT-hubb. För att dessa åtgärder ska fungera måste du logga in på ditt Azure-konto och välja din hubb.

1. Öppna Utforskarvyn i Visual Studio Code.

2. Längst ned i Utforskaren expanderar du avsnittet Azure IoT Hub .

   

3. Klicka på ... i avsnittsrubriken Azure IoT Hub. Om du inte ser ellipsen klickar du på eller hovra över rubriken.

4. Välj Välj IoT Hub.

5. Om du inte är inloggad på ditt Azure-konto följer du anvisningarna för att göra det.

6. Välj din Azure-prenumeration.

7. Välj din IoT-hubb.

Registrera en ny enhet med Visual Studio Code

1. I Visual Studio Code Explorer expanderar du avsnittet Azure IoT Hub .
2. Klicka på ... i avsnittsrubriken Azure IoT Hub. Om du inte ser ellipsen klickar du på eller hovra över rubriken.
3. Välj Skapa IoT Edge-enhet.
4. Ge enheten ett ID i textrutan som öppnas.

På utdataskärmen ser du resultatet av kommandot. Enhetsinformationen skrivs ut, som innehåller det deviceId som du angav och den connectionString som du kan använda för att ansluta din fysiska enhet till din IoT-hubb.

Använd kommandot az iot hub device-identity create för att skapa en ny enhetsidentitet i din IoT-hubb. Till exempel:

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

Det här kommandot innehåller tre parametrar:

• --device-id eller -d: Ange ett beskrivande namn som är unikt i din IoT-hubb.

• --hub-name eller -n: Ange namnet på din IoT-hubb.

• --edge-enabled eller --ee: Deklarera att enheten är en IoT Edge-enhet.

  

De gränsaktiverade enheter som ansluter till din IoT-hubb visas på sidan Enheter . Du kan filtrera listan efter typ av Iot Edge-enhet.

När du är redo att konfigurera enheten behöver du den anslutningssträng som länkar den fysiska enheten till dess identitet i IoT-hubben.

Enheter som autentiserar med symmetriska nycklar har sina anslutningssträng tillgängliga att kopiera i portalen.

1. På sidan Enheter i portalen väljer du IoT Edge-enhets-ID i listan.
2. Kopiera värdet för antingen primär anslutningssträng eller sekundär anslutningssträng.

Alla enheter som ansluter till din IoT-hubb visas i avsnittet Azure IoT Hub i Visual Studio Code Explorer. IoT Edge-enheter kan skiljas från icke-Edge-enheter med en annan ikon och det faktum att modulerna $edgeAgent och $edgeHub distribueras till varje IoT Edge-enhet.

När du är redo att konfigurera enheten behöver du den anslutningssträng som länkar den fysiska enheten till dess identitet i IoT-hubben.

1. Högerklicka på enhetens ID i avsnittet Azure IoT Hub .

2. Välj Kopiera enhetsanslutningssträng.

   Anslutningssträngen kopieras till ditt Urklipp.

Du kan också välja Hämta enhetsinformation på högerklicksmenyn för att se all enhetsinformation, inklusive anslutningssträngen, i utdatafönstret.

Använd kommandot az iot hub device-identity list för att visa alla enheter i din IoT-hubb. Till exempel:

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

Alla enheter som är registrerade som en IoT Edge-enhet har egenskapen capabilities.iotEdge inställd på true.

När du är redo att konfigurera enheten behöver du den anslutningssträng som länkar den fysiska enheten till dess identitet i IoT-hubben. Använd kommandot az iot hub device-identity connection-string show för att returnera anslutningssträngen för en enda enhet:

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

Värdet för parametern device-id är skiftlägeskänsligt.

När du kopierar anslutningssträng som ska användas på en enhet ska du inte ta med citattecknen runt anslutningssträng.

Installera IoT Edge för Linux på Windows på målenheten.

1. I en upphöjd PowerShell-session kör du vart och ett av följande kommandon för att ladda ned IoT Edge för Linux i Windows.

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

2. Installera IoT Edge för Linux på Windows på din enhet.

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

   Du kan ange anpassad IoT Edge för Linux i Windows-installation och VHDX-kataloger genom att lägga till INSTALLDIR="<FULLY_QUALIFIED_PATH>" och VHDXDIR="<FULLY_QUALIFIED_PATH>" parametrar i installationskommandot. Om du till exempel vill använda mappen D:\EFLOW för installation och D:\EFLOW-VHDX för VHDX kan du använda följande PowerShell-cmdlet.

   Start-Process -Wait msiexec -ArgumentList "/i","$([io.Path]::Combine($env:TEMP, 'AzureIoTEdge.msi'))","/qn","INSTALLDIR=D:\EFLOW", "VHDXDIR=D:\EFLOW-VHDX"
   

3. Ställ in körningspolicyn på målenheten till AllSigned om den inte redan är inställd. Se PowerShell-kraven för kommandon för att kontrollera den aktuella körningsprincipen och ange körningsprincipen till AllSigned.

4. Skapa IoT Edge för Linux i Windows-distributionen. Distributionen skapar din virtuella Linux-dator och installerar IoT Edge-körningen åt dig.

   Deploy-Eflow
   

   Tips/Råd

   Som standard skapar kommandot den Deploy-Eflow virtuella Linux-datorn med 1 GB RAM-minne, 1 vCPU-kärna och 16 GB diskutrymme. De resurser som din virtuella dator behöver är dock mycket beroende av de arbetsbelastningar som du distribuerar. Om den virtuella datorn inte har tillräckligt med minne för att stödja dina arbetsbelastningar startar den inte.

   Du kan anpassa den virtuella datorns tillgängliga resurser med hjälp av Deploy-Eflow kommandots valfria parametrar.

   Kommandot nedan skapar till exempel en virtuell dator med 4 vCPU-kärnor, 4 GB RAM-minne (representerat i MB) och 20 GB diskutrymme:

   Deploy-Eflow -cpuCount 4 -memoryInMB 4096 -vmDiskSize 20
   

   Information om alla tillgängliga valfria parametrar finns i PowerShell-funktioner för IoT Edge för Linux i Windows.

   Varning

   Som standard har den virtuella EFLOW Linux-datorn ingen DNS-konfiguration. Distributioner med DHCP försöker hämta DNS-konfigurationen som sprids av DHCP-servern. Kontrollera DNS-konfigurationen för att säkerställa internetanslutningen. Mer information finns i AzEFLOW-DNS.

   Du kan tilldela en GPU till din distribution för att aktivera GPU-accelererade Linux-moduler. För att få åtkomst till dessa funktioner måste du installera kraven som beskrivs i GPU-acceleration för Azure IoT Edge för Linux i Windows.

   Om du vill använda en GPU-genomströmning lägger du till parametrarna gpuName, gpuPassthroughType och gpuCount i kommandot Deploy-Eflow . Information om alla tillgängliga valfria parametrar finns i PowerShell-funktioner för IoT Edge för Linux i Windows.

   Varning

   Aktivering av tillträde för maskinvaruenheter kan öka säkerhetsriskerna. Microsoft rekommenderar en enhetsreduceringsdrivrutin från GPU:ns leverantör när det är tillämpligt. Mer information finns i Distribuera grafikenheter med diskret enhetstilldelning.

5. Ange "Y" för att godkänna licensvillkoren.

6. Ange "O" eller "R" för att växla Valfria diagnostikdata på eller av, beroende på vad du föredrar.

7. När distributionen är klar rapporterar PowerShell-fönstret Distributionen lyckades.

   

   Efter en lyckad distribution är du redo att konfigurera enheten.

1. Installera och öppna Administrationscenter för Windows.

   På startsidan för Windows Admin Center, under listan över anslutningar, visas en lokal värdanslutning som representerar den dator där du kör Windows Admin Center. Eventuella ytterligare servrar, datorer eller kluster som du hanterar visas också här.

   Du kan använda Windows Admin Center för att hantera Azure IoT Edge för Linux i Windows på antingen din lokala enhet eller fjärrhanterade enheter. I den här guiden fungerar den lokala värdanslutningen som målenhet för distributionen av Azure IoT Edge för Linux i Windows.

2. Bekräfta att din lokala enhet visas under Alla anslutningar, som du ser nedan.

   

   Om du vill distribuera till en fjärrmålenhet i stället för din lokala enhet och du inte ser önskad målenhet i listan följer du anvisningarna för att lägga till enheten.

3. Välj + Lägg till för att börja skapa distributionen. Distributionen skapar din virtuella Linux-dator och installerar IoT Edge-körningen åt dig.

4. Leta upp Panelen Azure IoT Edge i fönstret Lägg till eller skapa resurser. Välj Skapa ny för att installera en ny instans av Azure IoT Edge för Linux på Windows på en enhet.

   Om du redan har IoT Edge för Linux på Windows som körs på en enhet kan du välja Lägg till för att ansluta till den befintliga IoT Edge-enheten och hantera den med Windows Admin Center.

   

5. Distributionsfönstret Skapa en Azure IoT Edge för Linux i Windows öppnas. På fliken 1. Getting Started, granska minimikraven och välj Nästa.

6. Granska licensvillkoren, kontrollera Jag accepterar och välj Nästa.

7. Du kan växla Valfria diagnostikdata på eller av, beroende på vad du föredrar.

8. Välj Nästa: Distribuera.

   

9. På fliken 2. Distribuera, under Välj en målenhet, klickar du på din lista enhet för att verifiera att den uppfyller minimikraven. När dess status har bekräftats som stöds väljer du Nästa.

   

10. På fliken 2.2-inställningar granskar du konfigurationsinställningarna för distributionen. Tabellen nedan visar inställningarna och deras standardvärden.

    Inställning	Standardvärde
    Storlek på virtuell disk i GB	16
    Minne i MB (jämnt tal)	1024
    Antal kärnor	2
    Azure IoT Edge-version	1.1 (LTS)

    Anmärkning

    IoT Edge för Linux i Windows använder en standardväxel som tilldelar den virtuella Linux-datorn en intern IP-adress. Det går inte att nå den här interna IP-adressen utanför Windows-datorn. Du kan ansluta till den virtuella datorn lokalt när du är inloggad på Windows-datorn.

    Om du använder Windows Server konfigurerar du en standardväxel innan du distribuerar IoT Edge för Linux i Windows.

    Du kan tilldela en GPU till din distribution för att aktivera GPU-accelererade Linux-moduler. För att få åtkomst till dessa funktioner måste du installera kraven som beskrivs i GPU-acceleration för Azure IoT Edge för Linux i Windows. Om du bara installerar de här förutsättningarna just nu i distributionsprocessen måste du börja om från början.

    Det finns två alternativ för GPU-genomströmning: Direkt enhetstilldelning (DDA) och GPU Paravirtualization (GPU-PV), beroende på vilken GPU-adapter du tilldelar distributionen.

    För metoden för direkt enhetstilldelning väljer du antalet GPU-processorer som ska allokeras till den virtuella Linux-datorn.

    För paravirtualiseringsmetoden behövs inga ytterligare inställningar.

    Varning

    Aktivering av tillträde för maskinvaruenheter kan öka säkerhetsriskerna. Microsoft rekommenderar en enhetsreduceringsdrivrutin från GPU:ns leverantör när det är tillämpligt. Mer information finns i Distribuera grafikenheter med diskret enhetstilldelning.

    När du är nöjd med inställningarna väljer du Nästa.

11. På fliken 2.3-distribution kan du titta på distributionens förlopp. Den fullständiga processen omfattar nedladdning av Azure IoT Edge för Linux i Windows-paketet, installation av paketet, konfiguration av värdenheten och konfiguration av den virtuella Linux-datorn. Den här processen kan ta flera minuter att slutföra. En lyckad distribution visas nedan.

    

12. När distributionen är klar är du redo att konfigurera din enhet. Välj Nästa: Anslut för att fortsätta till 3. Fliken Anslut , som hanterar Azure IoT Edge-enhetsetablering.

Kör följande kommando i en upphöjd PowerShell-session på målenheten. Ersätt platshållartexten med dina egna värden.

Provision-EflowVm -provisioningType ManualConnectionString -devConnString "PASTE_DEVICE_CONNECTION_STRING_HERE"

Mer information om kommandot finns i Provision-EflowVMPowerShell-funktioner för IoT Edge för Linux i Windows.

1. I fönstret Azure IoT Edge-enhetsetablering väljer du Anslutningssträng (manuell) i listrutan etableringsmetod.

2. Ange enhetsanslutningssträngen som du hämtade från IoT Hub när du har registrerat enheten.

3. Välj Etablering med den valda metoden.

   

4. När etableringen är klar väljer du Slutför. Du kommer tillbaka till huvudinstrumentpanelen. Nu bör du se en ny enhet listad med typen IoT Edge Devices. Du kan välja den IoT Edge-enhet som ska anslutas till den. På sidan Översikt kan du visa IoT Edge-modullistan och IoT Edge-statusen för enheten.

1. Logga in på din IoT Edge för Linux på en virtuell Windows-dator med följande kommando i PowerShell-sessionen:

   Connect-EflowVm
   

   Anmärkning

   Det enda konto som tillåts för SSH till den virtuella datorn är användaren som skapade det.

2. När du är inloggad kan du kontrollera listan över IoT Edge-moduler som körs med hjälp av följande Linux-kommando:

   sudo iotedge list
   

3. Om du behöver felsöka IoT Edge-tjänsten använder du följande Linux-kommandon.

   1. Hämta tjänstloggarna.

      sudo journalctl -u iotedge
      

   2. Använd verktyget check för att verifiera enhetens konfigurations- och anslutningsstatus.

      sudo iotedge check
      

   Anmärkning

   På en nyligen konfigurerad enhet kan du se ett fel som rör IoT Edge Hub.

   × produktionsberedskap: Edge Hubs lagringskatalog sparas i värdfilsystemet – Fel

   Det gick inte att kontrollera det aktuella tillståndet för edgeHub-containern

   Det här felet förväntas på en nyligen etablerad enhet eftersom IoT Edge Hub-modulen inte körs. Lös felet genom att ange modulerna för enheten i IoT Hub och skapa en distribution. När du skapar en distribution för enheten startas modulerna på enheten, inklusive IoT Edge Hub-modulen.

1. Välj din IoT Edge-enhet i listan över anslutna enheter i Administrationscenter för Windows för att ansluta till den.

2. På sidan enhetsöversikt visas viss information om enheten:

   • Avsnittet IoT Edge-modullista visar moduler som körs på enheten. När IoT Edge-tjänsten startar för första gången bör du bara se edgeAgent-modulen köras. EdgeAgent-modulen körs som standard och hjälper till att installera och starta eventuella ytterligare moduler som du distribuerar till enheten.

   • Avsnittet IoT Edge-status visar tjänstens status och ska rapportera aktiv (körs).