次の方法で共有

新しいバージョンにアップグレードする

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

前提条件

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

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

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

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

既存の Azure IoT Operations インスタンスを、同じマイナー バージョンの任意のパッチまたは次のマイナー バージョンにアップグレードできます。

Azure IoT Operations は、バージョン間のダウングレードをサポートしていません。 以前のバージョンに移行するには、Azure IoT Operations をアンインストールして、目的のバージョンを再インストールします。

注

Azure IoT Operations では、ライブ アップグレードはサポートされていません。 アップグレード プロセス中にダウンタイムが発生する可能性があります。

アップグレード

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 IoT Operations CLI 拡張機能を使用して、最新バージョンの Azure IoT Operations を取得する必要があります。 前提条件の一部として拡張機能を更新しなかった場合は、今すぐ更新してください。

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

    または、デプロイを最新バージョンではなく新しいバージョンにアップグレードする場合は、CLI 拡張機能のバージョンを、IoT Operations のバージョン内の目的の Azure IoT Operations バージョンに関連するバージョンに設定します。

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

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

  5. コピーした az iot ops upgrade コマンドを実行します。

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

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

MQTT ブローカーのアップグレードに関する考慮事項

デプロイのアップグレード時にデータ損失ゼロを確保し、高可用性を維持するために、MQTT ブローカーはポッド間でローリング更新を実装します。 ヘルス マネージャー ポッドは、MQTT ブローカー ポッドの段階的アップグレード プロセスを調整して、次のことを確保します。

  • アクティブなクライアント接続は中断されません。
  • 飛行中のメッセージはすべて保持されます。
  • ディスクに格納されているデータは、バージョン間で適切に移行されます。

アップグレード プロセス中にエラーが発生した場合、ヘルス マネージャー ポッドは、データや接続を失わない状態でアップグレード プロセスを自動的に再起動します。

ローリング更新は、MQTT ブローカーが 2 つ以上のバックエンド レプリカを使用してデプロイされている場合にのみ発生します。 MQTT ブローカーのアップグレードは、単一レプリカのデプロイではサポートされていません。 Azure IoT Operations をデプロイするときに、 az iot ops create コマンドで作成するバックエンド レプリカの数を --broker-backend-rf パラメーターで指定します。