Bedarfsgerechtes Bereitstellen von IoT Edge-Modulen mithilfe des Azure-Portals

Gilt für: IoT Edge 1.5

Wichtig

IoT Edge 1.5 LTS ist das unterstützte Release. IoT Edge 1.4 LTS wurde am 12. November 2024 eingestellt. Wenn Sie ein früheres Release verwenden, finden Sie weitere Informationen unter Aktualisieren von IoT Edge.

Erstellen Sie eine automatische IoT Edge-Bereitstellung im Azure-Portal zum gleichzeitigen Verwalten laufender Bereitstellungen vieler Geräte. Automatische Bereitstellungen für IoT Edge sind Teil des Features Geräteverwaltung von IoT Hub. Bereitstellungen sind dynamische Prozesse, mit denen Sie mehrere Module auf mehreren Geräten bereitstellen, Status und Integrität der Module nachverfolgen und bei Bedarf Änderungen vornehmen können.

Weitere Informationen finden Sie unter Grundlegendes zu automatischen IoT Edge-Bereitstellungen für einzelne Geräte oder nach Bedarf.

Identifizieren von Geräten mithilfe von Tags

Bevor Sie eine Bereitstellung erstellen können, müssen Sie angeben können, welche Geräte Sie ansprechen möchten. Azure IoT Edge erkennt Geräte anhand von Tags im Gerätezwilling. Jedes Gerät kann mehrere Tags aufweisen, die Sie auf eine für Ihre Lösung sinnvolle Weise definieren können.

Wenn Sie z.B. einen Campus von intelligenten Gebäuden verwalten, könnten Sie einem Gerät Standort, Raumtyp und Umgebungstags hinzufügen:

"tags":{
  "location":{
    "building": "20",
    "floor": "2"
  },
  "roomtype": "conference",
  "environment": "prod"
}

Weitere Informationen zu Gerätezwillingen und Tags finden Sie unter Verstehen und Verwenden von Gerätezwillingen in IoT Hub.

Erstellen einer Bereitstellung

IoT Edge bietet zwei verschiedene Arten von automatischen Bereitstellungen, die Sie zum Anpassen Ihres Szenarios verwenden können. Sie können eine Standardbereitstellung erstellen, die diese Systemlaufzeitmodule und alle anderen Module und Routen umfasst. Jedes Gerät kann nur eine Bereitstellung anwenden. Oder Sie können eine mehrstufige Bereitstellung erstellen, die nur benutzerdefinierte Module und Routen (und nicht die Systemlaufzeit) enthält. Viele mehrstufige Bereitstellungen können auf einem Gerät – basierend auf einer Standardbereitstellung – kombiniert werden. Weitere Informationen dazu, wie die beiden Typen automatischer Bereitstellungen zusammenarbeiten, finden Sie unter Grundlegendes zu automatischen IoT Edge-Bereitstellungen für einzelne Geräte oder nach Bedarf.

Die Schritte zum Erstellen einer Bereitstellung und einer mehrstufigen Bereitstellung sind ähnlich. In den folgenden Schritten wird auf eventuelle Unterschiede hingewiesen.

1. Navigieren Sie im Azure-Portal zu Ihrem IoT Hub.
2. Wählen Sie im Menü "Ressource" im linken Bereich unter "Geräteverwaltung" die Option "Konfigurationen + Bereitstellungen" aus.
3. Wählen Sie auf der Befehlsleiste Hinzufügen>Bereitstellung oder Mehrschichtbereitstellung aus.

Zum Erstellen einer Bereitstellung müssen fünf Schritte ausgeführt werden. Diese werden in den folgenden Abschnitten exemplarisch beschrieben.

Hinweis

Die Schritte in diesem Artikel entsprechen der aktuellen Schemaversion des IoT Edge-Agents und -Hubs.

Wenn Sie auf einem Gerät mit Version 1.0.9 oder früher bereitstellen, bearbeiten Sie die Laufzeiteinstellungen im Schritt Module des Assistenten, um die Schemaversion 1.0 zu verwenden.

Schritt 1: Name und Bezeichnung

1. Geben Sie Ihrer Bereitstellung einen eindeutigen Namen, der bis zu 128 Kleinbuchstaben umfasst. Verwenden Sie dabei weder Leerzeichen noch die folgenden ungültigen Zeichen: & ^ [ ] { } \ | " < > /.
2. Sie können Bezeichnungen als Schlüssel-Wert-Paare hinzufügen, um Ihre Bereitstellungen im Blick zu behalten. Beispiel: HostPlatform und Linux oder Version und 3.0.1.
3. Wählen Sie Weiter: Module aus, um mit Schritt 2 fortzufahren.

Schritt 2: Module

Sie können einer Bereitstellung bis zu 50 Module hinzufügen. Wenn Sie eine Bereitstellung ohne Module erstellen, werden alle aktuellen Module von den Zielgeräten entfernt.

In Bereitstellungen können Sie die Einstellungen für die IoT Edge-Agent- und IoT Edge-Hub-Module verwalten. Wählen Sie Laufzeiteinstellungen aus, um die beiden Laufzeitmodule zu konfigurieren. Bei einer geschichteten Bereitstellung sind die Laufzeitmodule nicht enthalten und können daher nicht konfiguriert werden.

So fügen Sie benutzerdefinierten Code als Modul oder aber ein Azure-Dienstmodul manuell hinzu:

1. Geben Sie im Abschnitt "Anmeldeinformationen der Containerregistrierung " der Seite die Anmeldeinformationen für den Zugriff auf alle privaten Containerregistrierungen an, die Ihre Modulimages enthalten.

2. Wählen Sie im Abschnitt IoT Edge-Module der Seite die Option Hinzufügen aus.

3. Wählen Sie einen der Modultypen aus dem Dropdownmenü aus:

   • IoT Edge-Modul – Geben Sie den Modulnamen und den URI des Containerimages an. Beispielsweise lautet der Image-URI für das Beispielmodul „SimulatedTemperatureSensor“ mcr.microsoft.com/azureiotedge-simulated-temperature-sensor:1.5. Eine Liste der Microsoft IoT Edge-Modulimages finden Sie in der Microsoft-Artefaktregistrierung.
   • Azure Stream Analytics-Modul – Module, die aus einer Azure Stream Analytics-Workload generiert wurden.

4. Wiederholen Sie bei Bedarf die Schritte 2 und 3, um Ihrer Bereitstellung weitere Module hinzuzufügen.

Nachdem Sie ein Modul zu einer Bereitstellung hinzugefügt haben, können Sie dessen Namen zum Öffnen der Seite IoT Edge-Modul aktualisieren auswählen. Auf dieser Seite können Sie die Moduleinstellungen und Umgebungsvariablen bearbeiten und Optionen, Startreihenfolgen und einen Modulzwilling erstellen. Wenn Sie ein Modul aus dem Marketplace hinzugefügt haben, enthält es möglicherweise bereits einige dieser Parameter. Weitere Informationen zu den verfügbaren Moduleinstellungen finden Sie unter Bereitstellen von Modulen und Einrichten von Routen in IoT Edge.

Wenn Sie eine mehrschichtige Bereitstellung erstellen, konfigurieren Sie möglicherweise ein Modul, das in anderen Bereitstellungen für dieselben Geräte vorhanden ist. Möchten Sie den Modulzwilling aktualisieren, ohne dadurch andere Versionen zu überschreiben, öffnen Sie die Registerkarte Einstellungen für Modulzwilling. Erstellen Sie eine neue Eigenschaft für Modulzwilling mit einem eindeutigen Namen für einen Unterabschnitt innerhalb der gewünschten Eigenschaften des Modulzwillings, beispielsweise properties.desired.settings. Wenn Sie Eigenschaften nur im Feld properties.desired definieren, werden dadurch die gewünschten Eigenschaften für das Modul überschrieben, das in beliebigen Bereitstellungen mit niedrigerer Priorität definiert wurde.

Weitere Informationen zur Konfiguration von Modulzwillingen in mehrstufigen Bereitstellungen finden Sie unter Mehrstufige Bereitstellung.

Nachdem Sie alle Module für eine Bereitstellung konfiguriert haben, wählen Sie Weiter: Routen aus, um mit Schritt 3 fortzufahren.

Schritt 3: Routen

Auf der Registerkarte "Routen " definieren Sie, wie Nachrichten zwischen Modulen und dem IoT-Hub übergeben werden. Nachrichten werden mit Name-Wert-Paaren erstellt.

Eine Route mit dem Namen route und dem Wert FROM /messages/* INTO $upstream würde alle von Modulen ausgegebenen Nachrichten übernehmen und an Ihren IoT-Hub senden.

Die Parameter Priority und Time to live sind optionale Parameter, die Sie in eine Routendefinition einschließen können. Mit dem Parameter „Priority“ können Sie auswählen, für welche Routen die Nachrichten zuerst bzw. zuletzt verarbeitet werden sollen. Die Priorität wird durch das Festlegen einer Zahl zwischen 0 und 9 festgelegt, wobei 0 für die höchste Priorität steht. Mit dem Parameter „Time to live“ können Sie deklarieren, wie lange Nachrichten in dieser Route aufbewahrt werden sollen, bis sie entweder verarbeitet oder aus der Warteschlange entfernt werden.

Weitere Informationen zum Erstellen von Routen finden Sie unter Deklarieren von Routen.

Wählen Sie Weiter: Zielgeräte aus.

Schritt 4: Festlegen von Zielgeräten

Verwenden Sie die tags Eigenschaft von Ihren Geräten, um auf die spezifischen Geräte zu abzielen, die diese Bereitstellung erhalten sollen.

Da mehrere Bereitstellungen dasselbe Gerät als Ziel verwenden können, sollten Sie für jede Bereitstellung eine Priorität festlegen. Wenn irgendwann ein Konflikt auftritt, „gewinnt“ die Bereitstellung mit der höchsten Priorität (höhere Werte deuten auf eine höhere Priorität hin). Haben zwei Bereitstellungen dieselbe Priorität, dann wird jeweils diejenige verwendet, die später erstellt wurde.

Wenn mehrere Bereitstellungen auf dasselbe Gerät abzielen, wird nur die Bereitstellung mit der höheren Priorität angewendet. Wenn mehrere ebenenbasierte Bereitstellungen auf dasselbe Gerät abzielen, werden sie alle angewendet. Werden aber irgendwelche Eigenschaften dupliziert, z. B. zwei Routen mit demselben Namen, überschreibt die Eigenschaft aus der mehrstufigen Bereitstellung mit der höheren Priorität die restlichen Eigenschaften.

Eine mehrstufige Bereitstellung für ein Gerät muss eine höhere Priorität als die Basisbereitstellung haben, damit sie angewendet wird.

1. Geben Sie eine positive ganze Zahl als Priorität für die Bereitstellung ein.
2. Geben Sie eine Zielbedingung ein, um festzulegen, auf welche Geräte diese Bereitstellung angewendet werden soll. Die Bedingung basiert auf den Gerätezwillingstags oder auf den gemeldeten Gerätezwillingseigenschaften und muss dem Ausdrucksformat entsprechen. Zum Beispiel: tags.environment='test' oder properties.reported.devicemodel='4000x'.

Wählen Sie Weiter: Metriken aus.

Schritt 5: Metriken

Metriken stellen eine Zusammenfassung der verschiedenen Zustände bereit, die ein Gerät aufgrund der Anwendung von Konfigurationsinhalten zurückmelden kann.

1. Geben Sie unter Metrikname einen Namen ein.

2. Geben Sie eine Abfrage unter Metrikkriterien ein. Diese Abfrage basiert auf gemeldeten Eigenschaften eines IoT Edge-Hub-Modulzwillings. Die Metrik stellt die Anzahl der von der Abfrage zurückgegebenen Zeilen dar.

   Zum Beispiel:

   SELECT deviceId FROM devices
     WHERE properties.reported.lastDesiredStatus.code = 200
   

Wählen Sie "Weiter" aus: Überprüfen + Erstellen , um zum letzten Schritt zu wechseln.

Schritt 6: Überprüfen und Erstellen

Überprüfen Sie Ihre Bereitstellungsinformationen, und klicken Sie dann auf Erstellen.

Informationen zum Überwachen der Bereitstellung finden Sie unter Überwachen von IoT Edge-Bereitstellungen.

Hinweis

Wenn eine neue IoT Edge-Bereitstellung erstellt wird, kann es manchmal bis zu 5 Minuten dauern, bis der IoT-Hub die neue Konfiguration verarbeitet und die neuen gewünschten Eigenschaften an die Zielgeräte verteilt.

Ändern einer Bereitstellung

Wenn Sie Änderungen an einer Bereitstellung vornehmen, werden diese sofort auf alle Zielgeräte repliziert. Sie können die folgenden Einstellungen und Features für eine vorhandene Bereitstellung ändern:

• Zielbedingungen
• Benutzerdefinierte Metriken
• Beschriftungen
• Stichwörter
• Gewünschte Eigenschaften

Ändern von Zielbedingungen, benutzerdefinierten Metriken und Bezeichnungen

1. Wählen Sie in Ihrem IoT-Hub konfigurationen + Bereitstellungen unter **Geräteverwaltung ** im Ressourcenmenü aus.

2. Wählen Sie die Bereitstellung aus, die Sie konfigurieren möchten.

3. Wählen Sie die Registerkarte Zielgeräte aus. Ändern Sie die Zielbedingung, um die gewünschten Geräte anzuvisieren. Sie können auch die Priorität einstellen.

   Wenn Sie die Zielbedingung ändern, erfolgen die nachfolgend aufgeführten Anpassungen:

   • Wenn ein Gerät die alte Zielbedingung nicht erfüllt, wohl aber die neue, und diese Bereitstellung die höchste Priorität für das Gerät hat, wird diese Bereitstellung auf das Gerät angewendet.
   • Wenn ein Gerät, auf dem diese Bereitstellung gegenwärtig ausgeführt wird, die Zielbedingung nicht mehr erfüllt, wird diese Bereitstellung deinstalliert, und die Bereitstellung mit der nächsthöheren Priorität wird angewendet.
   • Wenn ein Gerät, auf dem diese Bereitstellung gegenwärtig ausgeführt wird, diese Zielbedingung wie auch die Zielbedingungen aller anderen Bereitstellungen nicht erfüllt, erfolgt keine Änderung auf dem Gerät. Das Gerät führt die aktuellen Module im aktuellen Zustand weiter aus, wird aber nicht mehr als Teil dieser Bereitstellung verwaltet. Sobald es die Zielbedingung einer anderen Bereitstellung erfüllt, wird diese Bereitstellung deinstalliert, und die neue Bereitstellung wird angewendet.

4. Wählen Sie die Registerkarte "Metriken " aus, und fügen Sie benutzerdefinierte Metriken hinzu, oder ändern Sie sie mithilfe der Beispielsyntax als Leitfaden. Wählen Sie Speichern.

   

5. Wählen Sie die Registerkarte Bezeichnungen aus, nehmen Sie die gewünschten Änderungen vor, und wählen Sie dann Speichern aus.

Löschen einer Bereitstellung

Wenn Sie eine Bereitstellung löschen, übernehmen alle bereitgestellten Geräte ihre nächste Bereitstellung mit der höchsten Priorität. Wenn Ihre Geräte die Zielbedingung einer anderen Bereitstellung nicht erfüllen, werden die Module nicht entfernt, wenn die Bereitstellung gelöscht wird.

1. Melden Sie sich beim Azure-Portal an, und navigieren Sie zu Ihrem IoT Hub.
2. Wählen Sie im Menü "Ressource" unter "Geräteverwaltung" die Option "Konfigurationen + Bereitstellungen" aus.
3. Wählen Sie die zu löschende Bereitstellung durch Aktivieren des zugehörigen Kontrollkästchens aus.
4. Wählen Sie "Löschen " in der Befehlsleiste aus.
5. Eine Meldung informiert Sie darüber, dass diese Aktion diese Bereitstellung löschen wird und der vorherige Status auf allen Geräten wiederhergestellt wird. Es wird eine Bereitstellung mit einer niedrigeren Priorität angewendet. Wenn keine andere Zielbereitstellung für das Gerät vorhanden ist, werden keine Module entfernt. Wenn Sie alle Module vom Gerät entfernen möchten, erstellen Sie eine Bereitstellung ohne Module, und stellen Sie sie auf den gleichen Geräten bereit. Klicken Sie auf Yes (Ja), um den Vorgang fortzusetzen.

Nächste Schritte

Weitere Informationen zum Bereitstellen von Modulen auf IoT Edge-Geräten finden Sie unter Verstehen automatischer IoT Edge-Bereitstellungen für einzelne Geräte oder im großen Maßstab.