Dela via


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

Gäller för:ja-ikonen IoT Edge 1.1

Viktigt

IoT Edge 1.1 slutdatum var den 13 december 2022. I informationen om Microsoft-produktens livscykel hittar du fler uppgifter om vilken support som gäller för denna produkt, tjänst, teknik eller detta API. Mer information om hur du uppdaterar till den senaste versionen av IoT Edge finns i Uppdatera IoT Edge.

Den här artikeln innehåller instruktioner för automatisk avetablering av en Azure-IoT Edge för Linux på Windows-enheter med hjälp av en TPM (Trusted Platform Module). Du kan automatiskt etablera Azure IoT Edge-enheter med Azure IoT Hub enhetsetableringstjänst. Om du inte känner till processen för automatisk avetablering läser du etableringsöversikten innan du fortsätter.

Den här artikeln beskriver två metoder. Välj dina inställningar baserat på lösningens arkitektur:

  • Autoetablera en Linux på Windows-enhet med fysisk TPM-maskinvara.
  • Autoetablera en Linux på Windows-enhet med hjälp av en simulerad TPM. Vi rekommenderar endast den här metoden som ett testscenario. En simulerad TPM erbjuder inte samma säkerhet som en fysisk TPM.

Uppgifterna är följande:

  • Installera IoT Edge för Linux i Windows.
  • Hämta TPM-informationen från enheten.
  • Skapa en enskild registrering för enheten.
  • Etablera enheten med dess TPM-information.

Förutsättningar

Molnresurser

  • En aktiv IoT-hubb
  • En instans av IoT Hub enhetsetableringstjänst i Azure som är länkad till din IoT-hubb

Krav på enheten

En Windows-enhet med följande minimikrav:

  • Systemkrav

    • Windows 10 1/11 (Pro, Enterprise, IoT Enterprise)
    • Windows Server 20191/2022
      1 Windows 10 och Windows Server 2019 minimum build 17763 med alla aktuella kumulativa uppdateringar installerade.
  • Maskinvarukrav

    • Minsta lediga minne: 1 GB
    • Minsta lediga diskutrymme: 10 GB
  • Stöd för virtualisering

  • Nätverksstöd

    • Windows Server har ingen standardväxel. Innan du kan distribuera EFLOW till en Windows Server-enhet måste du skapa en virtuell växel. Mer information finns i Skapa virtuell växel för Linux i Windows.
    • Windows Desktop-versioner levereras med en standardväxel som kan användas för EFLOW-installation. Om det behövs kan du skapa en egen anpassad virtuell växel.

Tips

Om du vill använda GPU-accelererade Linux-moduler i azure-IoT Edge för Linux i Windows-distribution finns det flera konfigurationsalternativ att överväga.

Du måste installera rätt drivrutiner beroende på din GPU-arkitektur och du kan behöva åtkomst till en Windows Insider Program-version. Information om hur du fastställer dina konfigurationsbehov och uppfyller dessa krav finns i GPU-acceleration för Azure IoT Edge för Linux i Windows.

Se till att du tar dig tid att uppfylla kraven för GPU-acceleration nu. Du måste starta om installationsprocessen om du vill ha GPU-acceleration under installationen.

Utvecklarverktyg

Du kan använda antingen PowerShell eller Windows Admin Center för att hantera dina IoT Edge enheter. Varje verktyg har sina egna förutsättningar:

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 körningsprincipen på målenheten till AllSigned. Du kan kontrollera den aktuella körningsprincipen i en upphöjd PowerShell-prompt med följande kommando:

    Get-ExecutionPolicy -List
    

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

    Set-ExecutionPolicy -ExecutionPolicy AllSigned -Force
    

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

Anteckning

TPM 2.0 krävs när du använder TPM-attestering med enhetsetableringstjänsten.

Du kan bara skapa registreringar för enskilda enheter, inte grupper, enhetsetableringstjänsten när du använder en TPM.

Installera IoT Edge

Distribuera Azure IoT Edge för Linux i Windows på målenheten.

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

Anteckning

Följande PowerShell-process beskriver hur du distribuerar IoT Edge för Linux på Windows på den lokala enheten. Om du vill distribuera till en fjärrmålenhet med Hjälp av PowerShell kan du använda Remote PowerShell för att upprätta en anslutning till en fjärrenhet och köra dessa kommandon via fjärranslutning på den enheten.

  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 anpassade IoT Edge för Linux i Windows-installation och VHDX-kataloger genom att lägga till INSTALLDIR="<FULLY_QUALIFIED_PATH>" parametrarna och VHDXDIR="<FULLY_QUALIFIED_PATH>" 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. Ange körningsprincipen på målenheten till AllSigned om den inte redan är det. 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-distribution. Distributionen skapar din virtuella Linux-dator och installerar IoT Edge-körningen åt dig.

    Deploy-Eflow
    

    Tips

    Som standard skapar kommandot din Deploy-Eflow virtuella Linux-dator 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 valfria parametrar finns i PowerShell-funktioner för IoT Edge för Linux i Windows.

    Varning

    Som standard har den virtuella linux-datorn EFLOW ingen DNS-konfiguration. Distributioner som använder 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 valfria parametrar finns i PowerShell-funktioner för IoT Edge för Linux i Windows.

    Varning

    Aktivering av genomströmning för maskinvaruenheter kan öka säkerhetsriskerna. Microsoft rekommenderar en enhetsminskningsdrivrutin från GPU:ns 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 om du vill aktivera eller inaktivera valfria diagnostikdata , beroende på dina önskemål.

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

    En lyckad distribution säger

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

Det finns några steg för att förbereda enheten för etablering med TPM. Lämna distributionen öppen medan du förbereder enheten. Du återgår till distributionen senare i artikeln.

Aktivera TPM-genomströmning

IoT Edge för Linux på virtuella Windows-datorer har en TPM-funktion som kan aktiveras eller inaktiveras. Som standard är den inaktiverad. När den här funktionen är aktiverad kan den virtuella datorn komma åt värddatorns TPM.

  1. Öppna PowerShell i en upphöjd session.

  2. Om du inte redan har gjort det ställer du in körningsprincipen på enheten så AllSigned att du kan köra IoT Edge för Linux på Windows PowerShell funktioner.

    Set-ExecutionPolicy -ExecutionPolicy AllSigned -Force
    
  3. Aktivera TPM-funktionen.

    Set-EflowVmFeature -feature 'DpsTpm' -enable
    

Hämta TPM-informationen från enheten

För att etablera enheten behöver du en bekräftelsenyckel för ditt TPM-chip och registrerings-ID för din enhet. Du anger den här informationen för din instans av enhetsetableringstjänsten så att tjänsten kan identifiera din enhet när den försöker ansluta.

Bekräftelsenyckeln är unik för varje TPM-chip. Det erhålls från TPM-chiptillverkaren som är associerad med den. Du kan härleda ett unikt registrerings-ID för din TPM-enhet genom att till exempel skapa en SHA-256-hash för bekräftelsenyckeln.

IoT Edge för Linux i Windows innehåller ett PowerShell-skript som hjälper dig att hämta den här informationen från din TPM. Följ dessa steg på enheten om du vill använda skriptet:

  1. Öppna PowerShell i en upphöjd session.

  2. Kör kommandot.

    Get-EflowVmTpmProvisioningInfo | Format-List
    

Skapa en registrering av enhetsetableringstjänsten

Använd TPM:s etableringsinformation för att skapa en enskild registrering i enhetsetableringstjänsten.

När du skapar en registrering i enhetsetableringstjänsten har du möjlighet att deklarera ett initialt enhetstvillingtillstånd. I enhetstvillingen kan du ange taggar för att gruppera enheter efter mått som används i din lösning, till exempel region, miljö, plats eller enhetstyp. Dessa taggar används för att skapa automatiska distributioner.

Tips

Stegen i den här artikeln gäller för Azure Portal, men du kan också skapa enskilda registreringar med hjälp av Azure CLI. Mer information finns i az iot dps enrollment (az iot dps enrollment). Som en del av CLI-kommandot använder du den gränsaktiverade flaggan för att ange att registreringen är för en IoT Edge enhet.

  1. I Azure Portal går du till din instans av IoT Hub enhetsetableringstjänst.

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

    2. Ange bekräftelsenyckeln och registrerings-ID :t som du kopierade från den virtuella datorn eller den fysiska enheten.

    3. Ange ett ID för enheten om du vill. Om du inte anger något enhets-ID används registrerings-ID:t.

    4. Välj Sant för att deklarera att den virtuella datorn eller den fysiska enheten är en IoT Edge enhet.

    5. Välj den länkade IoT-hubb som du vill ansluta enheten till eller välj Länka till ny IoT Hub. Du kan välja flera hubbar och enheten tilldelas till en av dem enligt den valda tilldelningsprincipen.

    6. Lägg till ett taggvärde i det initiala enhetstvillingtillståndet om du vill. Du kan använda taggar till målgrupper med enheter för moduldistribution. Mer information finns i Distribuera IoT Edge moduler i stor skala.

    7. Välj Spara.

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

Etablera enheten med sin molnidentitet

  1. Öppna en upphöjd PowerShell-session på Windows-enheten.

  2. Etablera enheten med hjälp av det omfångs-ID som du samlade in från din instans av enhetsetableringstjänsten.

    Provision-EflowVM -provisioningType "DpsTpm" -scopeId "SCOPE_ID_HERE"
    

    Om du har registrerat enheten med ett anpassat registrerings-ID måste du även ange det registrerings-ID:t när du etablerar:

    Provision-EflowVM -provisioningType "DpsTpm" -scopeId "SCOPE_ID_HERE" -registrationId "REGISTRATION_ID_HERE"
    

Kontrollera att installationen har slutförts

Kontrollera att IoT Edge för Linux i Windows har installerats och konfigurerats på din IoT Edge enhet.

Om körningen har startats kan du gå till din IoT-hubb och börja distribuera IoT Edge moduler till enheten.

Du kan kontrollera att den enskilda registreringen som du skapade i enhetsetableringstjänsten användes. Gå till din instans av enhetsetableringstjänsten i Azure Portal. Öppna registreringsinformationen för den enskilda registrering som du skapade. Observera att statusen för registreringen har tilldelats och att enhets-ID:t visas.

Använd följande kommandon på enheten för att kontrollera att IoT Edge installerat och startat.

  1. Anslut till din IoT Edge för Linux på en virtuell Windows-dator med hjälp av följande kommando i PowerShell-sessionen:

    Connect-EflowVm
    

    Anteckning

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

  2. När du har loggat in 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änstloggar om du behöver felsöka tjänsten.

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

      sudo iotedge check
      

    Anteckning

    På en nyligen etablerad 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 modulen IoT Edge Hub inte körs. Lös felet genom att i IoT Hub ange modulerna för enheten och skapa en distribution. När du skapar en distribution för enheten startas modulerna på enheten, inklusive modulen IoT Edge Hub.

Avinstallera IoT Edge för Linux i Windows

Om du vill ta bort Azure IoT Edge för Linux på Windows-installationen från enheten använder du följande kommandon.

  1. Öppna inställningar i Windows
  2. Välj Lägg till eller ta bort program
  3. Välj Azure IoT Edge LTS-app
  4. Välj Avinstallera

Nästa steg

Med registreringsprocessen för enhetsetableringstjänsten kan du ange taggar för enhets-ID och enhetstvilling samtidigt som du etablerar den nya enheten. Du kan använda dessa värden för att rikta in dig på enskilda enheter eller grupper av enheter med hjälp av automatisk enhetshantering.

Lär dig hur du distribuerar och övervakar IoT Edge moduler i stor skala med hjälp av Azure Portal eller Azure CLI.