Bereitstellen von Azure IoT Einsatz in einem Testcluster

Erfahren Sie, wie Sie Azure IoT Einsatz in einem Testcluster bereitstellen, bei dem es sich um einen Arc-fähigen Kubernetes-Cluster handelt, den Sie für Test- und Auswertungsszenarien verwenden können.

Wenn Sie Azure IoT Einsatz in einem Produktionscluster bereitstellen möchten, lesen Sie die Informationen unter Bereitstellen von Azure IoT Einsatz in einem Produktionscluster.

Bevor Sie anfangen

In diesem Artikel werden Azure IoT Einsatz--Bereitstellungen und -Instanzen erläutert, bei denen es sich um zwei verschiedene Konzepte handelt:

• Eine Azure IoT Einsatz-Bereitstellung beschreibt alle Komponenten und Ressourcen, die das Azure IoT Einsatz-Szenario ermöglichen. Zu diesen Komponenten und Ressourcen gehören:

  • Eine Azure IoT Einsatz-Instanz
  • Arc-Erweiterungen
  • Benutzerdefinierte Standorte
  • Ressourcen, die Sie in Ihrer Azure IoT Operations-Lösung konfigurieren können, z. B. Ressourcen und Geräte.

• Eine Azure IoT Einsatz-Instanz ist die übergeordnete Ressource, die die Suite von Diensten bündelt, die in Was ist Azure IoT Einsatz? definiert werden, wie MQTT-Broker, Datenflüsse und Connector für OPC UA.

Wenn von der Bereitstellung von Azure IoT Einsatz die Rede ist, sind alle Komponenten gemeint, die eine Bereitstellung ausmachen. Sobald die Bereitstellung vorhanden ist, können Sie die Instanz anzeigen, verwalten und aktualisieren.

Voraussetzungen

Cloudressourcen:

• Ein Azure-Abonnement.

• Zugriffsberechtigungen in Azure. Weitere Informationen finden Sie unter Bereitstellungsdetails > Erforderliche Berechtigungen.

Entwicklungsressourcen:

• Installation der Azure CLI auf Ihrem Entwicklungscomputer. Für diesen Fall ist mindestens die Version 2.53.0 der Azure CLI erforderlich. Verwenden Sie az --version, um Ihre Version zu überprüfen. Bei Bedarf können Sie sie mithilfe von az upgrade aktualisieren. Weitere Informationen finden Sie unter Installieren der Azure CLI.

Ein Clusterhost:

• Ein Azure Arc-fähiger Kubernetes-Cluster mit aktivierten benutzerdefinierten Standort- und Workloadidentitätsfeatures. Wenn Sie noch nicht über einen verfügen, führen Sie die Schritte in Vorbereiten Ihres Azure Arc-fähigen Kubernetes-Clusters aus.

  Wenn Sie Azure IoT Einsatz bereits in Ihrem Cluster bereitgestellt haben, deinstallieren Sie diese Ressourcen, bevor Sie fortfahren. Weitere Informationen finden Sie unter Aktualisieren von Azure IoT Einsatz.

Bereitstellen im Azure-Portal

Die Bereitstellungsoberfläche des Azure-Portals ist ein Hilfstool, das einen Bereitstellungsbefehl basierend auf Ihren Ressourcen und der Konfiguration generiert. Der letzte Schritt besteht darin, einen Azure CLI-Befehl auszuführen, daher benötigen Sie weiterhin die im vorherigen Abschnitt beschriebenen Azure CLI-Voraussetzungen.

1. Melden Sie sich beim Azure-Portal an.

2. Suchen Sie im Azure-Portal nach Azure IoT Einsatz, und wählen Sie diese Option aus.

3. Wählen Sie "Erstellen" aus.

4. Geben Sie auf der Registerkarte Grundeinstellungen die folgenden Informationen an:

   Parameter	Wert
   Abonnement	Wählen Sie das Abonnement aus, das Ihren Arc-fähigen Cluster enthält.
   Ressourcengruppe	Wählen Sie die Ressourcengruppe aus, die Ihren Arc-fähigen Cluster enthält.
   Clustername	Wählen Sie den Cluster aus, in dem Azure IoT Einsatz bereitgestellt werden soll.
   Name des benutzerdefinierten Standorts	Optional: Ersetzen Sie den Standardnamen für den benutzerdefinierten Speicherort.
   Bereitstellungsversion	Wählen Sie 1.2 (neueste) Version aus. Weitere Informationen finden Sie unter IoT Einsatz-Versionen.

5. Wählen Sie "Weiter" aus: Konfiguration.

6. Geben Sie auf der Registerkarte Konfiguration die folgenden Informationen an:

   Parameter	Wert
   Azure IoT Einsatz-Name	Optional: Ersetzen Sie den Standardnamen für die Azure IoT Einsatz-Instanz.
   MQTT-Brokerkonfiguration	Optional: Bearbeiten Sie die Standardeinstellungen für den MQTT-Broker. Im Azure-Portal ist es möglich, Kardinalitäts- und Speicherprofileinstellungen zu konfigurieren. Informationen zum Konfigurieren anderer Einstellungen, einschließlich datenträgergestützter Nachrichtenpuffer und erweiterter MQTT-Clientoptionen, finden Sie unter Azure CLI-Unterstützung für die erweiterte MQTT-Brokerkonfiguration.
   Konfiguration des Datenflussprofils	Optional: Bearbeiten Sie die Standardeinstellungen für Datenflüsse. Weitere Informationen finden Sie unter Konfigurieren des Datenflussprofils.

   

7. Wählen Sie Weiter: Abhängigkeitsverwaltung aus.

8. Wählen Sie auf der Registerkarte Abhängigkeitsverwaltung eine vorhandene Schemaregistrierung aus, oder führen Sie die folgenden Schritte aus, um eine zu erstellen:

   1. Wählen Sie "Neu erstellen" aus.

   2. Geben Sie einen Schemaregistrierungsnamen und einen Schemaregistrierungs-Namespace an.

   3. Wählen Sie Azure-Speichercontainer auswählen aus.

   4. Wählen Sie ein Speicherkonto aus der Liste der hierarchischen namespacefähigen Konten aus, oder wählen Sie Erstellen aus, um ein Konto zu erstellen.

      Für die Schemaregistrierung ist ein Azure Storage-Konto mit hierarchischem Namespace und aktiviertem Zugriff auf öffentliche Netzwerke erforderlich. Wählen Sie beim Erstellen eines neuen Speicherkontos den Speicherkontotyp Allgemeines Speicherkontos v2 aus, und legen Sie Hierarchischer Namespace auf Aktiviert fest.

      Weitere Informationen zum Konfigurieren Ihres Speicherkontos finden Sie in den Richtlinien zur Produktionsbereitstellung.

   5. Wählen Sie einen Container in Ihrem Speicherkonto aus, oder wählen Sie Container aus, um einen zu erstellen.

   6. Wählen Sie Übernehmen aus, um die Schemaregistrierungskonfigurationen zu bestätigen.

9. Azure IoT Einsatz verwendet Namespaces zum Organisieren von Ressourcen und Geräten. Jede Azure IoT Einsatz-Instanz verwendet einen einzelnen Namespace für ihre Ressourcen und Geräte. Wählen Sie auf der Registerkarte " Abhängigkeitsverwaltung " einen vorhandenen Azure Device Registry-Namespace aus, oder führen Sie die folgenden Schritte aus, um einen zu erstellen:

   1. Wählen Sie "Neu erstellen" aus.

   2. Geben Sie auf der Registerkarte Grundeinstellungen die folgenden Informationen an:

      Parameter	Wert
      Abonnement	Wählen Sie Ihr Abonnement aus.
      Ressourcengruppe	Wählen Sie die Ressourcengruppe aus, die Ihre Azure IoT Operations-Instanz enthält.
      Name	Geben Sie einen eindeutigen Namen für Ihren Namespace an.
      Region	Wählen Sie die Azure-Region aus, um Ihren Namespace zu speichern.

      Klicken Sie auf Weiter, um fortzufahren.

   3. Auf der Registerkarte "Kategorien " können Sie Ihrem Namespace optional Tags hinzufügen. Klicken Sie auf Weiter, um fortzufahren.

   4. Überprüfen Sie auf der Registerkarte " Überprüfen + Erstellen " Ihre Konfigurationen, und wählen Sie "Erstellen" aus, um den Namespace zu erstellen.

   5. Wählen Sie wieder auf der Registerkarte " Abhängigkeitsverwaltung " den neu erstellten Namespace aus der Liste aus.

10. Wählen Sie auf der Registerkarte Abhängigkeitsverwaltung die Bereitstellungsoption Testeinstellungen aus. Diese Option verwendet Standardeinstellungen, die zu Testzwecken empfohlen werden.

    

11. Wählen Sie Weiter: Automatisierung aus.

Ausführen von Azure-CLI-Befehlen

Der letzte Schritt bei der Azure-Portalbereitstellung besteht darin, eine Reihe von Azure CLI-Befehlen auszuführen, um Azure IoT Einsatz in Ihrem Cluster bereitzustellen. Die Befehle werden basierend auf den Informationen generiert, die Sie in den vorherigen Schritten angegeben haben.

Führen Sie die einzelnen Azure CLI-Befehle auf der Registerkarte Automatisierung in einem Terminal aus:

1. Melden Sie sich interaktiv mit einem Browser bei der Azure CLI an, auch wenn Sie sich bereits zuvor angemeldet haben. Wenn Sie sich nicht interaktiv anmelden, wird möglicherweise eine Fehlermeldung angezeigt, die besagt: Ihr Gerät muss für den Zugriff auf Ihre Ressource verwaltet werden.

   az login
   

2. Installieren Sie die neueste Azure IoT Operations CLI-Erweiterung, sofern noch nicht geschehen.

   az extension add --upgrade --name azure-iot-ops
   

3. Kopieren Sie den angegebenen Befehl az iot ops schema registry create, und führen Sie ihn aus, um eine Schemaregistrierung zu erstellen, die von Azure IoT Einsatz-Komponenten verwendet werden. Wenn Sie sich für die Verwendung einer vorhandenen Schemaregistrierung entschieden haben, wird dieser Befehl auf der Registerkarte Automatisierung nicht angezeigt.

4. Bereiten Sie den Cluster für die Bereitstellung von Azure IoT Einsatz vor. Kopieren Sie den bereitgestellten Befehl az iot ops init, und führen Sie ihn aus.

   Tipp

   Der Befehl init muss nur einmal pro Cluster ausgeführt werden. Wenn Sie die optionale Voraussetzung zum Einrichten Ihres eigenen Zertifizierungsstelle-Ausstellers befolgt haben, führen Sie die Schritte unter Bring your own issuer aus.

   Die Ausführung dieses Befehls kann mehrere Minuten dauern. Sie können den Fortschritt in der Bereitstellungsstatusanzeige im Terminal überwachen.

5. Um Azure IoT Einsatz bereitzustellen, kopieren Sie den angegebenen Befehl az iot ops create, und führen Sie ihn aus. Die Ausführung dieses Befehls kann mehrere Minuten dauern. Sie können den Fortschritt in der Bereitstellungsstatusanzeige im Terminal überwachen.

6. Sobald alle Azure CLI-Befehle erfolgreich abgeschlossen wurden, können Sie den Assistenten zum Installieren von Azure IoT Einsatz schließen.

Sobald der Befehl create erfolgreich abgeschlossen wird, verfügen Sie über eine funktionierende Azure IoT Einsatz-Instanz, die auf Ihrem Cluster ausgeführt wird. An diesem Punkt ist Ihre Instanz für die meisten Test- und Auswertungsszenarien konfiguriert.

Überprüfen der Bereitstellung

Führen Sie nach Abschluss der Bereitstellung az iot ops check aus, um die Bereitstellung des IoT Einsatz-Diensts hinsichtlich Integrität, Konfiguration und Nutzbarkeit zu bewerten. Der check Befehl kann Ihnen helfen, Probleme in Ihrer Bereitstellung und Konfiguration zu finden.

az iot ops check

Der Befehl check zeigt eine Warnung zu fehlenden Datenflüssen an. Diese ist normal und erwartbar, bis Sie einen Datenfluss erstellen. Weitere Informationen finden Sie unter Verarbeiten und Weiterleiten von Daten mit Datenflüssen.

Sie können die Konfigurationen von Themenzuordnungen, QoS und Nachrichtenrouten überprüfen, indem Sie im Befehl --detail-level 2 den Parameter check für eine ausführliche Ansicht hinzufügen.

Sie können alle Versionen der CLI-Erweiterung für Azure IoT Einsatz anzeigen, die verfügbar sind, indem Sie den folgenden Befehl ausführen:

az iot ops get-versions

Nächste Schritte

Die bereitgestellte Azure IoT Einsatz-Instanz ist für Testszenarien konfiguriert. Wenn Sie die sichere Einstellung aktivieren und die Instanz für Produktionsszenarien vorbereiten möchten, führen Sie die Schritte unter Aktivieren sicherer Einstellungen in einer vorhandenen Azure IoT Einsatz-Instanz aus.