Azure IoT Edge-modules implementeren vanuit Visual Studio Code
Van toepassing op:
IoT Edge 1.5 IoT Edge 1.4
Belangrijk
IoT Edge 1.5 LTS en IoT Edge 1.4 LTS worden ondersteund releases. IoT Edge 1.4 LTS eindigt op 12 november 2024. Raadpleeg IoT Edge bijwerken als u een eerdere versie hebt.
Zodra u IoT Edge-modules met uw bedrijfslogica hebt gemaakt, wilt u deze implementeren op uw apparaten om aan de rand te werken. Als u meerdere modules hebt die samenwerken om gegevens te verzamelen en te verwerken, kunt u ze allemaal tegelijk implementeren en de routeringsregels declareren waarmee ze verbinding maken.
In dit artikel wordt beschreven hoe u een JSON-implementatiemanifest maakt en vervolgens dat bestand gebruikt om de implementatie naar een IoT Edge-apparaat te pushen. Zie IoT Edge-modules op schaal implementeren met Visual Studio Code voor meer informatie over het maken van een implementatie die op meerdere apparaten is gericht op basis van hun gedeelde tags.
Vereisten
Een IoT-hub in uw Azure-abonnement.
Een IoT Edge-apparaat
Als u geen IoT Edge-apparaat hebt ingesteld, kunt u er een maken in een virtuele Azure-machine. Volg de stappen in een van de quickstart-artikelen voor het maken van een virtueel Linux-apparaat of het maken van een virtueel Windows-apparaat.
Azure IoT Edge voor Visual Studio Code. De Azure IoT Edge-hulpprogramma's voor de Visual Studio Code-extensie bevindt zich in de onderhoudsmodus.
Een implementatiemanifest configureren
Een implementatiemanifest is een JSON-document waarin wordt beschreven welke modules moeten worden geïmplementeerd, hoe gegevens stromen tussen de modules en de gewenste eigenschappen van de moduledubbels. Zie Begrijpen hoe IoT Edge-modules kunnen worden gebruikt, geconfigureerd en hergebruikt voor meer informatie over hoe implementatiemanifesten werken en hoe ze kunnen worden gemaakt.
Als u modules wilt implementeren met Visual Studio Code, slaat u het implementatiemanifest lokaal op als een . JSON-bestand. U gebruikt het bestandspad in de volgende sectie wanneer u de opdracht uitvoert om de configuratie toe te passen op uw apparaat.
Hier volgt een basisimplementatiemanifest met één module als voorbeeld:
Notitie
In dit voorbeeldimplementatiemanifest wordt schemaversie 1.1 gebruikt voor de IoT Edge-agent en -hub. Schemaversie 1.1 is uitgebracht samen met IoT Edge versie 1.0.10 en maakt functies mogelijk, zoals opstartvolgorde van modules en route-prioriteitstelling.
{
"modulesContent": {
"$edgeAgent": {
"properties.desired": {
"schemaVersion": "1.1",
"runtime": {
"type": "docker",
"settings": {
"minDockerVersion": "v1.25",
"loggingOptions": "",
"registryCredentials": {}
}
},
"systemModules": {
"edgeAgent": {
"type": "docker",
"settings": {
"image": "mcr.microsoft.com/azureiotedge-agent:1.5",
"createOptions": "{}"
}
},
"edgeHub": {
"type": "docker",
"status": "running",
"restartPolicy": "always",
"settings": {
"image": "mcr.microsoft.com/azureiotedge-hub:1.5",
"createOptions": "{\"HostConfig\":{\"PortBindings\":{\"443/tcp\":[{\"HostPort\":\"443\"}],\"5671/tcp\":[{\"HostPort\":\"5671\"}],\"8883/tcp\":[{\"HostPort\":\"8883\"}]}}}"
}
}
},
"modules": {
"SimulatedTemperatureSensor": {
"version": "1.5",
"type": "docker",
"status": "running",
"restartPolicy": "always",
"settings": {
"image": "mcr.microsoft.com/azureiotedge-simulated-temperature-sensor:1.5",
"createOptions": "{}"
}
}
}
}
},
"$edgeHub": {
"properties.desired": {
"schemaVersion": "1.1",
"routes": {
"route": "FROM /messages/* INTO $upstream"
},
"storeAndForwardConfiguration": {
"timeToLiveSecs": 7200
}
}
},
"SimulatedTemperatureSensor": {
"properties.desired": {}
}
}
}
Aanmelden voor toegang tot uw IoT-hub
U kunt de Azure IoT-extensies voor Visual Studio Code gebruiken om bewerkingen uit te voeren met uw IoT-hub. Voordat deze bewerkingen werken, moet u zich aanmelden bij uw Azure-account en de IoT-hub selecteren waaraan u werkt.
Open in Visual Studio Code de Verkenner-weergave .
Vouw onderaan de Explorer de sectie Azure IoT Hub uit.
Klik op de sectieheader ... in de sectieheader van Azure IoT Hub . Als u het beletselteken niet ziet, plaatst u de muisaanwijzer op de koptekst.
Kies IoT Hub selecteren.
Als u niet bent aangemeld bij uw Azure-account, volgt u de aanwijzingen om dit te doen.
Selecteer uw Azure-abonnement.
Selecteer uw IoT-hub.
Uw apparaat implementeren
U implementeert modules op uw apparaat door het implementatiemanifest toe te passen dat u hebt geconfigureerd met de modulegegevens.
Vouw in de weergave Visual Studio Code Explorer de sectie Azure IoT Hub uit en vouw vervolgens het knooppunt Apparaten uit.
Klik met de rechtermuisknop op het IoT Edge-apparaat dat u wilt configureren met het implementatiemanifest.
Tip
Als u wilt controleren of het apparaat dat u hebt gekozen een IoT Edge-apparaat is, selecteert u het om de lijst met modules uit te vouwen en de aanwezigheid van $edgeHub en $edgeAgent te controleren. Elk IoT Edge-apparaat bevat deze twee modules.
Selecteer Implementatie maken voor één apparaat.
Navigeer naar het JSON-bestand voor het implementatiemanifest dat u wilt gebruiken en klik op Edge-implementatiemanifest selecteren.
De resultaten van uw implementatie worden afgedrukt in de Visual Studio Code-uitvoer. Geslaagde implementaties worden binnen een paar minuten toegepast als het doelapparaat wordt uitgevoerd en is verbonden met internet.
Modules op uw apparaat weergeven
Zodra u modules op uw apparaat hebt geïmplementeerd, kunt u deze allemaal bekijken in de sectie Azure IoT Hub . Selecteer de pijl naast uw IoT Edge-apparaat om het uit te vouwen. Alle modules die momenteel worden uitgevoerd, worden weergegeven.
Als u onlangs nieuwe modules op een apparaat hebt geïmplementeerd, beweegt u de muisaanwijzer over de sectiekop Azure IoT Hub-apparaten en selecteert u het vernieuwingspictogram om de weergave bij te werken.
Klik met de rechtermuisknop op de naam van een module om de moduledubbel weer te geven en te bewerken.
Volgende stappen
Meer informatie over het op schaal implementeren en bewaken van IoT Edge-modules met Visual Studio Code