Verwalten des Lebenszyklus einer Instanz von „Azure IoT Einsatz“

Verwenden Sie die Azure CLI und das Azure-Portal, um Instanzen von „Azure IoT Einsatz“ zu verwalten, zu deinstallieren oder zu aktualisieren.

Voraussetzungen

• Eine Instanz von „Azure IoT Einsatz“, die in einem Cluster bereitgestellt ist. Weitere Informationen finden Sie unter Bereitstellen von Azure IoT-Vorgängen.

• 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.

• 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
  

Verwalten

Nach der Bereitstellung können Sie die Azure CLI und das Azure-Portal verwenden, um Ihre Azure IoT Einsatz-Instanz anzuzeigen und zu verwalten.

Instanzen auflisten

Azure-Portal

1. Suchen Sie im Azure-Portal nach Azure IoT Operations, und wählen Sie sie aus.
2. Verwenden Sie die Filter, um Azure IoT Einsatz-Instanzen basierend auf Abonnement, Ressourcengruppe und mehr anzuzeigen.

Azure CLI

Verwenden Sie den Befehl az iot ops list, um alle Azure IoT Einsatz-Instanzen in Ihrem Abonnement oder Ihrer Ressourcengruppe anzuzeigen.

Der Basisbefehl gibt alle Instanzen in Ihrem Abonnement zurück.

az iot ops list

Um die Ergebnisse nach Ressourcengruppe zu filtern, fügen Sie den --resource-group-Parameter hinzu.

az iot ops list --resource-group <RESOURCE_GROUP>

Instanz anzeigen

Azure-Portal

Sie können Ihre Azure IoT Einsatz-Instanz im Azure-Portal einsehen.

1. Wechseln Sie im Azure-Portal zu der Ressourcengruppe, die Ihre Azure IoT Operations-Instanz enthält, oder suchen Sie nach Azure IoT Operations, und wählen Sie sie aus.

2. Wählen Sie den Namen Ihrer Azure IoT Einsatz-Instanz aus.

3. Auf der Seite "Übersicht" Ihrer Instanz können Sie die Eigenschaften Ihrer Instanz sehen. Beispielsweise können Sie den Status der Vorschauverbindungen sehen, die aktiviert oder deaktiviert werden können. Um den Status der Vorschauconnectors zu ändern, klicken Sie auf Bearbeiten.

   

   Diese Aktion öffnet einen Konfigurationsbereich, in dem Sie den ONVIF-Vorschauconnector aktivieren oder deaktivieren können.

4. Auf der Registerkarte " Ressourcenzusammenfassung " werden die Ressourcen angezeigt, die in Ihrem Cluster bereitgestellt wurden.

Azure CLI

Verwenden Sie den Befehl az iot ops show, um die Eigenschaften einer Instanz anzuzeigen.

az iot ops show --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP>

Sie können auch den Befehl az iot ops show verwenden, um die Ressourcen in Ihrer Azure IoT Einsatz-Bereitstellung in der Azure CLI anzuzeigen. Fügen Sie das Flag --tree hinzu, um eine Strukturansicht der Bereitstellung anzuzeigen, die die angegebene Azure IoT Einsatz-Instanz enthält.

az iot ops show --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --tree

Die Strukturansicht einer Bereitstellung sieht wie im folgenden Beispiel aus:

MyCluster
├── extensions
│   ├── akvsecretsprovider
│   ├── azure-iot-operations-ltwgs
│   └── azure-iot-operations-platform-ltwgs
└── customLocations
    └── MyCluster-cl
        ├── resourceSyncRules
        └── resources
            ├── MyCluster-ops-init-instance
            └── MyCluster-observability

Sie können az iot ops check in Ihrem Cluster ausführen, um die Integrität und Konfiguration einzelner Azure IoT Einsatz-Komponenten zu bewerten. Standardmäßig überprüft der Befehl MQ, aber Sie können den Dienst mit --ops-service Parameter angeben.

(Vorschau) Klonen einer Instanz

Hinweis

Die Klonfunktion ist in der Vorschau verfügbar und wird derzeit entwickelt.

Azure-Portal

Derzeit unterstützt das Azure-Portal das Klonen einer Azure IoT Operations-Instanz nicht. Sie können die Azure CLI verwenden, um eine Instanz zu klonen.

Azure CLI

Verwenden Sie den az iot ops clone Befehl, um eine neue Azure IoT Operations-Instanz basierend auf einer vorhandenen Instanz zu erstellen. Sie können die Ausgabe des Klons auf einen anderen verbundenen Cluster anwenden, der als Replikation bezeichnet wird. Sie können den Klon auch für die spätere Verwendung in einem lokalen Verzeichnis speichern und einige Konfigurationsänderungen vornehmen, bevor Sie ihn auf einen Cluster anwenden.

Weitere Informationen finden Sie auf der Wiki-Seite des Klonbefehls.

Führen Sie Folgendes aus, um eine Instanz in einen anderen Cluster zu klonen:

az iot ops clone --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --to-cluster-id <CLUSTER_ID> 

Um die Replikation auf einen anderen Cluster anzupassen, verwenden Sie --param und geben Sie die Parameter an, die Sie im Format key=value ändern möchten. Um beispielsweise den Speicherort der geklonten Instanz zu ändern, führen Sie Folgendes aus:

az iot ops clone --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --to-cluster-id <CLUSTER_ID> --param location=eastus

Führen Sie Folgendes aus, um eine Instanz in ein lokales Verzeichnis zu klonen:

az iot ops clone --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --to-dir <DIRECTORY>

Tipp

Um eine Instanz in das aktuelle Verzeichnis zu klonen, führen Sie --to-dir . aus.

Führen Sie Folgendes aus, um eine Instanz auf einen Cluster zu klonen, indem ressourcenbezogene Unterbereitstellungen aufgeteilt und nacheinander angewendet werden:

az iot ops clone --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --to-cluster-id <CLUSTER_ID> --mode linked

Aktualisieren von Instanzen und Konfigurationen

Azure-Portal

1. Wechseln Sie im Azure-Portal zu der Ressourcengruppe, die Ihre Azure IoT Operations-Instanz enthält, oder suchen Sie nach Azure IoT Operations, und wählen Sie sie aus.

2. Wählen Sie den Namen Ihrer Azure IoT Einsatz-Instanz aus.

3. Wählen Sie auf der Seite "Übersicht" Ihrer Instanz die Option "Kategorien hinzufügen " oder "Bearbeiten " aus, um Tags in Ihrer Instanz zu ändern.

Azure CLI

Verwenden Sie den Befehl "az iot ops update" , um die Features Ihrer Azure IoT Operations-Instanz zu bearbeiten.

Führen Sie Folgendes aus, um Tags und Beschreibungsparameter einer Instanz zu aktualisieren:

az iot ops update --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --desc "<INSTANCE_DESCRIPTION>" --tags <TAG_NAME>=<TAG-VALUE> <TAG_NAME>=<TAG-VALUE>

Wenn Sie alle Tags in einer Instanz löschen möchten, legen Sie den tags-Parameter auf einen NULL-Wert fest. Zum Beispiel:

az iot ops update --name <INSTANCE_NAME> --resource-group --tags ""

Führen Sie Folgendes aus, um die Vorschaukonnektorkonfiguration zu aktivieren:

az iot ops update --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --feature connectors.settings.preview=Enabled 

Führen Sie Folgendes aus, um die Konfiguration des Vorschau-Verbinders zu deaktivieren:

az iot ops update --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --feature connectors.settings.preview=Disabled  

Komponenten verwalten

Die Azure IoT Operations-Instanz enthält mehrere Komponenten, wie den MQTT-Broker, den Anschluss für OPC UA und die Datenflüsse. Weitere Informationen zum Verwalten dieser Komponenten finden Sie in den zugehörigen Artikeln. Um z. B. den MQTT-Broker zu verwalten, beginnen Sie mit der Broker-Übersicht.

(Vorschau:) Verwalten von Komponenten mithilfe von Kubernetes-Bereitstellungsmanifesten

"In der Regel nutzt Azure IoT Operationen die Azure Arc-Plattform, um ein hybrides Cloud-Erlebnis bereitzustellen, bei dem Sie die Konfiguration über den Azure Resource Manager (ARM) und Frontend-Tools wie das Azure-Portal, Bicep und die Azure-Befehlszeilenschnittstelle verwalten können."

Sie können jedoch auch die Komponenten von Azure IoT Einsatz mithilfe von Kubernetes-Bereitstellungsmanifesten im YAML-Format verwalten. Dadurch können Sie Tools wie kubectl verwenden, um einige Komponenten von Azure IoT Einsatz zu verwalten. Dieses Feature befindet sich in der Vorschau, daher gelten einige Einschränkungen:

• Nur einige der Komponenten unterstützen die Verwendung von Kubernetes-Bereitstellungsmanifesten. Diese Komponenten sind der MQTT-Broker und Datenflüsse. Andere Komponenten wie der Anschluss für OPC UA und Akri-Dienste unterstützen dieses Feature nicht.
• Sofern Sie die Ressourcensynchronisierung in Azure IoT Operations nicht mithilfe az iot ops rsync enablevon Azure IoT Operations aktivieren, werden Änderungen, die an den Ressourcen mithilfe von Kubernetes-Bereitstellungsmanifesten vorgenommen wurden, nicht mit Azure synchronisiert. Weitere Informationen zur Ressourcensynchronisierung finden Sie unter "Ressourcensynchronisierung".
• Selbst wenn die Ressourcensynchronisierung aktiviert ist, werden völlig neue Ressourcen, die mit Kubernetes-Bereitstellungsmanifesten erstellt wurden, nicht mit Azure synchronisiert. Es werden nur Änderungen an vorhandenen Ressourcen synchronisiert.

Deinstallieren

Das Azure IoT Operations CLI- und Azure-Portal bieten verschiedene Optionen zum Deinstallieren von Azure IoT Operations.

Von Bedeutung

Wenn Sie Ihre Cluster- und Ressourcengruppe bereinigen möchten, empfiehlt es sich, Zuerst Azure IoT Operations aus dem Cluster mithilfe der Azure IoT Operations CLI-Befehle im folgenden Abschnitt zu entfernen. Anschließend können Sie die Ressourcengruppe löschen. Wenn Sie die Ressourcengruppe direkt löschen, bleiben verwaiste Ressourcen im Cluster erhalten.

Azure-Portal

1. Wechseln Sie im Azure-Portal zu der Ressourcengruppe, die Ihre Azure IoT Operations-Instanz enthält, oder suchen Sie nach Azure IoT Operations, und wählen Sie sie aus.

2. Wählen Sie den Namen Ihrer Azure IoT Einsatz-Instanz aus.

3. Wählen Sie auf der Seite "Übersicht" Ihrer Instanz "Löschen" aus.

4. Überprüfen Sie die Liste der Ressourcen, die im Rahmen dieses Vorgangs nicht gelöscht werden, geben Sie dann den Namen Ihrer Instanz ein, und wählen Sie " Löschen" aus, um dies zu bestätigen.

   

Hinweis

Durch das Löschen der Azure IoT Operations-Instanz im Azure-Portal werden die Abhängigkeiten, die beim Bereitstellen von Azure IoT Operations erstellt wurden, nicht entfernt. Um diese Abhängigkeiten zu entfernen, verwenden Sie den az iot ops delete --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --include-deps Befehl, der in der Azure CLI-Anleitung beschrieben ist.

Azure CLI

Verwenden Sie den Befehl " az iot ops delete ", um die gesamte Azure IoT Operations-Bereitstellung aus einem Cluster zu löschen. Der Befehl delete wertet die Ressourcen im Zusammenhang mit Azure IoT Einsatz im Cluster aus und stellt eine Strukturansicht der zu löschenden Ressourcen dar. Der Cluster sollte online sein, wenn Sie diesen Befehl ausführen.

Der Befehl delete vereinfacht die erneute Bereitstellung von Azure IoT-Betrieb auf demselben Cluster. Der Befehl create wird damit rückgängig gemacht, sodass Sie create, delete und create usw. erneut ausführen können, ohne init erneut ausführen zu müssen.

Der Befehl delete entfernt Folgendes:

• Die Azure IoT Einsatz-Instanz
• Arc-Erweiterungen
• Benutzerdefinierte Standorte
• Regeln für die Ressourcensynchronisierung
• Ressourcen, die Sie in Ihrer Azure IoT Einsatz-Lösung konfigurieren können, z. B. Ressourcen, MQTT-Broker und Datenflüsse.

az iot ops delete --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP>

Um die Instanz zu löschen und auch die Abhängigkeiten von „Azure IoT Operationen“ (die Ausgabe von init) zu entfernen, setzen Sie das Flag --include-deps.

az iot ops delete --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --include-deps