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

Gäller för: IoT Edge 1.4

Viktigt!

IoT Edge 1.4 är den version som stöds. Om du har en tidigare version läser du Uppdatera IoT Edge.

Den här artikeln innehåller instruktioner från slutpunkt till slutpunkt för registrering och etablering av en IoT Edge för Linux på Windows-enheter.

Varje enhet som ansluter till en IoT-hubb har ett enhets-ID som används för att spåra kommunikation från moln till enhet eller från enhet till moln. Du konfigurerar en enhet med dess anslutningsinformation, som innehåller IoT Hub-värdnamnet, enhets-ID:t och den information som enheten använder för att autentisera till IoT Hub.

Stegen i den här artikeln går igenom en process som kallas manuell etablering, där du ansluter en enda enhet till dess IoT-hubb. För manuell etablering har du två alternativ för att autentisera IoT Edge-enheter:

• Symmetriska nycklar: När du skapar en ny enhetsidentitet i IoT Hub skapar tjänsten två nycklar. Du placerar en av nycklarna på enheten och den visar nyckeln till IoT Hub när du autentiserar.

  Den här autentiseringsmetoden går snabbare att komma igång, men inte lika säker.

• X.509 självsignerade: Du skapar två X.509-identitetscertifikat och placerar dem på enheten. När du skapar en ny enhetsidentitet i IoT Hub anger du tumavtryck från båda certifikaten. När enheten autentiseras till IoT Hub visas ett certifikat och IoT Hub verifierar att certifikatet matchar tumavtrycket.

  Den här autentiseringsmetoden är säkrare och rekommenderas för produktionsscenarier.

Den här artikeln beskriver hur du använder symmetriska nycklar som autentiseringsmetod. Om du vill använda X.509-certifikat läser du Skapa och etablera en IoT Edge för Linux på Windows-enheter med X.509-certifikat.

Kommentar

Om du har många enheter att konfigurera och inte vill etablera var och en manuellt använder du någon av följande artiklar för att lära dig hur IoT Edge fungerar med IoT Hub-enhetsetableringstjänsten:

• Skapa och etablera IoT Edge-enheter i stor skala med X.509-certifikat
• Skapa och etablera IoT Edge-enheter i stor skala med en TPM
• Skapa och etablera IoT Edge-enheter i stor skala med hjälp av symmetriska nycklar

Förutsättningar

Den här artikeln beskriver hur du registrerar din IoT Edge-enhet och installerar IoT Edge för Linux i Windows. Dessa uppgifter har olika förutsättningar och verktyg som används för att utföra dem. Kontrollera att du har alla förutsättningar som omfattas innan du fortsätter.

Verktyg för enhetshantering

Du kan använda Azure-portalen, Visual Studio Code eller Azure CLI för stegen för att registrera din enhet. Varje verktyg har sina egna förutsättningar eller kan behöva installeras:

Portal

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

Visual Studio Code

• En kostnadsfri IoT-hubb eller standard-IoT-hubb i din Azure-prenumeration
• Visual Studio Code
• Azure IoT Edge-tillägg . Azure IoT Edge-verktygen för Visual Studio Code-tillägget är i underhållsläge.
• Azure IoT Hub-tillägg

Azure CLI

• 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. Validera med az --version. Den här versionen stöder az tilläggskommandon och introducerar Knack-kommandoramverket.

Enhetskrav

En Windows-enhet med följande minimikrav:

• Systemkrav

  • Windows 10¹/11 (Pro, Enterprise, IoT Enterprise)
  • Windows Server 2019¹/2022
    _{¹ Windows 10 och Windows Server 2019 minsta version 17763 med alla aktuella kumulativa uppdateringar installerade.}

• Maskinvarukrav

  • Minsta lediga minne: 1 GB
  • Minsta lediga diskutrymme: 10 GB

• Stöd för virtualisering

  • Aktivera Hyper-V i Windows 10. Mer information finns i Installera Hyper-V på Windows 10.
  • Installera Hyper-V-rollen på Windows Server och skapa en standardnätverksväxel. Mer information finns i Kapslad virtualisering för Azure IoT Edge för Linux i Windows.
  • Konfigurera kapslad virtualisering på en virtuell dator. Mer information finns i kapslad 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.

Dricks

Om du vill använda GPU-accelererade Linux-moduler i din Azure IoT Edge för Linux i Windows-distributionen finns det flera konfigurationsalternativ att tänka på.

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.

Utvecklingsverktyg

Förbered 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 hjälp av 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.

Registrera din enhet

Du kan använda Azure-portalen, Visual Studio Code eller Azure CLI för att registrera din enhet, beroende på vad du föredrar.

Portal

I din IoT-hubb i Azure-portalen 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, till exempel my-edge-device-1 (alla gemener). Kopiera det här enhets-ID:t när du använder det senare.
   • Markera kryssrutan IoT Edge-enhet .
   • Välj Symmetrisk nyckel som autentiseringstyp.
   • Använd standardinställningarna för att generera autentiseringsnycklar automatiskt, som ansluter den nya enheten till din hubb.

4. Välj Spara.

Du bör se din nya enhet i din IoT-hubb.

Visual Studio Code

Logga in på Azure

Du kan använda Azure IoT-tilläggen för Visual Studio Code för att utföra åtgärder med din IoT-hubb. Kontrollera att du har installerat förhandskraven för Azure IoT-tillägget.

När Azure IoT Edge- och Azure IoT Hub-tillägg har installerats ser du att en Azure-ikon läggs till på menyn till vänster ikon. Du kan logga in på ditt Azure-konto via Visual Studio Code genom att välja Azure-ikonen och sedan välja Logga in på Azure.

Registrera en ny enhet med Visual Studio Code

Att registrera en ny enhet liknar att skapa en IoT Edge-enhet i Azure-portalen. Den här virtuella enheten är en av tvillingarna, medan den verkliga enheten är den andra tvillingen. Visual Studio Code kan konfigurera detta åt dig genom följande steg.

1. I Visual Studio Code Explorer-menyn expanderar du avsnittet Azure IoT Hub .
2. Klicka på ... i avsnittsrubriken för Azure IoT Hub. Om du inte ser ellipsen klickar du på eller hovra över rubriken.
3. Välj Skapa IoT Edge-enhet.
4. I textrutan som öppnas ger du enheten ett ID, till exempel my-edge-device-1 (alla gemener) och trycker sedan på Retur.

I utdatakonsolen för Visual Studio Code ser du resultatet av kommandot: en JSON-utskrift. Enhetsinformationen innehåller det deviceId som du angav och genererar en connectionString som du kan använda för att ansluta din fysiska enhet till din IoT-hubb. Utdatakonsolen visar även dina nycklar och annan enhet som identifierar information.

Nu kan du se din enhet under avsnittet Azure IoT Hub-enheter> i Explorer-menyn.

Kommentar

Om enheten inte visas kan du behöva välja din IoT Hub från länken Välj IoT Hub som tillhandahålls under Azure IoT Hub och sedan följa anvisningarna. Du uppmanas att välja din prenumeration först och sedan din IoT Hub. Den här processen låter Visual Studio Code veta om din IoT Hub (och alla enheter i den). Uppdatera Visual Studio Code så ska enheten visas.

Azure CLI

Använd kommandot az iot hub device-identity create för att skapa en ny enhetsidentitet i din IoT-hubb. Ersätt device_id_here med ditt eget nya och unika enhets-ID, till exempel my-edge-device-1 (alla gemener). Ersätt hub_name_here med din befintliga IoT-hubb.

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.

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

Om cli säger kommandot kräver tillägget azure-iot. Vill du installera den nu? skriver Y du och trycker på Enter för att starta nedladdningen för att skapa enheten.

Nu när du har en enhet registrerad i IoT Hub kan du hämta etableringsinformation som används för att slutföra installationen och etableringen av IoT Edge-körningen i nästa steg.

Visa registrerade enheter och hämta etableringsinformation

Enheter som använder symmetrisk nyckelautentisering behöver sina anslutningssträng för att slutföra installationen och etableringen av IoT Edge-körningen. Anslutningssträng genereras för din IoT Edge-enhet när du skapar enheten. För Visual Studio Code och Azure CLI finns anslutningssträng i JSON-utdata. Om du använder Azure-portalen för att skapa din enhet kan du hitta anslutningssträng från själva enheten. När du väljer din enhet i din IoT-hubb visas den som Primary connection string på enhetssidan.

Portal

De gränsaktiverade enheter som ansluter till din IoT-hubb visas på sidan Enheter i din IoT-hubb. Om du har flera enheter kan du filtrera listan genom att välja typen Iot Edge-enheter och sedan välja Använd.

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. Så här hittar du din anslutningssträng i portalen:

1. På sidan Enheter väljer du IoT Edge-enhets-ID i listan.
2. Kopiera värdet för antingen Primär Anslut ionssträng eller Sekundär Anslut ionssträng. Båda nycklarna fungerar.

Visual Studio Code

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 eftersom de har en annan ikon och du ser $edgeAgent och $edgeHub moduler 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. Så här hämtar du dina anslutningssträng från Visual Studio Code.

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

2. Välj Kopiera Anslut ionssträng för enhet.

   Anslutningssträng kopieras till Urklipp.

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

Azure CLI

Om du vill se alla enheter i din IoT-hubb använder du kommandot az iot hub device-identity list . Ersätt hub_name_here med ditt eget IoT-hubbnamn.

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. Du ser även många andra metadata som JSON-utdata, inklusive dina enhets-ID:n.

När du är redo att konfigurera enheten behöver du dess anslutningssträng som länkar din fysiska enhet med dess identitet i IoT-hubben. Använd följande kommando az iot hub device-identity connection-string show för att returnera anslutningssträng för en enda enhet. Ersätt [device_id] och [hub_name] med dina egna värden. Värdet för parametern device-identity är skiftlägeskänsligt.

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

Du bör se JSON-utdata i -konsolen, ungefär så här:

{
  "connectionString": "HostName=my-iot-hub.azure-devices.net;DeviceId=my-edge-device-1;SharedAccessKey=saQ52bt6BBUlRfusqWuxPMAx4ysQwWEb5+1eidwzHPY="
}

Dricks

Kommandot connection-string show introducerades i version 0.9.8 av Azure IoT-tillägget och ersatte det inaktuella show-connection-string kommandot. Om du får ett fel när du kör det här kommandot kontrollerar du att tilläggsversionen har uppdaterats till 0.9.8 eller senare. Mer information och de senaste uppdateringarna finns i Microsoft Azure IoT-tillägget för Azure CLI.

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

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

Kommentar

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

1. I en upphöjd PowerShell-session kör du något av följande kommandon beroende på din målenhetsarkitektur för att ladda ned IoT Edge för Linux i Windows.

   • X64/AMD64

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

   • ARM64

     $msiPath = $([io.Path]::Combine($env:TEMP, 'AzureIoTEdge.msi'))
     $ProgressPreference = 'SilentlyContinue'
     Invoke-WebRequest "https://aka.ms/AzEFLOWMSI_1_4_LTS_ARM64" -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. 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-distributionen. Distributionen skapar din virtuella Linux-dator och installerar IoT Edge-körningen åt dig.

   Deploy-Eflow
   

   Dricks

   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. Detta krävs för att distribuera EFLOW på en enhet med minimikraven för maskinvara.

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

   Deploy-Eflow -cpuCount 1 -memoryInMB 1024 -vmDataSize 2
   

   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 genomströmning av 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 etablera enheten.

Etablera enheten med dess molnidentitet

Du är redo att konfigurera enheten med dess molnidentitet och autentiseringsinformation.

Om du vill etablera enheten med symmetriska nycklar behöver du enhetens anslutningssträng.

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-EflowVM PowerShell-funktioner för IoT Edge för Linux i Windows.

Kontrollera att konfigurationen har slutförts

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

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

   Connect-EflowVm
   

   Kommentar

   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 iotedge system logs
      

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

      sudo iotedge check
      

   Kommentar

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

När du skapar en ny IoT Edge-enhet visas statuskoden 417 -- The device's deployment configuration is not set i Azure-portalen. Den här statusen är normal och innebär att enheten är redo att ta emot en moduldistribution.

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-app
4. Välj Avinstallera

Nästa steg

• Fortsätt att distribuera IoT Edge-moduler för att lära dig hur du distribuerar moduler till din enhet.
• Lär dig hur du hanterar certifikat på din virtuella IoT Edge för Linux på en virtuell Windows-dator och överför filer från värdoperativsystemet till den virtuella Linux-datorn.
• Lär dig hur du konfigurerar IoT Edge-enheter så att de kommunicerar via en proxyserver.