Übung: Erstellen einer Azure IoT Central-Anwendung

  • 8 Minuten

Erstellen Sie eine Azure IoT Central-Anwendung für Ihre IoT Edge-Geräte, mit der die Verbindungsherstellung und Verwaltung durchgeführt werden kann.

Erinnern Sie sich, dass Sie die Bereitstellung eines IoT Edge-Geräts in jeder Filiale planen, mit dem die lokalen Sensoren verwaltet und die an Azure IoT Central gesendeten Daten gefiltert werden können.

Hier verwenden Sie die Azure-Befehlszeilenschnittstelle, um eine Azure IoT Central-Anwendung über die Vorlage Benutzerdefinierte Anwendung zu erstellen. Sie führen die CLI-Befehle in der Azure-Sandbox aus und gehen dann zur Webbenutzeroberfläche der Anwendung. Auf der Webbenutzeroberfläche schließen Sie das Setup ab, indem Sie eine Gerätevorlage für Ihr IoT Edge-Gerät hinzufügen.

Hinweis

Diese Übung ist optional. Wenn Sie die Schritte in dieser Übung ausführen möchten, müssen Sie zuvor ein Azure-Abonnement erstellen. Wenn Sie kein Azure-Konto besitzen oder gerade kein Konto erstellen möchten, können Sie die Anweisungen durchlesen und die dargelegten Informationen nachvollziehen.

Herunterladen des Bereitstellungsmanifests

Wenn Sie die Gerätevorlage für Ihr IoT Edge-Gerät erstellen, benötigen Sie auf Ihrem lokalen Computer das Bereitstellungsmanifest und eine Schnittstellendefinition. Um diese Dateien herunterzuladen, klicken Sie mit der rechten Maustaste auf diese Links, und wählen Sie Speichern unter aus:

Erinnern Sie, wo Sie diese Dateien speichern, denn sie benötigen Sie später.

Erstellen und Konfigurieren der Azure IoT Central-Anwendung

Die folgenden Schritte erstellen eine Azure IoT Central-Anwendung und generieren ein API-Token, das später in diesem Modul verwendet werden soll.

  1. Führen Sie die folgenden Befehle in Azure Cloud Shell aus, um einen eindeutigen Namen für Ihre Azure IoT Central-Anwendung zu generieren und in einer Umgebungsvariablen zu speichern, die Sie später verwenden können:

    APP_NAME="store-manager-$RANDOM"
echo "Your application name is: $APP_NAME"

    Notieren Sie sich den Anwendungsnamen, nur für den Fall, dass die Shell ausfällt und die Umgebungsvariable verloren geht.

  2. Um eine Azure IoT Central-Anwendung in der Sandbox zu erstellen, führen Sie den folgenden Befehl in Cloud Shell aus:

    az iot central app create \
--resource-group <rgn>[sandbox resource group name]</rgn> \
--name $APP_NAME --sku ST2 --location centralus \
--subdomain $APP_NAME --template iotc-pnp-preview \
--display-name 'Store Management'
echo "You can now navigate to: https://$APP_NAME.azureiotcentral.com/edge-manifests"

    Die Ausführung dieses Befehls kann ein bis zwei Minuten dauern.

  3. Gehen Sie in einem anderen Browsertab bzw. -fenster zu der URL, die in der Ausgabe des vorherigen Befehls enthalten ist. Auf dieser Web-UI-Seite laden Sie ein IoT Edge-Bereitstellungsmanifest hoch:

    Screenshot der Seite „Bereitstellungsmanifeste“, auf der Sie die IoT Edge-Bereitstellungsmanifesten in Ihrer Azure IoT Central-Anwendung verwalten.

  4. Wählen Sie Edgemanifest erstellen aus, geben Sie den Namen Environmental Sensor (Umgebungssensor) ein, wählen Sie Datei hochladen aus, und durchsuchen Sie dann die Dateien, um die Datei EnvironmentalSensorManifest-1-4.json auszuwählen, die Sie zuvor heruntergeladen haben.

  5. Wählen Sie Weiter und dann Erstellen aus, um das Manifest hochzuladen. Das Manifest konfiguriert drei IoT Edge-Module: edgeAgent, edgeHub und SimulatedTemperatureSensor.

  6. Wählen Sie nun Gerätevorlagen aus. Auf dieser Web-UI-Seite erstellen Sie eine Gerätevorlage:

    Screenshot der Seite „Gerätevorlagen“, auf der Sie die Vorlagen in Ihrer Azure IoT Central-Anwendung verwalten.

  7. Wählen Sie die Option Gerätevorlage erstellen, die Kachel Azure IoT Edge und dann Weiter: Anpassen aus.

  8. Geben Sie Environmental Sensor Edge Device (Umgebungssensor-Edgegerät) als Name für die Gerätevorlage ein. Wählen Sie anschließend Next: Review (Weiter: Überprüfen).

  9. Wählen Sie Erstellen aus, um die Gerätevorlage zu erstellen. Wählen Sie anschließend Benutzerdefiniertes Modell aus, um mit einem leeren Modell zu beginnen.

Das hochgeladene Bereitstellungsmanifest verfügt über ein Modul namens SimulatedTemperatureSensor mit einer Schnittstelle namens management. Die Schnittstelle management enthält die schreibbaren Eigenschaften SendData und SendInterval. Führen Sie die folgenden Schritte aus, um ihrer neuen Gerätevorlage diese Informationen hinzuzufügen:

  1. Wählen Sie auf der Seite „Gerätevorlage“ im Abschnitt Modell die Option Module aus.

  2. Wählen Sie Module aus Manifest importieren aus:

    Screenshot der Seite „Gerätevorlagen“, auf der Sie die Moduldefinitionen aus dem Bereitstellungsmanifest importieren.

  3. Wählen Sie das Bereitstellungsmanifest Environmental Sensor (Umgebungssensor) aus, um die Module zu importieren.

Ihre Gerätevorlage enthält jetzt das Modul SimulatedTemperatureSensor mit einer Schnittstelle management. Die Schnittstelle definiert die schreibbaren Eigenschaften SendData und SendInterval.

Das Bereitstellungsmanifest enthält keine Informationen zu den Telemetriedaten, die von den Gerätemodulen gesendet werden. Fügen Sie eine Schnittstelle mit den erforderlichen Definitionen hinzu, um für Azure IoT Central die Erstellung von Visualisierungen für die Telemetriedaten zu ermöglichen:

  1. Wählen Sie das Modul SimulatedTemperatureSensor und dann die Option + Add inherited interface (+ Geerbte Schnittstelle hinzufügen) aus. Möglicherweise müssen Sie die Auslassungspunkte (...) auswählen, um diese Option anzuzeigen.

  2. Wählen Sie die Kachel Importschnittstelle aus, und wählen Sie die zuvor heruntergeladene TelemetryInterface.json-Datei aus.

    Auf der Schnittstelle Telemetry werden die Telemetriedatentypen machine und ambient als Objekte definiert. Das Objekt „machine“ enthält Telemetriedaten zu Temperatur und Druck. Das Objekt „ambient“ enthält Telemetriedaten zu Temperatur und Luftfeuchtigkeit. Darüber hinaus enthält die Schnittstelle auch timeCreated als DateTime-Telemetriedatentyp.

    Screenshot: Schnittstelle „Telemetry“ in der Gerätevorlage

Fügen Sie dem Modell Environmental Sensor Edge Device die folgenden Cloudeigenschaften hinzu, damit ein Operator Informationen zu jedem IoT Edge-Gerät aufzeichnen kann:

Anzeigename Name Funktionstyp Schema
Store Name StoreName Eigenschaft String
Dienstdatum ServiceDate Eigenschaft Datum

Screenshot: Cloudeigenschaften in der Gerätevorlage

Tipp

Sie müssen die Cloudeigenschaft erweitern, um die Schemaeinstellung anzuzeigen.

Klicken Sie zum Speichern der Änderungen auf Speichern.

Fügen Sie der Gerätevorlage die folgende Sicht hinzu, damit ein Operator die Umgebungsdaten aus Ihren Filialen anzeigen kann:

  1. Wählen Sie in der Gerätevorlage die Option Sichten aus, um eine neue Sicht hinzuzufügen. Wählen Sie anschließend die Kachel Gerät visualisieren aus.

    Screenshot der Visualisierung der Gerätekachel in der Gerätevorlage.

  2. Ändern Sie den Namen der Sicht in View IoT Edge device telemetry (IoT Edge-Gerätetelemetrie anzeigen).

  3. Wählen Sie Start with devices (Mit Geräten starten) aus.

  4. Fügen Sie die Telemetrietypen ambient/temperature, humidity, machine/temperature und pressure hinzu, und wählen Sie dann Kachel hinzufügen aus.

  5. Wählen Sie Speichern aus.

    Screenshot: Telemetriedaten-Sichtdefinition

Fügen Sie der Gerätevorlage die folgende Sicht hinzu, damit der Bediener Informationen zu jeder Filiale aufzeichnen und das Gerät verwalten kann:

  1. Wählen Sie in der Gerätevorlage die Option Sichten aus, um eine neue Sicht hinzuzufügen. Wählen Sie anschließend die Kachel Geräte- und Clouddaten werden bearbeitet aus.

  2. Ändern Sie den Namen des Formulars in Store information (Informationen zur Filiale).

  3. Wählen Sie die Cloudeigenschaften Store Name (Name der Filiale) und Service Date (Dienstdatum) aus. Wählen Sie anschließend Abschnitt hinzufügen aus.

  4. Wählen Sie Speichern aus.

    Screenshot: Formulardefinition für Cloudeigenschaften

Nun können Sie die Vorlage veröffentlichen und ein Gerät hinzufügen:

  1. Wählen Sie oben auf der Seite Veröffentlichen und dann im Dialogfeld Diese Gerätevorlage für die Anwendung veröffentlichen die Option Veröffentlichen aus.

  2. Gehen Sie in Ihrer Azure IoT Central-Anwendung zur Seite Geräte.

  3. Wählen Sie die Gerätevorlage Environmental Sensor Edge (Umgebungssensor-Edgegerät) und dann + Neu aus.

  4. Geben Sie im Dialogfeld Neues Gerät erstellen die Geräte-ID store-001 ein. Stellen Sie sicher, dass die Gerätevorlage Umgebungssensor-Edgegerät ist und dass Azure IoT Edge-Gerät? schon auf Ja festgelegt ist. Wählen Sie dann Umgebungssensor als Edgemanifest aus. Klicken Sie auf Erstellen.

Das Gerät store-001 wird in der Liste mit den Geräten mit dem Status Registriert angezeigt.

Screenshot: Registriertes Gerät in der Geräteliste

Arbeit überprüfen

  1. Wählen Sie in der Liste mit den Geräten auf den Gerätenamen Umgebungssensor-Edgegerät – store-001 aus. Die verfügbaren Sichten für das Gerät werden angezeigt, z. B. Store information (Informationen zur Filiale) und View IoT Edge device telemetry (IoT Edge-Gerätetelemetrie anzeigen).

  2. Wählen Sie oben auf der Seite Verbinden aus. Notieren Sie sich den ID-Bereich und den Primärschlüssel. Sie verwenden diese Werte später beim Konfigurieren Ihres IoT Edge-Geräts für die Verbindungsherstellung mit Ihrer Anwendung.

    Lassen Sie diese Seite in Ihrem Webbrowser geöffnet. Sie kehren später zu dieser Azure IoT Central-Anwendung zurück.

Sie haben eine Anwendung zum Verwalten Ihrer Stores erstellt. Sie haben eine Gerätevorlage erstellt, die ein IoT Edge-Bereitstellungsmanifest für die Geräte enthält, die Sie in Ihren Stores installieren möchten. Die Vorlage enthält Sichten, mit denen ein Operator die Umgebungsbedingungen in der Filiale überwachen und die Geräte per Remotezugriff verwalten kann.