Quickstart: Uw eerste IoT Edge-module implementeren op een Windows-apparaat

Van toepassing op: IoT Edge 1.5

Probeer Azure IoT Edge in deze quickstart door containercode te implementeren in een Linux op Windows IoT Edge apparaat. IoT Edge kunt u op afstand code op uw apparaten beheren, zodat u meer workloads naar de rand kunt verzenden. Voor deze quickstart is het raadzaam dat u uw eigen Windows Client-apparaat gebruikt om te zien hoe eenvoudig het is om Azure IoT Edge te gebruiken voor Linux op Windows. Als u Windows Server of een Azure VM wilt gebruiken om uw implementatie te maken, volgt u de stappen in de handleiding over installatie en inrichting van Azure IoT Edge voor Linux op een Windows apparaat.

In deze snelstart leert u de volgende zaken:

• Maak een IoT-hub.
• Registreer een IoT Edge apparaat bij uw IoT-hub.
• Installeer en start de IoT Edge voor Linux op Windows runtime op uw apparaat.
• Implementeer een module op afstand op een IoT Edge apparaat en verzend telemetrie.

In deze quickstart wordt uitgelegd hoe u uw Azure IoT Edge voor Linux instelt op Windows apparaat. Vervolgens implementeert u een module vanuit de Azure-portal op uw apparaat. De module die u gebruikt, is een gesimuleerde sensor waarmee temperatuur-, vochtigheids- en drukgegevens worden gegenereerd. Andere Azure IoT Edge zelfstudies bouwen voort op het werk dat u hier doet door modules te implementeren die de gesimuleerde gegevens voor zakelijke inzichten analyseren.

Als u geen actief Azure-abonnement hebt, maakt u een vrij account voordat u begint.

Vereisten

Bereid uw omgeving voor op de Azure CLI.

• Gebruik de Bash-omgeving in Azure Cloud Shell. Zie Get gestart met Azure Cloud Shell voor meer informatie.

  

• Als u CLI-referentieopdrachten liever lokaal uitvoert, installeer de Azure CLI. Als u op Windows of macOS werkt, kunt u overwegen Azure CLI uit te voeren in een Docker-container. Zie De Azure CLI uitvoeren in een Docker-container voor meer informatie.

  • Als u een lokale installatie gebruikt, meldt u zich aan bij de Azure CLI met behulp van de opdracht az. Volg de stappen die worden weergegeven in de terminal, om het verificatieproces te voltooien. Zie Authenticate to Azure using Azure CLI voor andere aanmeldingsopties.

  • Wanneer u hierom wordt gevraagd, installeert u de Azure CLI-extensie bij het eerste gebruik. Zie Uitbreidingen gebruiken en beheren met de Azure CLI voor meer informatie over extensies.

  • Voer az version uit om de geïnstalleerde versie en de afhankelijke bibliotheken te vinden. Voer az upgrade uit om naar de nieuwste versie te upgraden.

Maak een cloudresourcegroep voor het beheren van alle resources die u in deze quickstart gebruikt.

az group create --name IoTEdgeResources --location westus2

Zorg ervoor dat uw IoT Edge apparaat voldoet aan de volgende vereisten:

• Systeemvereisten

  • Windows 10¹/11 (Pro, Enterprise, IoT Enterprise) _{¹ Windows 10 minimum build 17763 met alle huidige cumulatieve updates geïnstalleerd.}

• Hardwarevereisten

  • Minimaal vrij geheugen: 1 GB
  • Minimale vrije schijfruimte: 10 GB

Een IoT Hub maken

Begin met het maken van een IoT-hub met behulp van de Azure CLI.

Het gratis niveau van Azure IoT Hub werkt voor deze snelle start. Als u eerder IoT Hub hebt gebruikt en al een hub hebt, kunt u die IoT hub gebruiken.

Met de volgende code wordt een gratis F1-hub gemaakt in de resourcegroep IoTEdgeResources. Vervang {hub_name} door een unieke naam voor uw IoT-hub. Het kan enkele minuten duren voordat een IoT-hub is gemaakt.

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

Als er een fout optreedt omdat u al één gratis hub in uw abonnement hebt, wijzigt u de SKU in S1. Als u een foutbericht krijgt dat de naam van de IoT-hub niet beschikbaar is, heeft iemand anders al een hub met die naam. Probeer een andere naam.

Een IoT Edge-apparaat registreren

Registreer een IoT Edge apparaat bij uw zojuist gemaakte IoT-hub.

Maak een apparaat-id voor uw gesimuleerde apparaat, zodat het met uw IoT-hub kan communiceren. De apparaat-id bevindt zich in de cloud, en u gebruikt een unieke apparaat verbindingstekenreeks om een fysiek apparaat te koppelen aan een apparaat-id.

IoT Edge-apparaten gedragen zich anders en kunnen anders worden beheerd dan typische IoT-apparaten. Gebruik de vlag --edge-enabled om aan te geven dat deze identiteit voor een IoT Edge apparaat is.

1. Voer in Azure Cloud Shell de volgende opdracht in om een apparaat met de naam myEdgeDevice te maken in uw hub.

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

   Als u een foutmelding krijgt over iothubowner beleidssleutels, controleert u of Cloud Shell de nieuwste versie van de Azure IoT-extensie uitvoert.

2. Bekijk de connection string voor uw apparaat, waarmee uw fysieke apparaat wordt gekoppeld aan de identiteit in IoT Hub. Het bevat de naam van uw IoT-hub, de naam van uw apparaat en een gedeelde sleutel waarmee verbindingen tussen de twee worden geverifieerd.

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

3. Kopieer de waarde van de sleutel connectionString uit de JSON-uitvoer en sla deze op. Deze waarde is de verbindingsreeks van het apparaat. Gebruik deze om de IoT Edge runtime in de volgende sectie te configureren.

   Uw connection string moet er bijvoorbeeld ongeveer uitzien als HostName=contoso-hub.azure-devices.net;DeviceId=myEdgeDevice;SharedAccessKey=<DEVICE_SHARED_ACCESS_KEY>.

De IoT Edge runtime installeren en starten

Installeer IoT Edge voor Linux op Windows op uw apparaat en configureer het met de apparaatverbindingstekenreeks.

Voer de volgende PowerShell-opdrachten uit op het doelapparaat waarop u Azure IoT Edge voor Linux wilt implementeren op Windows. Als u wilt implementeren op een extern doelapparaat met behulp van PowerShell, gebruikt u Externe PowerShell om een verbinding met een extern apparaat tot stand te brengen en deze opdrachten op afstand op dat apparaat uit te voeren.

1. Voer in een PowerShell-sessie met verhoogde bevoegdheid de volgende opdracht uit om Hyper-V in te schakelen. Zie Hyper-V op Windows 10 voor meer informatie.

   Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All
   

2. Voer in een PowerShell-sessie met verhoogde bevoegdheid elk van de volgende opdrachten uit om IoT Edge voor Linux op Windows te downloaden.

   • X64/AMD64

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

   • ARM64

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

3. Installeer IoT Edge voor Linux op Windows op uw apparaat.

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

4. Stel het uitvoeringsbeleid op het doelapparaat in op AllSigned als dit nog niet is gebeurd. U kunt het huidige uitvoeringsbeleid controleren in een PowerShell-prompt met verhoogde bevoegdheid met behulp van:

   Get-ExecutionPolicy -List
   

   Als het uitvoeringsbeleid local machine niet AllSignedis, stelt u het uitvoeringsbeleid in met behulp van de volgende opdracht:

   Set-ExecutionPolicy -ExecutionPolicy AllSigned -Force
   

5. Creëer de IoT Edge voor Linux op Windows-implementatie.

   Deploy-Eflow
   

6. Voer Y in om de licentievoorwaarden te accepteren.

7. Voer O of R in om optionele diagnostische gegevens in of uit te schakelen, afhankelijk van uw voorkeur. In de volgende afbeelding wordt een geslaagde implementatie weergegeven.

   

8. Richt uw apparaat in met behulp van de verbindingsreeks van het apparaat die u in de vorige sectie hebt opgehaald. Vervang de tekst van de tijdelijke aanduiding door uw eigen waarde.

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

Uw IoT Edge-apparaat is nu geconfigureerd. Het is gereed voor de uitvoering van modules die in de cloud zijn geïmplementeerd.

Een module implementeren

Beheer uw Azure IoT Edge apparaat vanuit de cloud om een module te implementeren die telemetriegegevens naar IoT Hub verzendt.

Een van de belangrijkste mogelijkheden van Azure IoT Edge is het implementeren van code op uw IoT Edge apparaten vanuit de cloud. IoT Edge modules zijn uitvoerbare pakketten die zijn geïmplementeerd als containers. In deze sectie implementeert u een vooraf gemaakte module vanuit de sectie IoT Edge Modules van Microsoft Artifact Registry.

De module die u in deze sectie implementeert, simuleert een sensor en verzendt gegenereerde gegevens. Deze module is een nuttig stukje code wanneer u aan de slag gaat met IoT Edge omdat u de gesimuleerde gegevens kunt gebruiken voor ontwikkeling en testen. Als u precies wilt zien wat deze module doet, kunt u de broncode van de simulated temperatuursensor bekijken.

Volg deze stappen om uw eerste module te implementeren.

1. Meld u aan bij de Azure-portal en ga naar uw IoT Hub.

2. Selecteer Apparaten in het menu aan de linkerkant onder het menu Apparaatbeheer.

3. Selecteer de apparaat-id van het doelapparaat in de lijst met apparaten.

   Notitie

   Wanneer u een nieuw IoT Edge-apparaat maakt, wordt de statuscode weergegeven 417 -- The device's deployment configuration is not set in de Azure-portal. Deze status is normaal en betekent dat het apparaat gereed is voor het ontvangen van een module-implementatie.

4. Selecteer op de bovenste balk Modules instellen.

   Kies welke modules u wilt uitvoeren op uw apparaat. U kunt kiezen uit modules die u al hebt gemaakt, modules uit Microsoft Artifact Registry of modules die u zelf hebt gemaakt. In deze quickstart implementeert u een module uit het Microsoft Artifact Registry.

5. Selecteer in de sectie IoT Edge modulesToevoegen en kies vervolgens IoT Edge Module.

6. Werk de volgende module-instellingen bij:

   Instelling	Waarde
   Naam van IoT-module	SimulatedTemperatureSensor
   Afbeelding-URI	mcr.microsoft.com/azureiotedge-simulated-temperature-sensor:latest
   Beleid voor opnieuw opstarten	altijd
   Gewenste status	draaiend

7. Selecteer Volgende: Routes om door te gaan met het configureren van routes.

8. Voeg een route toe waarmee alle berichten van de gesimuleerde temperatuurmodule naar IoT Hub worden verzonden.

   Instelling	Waarde
   Naam	SimulatedTemperatureSensorToIoTHub
   Waarde	FROM /messages/modules/SimulatedTemperatureSensor/* INTO $upstream

9. Selecteer Volgende: Beoordelen en maken.

10. Controleer het JSON-bestand en selecteer Maken. Het JSON-bestand definieert alle modules die u op uw IoT Edge apparaat implementeert.

    Notitie

    Wanneer u een nieuwe implementatie naar een IoT Edge apparaat verzendt, wordt er niets naar uw apparaat gepusht. In plaats daarvan vraagt het apparaat regelmatig bij IoT Hub om eventuele nieuwe instructies. Als het apparaat een bijgewerkt implementatiemanifest vindt, wordt de informatie over de nieuwe implementatie gebruikt om de installatiekopieën van de module op te halen uit de cloud, waarna de modules lokaal worden uitgevoerd. Dit proces kan enkele minuten in beslag nemen.

Nadat u de informatie over de implementatie van de module hebt gemaakt, gaat de wizard terug naar de pagina met apparaatdetails. Bekijk de implementatiestatus op het tabblad Modules .

U ziet drie modules: $edgeAgent, $edgeHub en SimulatedTemperatureSensor. Als een of meer van de modules onder Yes bij Specified in Deployment staan, maar niet onder Reported by Device, dan worden ze nog steeds gestart door uw IoT Edge-apparaat. Wacht enkele minuten en vernieuw de pagina.

Als u problemen ondervindt met het implementeren van modules, raadpleegt u Roubleshoot IoT Edge-apparaten vanuit de Azure-portal.

De gegenereerde gegevens weergeven

In deze quickstart hebt u een nieuw IoT Edge-apparaat gemaakt en de IoT Edge runtime erop geïnstalleerd. Vervolgens hebt u de Azure-portal gebruikt om een IoT Edge-module te implementeren die op het apparaat moet worden uitgevoerd zonder dat u wijzigingen hoeft aan te brengen in het apparaat zelf.

Met de module die u pusht, worden voorbeeldomgevingsgegevens gegenereerd die u later kunt gebruiken voor het testen. De gesimuleerde sensor bewaakt zowel een machine als de omgeving rond de machine. Deze sensor kan zich bijvoorbeeld in een serverruimte, in een fabriek of op een windturbine bevinden. De berichten die het verzendt, zijn omgevingstemperatuur en vochtigheid, machinetemperatuur en druk en een tijdstempel. IoT Edge zelfstudies gebruiken de gegevens die door deze module zijn gemaakt als testgegevens voor analyse.

1. Meld u aan bij uw IoT Edge voor Linux op Windows virtuele machine met behulp van de volgende opdracht in uw PowerShell-sessie:

   Connect-EflowVm
   

   Notitie

   Het enige account dat SSH-toegang tot de virtuele machine heeft, is de gebruiker die deze heeft gecreëerd.

2. Nadat u zich hebt aangemeld, controleert u de lijst met het uitvoeren van IoT Edge modules met behulp van de volgende Linux-opdracht:

   sudo iotedge list
   

   

3. Bekijk de berichten die vanuit de temperatuursensormodule naar de cloud worden verzonden met behulp van de volgende Linux-opdracht:

   sudo iotedge logs SimulatedTemperatureSensor -f
   

   

   Tip

   IoT Edge-opdrachten zijn hoofdlettergevoelig wanneer ze verwijzen naar modulenamen.

Middelen opschonen

Als u door wilt gaan naar de IoT Edge zelfstudies, slaat u deze stap over. U kunt het apparaat gebruiken dat u hebt geregistreerd en ingesteld in deze snelle startgids. Verwijder anders de Azure resources die u hebt gemaakt om kosten te voorkomen.

Als u uw virtuele machine en IoT-hub in een nieuwe resourcegroep hebt gemaakt, verwijdert u die groep en alle bijbehorende resources. Als u de hele groep niet wilt verwijderen, verwijdert u in plaats daarvan afzonderlijke resources.

Gebruik de volgende opdracht om de groep IoTEdgeResources te verwijderen. Het verwijderen kan enkele minuten duren.

az group delete --name IoTEdgeResources

U kunt bevestigen dat de resourcegroep is verwijderd met behulp van deze opdracht om de lijst met resourcegroepen weer te geven.

az group list

Verwijder IoT Edge voor Linux op Windows

Voer de volgende stappen uit om de Azure IoT Edge voor Linux op Windows installatie van uw apparaat te verwijderen.

1. Open Instellingen in Windows.
2. Selecteer Programma's toevoegen of verwijderen.
3. Selecteer de app Azure IoT Edge.
4. Selecteer Deïnstalleren.

Volgende stappen

In deze quickstart hebt u een IoT Edge apparaat gemaakt en de Azure IoT Edge cloudinterface gebruikt om code op het apparaat te implementeren. U hebt nu een testapparaat dat onbewerkte gegevens over de omgeving genereert.

In de volgende zelfstudie leert u hoe u de activiteit en status van uw apparaat kunt bewaken vanuit de Azure-portal.