Skapa och etablera IoT Edge för Linux på Windows-enheter i stor skala med hjälp av symmetriska nycklar

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 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-klient 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 Gatewayoch väljer Tillägg.

6. På fliken Tillgängliga tillägg hittar du Azure IoT Edge- i listan med tillägg. Välj det, och välj Installera-kommandot 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.

Skapa en individuell DPS-registrering

1. I Azure Portal navigerar du till din instans av IoT Hub-enhetsetableringstjänsten.

2. Under Inställningar väljer du Hantera registreringar.

3. Välj Lägg till enskild registrering och slutför sedan följande steg för att konfigurera registreringen:

   1. För Mekanism väljer du Symmetrisk nyckel.

   2. Ange ett unikt registrerings-ID för din enhet.

   3. Du kan också ange ett IoT Hub-enhets-ID för din enhet. Du kan använda enhets-ID:n för att rikta in dig på en enskild enhet för moduldistribution. Om du inte anger något enhets-ID används registrerings-ID:t.

   4. Välj Sant för att deklarera att registreringen gäller för en IoT Edge-enhet.

   5. Du kan valfritt lägga till ett taggvärde till det inledande enhetstvillingtillståndet. Du kan använda taggar för att rikta in grupper av enheter för distribution av moduler. Till exempel:

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

   6. Välj Spara.

4. Kopiera den individuella registreringens primärnyckelvärde som ska användas när du installerar IoT Edge-körtiden.

Nu när det finns en registrering för den här enheten kan IoT Edge-körningen automatiskt etablera enheten under installationen.

Skapa en DPS-gruppregistrering

1. I Azure Portal navigerar du till din instans av IoT Hub-enhetsetableringstjänsten.

2. Under Inställningar väljer du Hantera registreringar.

3. Välj Lägg till enskild registrering och slutför sedan följande steg för att konfigurera registreringen:

   1. Ange ett gruppnamn.

   2. Välj Symmetrisk nyckel som attesteringstyp.

   3. Välj Sant för att deklarera att registreringen gäller för en IoT Edge-enhet. För en gruppregistrering måste alla enheter vara IoT Edge-enheter eller så kan ingen av dem vara det.

   4. Du kan valfritt lägga till ett taggvärde till det inledande enhetstvillingtillståndet. Du kan använda taggar för att rikta in grupper av enheter för distribution av moduler. Till exempel:

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

   5. Välj Spara.

4. Kopiera registreringsgruppens primärnyckelvärde som ska användas när du skapar enhetsnycklar för användning med en gruppregistrering.

Nu när det finns en registreringsgrupp kan IoT Edge-runtime-miljön automatiskt installera enheter under installationen.

Härled en enhetsnyckel

Varje enhet som etableras som en del av en gruppregistrering behöver en härledd enhetsnyckel för att utföra symmetrisk nyckelvalidering under registreringsprocessen.

Om du vill generera en enhetsnyckel använder du nyckeln som du kopierade från dps-registreringsgruppen för att beräkna ett HMAC-SHA256 av enhetens unika registrerings-ID och konvertera resultatet till Base64-format.

I Windows kan du använda PowerShell för att generera din härledda enhetsnyckel enligt följande exempel.

Ersätt värdet för KEY med den primärnyckel som du antecknade tidigare.

Ersätt värdet för REG_ID med enhetens registrerings-ID.

$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"

Nedan visas ett exempel på utdata från en härledd enhetsnyckel:

Jsm0lyGpjaVYVP2g3FnmnmG9dI/9qU24wNoykUmermc=

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 de krav 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 inte ser önskad målenhet i listan följer du instruktioner 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 nya 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. Panelen Skapa en Azure IoT Edge för Linux på Windows-distribution öppnas. På 1. Fliken Komma igång, granska minimikraven och välj Nästa.

6. Granska licensvillkoren, kontrollera Jag accepteraroch 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å 2. Fliken Distribuera under Välj en målenhetklickar du på den angivna enheten för att verifiera att den uppfyller minimikraven. När dess status har bekräftats som stöds väljer du Nästa.

   

10. Granska konfigurationsinställningarna för distributionen på fliken 2.2 Inställningar. 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 konfigurera 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 de krav 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: Direct Device Assignment (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 gå vidare till fliken 3. Anslut, som hanterar Azure IoT Edge-enhetsetablering.

För PowerShell kör du följande kommando med platshållarvärdena uppdaterade med dina egna värden:

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

Använd följande steg för Administrationscenter för Windows:

1. I fönstret Azure IoT Edge-enhetsetablering väljer du Symmetrisk nyckel (DPS) i listrutan etableringsmetod.

2. I Azure-portalen navigerar du till din DPS-instans.

3. Ange ditt DPS-omfångs-ID, enhetsregistrerings-ID och primärnyckel för registrering eller härledd nyckel i fälten i Windows Administrationscenter.

4. Välj Etablering med den valda metoden.

   

5. När etableringen är klar väljer du Slutför. Du kommer tillbaka till huvudinstrumentpanelen. Nu bör du se en ny enhet i listan, vars typ är IoT Edge Devices. Du kan välja den IoT Edge-enhet som ska anslutas till den. På dess Översikt-sida kan du se IoT Edge-modullistan och IoT Edge-status för din enhet.

Du kan kontrollera att den enskilda registreringen som du skapade i enhetsetableringstjänsten användes. Navigera till din instans av enhetshanteringstjänsten i Azure-portalen. Öppna registreringsinformationen för den enskilda registrering som du skapade. Observera att registreringens status är tilldelad och att enhetens ID visas.

Du kan kontrollera att gruppregistreringen som du skapade i enhetsetableringstjänsten användes. Navigera till din instans av enhetshanteringstjänsten i Azure-portalen. Öppna registreringsinformationen för den gruppregistrering som du skapade. Gå till fliken Registreringar för att se alla enheter som är registrerade i gruppen.

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 startas för första gången bör du bara se modulen edgeAgent 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 bör rapportera aktiv (körs).