Snabbstart: Distribuera din första IoT Edge till en Windows enhet

Gäller för: IoT Edge 1,1

Prova att Azure IoT Edge den här snabbstarten genom att distribuera containerkod till en Linux på Windows IoT Edge enhet. IoT Edge kan du fjärrhantera kod på dina enheter så att du kan skicka fler av dina arbetsbelastningar till gränsen. För den här snabbstarten rekommenderar vi att du använder din egen enhet för att se hur enkelt det är att använda Azure IoT Edge linux på Windows.

I den här snabbstarten lär du dig att:

• Skapa en IoT-hubb.
• Registrera en IoT Edge-enhet till din IoT Hub.
• Installera och starta IoT Edge för Linux Windows körtid på enheten.
• Fjärr distribuera en modul till en IoT Edge enhet och skicka telemetri.

Den här snabbstarten visar hur du ställer in Azure IoT Edge för Linux på Windows enhet. Sedan distribuerar du en modul från Azure Portal till din enhet. Modulen du använder är en simulerad sensor som genererar temperatur-, fuktighets- och tryckdata. Andra Azure IoT Edge självstudier bygger på det arbete du gör här genom att distribuera moduler som analyserar simulerade data för affärsinsikter.

Om du inte har en aktiv Azure-prenumeration kan du skapa ett kostnadsfritt konto innan du börjar.

Förutsättningar

Förbered din miljö för Azure CLI.

• Använd bash-miljön i Azure Cloud Shell.

  

• Om du vill kan du i stället installera Azure CLI för att köra CLI-referenskommandon.

  • Om du använder en lokal installation loggar du in på Azure CLI med hjälp av kommandot az login. Slutför autentiseringsprocessen genom att följa stegen som visas i terminalen. Fler inloggningsalternativ finns i Logga in med Azure CLI.

  • När du uppmanas till det installerar du Azure CLI-tillägg vid första användning. Mer information om tillägg finns i Använda tillägg med Azure CLI.

  • Kör az version om du vill hitta versionen och de beroende bibliotek som är installerade. Om du vill uppgradera till den senaste versionen kör du az upgrade.

Skapa en molnresursgrupp för att hantera alla resurser som du kommer att använda i den här snabbstarten.

az group create --name IoTEdgeResources --location westus2

Kontrollera att IoT Edge enheten uppfyller följande krav:

• Systemkrav

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

• Maskinvarukrav

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

Skapa en IoT Hub

Börja med att skapa en IoT-hubb med Azure CLI.

Den kostnadsfria nivån av Azure IoT Hub fungerar för den här snabbstarten. Om du har använt IoT Hub tidigare och redan har skapat en hubb kan du använda den IoT-hubben.

Följande kod skapar en kostnadsfri F1-hubb i resursgruppen IoTEdgeResources . Ersätt {hub_name} med ett unikt namn för din IoT-hubb. Det kan ta några minuter att skapa en IoT-hubb.

az iot hub create --resource-group IoTEdgeResources --name {hub_name} --sku F1 --partition-count 2

Om du får ett felmeddelande eftersom du redan har en kostnadsfri hubb i din prenumeration ändrar du SKU:n till S1 . Om du får ett felmeddelande om att IoT-hubbnamnet inte är tillgängligt har någon annan redan en hubb med det namnet. Prova med ett nytt namn.

Registrera en IoT Edge-enhet

Registrera en IoT Edge-enhet med IoT-hubben som du nyss skapade.

Skapa en enhetsidentitet för den simulerade enheten så att den kan kommunicera med din IoT Hub. Enhetsidentiteten finns i molnet, och du använder en unik enhetsanslutningssträng för att associera en fysisk enhet med en enhetsidentitet.

IoT Edge fungerar och kan hanteras på ett annat sätt än vanliga IoT-enheter. Använd flaggan --edge-enabled för att deklarera att den här identiteten är för en IoT Edge enhet.

1. I Azure Cloud Shell du följande kommando för att skapa en enhet med namnet myEdgeDevice i hubben.

   az iot hub device-identity create --device-id myEdgeDevice --edge-enabled --hub-name {hub_name}
   

   Om du får ett felmeddelande om principnycklar kontrollerar du iothubowner att Cloud Shell kör den senaste versionen av Azure IoT-tillägget.

2. Visa anslutningssträngen för enheten, som länkar den fysiska enheten med dess identitet i IoT Hub. Den innehåller namnet på din IoT-hubb, namnet på din enhet och en delad nyckel som autentiserar anslutningar mellan dem.

   az iot hub device-identity connection-string show --device-id myEdgeDevice --hub-name {hub_name}
   

3. Kopiera värdet för connectionString-nyckeln från JSON-utdata och spara det. Det här värdet är enhetens anslutningssträng. Du använder den för att konfigurera IoT Edge körning i nästa avsnitt.

   

Installera och starta IoT Edge-körningen

Installera IoT Edge Linux på Windows på enheten och konfigurera den med enhetens anslutningssträng.

Kör följande PowerShell-kommandon på målenheten där du vill distribuera Azure IoT Edge för Linux på Windows. Om du vill distribuera till en fjärransluten målenhet med hjälp av PowerShell använder du Fjärr-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 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 för Linux på Windows på enheten.

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

3. Ange körningsprincipen på målenheten till AllSigned om den inte redan är det. Du kan kontrollera den aktuella körningsprincipen i en upphöjd PowerShell-kommandotolk med hjälp av:

   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
   

4. Skapa IoT Edge linux på Windows distribution.

   Deploy-Eflow
   

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. En lyckad distribution visas nedan.

   

7. Etablera enheten med enhetsanslutningssträngen som du hämtade i föregående avsnitt. Ersätt platshållartexten med ditt eget värde.

   Provision-EflowVm -provisioningType ManualConnectionString -devConnString "<CONNECTION_STRING_HERE>"
   

IoT Edge-enheten har nu konfigurerats. Den är redo att köra molndistribuerade moduler.

Distribuera en modul

Hantera din Azure IoT Edge-enhet från molnet för att distribuera en modul som skickar telemetridata till IoT Hub.

En av de viktigaste funktionerna i Azure IoT Edge är att distribuera kod till IoT Edge enheter från molnet. IoT Edge moduler är körbara paket som implementeras som containrar. I det här avsnittet distribuerar du en förbyggd modul från avsnittet IoT Edge Modules i Azure Marketplace direkt från Azure IoT Hub.

Den modul som du distribuerar i det här avsnittet simulerar en sensor och skickar genererade data. Modulen är användbar kod när du kör igång med IoT Edge eftersom du kan använda simulerade data för utveckling och testning. Om du vill se exakt vad den här modulen gör kan du visa källkoden för den simulerade temperatursensorn.

Följ dessa steg för att distribuera din första modul från Azure Marketplace.

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

2. På menyn till vänster, under Automatisk Enhetshantering väljer du IoT Edge.

3. Välj målenhetens enhets-ID i listan över enheter.

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

4. Välj Ange moduler i det övre fältet.

   

5. Under IoT Edge Modules(Moduler) öppnar du listrutan Add (Lägg till) och väljer sedan Marketplace Module (Marketplace-modul).

   

6. I IoT Edge-modulen Marketplace söker du efter och väljer Simulated Temperature Sensor modulen.

   Modulen läggs till i avsnittet IoT Edge Moduler med önskad körningsstatus.

7. Välj Nästa: Vägar för att fortsätta till nästa steg i guiden.

   

8. På fliken Vägar tar du bort standardvägen, dirigerar och väljer sedan Nästa: Granska + skapa för att fortsätta till nästa steg i guiden.

   Anteckning

   Vägar konstrueras med hjälp av namn- och värdepar. Du bör se två vägar på den här sidan. Standardvägen, route, skickar alla meddelanden till IoT Hub (som kallas $upstream ). En andra väg, SimulatedTemperatureSensorToIoTHub, skapades automatiskt när du lade till modulen från Azure Marketplace. Den här vägen skickar alla meddelanden från modulen för simulerad temperatur till IoT Hub. Du kan ta bort standardvägen eftersom den är redundant i det här fallet.

   

9. Granska JSON-filen och välj sedan Skapa. JSON-filen definierar alla moduler som du distribuerar till din IoT Edge enhet. Du ser modulen SimulatedTemperatureSensor och de två körningsmodulerna edgeAgent och edgeHub.

   Anteckning

   När du skickar en ny distribution till en IoT Edge-enhet distribueras ingenting till enheten. I stället frågar enheten regelbundet IoT Hub efter nya instruktioner. Om enheten hittar ett uppdaterat distributionsmanifest använder den informationen om den nya distributionen för att hämta modulavbildningarna från molnet och börjar sedan köra modulerna lokalt. Den här processen kan ta några minuter.

10. När du har skapat information om moduldistributionen återgår guiden till sidan med enhetsinformation. Visa distributionsstatusen på fliken Moduler.

    Du bör se tre moduler: $edgeAgent, $edgeHub och SimulatedTemperatureSensor. Om en eller flera av modulerna har YES (JA) under SPECIFIED IN DEPLOYMENT (ANGES I DISTRIBUTION) men inte under REPORTED BY DEVICE(RAPPORTERAS AV ENHET) IoT Edge enheten fortfarande startar dem. Vänta några minuter och uppdatera sedan sidan.

    

Visa genererade data

I den här snabbstarten skapade du en ny IoT Edge-enhet och installerade IoT Edge-körningsmiljön på den. Sedan använde du Azure Portal för att distribuera en IoT Edge-modul som ska köras på enheten utan att behöva göra ändringar i själva enheten.

Modulen som du push-pushade genererar exempelmiljödata som du kan använda för testning senare. Den simulerade sensorn övervakar både en dator och miljön runt datorn. Den här sensorn kan till exempel finnas i ett serverrum, på fabriksgolvet eller på en vindturbin. Meddelandena som skickas är omgivande temperatur och luftfuktighet, maskintemperatur och tryck samt en tidsstämpel. IoT Edge självstudier använder data som skapats av den här modulen som testdata för analys.

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 har loggat in kan du kontrollera listan över körningar IoT Edge moduler med hjälp av följande Linux-kommando:

   sudo iotedge list
   

   

3. Visa meddelanden som skickas från temperatursensormodulen till molnet med hjälp av följande Linux-kommando:

   sudo iotedge logs SimulatedTemperatureSensor -f
   

   Viktigt

   IoT Edge kommandon är fallkänsliga när de refererar till modulnamn.

   

Du kan också använda Azure IoT Hub för att Visual Studio Code för att se när meddelanden kommer till din IoT-hubb.

Rensa resurser

Om du vill fortsätta med självstudierna IoT Edge du hoppa över det här steget. Du kan använda den enhet som du registrerade och konfigurerade i den här snabbstarten. Annars kan du ta bort de Azure-resurser som du skapade för att undvika kostnader.

Om du skapade den virtuella datorn och IoT-hubben i en ny resursgrupp kan du ta bort den gruppen och alla associerade resurser. Om du inte vill ta bort hela gruppen kan du ta bort enskilda resurser i stället.

Använd följande kommando för att ta bort gruppen IoTEdgeResources. Borttagningen kan ta några minuter.

az group delete --name IoTEdgeResources

Du kan bekräfta att resursgruppen har tagits bort med hjälp av det här kommandot för att visa listan över resursgrupper.

az group list

Ta Azure IoT Edge för Linux på Windows

Använd instrumentpanelstillägget i Windows Administrationscenter för att avinstallera Azure IoT Edge för Linux på Windows.

1. Anslut till IoT Edge i Windows Administrationscenter. Verktygstillägget för Azure-instrumentpanelen läses in.

2. Välj Avinstallera. När Azure IoT Edge har tagits bort Windows Administrationscenter Azure IoT Edge posten för enhetsanslutningen från startsidan.

Nästa steg

I den här snabbstarten skapade du en IoT Edge-enhet och använde molngränssnittet i Azure IoT Edge för att distribuera kod till enheten. Nu har du en testenhet som genererar rådata om miljön.

I nästa självstudie får du lära dig hur du övervakar enhetens aktivitet och hälsotillstånd från Azure Portal.