Azure IoT Edge-modules implementeren vanuit de Azure Portal

Van toepassing op:IoT Edge 1.4 checkmark IoT Edge 1.4

Belangrijk

IoT Edge 1.4 is de ondersteunde release. 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 in Azure Portal een implementatiemanifest maakt en de implementatie naar een IoT Edge-apparaat pusht. Zie IoT Edge-modules op schaal implementeren en bewaken voor informatie over het maken van een implementatie die is gericht op meerdere apparaten op basis van hun gedeelde tags.

Vereisten

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.

Azure Portal bevat een wizard waarmee u het implementatiemanifest kunt maken in plaats van het JSON-document handmatig te bouwen. Het heeft drie stappen: modules toevoegen, routes opgeven en implementatie controleren.

Notitie

De stappen in dit artikel weerspiegelen de nieuwste schemaversie van de IoT Edge-agent en -hub. Schemaversie 1.1 is uitgebracht samen met IoT Edge versie 1.0.10 en maakt de opstartvolgorde en route-prioriteitsfuncties van de module mogelijk.

Als u implementeert op een apparaat met versie 1.0.9 of eerder, bewerkt u de Runtime-Instellingen in de stap Modules van de wizard om schemaversie 1.0 te gebruiken.

Apparaat selecteren en modules toevoegen

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

  2. Selecteer Apparaten in het linkerdeelvenster onder het menu Apparaatbeheer .

  3. Selecteer het IoT Edge-doelapparaat in de lijst.

  4. Selecteer op de bovenste balk Modules instellen.

  5. Geef in het gedeelte Container Registry-referenties van de pagina de referenties op voor toegang tot alle persoonlijke containerregisters die uw module-installatiekopieën bevatten.

  6. Selecteer Toevoegen in de sectie IoT Edge-modules van de pagina.

  7. Kies een van de drie typen modules in de vervolgkeuzelijst:

    • IoT Edge-module : u geeft de modulenaam en de URI van de containerinstallatiekopieën op. De afbeeldings-URI voor de voorbeeldmodule SimulatedTemperatureSensor is mcr.microsoft.com/azureiotedge-simulated-temperature-sensor:1.0bijvoorbeeld . Als de module-installatiekopieën zijn opgeslagen in een privécontainerregister, voegt u de referenties op deze pagina toe om toegang te krijgen tot de installatiekopieën.
    • Marketplace-module : modules die worden gehost in Azure Marketplace. Voor sommige Marketplace-modules is extra configuratie vereist. Bekijk daarom de moduledetails in de lijst met IoT Edge-modules van Azure Marketplace.
    • Azure Stream Analytics-module : modules die zijn gegenereerd op basis van een Azure Stream Analytics-workload.
  8. Nadat u een module hebt toegevoegd, selecteert u de modulenaam in de lijst om de module-instellingen te openen. Vul indien nodig de optionele velden in.

    Zie Moduleconfiguratie en -beheer voor meer informatie over de beschikbare module-instellingen.

    Zie Gewenste eigenschappen definiëren of bijwerken voor meer informatie over de moduledubbel.

  9. Herhaal stap 6 tot en met 8 om extra modules toe te voegen aan uw implementatie.

  10. Selecteer Volgende: Routes om door te gaan naar de sectie Routes.

Routes opgeven

Op het tabblad Routes definieert u hoe berichten tussen modules en de IoT Hub worden uitgewisseld. Berichten worden gemaakt met behulp van naam/waarde-paren. De eerste implementatie voor een nieuw apparaat bevat standaard een route met de naam route en gedefinieerd als FROM /messages/* INTO $upstream, wat betekent dat alle berichten die door modules worden uitgevoerd, naar uw IoT-hub worden verzonden.

De parameters Priority en Time to Live zijn optionele parameters die u kunt opnemen in een routedefinitie. Met de prioriteitsparameter kunt u kiezen welke routes als eerste moeten worden verwerkt of welke routes als laatste moeten worden verwerkt. Prioriteit wordt bepaald door een getal 0-9 in te stellen, waarbij 0 de hoogste prioriteit heeft. Met de time to live-parameter kunt u aangeven hoe lang berichten in die route moeten worden bewaard totdat ze worden verwerkt of verwijderd uit de wachtrij.

Zie Routes declareren voor meer informatie over het maken van routes.

Zodra de routes zijn ingesteld, selecteert u Volgende: Controleren en maken om door te gaan naar de volgende stap van de wizard.

Implementatie controleren

In de beoordelingssectie ziet u het JSON-implementatiemanifest dat is gemaakt op basis van uw selecties in de vorige twee secties. Houd er rekening mee dat er twee modules zijn gedeclareerd die u niet hebt toegevoegd: $edgeAgent en $edgeHub. Deze twee modules vormen de IoT Edge-runtime en zijn vereist voor elke implementatie.

Controleer uw implementatiegegevens en selecteer Vervolgens Maken.

Modules op uw apparaat weergeven

Zodra u modules op uw apparaat hebt geïmplementeerd, kunt u ze allemaal bekijken op de pagina met apparaatdetails van uw IoT Hub. Op deze pagina wordt de naam van elke geïmplementeerde module weergegeven, evenals nuttige informatie zoals de implementatiestatus en afsluitcode.

Modules implementeren vanuit Azure Marketplace

Azure Marketplace is een online marketplace voor toepassingen en services waar u door een breed scala aan bedrijfstoepassingen en -oplossingen kunt bladeren die zijn gecertificeerd en geoptimaliseerd voor uitvoering in Azure, waaronder IoT Edge-modules.

U kunt een IoT Edge-module implementeren vanuit Azure Marketplace en vanuit uw IoT Hub.

Implementeren vanuit Azure Marketplace

Gebruik de IoT Edge-modules in de marketplace en wanneer u de gewenste module hebt gevonden, kunt u deze implementeren door Nu maken of Downloaden te selecteren. Ga verder met de stappen van de implementatiewizard, afhankelijk van de IoT Edge-module die u hebt geselecteerd:

  1. Bevestig de gebruiksvoorwaarden en het privacybeleid van de provider door Doorgaan te selecteren. Mogelijk moet u eerst contactgegevens opgeven.
  2. Kies uw abonnement en de IoT Hub waaraan het doelapparaat is gekoppeld.
  3. Kies Implementeren op een apparaat.
  4. Voer de naam van het apparaat in of selecteer Apparaat zoeken om te bladeren tussen de apparaten die zijn geregistreerd bij de hub.
  5. Selecteer Maken om door te gaan met het standaardproces voor het configureren van een implementatiemanifest, inclusief het toevoegen van andere modules indien gewenst. Details voor de nieuwe module, zoals afbeeldings-URI, opties voor maken en gewenste eigenschappen, zijn vooraf gedefinieerd, maar kunnen worden gewijzigd.

Controleer of de module is geïmplementeerd in uw IoT Hub in Azure Portal. Selecteer uw apparaat, selecteer Modules instellen en de module moet worden vermeld in de sectie IoT Edge-modules .

Implementeren vanuit Azure IoT Hub

U kunt snel een module vanuit Azure Marketplace implementeren op uw apparaat in uw IoT Hub in Azure Portal.

  1. Ga in Azure Portal naar uw IoT Hub.
  2. Selecteer Apparaten in het linkerdeelvenster onder het menu Apparaatbeheer .
  3. Selecteer het IoT Edge-apparaat dat de implementatie moet ontvangen.
  4. Selecteer op de bovenste balk Modules instellen.
  5. Klik in de sectie IoT Edge-modules op Toevoegen en selecteer Marketplace-module in de vervolgkeuzelijst.

Screenshot showing how to add a module in I o T Hub.

Kies een module op de marketplace-pagina voor IoT Edge-modules . De module die u selecteert, wordt automatisch geconfigureerd voor uw abonnement, resourcegroep en apparaat. Deze wordt vervolgens weergegeven in uw lijst met IoT Edge-modules. Voor sommige modules is mogelijk extra configuratie vereist.

Fooi

De informatie over IoT Edge-modules van de Azure IoT Hub is beperkt. U vindt eerst meer informatie over de IoT Edge-modules in Azure Marketplace.

Selecteer Volgende: Routes en doorgaan met de implementatie, zoals beschreven door Routes opgeven en Implementatie controleren eerder in dit artikel.

Volgende stappen

Meer informatie over het implementeren en bewaken van IoT Edge-modules op schaal