次の方法で共有

バージョン間でのアップグレードまたはダウングレード

  • [アーティクル]

Azure IoT Operations デプロイを新しいバージョンにアップグレードするか、または以前のバージョンにロールバックします。 Azure IoT Operations は、バージョン 1.0.x 以降のアップグレードとロールバックをサポートしています。 Azure IoT Operations のプレビュー バージョンから一般公開 (GA) バージョンへのアップグレードはサポートされていません。

前提条件

  • Azure CLI。 このシナリオには、Azure CLI バージョン 2.64.0 以降が必要です。 az --version を使用してバージョンを確認し、必要に応じて az upgrade を使用して更新します。 詳細については、Azure CLI の概要に関するページをご覧ください。

  • Azure CLI 用の Azure IoT Operations 拡張機能。 次のコマンドを使用して、拡張機能を追加するか、それを最新バージョンに更新します。

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

アップグレードサポートについて

アップグレードとロールバックがサポートされるのは、Azure IoT Operations の N+3 または N-3 マイナー バージョン間、または同じマイナー バージョンのパッチ バージョン間です。 次の表に例を示します。

バージョン アップグレード範囲 ダウングレード範囲
1.0.0 1.0.1 から 1.3.x なし
1.1.0 1.1.1 から 1.4.x 1.0.x
1.4.4 1.4.5 から 1.7.x 1.1.x から 1.4.3

アップグレード

Azure IoT Operations は、インスタンスの新しい GA バージョンがリリースされたときに、それにアップグレードすることをサポートしています。

プレビュー インストールから GA バージョンにアップグレードすることはできません。 バージョン 1.0.x に移行するには、Azure IoT Operations をアンインストールして、新しいバージョンを再インストールします。

Azure IoT Operations デプロイがアップグレードの対象となる場合、Azure portal に [アップグレード] オプションが表示されます。 アップグレードするためのこのオプションが表示されない場合、デプロイは最新バージョンです。

  1. Azure portal で、Azure IoT Operations インスタンスに移動します。

  2. インスタンスの [概要] ページで [アップグレード] を選択します。

    Azure portal で有効になっている [アップグレード] ボタンを示すスクリーンショット。

  3. ポータルには、サブスクリプション、リソース グループ、インスタンスの詳細が事前設定された、インスタンスをアップグレードするための Azure CLI コマンドが提示されます。 CLI コマンドの横にあるコピー アイコンを選択します。

  4. Azure CLI がインストールされている任意の環境で、コピーした az iot ops upgrade コマンドを実行します。

  5. アップグレード コマンドが正常に完了した後、インスタンスを更新して変更を確認します。

インスタンスの [概要] ページに表示される [バージョン] の値に、Azure IoT Operations インスタンスのバージョンが反映されます。 ただし、必要な Arc 拡張機能に利用可能なアップグレードがある場合は、アップグレードするように求められることがあります。 何も変更されていないように見える場合でも、インスタンスの [概要] ページから [アップグレード] オプションが消えていれば、アップグレードが成功したことがわかります。 Azure IoT Operation デプロイの Arc 拡張機能のバージョンは、Azure portal の Arc 対応クラスターの [拡張機能] ページで確認できます。

ダウングレード

Azure portal では、バージョンのダウングレード オプションは提供されません。 代わりに、Azure CLI を使用します。