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

az iot ops list

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

Instanz anzeigen

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

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

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

Azure-Geräteregistrierung anzeigen

Im Azure-Portal können Sie die Azure-Geräteregistrierung anzeigen, bei der es sich um eine Sammlung aller Geräte und Ressourcen handelt, die mit Ihrer Azure IoT Einsatz-Instanz verbunden sind.

Die Azure Device Registry verwendet Namespaces zum Organisieren von Objekten und Geräten. Jede Azure IoT Einsatz-Instanz verwendet einen einzelnen Namespace für ihre Ressourcen und Geräte. Mehrere Instanzen können einen einzelnen Namespace gemeinsam nutzen.

So zeigen Sie Elemente in der Azure-Geräteregistrierung im Azure-Portal an:

1. Suchen Sie im Azure-Portal nach Azure-Geräteregistrierung, und wählen Sie diese Option aus. Auf der Seite Übersicht werden die Anzahl der Ressourcen, Schemaregistrierungen und Namespaces in Ihrem Abonnement zusammengefasst:

   

2. Verwenden Sie die Seite "Objekte ", um die Objekte in der Azure-Geräteregistrierung anzuzeigen. Standardmäßig zeigt die Seite Ressourcen die Objekte in allen Namespaces in Ihrem Abonnement an. Verwenden Sie die Filter, um eine Teilmenge der Objekte anzuzeigen, z. B. die Objekte in einem bestimmten Namespace oder einer bestimmten Ressourcengruppe:

   

3. Verwenden Sie die Seite Schemaregistrierungen, um die Schemaregistrierungen in der Azure-Geräteregistrierung anzuzeigen. Standardmäßig zeigt die Seite Schemaregistrierungen die Schemaregistrierungen in allen Namespaces in Ihrem Abonnement an. Verwenden Sie die Filter, um eine Teilmenge der Schemaregistrierungen anzuzeigen, z. B. die Schemaregistrierungen in einem bestimmten Namespace oder einer bestimmten Ressourcengruppe:

   

4. Verwenden Sie die Namespaces-Seite, um die Namespaces in der Azure-Geräteregistrierung anzuzeigen. Standardmäßig zeigt die Seite Namespaces die Namespaces in Ihrem Abonnement an. Verwenden Sie die Filter, um eine Teilmenge der Namespaces anzuzeigen, z. B. die Namespaces in einer bestimmten Ressourcengruppe. Auf dieser Seite können Sie neue Namespaces erstellen oder die Details vorhandener Namespaces anzeigen:

   

Sie können auch die Details eines vorhandenen Namespaces in der Ressourcengruppe anzeigen, die Ihre Azure IoT Einsatz-Instanz enthält. Der folgende Screenshot zeigt beispielsweise die adr-Namespace-Ressource, die der Azure IoT Einsatz-Instanz aio-131235032 zugeordnet ist:

Der vorherige Screenshot zeigt auch die anderen Ressourcen in der Azure-Geräteregistrierung, z. B. die IoT Schema Registry, IoT Namespace Assets und Geräte im Kontext der Ressourcengruppe, die Ihre Azure IoT Einsatz-Instanz enthält.

Migrieren von Ressourcen (klassisch) zu Ressourcen

Wenn Sie über vorhandene Ressourcen in Ihrer Azure IoT Operations-Instanz verfügen, die Sie in einen Namespace verschieben möchten, können Sie den az iot ops migrate-assets Befehl verwenden. Mit diesem Befehl werden Ressourcen auf Stammebene (klassisch) zu Objekten in der Azure-Geräteregistrierung migriert.

Der Zielsatz von Ressourcen (klassisch) wird in eine entsprechende Objektdarstellung konvertiert und ersetzt die ursprüngliche Ressource auf Stammebene (klassisch). Während der Migration werden Geräte anstelle der Endpunktprofile erstellt, auf die von den Stammressourcen verwiesen wird. Wenn mehrere Objekte auf dasselbe Endpunktprofil verweisen, wird nur auf ein Gerät von den migrierten Ressourcen verwiesen.

Führen Sie den folgenden Befehl aus, um alle Stammressourcen zu migrieren, die einer Instanz zugeordnet sind:

az iot ops migrate-assets -n <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> 

Führen Sie den folgenden Befehl aus, um bestimmte Stammressourcen zu migrieren, die einer Instanz zugeordnet sind:

az iot ops migrate-assets -n <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --pattern <ASSET_ID_1> <ASSET_ID_2> <ASSET_ID_3>

Führen Sie den folgenden Befehl aus, um alle Stammressourcen zu migrieren, die einer Instanz zugeordnet sind, die mit Glob-Stilmustern übereinstimmt:

az iot ops migrate-assets -n <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --pattern asset-pl-* asset-eng?-01

Nach Abschluss der Migration können Sie die az iot ops ns asset- und az iot ops ns device-Befehle verwenden, um die Ressourcen und Geräte in Ihrer Azure IoT Operations-Instanz zu verwalten.

Konfigurieren von Connectorvorlagen

Im Azure-Portal können Sie Connectorvorlagen für Ihre Azure IoT Einsatz-Instanz konfigurieren. Connectorvorlagen definieren die Konfiguration von Connectors, z. B. den Connector für OPC UA, die in Ihrem Cluster bereitgestellt werden. Wenn Sie eine Connectorvorlage erstellen, kann ein OT-Benutzer ein Gerät erstellen, das den Connectortyp in der Web-UI für Vorgänge verwendet.

Weitere Informationen zu Connectorvorlagen finden Sie unter Bereitstellen des Connectors für ONVIF.

Verwalten von Instanzkomponenten

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.

Verwalten von Komponenten mithilfe von Kubernetes-Bereitstellungsmanifesten (Vorschau)

"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 des az iot ops enable-rsync Befehls 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.

Aktualisieren von Instanzen und Konfigurationen

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

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

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

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

Deinstallieren

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

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

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