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

Van toepassing op: IoT Edge 1,1

Probeer Azure IoT Edge in deze quickstart door in een container geplaatste code te implementeren op een Linux-Windows IoT Edge apparaat. Met IoT Edge kunt u code op uw apparaten op afstand beheren zodat u meer van uw workloads naar de rand kunt verzenden. Voor deze quickstart raden we u aan om uw eigen apparaat te gebruiken om te zien hoe eenvoudig het is om Azure IoT Edge Linux op een Windows.

In deze snelstart leert u het volgende:

• Maak een IoT-hub.
• Een IoT Edge-apparaat registreren in uw IoT-hub.
• Installeer en start de IoT Edge voor Linux op Windows runtime op uw apparaat.
• Een module op afstand implementeren op een IoT Edge apparaat en telemetrie verzenden.

In deze quickstart wordt besturingssysteem voor het instellen van uw Azure IoT Edge voor Linux op Windows apparaat. Vervolgens implementeert u een module van de Azure Portal op uw apparaat. De module die u gebruikt, is een gesimuleerde sensor die temperatuur-, vochtigheids- en drukgegevens genereert. Andere Azure IoT Edge zijn gebaseerd op het werk dat u hier doet door modules te implementeren die de gesimuleerde gegevens analyseren voor zakelijke inzichten.

Als u nog geen actief abonnement op Azure hebt, maakt u een gratis Azure-account aan voordat u begint.

Vereisten

Bereid uw omgeving voor op Azure CLI.

• Gebruik de bash-omgeving in Azure Cloud shell.

  

• Installeer de Azure CLI, indien gewenst, om CLI-referentieopdrachten uit te voeren.

  • Als u een lokale installatie gebruikt, meldt u zich aan bij Azure CLI met behulp van de opdracht AZ login. Volg de stappen die worden weergegeven in de terminal, om het verificatieproces te voltooien. Raadpleeg Aanmelden bij de Azure CLI voor aanvullende aanmeldingsopties.

  • Installeer de Azure CLI-extensie bij het eerste gebruik, wanneer u hierom wordt gevraagd. Raadpleeg Extensies gebruiken met Azure CLI voor meer informatie over extensies.

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

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

az group create --name IoTEdgeResources --location westus2

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

• Systeemvereisten

  • Windows 10/11 (Pro, Enterprise, IoT Enterprise)
  • Windows Server 2019/2022
    _{² Windows 10 en Windows Server 2019 minimaal 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 de Azure CLI.

Het gratis niveau van Azure IoT Hub werkt voor deze quickstart. Als u in het verleden IoT Hub hebt gebruikt en al een hub hebt gemaakt, 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 foutbericht wordt weergegeven omdat u al één gratis hub in uw abonnement hebt, wijzigt u de SKU in S1 . Als er een foutbericht wordt weergegeven 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 net gemaakte IoT Hub.

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

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

1. Voer Azure Cloud Shell 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 er een foutbericht over beleidssleutels wordt weergegeven, moet u ervoor zorgen dat Cloud Shell nieuwste versie van de iothubowner Azure IoT-extensie wordt uitgevoerd.

2. Bekijk de verbindingsreeks voor uw apparaat. Hiermee wordt uw fysieke apparaat aan de bijbehorende identiteit in IoT Hub gekoppeld. Het bevat de naam van uw IoT-hub, de naam van uw apparaat en een gedeelde sleutel die verbindingen tussen de twee verifieert.

   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. U gebruikt deze om de runtime IoT Edge configureren in de volgende sectie.

   

De IoT Edge-runtime installeren en starten

Installeer IoT Edge voor Linux Windows op uw apparaat en configureer deze met de connection string.

Voer de volgende PowerShell-opdrachten uit op het doelapparaat waarop u Azure IoT Edge 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 voert u deze opdrachten extern uit op dat apparaat.

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

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

2. Installeer IoT Edge voor Linux op Windows apparaat.

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

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

   Get-ExecutionPolicy -List
   

   Als het uitvoeringsbeleid van local machine niet AllSigned is, kunt u het uitvoeringsbeleid instellen met behulp van:

   Set-ExecutionPolicy -ExecutionPolicy AllSigned -Force
   

4. Maak de IoT Edge voor Linux op Windows implementatie.

   Deploy-Eflow
   

5. Voer 'Y' in om de licentievoorwaarden te accepteren.

6. Voer 'O' of 'R' in om Optionele diagnostische gegevens in of uit te schakelen, afhankelijk van uw voorkeur. Hieronder ziet u een geslaagde implementatie.

   

7. Uw apparaat inrichten met behulp van de connection string 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 waarmee telemetriegegevens worden verzonden naar IoT Hub.

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 gebouwde module vanuit de sectie IoT Edge Modules van Azure Marketplace rechtstreeks vanuit Azure IoT Hub.

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

Volg deze stappen om uw eerste module te implementeren vanuit Azure Marketplace.

1. Meld u aan bij Azure Portal en ga naar uw IoT-hub.

2. Selecteer in het menu aan de linkerkant onder Automatisch apparaatbeheer de optie IoT Edge.

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

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

4. Selecteer op de bovenste balk Modules instellen.

   

5. Open IoT Edge modules de vervolgkeuzelijst Toevoegen en selecteer vervolgens Marketplace-module.

   

6. Zoek IoT Edge module marketplace naar de module en selecteer Simulated Temperature Sensor deze.

   De module wordt toegevoegd aan de sectie IoT Edge Modules met de gewenste status.

7. Selecteer Volgende: Routes om door te gaan naar de volgende stap in de wizard.

   

8. Verwijder op het tabblad Routes de standaardroute, route en selecteer vervolgens Volgende: Beoordelen en maken om door te gaan naar de volgende stap van de wizard.

   Notitie

   Routes worden samengesteld met behulp van naam- en waardeparen. Op deze pagina ziet u twee routes. De standaardroute, route, verzendt alle berichten naar IoT Hub (dit wordt $upstream genoemd). Er is automatisch een tweede route, SimulatedTemperatureSensorToIoTHub, gemaakt toen u de module vanuit de Azure Marketplace. Deze route verzendt alle berichten van de gesimuleerde temperatuurmodule naar IoT Hub. U kunt de standaardroute verwijderen, omdat deze in dit geval overbodig is.

   

9. Controleer het JSON-bestand en selecteer vervolgens Maken. Het JSON-bestand definieert alle modules die u op uw IoT Edge implementeert. U ziet de module SimulatedTemperatureSensor en de twee runtimemodules edgeAgent en edgeHub.

   Notitie

   Wanneer u een nieuwe implementatie bij een IoT Edge-apparaat indient, wordt er niets naar uw apparaat gepusht. In plaats daarvan voert het apparaat regelmatig query’s uit naar eventuele nieuwe instructies. Als het apparaat een manifest van een bijgewerkte implementatie vindt, wordt de informatie over de nieuwe implementatie gebruikt om installatiekopieën van de module op te halen uit de cloud en wordt een lokale uitvoering van de modules gestart. Dit proces kan enkele minuten duren.

10. 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 voor een of meer van de modules JA is opgegeven onder OPGEGEVEN IN IMPLEMENTATIE maar niet onder GERAPPORTEERD DOOR APPARAAT, wordt IoT Edge apparaat nog steeds op het apparaat. Wacht enkele minuten en vernieuw de pagina.

    

De gegenereerde gegevens weergeven

In deze snelstart 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 kan worden uitgevoerd zonder dat u wijzigingen in het apparaat zelf moet aanbrengen.

De module die u hebt ge pusht, genereert voorbeeldomgevingsgegevens die u later kunt gebruiken voor het testen. De gesimuleerde sensor bewaakt zowel een machine als de omgeving rond die machine. Deze sensor kan zich bijvoorbeeld in een serverruimte, in een fabriek of op een windturbine bevinden. De berichten die worden verzonden, 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 IoT Edge Linux op Windows virtuele machine met behulp van de volgende opdracht in uw PowerShell-sessie:

   Connect-EflowVm
   

   Notitie

   Het enige account dat is toegestaan voor SSH voor de virtuele machine is de gebruiker die deze heeft gemaakt.

2. Zodra u bent aangemeld, kunt u de lijst met de IoT Edge modules controleren met behulp van de volgende Linux-opdracht:

   sudo iotedge list
   

   

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

   sudo iotedge logs SimulatedTemperatureSensor -f
   

   Belangrijk

   IoT Edge-opdrachten zijn zeer gevoelig wanneer ze naar modulenamen verwijzen.

   

U kunt ook de extensie Azure IoT Hub voor Visual Studio Code gebruiken om berichten te bekijken die binnenkomen bij uw IoT-hub.

Resources opschonen

Als u wilt doorgaan naar de IoT Edge zelfstudies, slaat u deze stap over. U kunt het apparaat gebruiken dat u hebt geregistreerd en ingesteld in deze quickstart. Anders kunt u de Azure-resources die u hebt gemaakt verwijderen om kosten te voorkomen.

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

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

az group delete --name IoTEdgeResources

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

az group list

De Azure IoT Edge voor Linux op Windows

Gebruik de dashboardextensie in Windows-beheercentrum om Azure IoT Edge voor Linux op Windows.

1. Verbinding maken naar het IoT Edge apparaat in Windows-beheercentrum. De extensie voor het Azure-dashboardhulpprogramma wordt geladen.

2. Selecteer Verwijderen. Nadat Azure IoT Edge is verwijderd, Windows het beheercentrum de vermelding Azure IoT Edge apparaatverbinding verwijderen van de startpagina.

Volgende stappen

In deze snelstart hebt u een IoT Edge-apparaat gemaakt en de Azure IoT Edge-cloudinterface gebruikt om code te implementeren op het apparaat. 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.