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

• Installation der Azure CLI auf Ihrem Entwicklungscomputer. Für dieses Szenario ist mindestens die Version 2.64.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 Einsatz, und wählen Sie diese Option aus.
2. Verwenden Sie die Filter, um Azure IoT Einsatz-Instanzen basierend auf Abonnement, Ressourcengruppe und mehr anzuzeigen.

Azure-Befehlszeilenschnittstelle

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>

Anzeigen der Instanz

Azure portal

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

1. Wechseln Sie im Azure-Portal zur Ressourcengruppe, die Ihre Azure IoT Einsatz-Instanz enthält, oder suchen Sie nach Azure IoT Einsatz.

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

3. Auf der Seite Übersicht Ihrer Instanz zeigt die Arc-Erweiterungen Tabelle die Ressourcen an, die in Ihrem Cluster bereitgestellt wurden.

   

Azure-Befehlszeilenschnittstelle

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 dem --ops-service-Parameter angeben.

Aktualisieren von Instanztags und -beschreibungen

Azure portal

1. Wechseln Sie im Azure-Portal zur Ressourcengruppe, die Ihre Azure IoT Einsatz-Instanz enthält, oder suchen Sie nach Azure IoT Einsatz.

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

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

Azure-Befehlszeilenschnittstelle

Verwenden Sie den Befehl az iot ops update, um die Tags und Beschreibungsparameter Ihrer Azure IoT Einsatz-Instanz zu bearbeiten. Die im Befehl update angegebenen Werte ersetzen vorhandene Tags oder Beschreibungen.

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 ""

Komponenten verwalten

Jede Instanz von Azure IoT Einsatz enthält mehrere Komponenten, z. B. den MQTT-Broker, den Anschluss für OPC UA und 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 Übersicht über den Broker.

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

Im Allgemeinen verwendet Azure IoT Einsatz die Azure Arc-Plattform, um eine Hybrid Cloud-Umgebung bereitzustellen, in der Sie die Konfiguration über Azure Resource Manager (ARM) und Front-End-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.
• Nur wenn Azure IoT Einsatz mithilfe von az iot ops create --enable-rsync mit aktivierter Ressourcensynchronisierung bereitgestellt wird, werden Änderungen an den Ressourcen, die mithilfe von Kubernetes-Bereitstellungsmanifesten vorgenommen wurden, 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

Die Azure CLI und das Azure-Portal bieten verschiedene Optionen zum Deinstallieren von Azure IoT Einsatz.

Mit den Schritten im Azure-Portal kann eine Instanz von „Azure IoT Einsatz“ gelöscht werden, aber sie wirken sich nicht auf die zugehörigen Ressourcen in der Bereitstellung aus. Wenn Sie eine ganze Bereitstellung löschen möchten, verwenden Sie die Azure CLI.

Azure portal

1. Wechseln Sie im Azure-Portal zur Ressourcengruppe, die Ihre Azure IoT Einsatz-Instanz enthält, oder suchen Sie nach Azure IoT Einsatz.

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 gelöscht oder nicht gelöscht werden, geben Sie dann den Namen Ihrer Instanz ein, und wählen Sie Löschen aus, um den Vorgang zu bestätigen.

   

Azure-Befehlszeilenschnittstelle

Verwenden Sie den Befehl az iot ops delete, um die gesamte Azure IoT Einsatz-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 optimiert die erneute Bereitstellung von „Azure IoT Einsatz“ 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 Dataflows.

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 Einsatz“ (die Ausgabe von init) zu entfernen, fügen Sie das Flag --include-deps hinzu.

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