Upgrade oder Downgrade zwischen Versionen

Aktualisieren Sie eine Azure IoT Einsatz-Bereitstellung auf eine neuere Version, oder führen Sie ein Rollback auf eine frühere Version durch. Azure IoT Einsatz unterstützt ab Version 1.0.x Upgrades und Rollbacks. Das Upgrade von einer Vorschauversion von Azure IoT Einsatz auf eine allgemein verfügbare Version (GA) wird nicht unterstützt.

Voraussetzungen

• Azure-Befehlszeilenschnittstelle. 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 Erste Schritte mit der Azure-Befehlszeilenschnittstelle.

• 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
  

Grundlegendes zur Upgradeunterstützung

Upgrade und Rollback werden zwischen N+3- oder N-3-Nebenversionen von Azure IoT Einsatz oder zwischen Patchversionen derselben Nebenversion unterstützt. In der folgenden Tabelle finden Sie einige Beispiele:

Version	Upgradebereich	Downgradebereich
1.0.0	1.0.1 bis 1.3.x	Keine
1.1.0	1.1.1 bis 1.4.x	1.0.x
1.4.4	1.4.5 bis 1.7.x	1.1.x bis 1.4.3

Upgraden

Azure IoT Einsatz unterstützt das Upgrade von Instanzen auf neue GA-Versionen, sobald sie veröffentlicht wurden.

Sie können kein Upgrade von einer Vorschauinstallation auf eine GA-Version durchführen. Um zu Version 1.0.x zu wechseln, deinstallieren Sie Azure IoT Einsatz , und installieren Sie die neue Version.

Azure portal

Wenn Ihre Azure IoT Einsatz-Bereitstellung für ein Upgrade berechtigt ist, wird im Azure-Portal die Option Upgraden angezeigt. Wenn die Option zum Upgrade nicht angezeigt wird, hat Ihre Bereitstellung die aktuelle Version.

1. Navigieren Sie im Azure-Portal zu Ihrer Azure IoT Einsatz-Instanz.

2. Wählen Sie auf der Seite Übersicht Ihrer Instanz die Option Upgraden aus.

   

3. Im Portal wird der Azure CLI-Befehl zum Upgraden Ihrer Instanz angezeigt. Er ist bereits mit Ihrem Abonnement, Ihrer Ressourcengruppe und den Instanzdetails aufgefüllt. Wählen Sie das Kopiersymbol neben dem CLI-Befehl aus.

4. Führen Sie den kopierten Befehl az iot ops upgrade in jeder Umgebung aus, in der Sie die Azure CLI installiert haben.

5. Sobald der Upgradebefehl erfolgreich abgeschlossen wurde, aktualisieren Sie die Instanz, um die Änderungen anzuzeigen.

Der Wert für Version, der auf der Übersichtsseite Ihrer Instanz angezeigt wird, spiegelt die Version der Azure IoT Einsatz-Instanz wider. Möglicherweise werden Sie jedoch aufgefordert, ein Upgrade durchzuführen, wenn für eine erforderliche Arc-Erweiterung ein Upgrade verfügbar ist. Sie können feststellen, ob ein Upgrade erfolgreich war, wenn die Option Upgraden von der Übersichtsseite der Instanz verschwindet, auch wenn es nicht aussieht, als hätte sich etwas geändert. Sie können die Versionen der Arc-Erweiterungen für Ihre Azure IoT Einsatz-Bereitstellung auf der Seite Erweiterungen Ihres Arc-fähigen Clusters im Azure-Portal überprüfen.

Azure-Befehlszeilenschnittstelle

Verwenden Sie den Befehl az iot ops upgrade, um eine vorhandene Azure IoT Einsatz-Bereitstellung auf eine neuere Version zu aktualisieren.

Der Upgradebefehl wertet die gesamte Azure IoT Einsatz-Bereitstellung auf verfügbare Updates aus, einschließlich der Arc-Erweiterungen, die im Befehl az iot ops init installiert werden, sowie der Azure IoT Einsatz-Instanz.

az iot ops upgrade --resource-group <RESOURCE_GROUP_NAME> --name <INSTANCE_NAME>

Die CLI gibt ggf. eine Tabelle der Komponenten aus, für die Upgrades verfügbar sind. Geben Sie Y ein, um mit dem Upgrade fortzufahren.

Wenn Sie ein Upgrade auf eine bestimmte Version einer Komponente durchführen möchten, geben Sie die Versionsnummer in den Parametern an. Zum Beispiel:

az iot ops upgrade --resource-group <RESOURCE_GROUP_NAME> --name <INSTANCE_NAME> --acs-version 2.2.3

Sie finden die unterstützten Komponentenversionen und Release Train-Informationen in der Datei azure-iot-operations-enablement.json, die in jedem Release von Azure IoT Einsatz enthalten ist.

Downgrade

Azure portal

Das Azure-Portal bietet keine Option für das Versionsdowngrade. Verwenden Sie stattdessen die Azure CLI.

Azure-Befehlszeilenschnittstelle

Verwenden Sie den Befehl az iot ops upgrade, um eine vorhandene Azure IoT Einsatz-Instanz auf eine vorherige Version zurückzusetzen.

Im Upgradebefehl können Sie eine Komponentenversion angeben, die bis zu drei Nebenversionen älter ist als die aktuelle Version.

Sie finden die unterstützten Komponentenversionen und Release Train-Informationen in der Datei azure-iot-operations-enablement.json, die in jedem Release von Azure IoT Einsatz enthalten ist.