Delen via


IoT Edge-implementatiemanifesten beheren in uw IoT Central-toepassing

Met een implementatiemanifest kunt u de modules opgeven die de IoT Edge-runtime moet downloaden en configureren. Een IoT Edge-apparaat kan een implementatiemanifest downloaden wanneer het voor het eerst verbinding maakt met uw IoT Central-toepassing. In dit artikel wordt beschreven hoe u implementatiemanifesten beheert in uw IoT Central-toepassing.

Zie Verbinding maken Azure IoT Edge-apparaten naar een Azure IoT Central-toepassing voor meer informatie over IoT Edge en IoT Central.

Zie Voor meer informatie over het beheren van implementatiemanifesten met behulp van de Rest API van IoT Central de IoT Central REST API voor het beheren van implementatiemanifesten.

Implementatiemanifesten beheren

Op de pagina Edge-manifesten kunt u de implementatiemanifesten in uw toepassing beheren. Op deze pagina kunt u het volgende doen:

  • Implementatiemanifesten uploaden of maken
  • Bestaande implementatiemanifesten wijzigen
  • Implementatiemanifesten verwijderen

Implementatiemanifesten uploaden en maken

Wanneer u een nieuw implementatiemanifest maakt, kunt u het JSON-bestand met het distributiemanifest uploaden of beginnen met een bestaand manifest:

  1. Selecteer + Nieuw op de pagina Edge-manifesten.

  2. Voer een naam in voor het implementatiemanifest.

  3. Als uw toepassing gebruikmaakt van organisaties, selecteert u een organisatie waaraan u het implementatiemanifest wilt koppelen.

  4. Blader naar een distributiemanifestbestand om een bestaand implementatiemanifest te uploaden of te kiezen als uitgangspunt voor uw nieuwe manifestbestand. IoT Central valideert alle geüploade bestanden.

    Screenshot that shows an uploaded and validated deployment manifest.

  5. Selecteer Volgende. Op de pagina Controleren en voltooien ziet u informatie over het implementatiemanifest en de modules die worden gedefinieerd. U kunt ook de onbewerkte JSON bekijken.

  6. Selecteer Maken. De pagina Edge-manifesten bevat nu het nieuwe implementatiemanifest.

Tip

Als u een groot aantal implementatiemanifesten hebt, kunt u de lijst sorteren en filteren die wordt weergegeven op de pagina Edge-manifesten .

De JSON-bron van een implementatiemanifest bewerken

Als u een implementatiemanifest wilt wijzigen door de JSON rechtstreeks te bewerken:

  1. Navigeer naar de pagina Edge-manifesten .

  2. Selecteer JSON bewerken in het contextmenu voor het implementatiemanifest dat u wilt wijzigen.

  3. Gebruik de JSON-editor om de vereiste wijzigingen aan te brengen. Selecteer vervolgens Opslaan.

De inhoud van een implementatiemanifest vervangen

De inhoud van een implementatiemanifest volledig vervangen:

  1. Navigeer naar de pagina Edge-manifesten .

  2. Selecteer het implementatiemanifest dat u wilt vervangen.

  3. Blader in het dialoogvenster Aanpassen naar een nieuw distributiemanifestbestand om een bestaand implementatiemanifest te uploaden of te kiezen als uitgangspunt. IoT Central valideert alle geüploade bestanden.

  4. Selecteer Volgende. Op de pagina Controleren en voltooien ziet u informatie over het nieuwe implementatiemanifest en de modules die worden gedefinieerd. U kunt ook de onbewerkte JSON bekijken.

  5. Selecteer Opslaan. De pagina Edge-manifesten bevat nu het bijgewerkte implementatiemanifest.

IoT Edge-apparaten beheren

Wanneer u een IoT Edge-apparaat toevoegt op de pagina apparaten, kunt u een implementatiemanifest voor het apparaat kiezen. In het dialoogvenster Een nieuw apparaat maken kunt u kiezen uit de lijst met eerder geüploade apparaatmanifesten op de pagina Edge-manifesten . Het is ook mogelijk om rechtstreeks een implementatiemanifest toe te voegen aan een apparaat nadat u het apparaat hebt gemaakt.

Als u een IoT Edge-apparaat toevoegt dat niet is toegewezen aan een apparaatsjabloon, ziet het dialoogvenster Een nieuw apparaat maken eruit als in de volgende schermopname:

Screenshot that shows adding an unassigned device to your application.

Het implementatiemanifest voor het apparaat kiezen:

  1. Schakel het Azure IoT Edge-apparaat in op Ja.

  2. Selecteer het IoT Edge-implementatiemanifest dat u wilt gebruiken. U kunt er ook voor kiezen om een implementatiemanifest toe te wijzen nadat u het apparaat hebt gemaakt.

  3. Selecteer Maken.

Als u een IoT Edge-apparaat toevoegt dat is toegewezen aan een apparaatsjabloon, ziet het dialoogvenster Een nieuw apparaat maken eruit als in de volgende schermopname:

Screenshot that shows adding an assigned device to your application.

Het implementatiemanifest voor het apparaat kiezen:

  1. Het Azure IoT Edge-apparaat? wisselknop is al ingesteld op Ja , omdat IoT Central herkent dat u een IoT Edge-apparaatsjabloon gebruikt.

  2. Selecteer het IoT Edge-implementatiemanifest dat u wilt gebruiken. U kunt er ook voor kiezen om een implementatiemanifest toe te wijzen nadat u het apparaat hebt gemaakt.

  3. Selecteer Maken.

Wanneer een IoT Edge-apparaat voor het eerst verbinding maakt met uw toepassing, wordt het implementatiemanifest gedownload, worden de modules geconfigureerd die zijn opgegeven in het implementatiemanifest en worden de modules uitgevoerd.

Als u geen implementatiemanifest selecteert wanneer u een IoT Edge-apparaat maakt, kunt u er een later afzonderlijk of aan meerdere apparaten toewijzen met behulp van een taak.

Het implementatiemanifest bijwerken dat een apparaat gebruikt

U kunt het implementatiemanifest voor een bestaand apparaat beheren:

Screenshot that shows the options to manage a deployment manifest on a device.

Gebruik Edge-manifest toewijzen om een eerder geüpload implementatiemanifest te selecteren op de pagina Edge-manifesten . U kunt deze optie ook gebruiken om een apparaat handmatig op de hoogte te stellen als u het implementatiemanifest wijzigt op de pagina Edge-manifesten .

Gebruik manifest bewerken om het implementatiemanifest voor dit apparaat te wijzigen. Wijzigingen die u hier aanbrengt, hebben geen invloed op het implementatiemanifest op de pagina Edge-manifesten .

Projecten

Gebruik een taak om het implementatiemanifest voor meerdere apparaten toe te wijzen of bij te werken. Gebruik het taaktype Distributiemanifest wijzigen in Edge:

Screenshot that shows the deployment manifest job type.

Modules en eigenschappen toevoegen aan apparaatsjablonen

Een implementatiemanifest definieert de modules die moeten worden uitgevoerd op het apparaat en eventueel beschrijfbare eigenschappen die u kunt gebruiken om modules te configureren.

Als u een apparaatsjabloon toewijst aan een IoT Edge-apparaat, kunt u de modules en schrijfbare eigenschappen in de apparaatsjabloon definiëren. De modules en eigenschapsdefinities toevoegen aan een apparaatsjabloon:

  1. Navigeer naar de pagina ModulesOverzicht van de IoT Edge-apparaatsjabloon.
  2. Selecteer Modules importeren uit manifest.
  3. Selecteer het juiste implementatiemanifest in de lijst.
  4. Selecteer Importeren. IoT Central voegt de aangepaste modules die zijn gedefinieerd in het implementatiemanifest toe aan de apparaatsjabloon. De namen van de modules in de apparaatsjabloon komen overeen met de namen van de aangepaste modules in het implementatiemanifest. De gegenereerde interface bevat eigenschapsdefinities voor de eigenschappen die zijn gedefinieerd voor de aangepaste module in het implementatiemanifest:

Screenshot the shows importing module definitions to a device template.