Verwalten von IoT Edge-Bereitstellungsmanifesten in Ihrer IoT Central-Anwendung

Mit einem Bereitstellungsmanifest können Sie die Module angeben, die die IoT Edge-Laufzeit herunterladen und konfigurieren soll. Ein IoT Edge-Gerät kann ein Bereitstellungsmanifest herunterladen, wenn es zuerst eine Verbindung mit Ihrer IoT Central-Anwendung herstellt. In diesem Artikel wird beschrieben, wie Sie Bereitstellungsmanifeste in Ihrer IoT Central-Anwendung verwalten.

Weitere Informationen zu IoT Edge und IoT Central finden Sie unter Verbinden von Azure IoT Edge-Geräten mit einer Azure IoT Central-Anwendung.

Informationen zum Verwalten von Bereitstellungsmanifesten mithilfe der IoT Central REST-API finden Sie unter Verwendung der IoT Central REST-API zum Verwalten von Bereitstellungsmanifesten.

Verwalten von Bereitstellungsmanifesten

Auf der Seite "Edgemanifeste " können Sie die Bereitstellungsmanifeste in Ihrer Anwendung verwalten. Auf dieser Seite haben Sie folgende Möglichkeiten:

• Hochladen oder Erstellen von Bereitstellungsmanifesten
• Ändern vorhandener Bereitstellungsmanifeste
• Löschen von Bereitstellungsmanifesten

Hochladen und Erstellen von Bereitstellungsmanifesten

Wenn Sie ein neues Bereitstellungsmanifest erstellen, können Sie die JSON-Datei des Bereitstellungsmanifests hochladen oder mit einem vorhandenen Manifest beginnen:

1. Wählen Sie auf der Edge-Manifestseite+ Neu aus.

2. Geben Sie einen Namen für das Bereitstellungsmanifest ein.

3. Wenn Ihre Anwendung Organisationen verwendet, wählen Sie eine Organisation aus, der das Bereitstellungsmanifest zugeordnet werden soll.

4. Suchen Sie nach einer Bereitstellungsmanifestdatei, um ein vorhandenes Bereitstellungsmanifest hochzuladen oder als Ausgangspunkt für Ihr neues Manifest auszuwählen. IoT Central überprüft alle hochgeladenen Dateien.

   

5. Wählen Sie Weiteraus. Auf der Seite " Überprüfen und Fertig stellen " werden Informationen zum Bereitstellungsmanifest und zu den von ihr definierten Modulen angezeigt. Sie können auch den unformatierten JSON-Code anzeigen.

6. Wählen Sie "Erstellen" aus. Die Seite "Edge-Manifeste " enthält jetzt das neue Bereitstellungsmanifest.

JSON-Quelle eines Bereitstellungsmanifests bearbeiten

So ändern Sie ein Bereitstellungsmanifest, indem Sie den JSON-Code direkt bearbeiten:

1. Navigieren Sie zur Seite "Edge-Manifeste ".

2. Wählen Sie im Kontextmenü " JSON bearbeiten" für das Bereitstellungsmanifest aus, das Sie ändern möchten.

3. Verwenden Sie den JSON-Editor, um die erforderlichen Änderungen vorzunehmen. Klicken Sie dann auf Speichern.

Ersetzen Sie den Inhalt eines Bereitstellungsmanifests

So ersetzen Sie den Inhalt eines Bereitstellungsmanifests vollständig:

1. Navigieren Sie zur Seite "Edge-Manifeste ".

2. Wählen Sie das Bereitstellungsmanifest aus, das Sie ersetzen möchten.

3. Suchen Sie im Dialogfeld "Anpassen " nach einer neuen Bereitstellungsmanifestdatei, um ein vorhandenes Bereitstellungsmanifest als Ausgangspunkt hochzuladen oder auszuwählen. IoT Central überprüft alle hochgeladenen Dateien.

4. Wählen Sie Weiteraus. Auf der Seite " Überprüfen und Fertig stellen " werden Informationen zum neuen Bereitstellungsmanifest und den von ihr definierten Modulen angezeigt. Sie können auch den unformatierten JSON-Code anzeigen.

5. Wählen Sie Speichern aus. Die Edgemanifestseite enthält jetzt das aktualisierte Bereitstellungsmanifest.

Verwalten von IoT Edge-Geräten

Wenn Sie ein IoT Edge-Gerät auf der Geräteseite hinzufügen, können Sie ein Bereitstellungsmanifest für das Gerät auswählen. Im Dialogfeld " Neues Gerät erstellen" können Sie aus der Liste der zuvor hochgeladenen Gerätemanifeste auf der Edge-Manifestseite auswählen. Es ist auch möglich, ein Bereitstellungsmanifest direkt zu einem Gerät hinzuzufügen, nachdem Sie das Gerät erstellt haben.

Wenn Sie ein IoT Edge-Gerät hinzufügen, das keiner Gerätevorlage zugewiesen ist, sieht das Dialogfeld " Neues Gerät erstellen " wie der folgende Screenshot aus:

So wählen Sie das Bereitstellungsmanifest für das Gerät aus:

1. Schalten Sie das Azure IoT Edge-Gerät auf "Ja" um.

2. Wählen Sie das zu verwendende IoT Edge-Bereitstellungsmanifest aus. Sie können auch ein Bereitstellungsmanifest zuweisen, nachdem Sie das Gerät erstellt haben.

3. Wählen Sie "Erstellen" aus.

Wenn Sie ein IoT Edge-Gerät hinzufügen, das einer Gerätevorlage zugewiesen ist, sieht das Dialogfeld " Neues Gerät erstellen " wie der folgende Screenshot aus:

So wählen Sie das Bereitstellungsmanifest für das Gerät aus:

1. Der Umschalter Azure IoT Edge Device? ist bereits auf Ja festgelegt, da IoT Central erkennt, dass Sie eine Vorlage für IoT Edge-Geräte verwenden.

2. Wählen Sie das zu verwendende IoT Edge-Bereitstellungsmanifest aus. Sie können auch ein Bereitstellungsmanifest zuweisen, nachdem Sie das Gerät erstellt haben.

3. Wählen Sie "Erstellen" aus.

Wenn ein IoT Edge-Gerät zum ersten Mal eine Verbindung mit Ihrer Anwendung herstellt, lädt es das Bereitstellungsmanifest herunter, konfiguriert die im Bereitstellungsmanifest angegebenen Module und führt die Module aus.

Wenn Sie beim Erstellen eines IoT Edge-Geräts kein Bereitstellungsmanifest auswählen, können Sie ein Gerät später entweder einzeln oder mehreren Geräten mithilfe eines Auftrags zuweisen.

Aktualisieren des Bereitstellungsmanifests, das ein Gerät verwendet

Sie können das Bereitstellungsmanifest für ein vorhandenes Gerät verwalten:

Verwenden Sie Edge-Manifest zuweisen, um auf der Seite Edge-Manifeste ein zuvor hochgeladenes Bereitstellungsmanifest auszuwählen. Sie können diese Option auch verwenden, um ein Gerät manuell zu benachrichtigen, wenn Sie das Bereitstellungsmanifest auf der Edge-Manifestseite ändern.

Verwenden Sie das Bearbeitungsmanifest , um das Bereitstellungsmanifest für dieses Gerät zu ändern. Änderungen, die Sie hier vornehmen, wirken sich nicht auf das Bereitstellungs-Manifest auf der Edge-Manifeste-Seite, aus.

Jobs

Verwenden Sie einen Auftrag, um das Bereitstellungsmanifest für mehrere Geräte zuzuweisen oder zu aktualisieren. Verwenden Sie den Auftragstyp Edge-Bereitstellungsmanifests ändern:

Screenshot, der den Auftragstyp des Bereitstellungsmanifests zeigt.

Hinzufügen von Modulen und Eigenschaften zu Gerätevorlagen

Ein Bereitstellungsmanifest definiert die Module, die auf dem Gerät ausgeführt werden sollen, und optional schreibbare Eigenschaften , die Sie zum Konfigurieren von Modulen verwenden können.

Wenn Sie einem IoT Edge-Gerät eine Gerätevorlage zuweisen, sollten Sie die Module und beschreibbaren Eigenschaften in der Gerätevorlage definieren. So fügen Sie einer Gerätevorlage die Module und Eigenschaftendefinitionen hinzu:

1. Navigieren Sie zur Modulzusammenfassungsseite der IoT Edge-Gerätevorlage.
2. Wählen Sie "Module aus Manifest importieren" aus.
3. Wählen Sie das entsprechende Bereitstellungsmanifest aus der Liste aus.
4. Klicken Sie auf Importieren. IoT Central fügt der Gerätevorlage die benutzerdefinierten Module hinzu, die im Bereitstellungsmanifest definiert sind. Die Namen der Module in der Gerätevorlage entsprechen den Namen der benutzerdefinierten Module im Bereitstellungsmanifest. Die generierte Schnittstelle enthält Eigenschaftendefinitionen für die Eigenschaften, die für das benutzerdefinierte Modul im Bereitstellungsmanifest definiert sind: