Snabbstart: Distribuera din första IoT Edge-modul till en virtuell Linux-enhet

Gäller för: IoT Edge 1.5

Prova Azure IoT Edge i den här snabbstarten genom att distribuera containerbaserad kod till en virtuell Linux IoT Edge-enhet. Med IoT Edge kan du fjärrhantera kod på dina enheter så att du kan överföra fler av dina arbetsbelastningar till edge. I den här snabbstarten använder du en virtuell Azure-dator för din IoT Edge-enhet. Med den kan du snabbt skapa en testdator och ta bort den när du är klar.

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

• Skapa en IoT Hub.
• Registrera en IoT Edge-enhet till din IoT Hub.
• Installera och starta IoT Edge-körningen på en virtuell enhet.
• Distribuera en modul via fjärranslutning till en IoT Edge-enhet.

Den här snabbstarten vägleder dig genom att skapa en virtuell Linux-dator som är konfigurerad för att vara en IoT Edge-enhet. Sedan distribuerar du en modul från Azure Portal till enheten. Den här snabbstarten använder en simulerad sensormodul som genererar temperatur, luftfuktighet och tryckdata. De andra Azure IoT Edge-självstudierna bygger på det arbete du utför här genom att distribuera ytterligare 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

Konfigurera din miljö för Azure CLI.

• Använd Bash-miljön i Azure Cloud Shell. Mer information finns i Kom igång med Azure Cloud Shell.

  

• Om du föredrar att köra CLI-referenskommandon lokalt installerar du Azure CLI. Om du kör i Windows eller macOS kan du köra Azure CLI i en Docker-container. Mer information finns i Så här kör du Azure CLI i en Docker-container.

  • 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. Andra inloggningsalternativ finns i Autentisera till Azure med Azure CLI.

  • När du uppmanas att installera Azure CLI-tillägget vid första användningen. Mer information om tillägg finns i Använda och hantera 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.

En resursgrupp som du använder för att hantera alla resurser i den här snabbstarten. Den här snabbstarten och följande självstudier använder namnet på exempelresursgruppen IoTEdgeResources.

az group create --name IoTEdgeResources --location westus2

Skapa en IoT Hub

Starta snabbstarten genom att skapa en IoT Hub med Azure CLI.

Den kostnadsfria nivån för 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 Hub. Det kan ta några minuter att skapa en IoT Hub.

az iot hub create --resource-group IoTEdgeResources --name <hub-name> --sku F1 --partition-count 2

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

Registrera en IoT Edge-enhet

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

Skapa en enhetsidentitet för din IoT Edge-enhet 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.

Eftersom IoT Edge-enheter beter sig och hanteras på ett annat sätt än vanliga IoT-enheter deklarerar du den här identiteten --edge-enabled som en IoT Edge-enhet med hjälp av flaggan.

1. Ange följande kommando i Azure Cloud Shell 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 för iothubowner kontrollerar du att Cloud Shell kör den senaste versionen av azure-iot-tillägget .

2. Kontrollera anslutningssträngen för din enhet, som länkar den fysiska enheten till dess identitet i IoT Hub. Den innehåller namnet på din IoT Hub, namnet på enheten och en delad nyckel som autentiserar anslutningar mellan dem. Du använder den här anslutningssträngen igen i nästa avsnitt för att konfigurera din IoT Edge-enhet.

   az iot hub device-identity connection-string show --device-id myEdgeDevice --hub-name <hub-name>
   

   Anslutningssträngen bör till exempel se ut ungefär som HostName=contoso-hub.azure-devices.net;DeviceId=myEdgeDevice;SharedAccessKey=<DEVICE-SHARED-ACCESS-KEY>.

Konfigurera din IoT Edge-enhet

Skapa en virtuell dator med Azure IoT Edge-miljön.

IoT Edge-runtime distribueras på alla IoT Edge-enheter och har tre komponenter. IoT Edge-säkerhetsdaemon startas varje gång en IoT Edge-enhet startar och initierar enheten genom att starta IoT Edge-agenten. IoT Edge-agenten underlättar distribution och övervakning av moduler på IoT Edge-enheten, inklusive IoT Edge-hubb. IoT Edge-hubben hanterar kommunikationen mellan moduler på IoT Edge-enheten, samt mellan enheten och IoT Hub.

Under körningskonfigurationen anger du en enhetsanslutningssträng. Den här strängen hämtas från Azure CLI. Den här strängen associerar den fysiska enheten med IoT Edge-enhetsidentiteten i Azure.

Distribuera IoT Edge-enheten

I det här avsnittet används en Azure Resource Manager-mall för att skapa en ny virtuell dator och installera IoT Edge-körningen på den. Om du vill använda en egen Linux-enhet i stället kan du följa installationsstegen i Etablera en enskild Linux IoT Edge-enhet manuellt och sedan återgå till den här snabbstarten.

Använd knappen Distribuera till Azure eller CLI-kommandon för att skapa en IoT Edge-enhet baserat på den fördefinierade mallen iotedge-vm-deploy .

• Distribuera med hjälp av IoT Edge Azure Resource Manager-mallen.

  

• För bash- eller Cloud Shell-användare kopierar du följande kommando till en textredigerare, ersätter platshållartexten med din information och kopierar sedan till bash- eller Cloud Shell-fönstret:

  az deployment group create \
  --resource-group IoTEdgeResources \
  --template-uri "https://raw.githubusercontent.com/Azure/iotedge-vm-deploy/main/edgeDeploy.json" \
  --parameters dnsLabelPrefix='<REPLACE_WITH_VM_NAME>' \
  --parameters adminUsername='azureUser' \
  --parameters deviceConnectionString=$(az iot hub device-identity connection-string show --device-id myEdgeDevice --hub-name <REPLACE_WITH_HUB_NAME> -o tsv) \
  --parameters authenticationType='password' \
  --parameters adminPasswordOrKey="<REPLACE_WITH_PASSWORD>"
  

• För PowerShell-användare kopierar du följande kommando till PowerShell-fönstret och ersätter platshållartexten med din egen information:

  az deployment group create `
  --resource-group IoTEdgeResources `
  --template-uri "https://raw.githubusercontent.com/Azure/iotedge-vm-deploy/main/edgeDeploy.json" `
  --parameters dnsLabelPrefix='<REPLACE_WITH_VM_NAME>' `
  --parameters adminUsername='azureUser' `
  --parameters deviceConnectionString=$(az iot hub device-identity connection-string show --device-id myEdgeDevice --hub-name <REPLACE_WITH_HUB_NAME> -o tsv) `
  --parameters authenticationType='password' `
  --parameters adminPasswordOrKey="<REPLACE_WITH_PASSWORD>"
  

Den här mallen tar följande parametrar:

När distributionen är klar innehåller JSON-formaterade utdata i CLI SSH-informationen för att ansluta till den virtuella datorn. Kopiera värdet för den offentliga SSH-posten i utdataavsnittet. SSH-kommandot bör till exempel se ut ungefär som ssh azureUser@edge-vm.westus2.cloudapp.azure.com.

Visa IoT Edge-körningsstatus

Resten av kommandona i den här snabbstarten sker på din IoT Edge-enhet så att du kan se vad som händer på enheten. Om du använder en virtuell dator ansluter du till den datorn nu med det administratörsanvändarnamn som du har konfigurerat och DNS-namnet som utdata från distributionskommandot. Du hittar även DNS-namnet på översiktssidan för den virtuella datorn i Azure Portal. Använd följande kommando för att ansluta till din virtuella dator. Ersätt <admin-username> och <DNS-name> med dina egna värden.

ssh <admin-username>@<DNS-name>

När du är ansluten till din virtuella dator, verifiera att runtime-miljön har installerats och konfigurerats på din IoT Edge-enhet.

1. Kontrollera om IoT Edge körs. Följande kommando returnerar statusen Ok om IoT Edge körs eller indikerar eventuella tjänstfel.

   sudo iotedge system status
   

   Tips

   Förhöjd behörighet krävs för att köra iotedge-kommandon. När du loggar ut från datorn och sedan loggar in igen för första gången efter installationen av IoT Edge-körningen, så uppdateras dina behörigheter automatiskt. Tills dess använder du sudo framför kommandona.

2. Hämta tjänstloggar om du behöver felsöka tjänsten.

   sudo iotedge system logs
   

3. Visa alla moduler som körs på din IoT Edge-enhet. Eftersom det är första gången du startar tjänsten, bör du bara kunna se den edgeAgent-modul som körs. EdgeAgent-modulen körs som standard och hjälper till att installera och starta eventuella ytterligare moduler som du distribuerar till enheten.

   sudo iotedge list
   

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 enhetstelemetridata till IoT Hub.

En viktig funktion i Azure IoT Edge är att distribuera kod till dina 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ördefinierad modul från avsnittet IoT Edge-moduler i Microsoft Artifact Registry.

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.

Använd de här stegen för att distribuera din första modul.

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

2. Välj Enheter under Enhetshantering på menyn till vänster.

3. Välj enhets-ID för mål-IoT Edge-enheten i listan.

   När du skapar en ny 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. I det övre fältet väljer du Ange moduler.

   Välj de moduler som du vill köra på enheten. Du kan välja mellan moduler som du har skapat själv eller avbildningar i ett containerregister. I den här snabbstarten distribuerar du en modul från Microsoft-containerregistret.

5. I avsnittet IoT Edge-moduler väljer du Lägg till och sedan IoT Edge-modul.

6. Uppdatera följande modulinställningar:

   Inställning	Värde
   Namn på IoT-modul	SimulatedTemperatureSensor
   URI för bild	mcr.microsoft.com/azureiotedge-simulated-temperature-sensor:latest
   Omstartsprincip	alltid
   Önskad status	körs

7. Välj Nästa: Vägar för att fortsätta konfigurera vägar.

8. Lägg till en väg som skickar alla meddelanden från modulen för simulerad temperatur till IoT Hub.

   Inställning	Värde
   Name	SimulatedTemperatureSensorToIoTHub
   Värde	FROM /messages/modules/SimulatedTemperatureSensor/* INTO $upstream

9. Välj Nästa: Granska + skapa.

10. Granska JSON-filen och välj sedan Skapa. JSON-filen definierar alla moduler som du distribuerar till din IoT Edge-enhet.

    Kommentar

    När du skickar en ny distribution till en IoT Edge-enhet, skickas ingenting till din enhet. 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.

När du har skapat information om moduldistributionen returnerar guiden dig till enhetens informationssida. Visa distributionsstatus på fliken Moduler .

Du bör se tre moduler: $edgeAgent, $edgeHub och SimulatedTemperatureSensor. Om en eller flera av modulerna har Ja under Angiven i distribution men inte under Rapporterad av enhet startar din IoT Edge-enhet dem fortfarande. Vänta några minuter och uppdatera sidan.

Om du har problem med att distribuera moduler kan du läsa mer i Felsöka IoT Edge-enheter från Azure-portalen.

Visa genererade data

I den här snabbstarten skapar du en ny IoT Edge-enhet och installerar IoT Edge-körningen på den. Sedan använder du Azure-portalen för att distribuera en IoT Edge-modul för att köras på enheten utan att göra ändringar i själva enheten.

I det här fallet genererar modulen som du pushade 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å ett vindkraftverk. Meddelandet innehåller rumstemperatur och fuktighet, maskintemperatur och tryck samt en tidsstämpel. I IoT Edge-självstudierna används de data som skapas av den här modulen som testdata för analys.

Öppna kommandotolken på IoT Edge-enheten eller använd SSH-anslutningen från Azure CLI. Bekräfta att modulen som du distribuerade från molnet körs på din IoT Edge-enhet:

sudo iotedge list

Visa meddelandena som skickas från temperatursensormodulen:

sudo iotedge logs SimulatedTemperatureSensor -f

Rensa resurser

Om du vill fortsätta med IoT Edge-självstudierna använder du den enhet som du registrerade och konfigurerade i den här snabbstarten. Annars tar du bort de Azure-resurser som du skapade för att undvika avgifter.

Om du skapade den virtuella datorn och IoT-hubben i en ny resursgrupp kan du ta bort den gruppen och alla associerade resurser. Dubbelkolla innehållet i resursgruppen för att säkerställa att det inte finns något du vill behålla. Om du inte vill ta bort hela gruppen kan du ta bort enskilda resurser i stället.

Ta bort gruppen IoTEdgeResources . Det kan ta några minuter att ta bort en resursgrupp.

az group delete --name IoTEdgeResources --yes

Bekräfta att resursgruppen har tagits bort genom att visa listan över resursgrupper.

az group list

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 använder du en testenhet som genererar rådata om dess miljö.

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