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

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

• En kostnadsfri eller standard-IoT Hub i din Azure-prenumeration
• Visual Studio Code
• Azure IoT Tools för Visual Studio Code

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

• Azure CLI i din miljö

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

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

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

   Get-ExecutionPolicy -List
   

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

   Set-ExecutionPolicy -ExecutionPolicy AllSigned -Force
   

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

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

1. Ladda ned och kör installationsprogrammet Windows Administrationscenter. Följ installationsguidens prompter för att installera Windows Administrationscenter.

2. När installationen är installerad använder du en webbläsare som stöds för att Windows Administrationscenter. 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 Windows Administrationscenter 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å Windows Administrationscenter.

   

5. På Inställningar väljer du Tillägg under Gateway.

6. På fliken Tillgängliga tillägg hittar du Azure IoT Edge i listan över tillägg. Välj den och välj installationsupptolken ovanför listan över 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 IoT-hubben i Azure Portal skapas IoT Edge och hanteras separat från IoT-enheter som inte är gränsaktiverade.

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

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

   

3. Ange följande information på sidan Skapa en enhet:

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

4. Välj Spara.

Logga in för att få åtkomst till din IoT-hubb

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

1. Öppna Visual Studio Explorer-vyn i Visual Studio Code.

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

   

3. Klicka på ... i Azure IoT Hub avsnittsrubriken. Om du inte ser ellipsen klickar du på eller hovrar ö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 Azure IoT Hub avsnitt.
2. Klicka på ... i Azure IoT Hub avsnittsrubriken. Om du inte ser ellipsen klickar du på eller hovrar över rubriken.
3. Välj Skapa IoT Edge enhet.
4. Ge enheten ett ID i textrutan som öppnas.

Resultatet av kommandot visas på utdataskärmen. Enhetsinformationen skrivs ut, inklusive det deviceId som du angav och connectionString som du kan använda för att ansluta den fysiska enheten till din IoT-hubb.

Använd kommandot az iot hub device-identity create för att skapa en ny enhetsidentitet i din IoT-hubb. 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.

  

Alla gränsaktiverade enheter som ansluter till din IoT-hubb visas på IoT Edge sidan.

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

Enheter som autentiseras med symmetriska nycklar har anslutningssträngar tillgängliga för kopiering i portalen.

1. På IoT Edge i portalen klickar du på enhets-ID:t i listan över IoT Edge enheter.
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 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 anslutningssträngen som länkar den fysiska enheten till dess identitet i IoT Hub.

1. Högerklicka på ID:t för din enhet i Azure IoT Hub avsnitt.

2. Välj Kopiera enhetens anslutningssträng.

   Anslutningssträngen kopieras till Urklipp.

Du kan också välja Hämta enhetsinformation på snabbmenyn 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. Exempel:

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

Alla enheter som är registrerade som IoT Edge enheter har egenskapen capabilities.iotEdge inställt på true.

När du är redo att konfigurera enheten behöver du anslutningssträngen som länkar den fysiska enheten till dess identitet i IoT Hub. Använd kommandot az iot hub device-identity connection-string show för att returnera anslutningssträngen för en enskild 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 fallkänsligt.

När du kopierar anslutningssträngen som ska användas på en enhet ska du inte inkludera citattecknen runt anslutningssträngen.

Installera IoT Edge 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 IoT Edge för Linux på Windows.

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

2. Installera IoT Edge linux på Windows på enheten.

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

   Du kan ange anpassade IoT Edge linux på Windows-installation och VHDX-kataloger genom att lägga till parametrarna och INSTALLDIR="<FULLY_QUALIFIED_PATH>" VHDXDIR="<FULLY_QUALIFIED_PATH>" i installationskommandot.

3. Ange körningsprincipen på målenheten till AllSigned om den inte redan är det. Se PowerShell-krav för kommandon för att kontrollera den aktuella körningsprincipen och ange körningsprincipen till AllSigned .

4. Skapa IoT Edge Linux på Windows distribution. Distributionen skapar din virtuella Linux-dator och installerar IoT Edge körtid åt dig.

   Deploy-Eflow
   

   Tips

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

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

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

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

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

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

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

   Varning

   Aktivering av genomströmning för maskinvaruenheter kan öka säkerhetsriskerna. Microsoft rekommenderar en drivrutin för enhetminskning från DIN GPU-leverantör, i förekommande fall. 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 aktivera eller inaktivera valfria diagnostikdata, beroende på vad du föredrar.

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

   

   När distributionen är klar är du redo att etablera enheten.

Installera Azure IoT Edge linux på Windows på enheten.

1. Ladda ned Azure IoT Edge för Linux på Windows installationsprogrammet.

2. När du har installerat Azure IoT Edge Linux på Windows öppnar du Windows Administrationscenter.

   På Windows administrationscentrets startsida under listan över anslutningar visas en lokal värdanslutning som representerar den dator där du kör Windows Administrationscenter. Ytterligare servrar, datorer eller kluster som du hanterar visas också här.

   Du kan använda Windows administrationscenter för att installera och hantera Azure IoT Edge för Linux på 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 distribution av Azure IoT Edge för Linux på Windows.

3. Kontrollera att den lokala enheten visas under Alla anslutningar, som du ser nedan.

   

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

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

5. I fönstret Lägg till eller skapa resurser letar du upp Azure IoT Edge panelen. 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 Administrationscenter.

   

6. Fönstret Skapa Azure IoT Edge för Linux Windows distribution öppnas. På 1. Komma igång du minimikraven och väljer Nästa.

7. Granska licensvillkoren, markera Jag accepterar och välj Nästa.

8. Du kan aktivera eller inaktivera valfria diagnostikdata beroende på vad du föredrar.

9. Välj Nästa: Distribuera.

   

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

    

11. På fliken 2.2 Inställningar du konfigurationsinställningarna för distributionen. I tabellen nedan visas inställningarna och deras standardvärden.

    Inställning	Standardvärde
    Virtuell diskstorlek i GB	16
    Minne i MB	1024
    Antal kärnor	2
    Azure IoT Edge version	1.1 (LTS)

    Anteckning

    IoT Edge linux på Windows en standardväxel som tilldelar den virtuella Linux-datorn en intern IP-adress. Den här interna IP-adressen kan inte nås 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 måste du konfigurera en standardväxel innan du distribuerar IoT Edge för Linux på Windows.

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

    Det finns två tillgängliga alternativ för GPU-genomströmning: Direkt enhetstilldelning (DDA) och GPU Paravirtualization (GPU-PV), beroende på GPU-adaptern som du tilldelar till distributionen.

    För direkt enhetstilldelningsmetod väljer du antalet GPU-processorer som ska allokeras till din virtuella Linux-dator.

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

    Varning

    Aktivering av genomströmning för maskinvaruenheter kan öka säkerhetsriskerna. Microsoft rekommenderar en drivrutin för enhetminskning från DIN GPU-leverantör, i förekommande fall. Mer information finns i Distribuera grafikenheter med diskret enhetstilldelning.

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

12. På fliken 2.3 Distribution kan du se förloppet för distributionen. Den fullständiga processen omfattar att ladda ned Azure IoT Edge för Linux på Windows-paket, installera paketet, konfigurera värdenheten och konfigurera den virtuella Linux-datorn. Den här processen kan ta flera minuter att slutföra. En lyckad distribution visas nedan.

    

13. När distributionen är klar är du redo att etablera enheten. Välj Nästa: Anslut för att fortsätta till 3. 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 Provision-EflowVM finns i PowerShell functions for IoT Edge for Linux on Windows.

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

2. Ange den enhetsanslutningssträng som du hämtade 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 för att ansluta till den. När du är på sidan Översikt kan du IoT Edge lista över moduler och IoT Edge status för din enhet.

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

   Connect-EflowVm
   

   Anteckning

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

2. När du är inloggad kan du kontrollera listan över körningsmoduler IoT Edge 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 konfiguration och anslutningsstatus.

      sudo iotedge check
      

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

2. På översiktssidan för enheten visas viss information om enheten:

   • Avsnittet IoT Edge modullista visar moduler som körs på enheten. När IoT Edge 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änststatus och bör rapportera aktiv (körs).