Bereitstellung von Azure IoT Operationen auf 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 Deploy Azure IoT Einsatz in einem Produktionscluster.

Bevor Sie anfangen

In diesem Artikel werden Azure IoT Einsatz deployments und instances erläutert, die zwei verschiedene Konzepte sind:

• Eine Azure IoT Einsatz deployment beschreibt alle Komponenten und Ressourcen, die das Azure IoT Einsatz Szenario aktivieren. Zu diesen Komponenten und Ressourcen gehören:

  • Eine Azure IoT Einsatz Instanz
  • Arc-Erweiterungen
  • Benutzerdefinierte Standorte
  • Ressourcen, die Sie in Ihrer Azure IoT Einsatz 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 sind, wie MQTT-Broker, Datenflüsse und Konnektor für OPC UA.

Wenn wir über die Bereitstellung von Azure IoT Einsatz sprechen, meinen wir den vollständigen Satz von Komponenten, die eine Deployment bilden. Sobald die Bereitstellung vorhanden ist, können Sie die Instanz anzeigen, verwalten und aktualisieren.

Voraussetzungen

Cloudressourcen:

• Ein Azure-Abonnement. Wenn Sie kein Azure-Abonnement besitzen, können Sie ein kostenloses Konto erstellen, bevor Sie beginnen.

• Azure Zugriffsberechtigungen. Weitere Informationen finden Sie unter Bereitstellungsübersicht > Erforderliche Berechtigungen.

Entwicklungsressourcen:

• Die auf dem Entwicklungscomputer installierte Azure CLI. Überprüfen Sie die verfügbaren Azure CLI-Erweiterungen für die minimal erforderliche Version, um die azure-iot-ops-Erweiterung zu verwenden. 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 Install the Azure CLI.

• Die Azure IoT Einsatz Erweiterung für die Azure CLI. Verwenden Sie den folgenden Befehl, um die Erweiterung hinzuzufügen oder auf die neueste Version zu aktualisieren:

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

Ein Clusterhost:

• Sie verfügen über einen Azure Arc-aktivierten Kubernetes-Cluster mit aktivierten benutzerdefinierten Standort- und Workload-Identitätsfunktionen. Wenn Sie keinen haben, befolgen Sie die Schritte in Bereiten Sie Ihren Azure Arc-fähigen Kubernetes-Cluster vor.

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

Automatische Kardinalität

Um die anfängliche Kardinalität während der Bereitstellung automatisch zu ermitteln, lassen Sie das cardinality-Feld in der Broker-Ressource weg. Der MQTT-Brokerbetreiber stellt die entsprechende Anzahl von Pods basierend auf der Anzahl der verfügbaren Knoten zum Zeitpunkt der Bereitstellung bereit. Diese Funktion ist nützlich für Nichtproduktionsszenarien, in denen Sie keine Einstellungen für hohe Verfügbarkeit oder Skalierung optimieren müssen.

Um die automatische Kardinalität zu verwenden, erstellen Sie eine Broker-Konfigurationsdatei im JSON-Format, die das cardinality-Feld auslässt. Legen Sie beispielsweise nur das Speicherprofil fest:

{
  "memoryProfile": "Medium"
}

Stellen Sie dann mit dem --broker-config-file-Flag bereit (andere Parameter, die aus Platzgründen weggelassen werden):

az iot ops create ... --broker-config-file <FILE>.json

Weitere Informationen finden Sie unter Azure CLI-Unterstützung für die erweiterte MQTT-Brokerkonfiguration.

Bereitstellen im Azure-Portal

Basics

Die Bereitstellungserfahrung im Azure-Portal ist ein Hilfstool, das auf Ihren Ressourcen und Ihrer Konfiguration basierend einen Bereitstellungsbefehl 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 portal Azure an.

2. Suchen Sie im Suchfeld nach Azure IoT Einsatz.

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, für den Sie Azure IoT Einsatz bereitstellen möchten.
   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.
   Bereitstellung optionaler Komponenten > OPC UA Connector	Wählen Sie, ob Sie den optionalen Connector für die OPC UA-Komponente bereitstellen möchten.

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

Configuration

1. 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. In Azure Portal ist es möglich, cardinality und memory profile 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 erweiterte MQTT-Brokerkonfiguration.
   Konfiguration des Datenflussprofils	Optional: Bearbeiten Sie die Standardeinstellungen für Datenflüsse. Weitere Informationen finden Sie unter Konfigurieren des Datenflussprofils.

   

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

Abhängigkeitsverwaltung

1. 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 Schemaregistrierungsnamespace ein.

   3. Wählen Sie Select Azure Storage container 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-Account mit aktiviertem hierarchischem Namespace und aktiviertem öffentlichem Netzwerkzugang 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.

2. 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 Dependency Management 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 Einsatz Instanz enthält.
      Name	Geben Sie einen eindeutigen Namen für Ihren Namespace ein.
      Region	Wählen Sie die region Azure 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.

Bereitstellungsoptionen

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

   

2. Wählen Sie Weiter: Automatisierung aus.

Ausführen Azure CLI Befehle

Der letzte Schritt in der Azure Portalbereitstellung besteht darin, eine Reihe von Azure CLI Befehlen auszuführen, um Azure IoT Einsatz für Ihren Cluster bereitzustellen. Das Portal generiert diese Befehle basierend auf den Informationen, die Sie in den vorherigen Schritten angeben.

Führen Sie jeweils jeden Azure CLI Befehl auf der Registerkarte Automation in einem Terminal aus:

1. Melden Sie sich bei Azure CLI interaktiv mit einem Browser 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 Einsatz CLI-Erweiterung, sofern noch nicht geschehen.

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

3. Kopieren Sie den bereitgestellten az iot ops schema registry create Befehl, um eine Schemaregistrierung zu erstellen, die von Azure IoT Einsatz Komponenten verwendet wird. 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 Azure IoT Einsatz Bereitstellung 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 bereitgestellten Befehl az iot ops create. 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 Install Azure IoT Einsatz schließen.

Sobald der Befehl create erfolgreich abgeschlossen ist, 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

Nachdem die Bereitstellung abgeschlossen ist, verwenden Sie az iot ops check , um die IoT Operations-Dienstbereitstellung für Integrität, Konfiguration und Nutzbarkeit zu bewerten. Mit dem check Befehl können Sie Probleme in Ihrer Bereitstellung und Konfiguration finden.

az iot ops check

Der Befehl check meldet die Datenflussprüfungen als übersprungen, wenn es noch keine Datenflüsse gibt, was normal und erwartet ist, bis du einen Datenfluss erstellst. Weitere Informationen finden Sie unter Verarbeiten und Weiterleiten von Daten mit Datenflüssen.

Um die Konfigurationen von Topic-Maps, QoS und Nachrichtenrouten zu überprüfen, fügen Sie den Parameter --detail-level 2 zum Befehl check hinzu, um eine ausführliche Ansicht zu erhalten.

Um alle verfügbaren Versionen der Azure IoT Einsatz CLI-Erweiterung anzuzeigen, führen Sie den folgenden Befehl aus:

az iot ops get-versions

Nächste Schritte

• Konfigurieren Sie die Observierbarkeit zum Einrichten von Überwachung und Dashboards.
• Die bereitgestellte Azure IoT Einsatz Instanz ist für Testszenarien konfiguriert. Wenn Sie sichere Einstellungen aktivieren und die Instanz für Produktionsszenarien vorbereiten möchten, führen Sie die Schritte unter Aktivieren sicherer Einstellungen für eine vorhandene Azure IoT Einsatz Instanz aus.