Freigeben über

Upgrade auf eine neue Version

Erfahren Sie, wie Sie eine Azure IoT Einsatz-Bereitstellung auf eine neuere Version aktualisieren.

Voraussetzungen

  • Ein Azure-Konto mit einem aktiven Abonnement. Wenn Sie kein Konto haben, können Sie ein kostenloses Konto erstellen.
  • Azure CLI: Version 2.53.0 oder höher 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.

Grundlegendes zur Upgradeunterstützung

Versionsversionen von Azure IoT Einsatz können Vorschau oder allgemein verfügbar (GA) sein, sie finden die neueste Version im Azure IoT Einsatz-Versionsdokument. Die Azure IoT Einsatz CLI-Erweiterungsversion ist an die Azure IoT Einsatz-Version gebunden, daher müssen Sie sicherstellen, dass die richtige CLI-Erweiterungsversion installiert ist, um ein Upgrade durchzuführen.

Azure IoT Einsatz unterstützt die folgenden Upgradeszenarien:

  • Sie können eine vorhandene Azure IoT Einsatz-Instanz auf einen Patch derselben Nebenversion oder auf die nächste Nebenversion aktualisieren.
  • Sie können das Downgrade zwischen Versionen nicht ausführen. Um zu einer älteren Version zu wechseln, deinstallieren Sie Azure IoT Operations, und installieren Sie die gewünschte Version erneut.
  • Sie können kein Upgrade von einer Vorschauversion auf eine GA-Version durchführen. Sie müssen Azure IoT Einsatz deinstallieren und die neue Version erneut installieren.
  • Sie können kein Upgrade von einer GA-Version auf eine Vorschauversion durchführen. Weitere Informationen zum Installieren einer Vorschauversion finden Sie unter Upgrade auf die Vorschauversion.

Hinweis

Azure IoT Operations unterstützt keine Liveupgrades. Bitte erwarten Sie während des Upgradevorgangs einige Ausfallzeiten.

Aktualisierung

Azure IoT Operationen unterstützt Upgrades von Instanzen auf neue GA-Versionen, sobald sie veröffentlicht werden. Wenn Ihre Azure IoT Einsatz-Instanz für ein Upgrade berechtigt ist, können Sie das Azure-Portal oder die Azure CLI verwenden, um das Upgrade durchzuführen.

Wenn sich die neueste Version von Azure IoT Einsatz in der Vorschau befindet, lesen Sie das Upgrade auf die Vorschauversion.

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.

    Screenshot: Schaltfläche „Upgraden“ im Azure-Portal

  3. Sie müssen die neueste Version der CLI-Erweiterung von Azure IoT Einsatz verwenden, um die neueste Version von Azure IoT Einsatz zu erhalten. Wenn Sie die Erweiterung nicht als Teil der Voraussetzungen aktualisiert haben, tun Sie dies jetzt.

    az extension add --upgrade --name azure-iot-ops

    Wenn Sie ihre Bereitstellung auf eine neuere, aber nicht die neueste Version aktualisieren möchten, legen Sie die Version der CLI-Erweiterung auf die Version fest, die mit Ihren gewünschten Azure IoT Einsatz-Versionen in IoT Einsatz-Versionen verknüpft ist.

    az extension add --upgrade --name azure-iot-ops --version <VERSION_NUMBER>

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

  5. Führen Sie den kopierten Befehl az iot ops upgrade aus.

  6. 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 eine erforderliche Arc-Erweiterung über ein verfügbares Upgrade verfügt. 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.

Upgrade auf Vorschauversion

Manchmal befindet sich die neueste Version von Azure IoT Einsatz in der Vorschau. Überprüfen Sie die Azure IoT Einsatz-Versionen, um die neueste Version anzuzeigen. Während der Vorschauversionen wird das Versionsupgrade blockiert, und Sie müssen Azure IoT Einsatz deinstallieren und die Vorschauversion erneut installieren.

Sie können eine Vorschauversion nur mithilfe der Azure CLI installieren.

  1. Wenn Sie über eine vorhandene Azure IoT Einsatz-Instanz verfügen, müssen Sie Azure IoT-Vorgänge deinstallieren, um eine neue Bereitstellung durchzuführen.

  2. Fügen Sie die neueste Version der Azure IoT Einsatz CLI-Erweiterung mit der --allow-preview Kennzeichnung hinzu.

    az extension add --upgrade --name azure-iot-ops --allow-preview

Wenn Sie ein Upgrade auf eine bestimmte Version von Azure IoT Einsatz durchführen möchten, die nicht die neuesten ist, können Sie az iot ops get-versions ausführen oder auf Azure IoT Einsatz-Versionen, um die CLI-Erweiterungsversion zu finden, die der gewünschten Azure IoT Einsatz-Version zugeordnet ist. Rufen Sie die Versionsnummer ab, und führen Sie den folgenden Befehl aus, um ein Upgrade auf diese Version auszuführen:

az extension add --upgrade --name azure-iot-ops --version <VERSION_NUMBER>

Überlegungen zum Upgrade des MQTT-Brokers

Um null Datenverlust und hohe Verfügbarkeit während Bereitstellungsupgrades sicherzustellen, implementiert der MQTT-Broker rollierende Updates über die MQTT-Broker-Pods hinweg. Der Health Manager-Pod koordiniert einen inkrementellen Upgradeprozess für die MQTT-Broker-Pods, um sicherzustellen, dass:

  • Aktive Clientverbindungen bleiben unterbrechungsfrei.
  • Alle In-Flight-Nachrichten werden beibehalten.
  • Auf dem Datenträger gespeicherte Daten werden zwischen Versionen ordnungsgemäß migriert.

Wenn während des Upgradevorgangs ein Fehler auftritt, startet das Gesundheits-Manager-Pod den Upgradevorgang automatisch neu und stellt dabei sicher, dass weder Daten noch die Konnektivität verloren gehen.

Rollierende Updates können nur durchgeführt werden, wenn der MQTT-Broker mit zwei oder mehr Backend-Replikas bereitgestellt wird. MQTT-Brokerupgrades werden für Bereitstellungen mit einem Replikat nicht unterstützt. Wenn Sie Azure IoT Operations bereitstellen, geben Sie die Anzahl der Backend-Replikate an, die im az iot ops create Befehl mit dem --broker-backend-rf Parameter erstellt werden sollen.

Unterstützte Versionen

Microsoft unterstützt jederzeit drei allgemein verfügbare-Versionen (GA) von Azure IoT Einsatz: die neueste Version und die beiden vorherigen Nebenversionen. Darüber hinaus stehen Vorschauversionen zum Testen neuer Features zur Verfügung.

Derzeit steht der Azure-Support für die folgenden Versionen zur Verfügung:

Version Typ Aktueller Patch
Release (YYMM)		 Strom
CLI-Version		 Versionshinweise
1.2.x GA 1.2.112 (2510) 2.0.1 Veröffentlichungshinweise
1.1.x GA 1.1.59 (2506) 1.7.0 Veröffentlichungshinweise
1.0.x GA 1.0.34 (2503) 1.3.0 Veröffentlichungshinweise

Informationen zu Upgrades zwischen Versionen finden Sie unter Upgrade auf eine neue Version.

Von Bedeutung

Frühere Nebenversionen erhalten keine Sicherheitspatches. Führen Sie ein Upgrade auf die neueste Version durch, um die neuesten Sicherheitsupdates und -features zu erhalten.

Warnung

Verwenden Sie keine Vorschauversionen in Produktionsumgebungen.

Um Ihre aktuelle Version zu überprüfen, wechseln Sie zur Übersichtsseite für Ihre Azure IoT Einsatz-Instanz im Azure-Portal, oder verwenden Sie den Befehl az iot ops instance show der Azure IoT Einsatz-CLI.

  • Last updated on