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

Van toepassing op: IoT Edge 1.5

Belangrijk

IoT Edge 1.5 LTS is een ondersteunde release. IoT Edge 1.4 LTS bereikt het einde van zijn levensduur op 12 november 2024. Raadpleeg IoT Edge bijwerken als u een eerdere versie hebt.

Probeer Azure IoT Edge in deze quickstart door containercode te implementeren op een virtueel IoT Edge-apparaat. Met IoT Edge kunt u op afstand code op uw apparaten beheren, zodat u meer workloads naar de rand kunt verzenden. Gebruik voor deze quickstart een virtuele Azure-machine voor uw IoT Edge-apparaat. Hiermee kunt u snel een testmachine maken en deze verwijderen wanneer u klaar bent.

In deze snelstart leert u de volgende zaken:

• Een IoT Hub maken.
• Een IoT Edge-apparaat registreren in uw IoT-hub.
• Installeer en start de IoT Edge-runtime op een virtueel apparaat.
• Een module op afstand implementeren op een IoT Edge-apparaat.

In deze quickstart leert u hoe u een virtuele Linux-machine maakt die is geconfigureerd als een IoT Edge-apparaat. Vervolgens implementeert u een module vanuit Azure Portal op uw apparaat. In deze quickstart wordt een gesimuleerde sensormodule gebruikt waarmee temperatuur-, vochtigheids- en drukgegevens worden gegenereerd. De andere Azure IoT Edge-zelfstudies bouwen voort op het werk dat u hier doet door aanvullende modules te implementeren waarmee de gesimuleerde gegevens worden geanalyseerd voor zakelijke inzichten.

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

Vereisten

Stel uw omgeving in voor de Azure CLI.

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

  

• Installeer de Azure CLI, indien gewenst, om CLI-referentieopdrachten uit te voeren. Als u in Windows of macOS werkt, kunt u Azure CLI uitvoeren 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 Azure CLI met behulp van de opdracht az login. Volg de stappen die worden weergegeven in de terminal, om het verificatieproces te voltooien. Zie Verifiëren bij Azure met behulp van Azure CLI voor andere aanmeldingsopties.

  • Installeer de Azure CLI-extensie bij het eerste gebruik, wanneer u hierom wordt gevraagd. Zie Extensies gebruiken en beheren met de Azure CLIvoor 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.

Een resourcegroep om alle resources die u in deze snelstartgids beheert, te beheren. In deze quickstart en de volgende zelfstudies wordt gebruikgemaakt van de voorbeeldresourcegroepnaam IoTEdgeResources.

az group create --name IoTEdgeResources --location westus2

Een IoT Hub maken

Start de quickstart door een IoT Hub te maken met de Azure CLI.

De gratis niveau van de IoT Hub is geschikt 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 maken van een IoT Hub kan enkele minuten duren.

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

Als er een fout optreedt omdat er al één gratis IoT Hub in uw abonnement is, wijzigt u de SKU in S1. Elk abonnement biedt toegang tot slechts één gratis IoT-hub. Als u het foutbericht ontvangt dat de naam van de IoT Hub niet beschikbaar is, betekent dit dat iemand anders al een hub met die naam heeft. Probeer een andere naam.

Een IoT Edge-apparaat registreren.

Registreer een IoT Edge-apparaat bij de IoT-hub die u zojuist hebt gemaakt.

Maak een apparaat-id voor uw IoT Edge-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.

Omdat IoT Edge-apparaten zich gedragen en anders worden beheerd dan typische IoT-apparaten, declareert u deze identiteit als een IoT Edge-apparaat met behulp van de --edge-enabled vlag.

1. Voer de volgende opdracht in Azure Cloud Shell 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 in Cloud Shell de nieuwste versie van de azure-iot-extensie wordt uitgevoerd.

2. Controleer de verbindingsreeks voor uw apparaat, die het fysieke apparaat koppelt 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 deze hubs worden geverifieerd. U gebruikt deze verbindingsreeks opnieuw in de volgende sectie om uw IoT Edge-apparaat in te stellen.

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

   De verbindingsreeks moet er bijvoorbeeld ongeveer als volgt uitzien: HostName=contoso-hub.azure-devices.net;DeviceId=myEdgeDevice;SharedAccessKey=<DEVICE-SHARED-ACCESS-KEY>.

Een IoT Edge-apparaat configureren

Maak een virtuele machine met de Azure IoT Edge-runtime.

De IoT Edge-runtime wordt geïmplementeerd op alle IoT Edge-apparaten en heeft drie onderdelen. De IoT Edge-beveiligingsdaemon wordt telkens gestart wanneer een IoT Edge-apparaat wordt opgestart en initialiseert het apparaat door de IoT Edge-agent te starten. De IoT Edge-agent faciliteert de implementatie en bewaking van modules op het IoT Edge-apparaat, inclusief de IoT Edge-hub. Met de IoT Edge-hub wordt de communicatie tussen modules op het IoT Edge-apparaat en tussen het apparaat en IoT Hub beheerd.

Geef tijdens de runtimeconfiguratie een apparaatverbindingsreeks op. Deze tekenreeks wordt verkregen uit de Azure CLI. Deze tekenreeks koppelt uw fysieke apparaat aan de IoT Edge-apparaat-id in Azure.

Het IoT Edge-apparaat implementeren

In deze sectie wordt een Azure Resource Manager-sjabloon gebruikt om een nieuwe virtuele machine te maken en de IoT Edge-runtime hierop te installeren. Als u in plaats daarvan uw eigen Linux-apparaat wilt gebruiken, kunt u de installatiestappen volgen in Het handmatig inrichten van één Linux IoT Edge-apparaat en vervolgens terugkeren naar deze quickstart.

Gebruik de knop Implementeren in Azure of CLI-opdrachten om een IoT Edge-apparaat te maken op basis van de vooraf gedefinieerde sjabloon iotedge-vm-deploy .

• Implementeren met behulp van de Azure Resource Manager-sjabloon van IoT Edge.

  

• Bash- of Cloud Shell-gebruikers kunnen de volgende opdracht naar een teksteditor kopiëren, de tekst van de tijdelijke aanduiding vervangen door hun eigen informatie en de tijdelijke aanduiding kopiëren naar het Bash- of Cloud Shell-venster:

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

• PowerShell-gebruiken kunnen de volgende opdracht naar hun PowerShell-venster kopiëren en vervolgens de tekst van de tijdelijke aanduiding vervangen door uw eigen informatie:

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

Voor deze sjabloon worden de volgende parameters gebruikt:

Parameter	Beschrijving
resource-group	De middelen groep waarin de middelen worden aangemaakt. Gebruik de standaardinstelling IoTEdgeResources die in dit artikel is gebruikt of geef de naam op van een bestaande resourcegroep in uw abonnement.
template-uri	Een verwijzing naar de Resource Manager-sjabloon die we gebruiken.
dnsLabelPrefix	Een tekenreeks die wordt gebruikt om de hostnaam van de virtuele machine te maken. Vervang de tijdelijke aanduiding voor tekst door een naam voor uw virtuele machine.
adminUsername	Een gebruikersnaam voor het beheerdersaccount van de virtuele machine. Gebruik het voorbeeld azureUser of geef een nieuwe gebruikersnaam op.
deviceConnectionString	De verbindingsreeks van de apparaat-id in IoT Hub, die wordt gebruikt om de IoT Edge-runtime op de virtuele machine te configureren. De CLI-opdracht in deze parameter haalt de verbindingsreeks voor u op. Vervang de tekst van de tijdelijke aanduiding door de naam van uw IoT-hub.
authenticatietype	De verificatiemethode voor het beheerdersaccount. Deze quickstart maakt gebruik van wachtwoordverificatie, maar u kunt deze parameter ook instellen op sshPublicKey.
adminPasswordOrKey	Het wachtwoord of de waarde voor de SSH-sleutel voor het beheerdersaccount. Vervang de tekst van de tijdelijke aanduiding door een veilig wachtwoord. Uw wachtwoord moet ten minste 12 tekens lang zijn en drie van de volgende vier typen tekens bevatten: kleine letters, hoofdletters, cijfers en speciale tekens.

Nadat de implementatie is voltooid, bevat JSON-opgemaakte uitvoer in de CLI de SSH-gegevens om verbinding te maken met de virtuele machine. Kopieer de waarde van de publieke SSH-invoer van de uitvoersectie. Uw SSH-opdracht moet er bijvoorbeeld ongeveer als ssh azureUser@edge-vm.westus2.cloudapp.azure.comvolgt uitzien.

De IoT Edge runtime-status bekijken

De overige opdrachten in deze snelstart worden toegepast op uw IoT Edge-apparaat zelf, zodat u kunt zien wat er op het apparaat gebeurt. Als u een virtuele machine gebruikt, maakt u nu verbinding met die machine. Gebruik hiervoor de gebruikersnaam van de beheerder die u hebt ingesteld en de DNS-naam die door de implementatieopdracht is uitgevoerd. U kunt de DNS-naam ook vinden op de overzichtspagina van de virtuele machine in Azure Portal. Gebruik de volgende opdracht om verbinding te maken met uw virtuele machine. Vervang <admin-username> en <DNS-name> door uw eigen waarden.

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

Zodra er verbinding met uw virtuele machine is gemaakt, controleert u of de runtime goed is geïnstalleerd en geconfigureerd op uw IoT Edge-apparaat.

1. Controleer of IoT Edge actief is. Met de volgende opdracht wordt de status OK geretourneerd als IoT Edge wordt uitgevoerd of servicefouten bevat.

   sudo iotedge system status
   

   Tip

   U hebt verhoogde bevoegdheden nodig om iotedge-opdrachten uit te voeren. Nadat u zich de eerste keer na de installatie van de IoT Edge-runtime hebt afgemeld en opnieuw hebt aangemeld, worden uw machtigingen automatisch bijgewerkt. Gebruik tot die tijd sudo voorafgaand aan de opdrachten.

2. Als u problemen met de service moet oplossen, haalt u de servicelogboeken op.

   sudo iotedge system logs
   

3. Bekijk alle modules die op uw IoT Edge-apparaat worden uitgevoerd. Aangezien de service net voor het eerst is gestart, zou u moeten zien dat alleen de edgeAgent-module actief is. De edgeAgent-module wordt standaard uitgevoerd en helpt bij het installeren en starten van aanvullende modules die u op uw apparaat implementeert.

   sudo iotedge list
   

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 van apparaten naar IoT Hub worden verzonden.

Een belangrijke mogelijkheid 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 Microsoft Artifact Registry.

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.

Gebruik deze stappen om uw eerste module te implementeren.

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

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

3. Selecteer de apparaat-id van het IoT Edge-doelapparaat in de lijst.

   Wanneer u een nieuw IoT Edge-apparaat maakt, wordt de statuscode 417 -- The device's deployment configuration is not set weergegeven in 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.

   Selecteer de modules die u op uw apparaat wilt uitvoeren. U kunt kiezen uit zelfgebouwde modules of images in een containerregister. In deze quickstart implementeert u een module uit het Microsoft-containerregister.

5. Selecteer Toevoegen in de sectie IoT Edge-modules en kies vervolgens IoT Edge-module.

6. Werk de volgende module-instellingen bij:

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

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 implementeert op uw IoT Edge-apparaat.

    Notitie

    Wanneer u een nieuwe implementatie naar een IoT Edge-apparaat verzendt, wordt er niets naar uw apparaat gepusht. In plaats daarvan voert het apparaat regelmatig query’s op IoT Hub uit naar eventuele nieuwe instructies. Als het apparaat een bijgewerkt distributiemanifest 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 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 Ja onder Opgegeven in Implementatie heeft, maar niet onder Gerapporteerd door apparaat, is uw IoT Edge-apparaat ze nog steeds aan het starten. Wacht enkele minuten en vernieuw de pagina.

Als u problemen ondervindt met het implementeren van modules, vindt u meer informatie in Het oplossen van problemen met IoT Edge-apparaten vanuit Azure Portal.

Gegenereerde gegevens weergeven

In deze quickstart maakt u een nieuw IoT Edge-apparaat en installeert u de IoT Edge-runtime erop. Vervolgens gebruikt u Azure Portal om een IoT Edge-module te implementeren die op het apparaat wordt uitgevoerd zonder dat u wijzigingen aanbrengt in het apparaat zelf.

In dit geval worden met de module die u hebt gepusht, gegevens voor een voorbeeldomgeving gegenereerd die u later voor testen kunt gebruiken. De gesimuleerde sensor bewaakt zowel een machine als de omgeving rond die machine. Deze sensor kan zich bijvoorbeeld in een serverruimte, op een fabrieksvloer of op een windturbine bevinden. Het bericht bevat informatie over de omgevingstemperatuur, de luchtvochtigheid, de machinetemperatuur en de druk, evenals een tijdstempel. In de IoT Edge-zelfstudies worden gegevens van deze module gebruikt als testgegevens voor analyses.

Open de opdrachtprompt op uw IoT Edge-apparaat of gebruik de SSH-verbinding vanuit Azure CLI. Controleer of de module die u hebt geïmplementeerd vanuit de cloud wordt uitgevoerd op uw IoT Edge-apparaat:

sudo iotedge list

Bekijk de berichten die zijn verzonden vanuit de temperatuursensormodule:

sudo iotedge logs SimulatedTemperatureSensor -f

Tip

IoT Edge-opdrachten zijn hoofdlettergevoelig bij het verwijzen naar modulenamen.

Middelen opschonen

Om door te gaan met de IoT Edge-handleidingen, gebruikt u het apparaat dat u in deze quickstart hebt geregistreerd en ingesteld. 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, kunt u die groep en alle bijbehorende resources verwijderen. Controleer de inhoud van de resourcegroep om ervoor te zorgen dat er niets is dat u wilt behouden. Als u niet de hele groep wilt verwijderen, kunt u in plaats daarvan afzonderlijke resources verwijderen.

Belangrijk

Het verwijderen van een resourcegroep kan niet ongedaan worden gemaakt.

Verwijder de ioTEdgeResources-groep . Het verwijderen van een resourcegroep kan enkele minuten duren.

az group delete --name IoTEdgeResources --yes

Controleer of de resourcegroep is verwijderd door de lijst met resourcegroepen weer te geven.

az group list

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 gebruikt nu een testapparaat waarmee onbewerkte gegevens over de omgeving worden gegenereerd.

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

IoT Edge-apparaten bewaken