Verwalten des Lebenszyklus einer Instanz von „Azure IoT Einsatz“

Wichtig

Die von Azure Arc unterstützte Vorschauversion von „Azure IoT Einsatz“ befindet sich derzeit in der Vorschauphase. Sie sollten diese Vorschausoftware nicht in Produktionsumgebungen verwenden.

Sie müssen eine neue Installation von „Azure IoT Einsatz“ bereitstellen, wenn ein allgemein verfügbares Release verfügbar wird. Sie werden kein Upgrade für eine Preview-Installation durchführen können.

Die zusätzlichen Nutzungsbestimmungen für Microsoft Azure-Vorschauen enthalten rechtliche Bedingungen. Sie gelten für diejenigen Azure-Features, die sich in der Beta- oder Vorschauversion befinden oder aber anderweitig noch nicht zur allgemeinen Verfügbarkeit freigegeben sind.

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

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.

Anzeigen der Instanz

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.

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.

   

Aktualisieren von Instanztags und -beschreibungen

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

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.

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

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.

   

Aktualisieren

Derzeit wird die Aktualisierung einer vorhandenen Bereitstellung in Azure IoT Einsatz nicht unterstützt. Stattdessen müssen Sie Azure IoT Einsatz deinstallieren und eine neue Version von Azure IoT Einsatz bereitstellen.

1. Verwenden Sie den Befehl az iot ops delete, um die Azure IoT Einsatz-Bereitstellung in Ihrem Cluster zu löschen.

   az iot ops delete --cluster <CLUSTER_NAME> --resource-group <RESOURCE_GROUP>
   

2. Aktualisieren Sie die CLI-Erweiterung, um die neueste Version von Azure IoT Einsatz zu erhalten.

   az extension update --name azure-iot-ops
   

3. Führen Sie die Schritte in diesem Artikel aus, um die neueste Version von Azure IoT Einsatz in Ihrem Cluster bereitzustellen.

   Tipp

   Fügen Sie dem Befehl az iot ops init das Flag --ensure-latest hinzu, um zu überprüfen, ob die neueste CLI-Version für Azure IoT Einsatz installiert ist, und geben Sie einen Fehler aus, wenn ein Upgrade verfügbar ist.