次の方法で共有

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

Azure IoT Operations デプロイを新しいバージョンにアップグレードする方法について説明します。

前提条件

  • アクティブなサブスクリプションを持つ Azure アカウント。 アカウントをお持ちでない場合は、 無料アカウントを作成できます。
  • Azure CLI バージョン 2.53.0 以降。 az --version を使用してバージョンを確認し、必要に応じて az upgrade を使用して更新します。 詳細については、Azure CLI の概要に関するページをご覧ください。

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

Azure IoT Operations のリリース バージョンはプレビューまたは一般公開 (GA) できます。最新バージョンについては、 Azure IoT Operations のバージョン に関するドキュメントを参照してください。 Azure IoT Operations CLI 拡張機能のバージョンは Azure IoT Operations バージョンに関連付けられているため、アップグレードを実行するために正しい CLI 拡張機能バージョンがインストールされていることを確認する必要があります。

Azure IoT Operations では、次のアップグレード シナリオがサポートされています。

  • 既存の Azure IoT Operations インスタンスを、同じマイナー バージョンの任意のパッチまたは次のマイナー バージョンにアップグレードできます。
  • バージョン間でダウングレードすることはできません。 古いバージョンに移行するには、 Azure IoT Operations をアンインストール し、目的のバージョンを再インストールします。
  • プレビュー バージョンから GA バージョンにアップグレードすることはできません。 Azure IoT Operations をアンインストールし、新しいバージョンを再インストールする必要があります。
  • GA バージョンからプレビュー バージョンにアップグレードすることはできません。 プレビュー バージョンをインストールする方法の詳細については、「プレビュー バージョン へのアップグレード」を参照してください。

注

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

アップグレード

Azure IoT Operations は、インスタンスの新しい GA バージョンがリリースされたときに、それにアップグレードすることをサポートしています。 Azure IoT Operations インスタンスがアップグレードの対象である場合は、Azure portal または Azure CLI を使用してアップグレードを実行できます。

最新バージョンの 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 対応クラスターの [拡張機能] ページで確認できます。

プレビュー バージョンへのアップグレード

Azure IoT Operations の最新バージョンがプレビュー段階にある場合があります。 Azure IoT Operations のバージョンを確認して、最新バージョンを確認します。 プレビュー リリース中はバージョンのアップグレードがブロックされ、Azure IoT Operations をアンインストールしてプレビュー バージョンを再インストールする必要があります。

プレビュー バージョンは、Azure CLI を使用してのみインストールできます。

  1. 既存の Azure IoT Operations インスタンスがある場合は、 Azure IoT Operations をアンインストール して新しいデプロイを実行する必要があります。

  2. --allow-preview フラグを使用して、Azure IoT Operations CLI 拡張機能の最新バージョンを追加します。

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

最新ではない特定のバージョンの Azure IoT Operations にアップグレードする場合は、 az iot ops get-versions 実行するか、 IoT Operations のバージョン を参照して、必要な Azure IoT Operations バージョンに関連付けられている CLI 拡張機能のバージョンを見つけることができます。 バージョン番号を取得し、次のコマンドを実行して、そのバージョンにアップグレードします。

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

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

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

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

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

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

サポートされているバージョン

Microsoft は常に、最新バージョンと以前の 2 つのマイナー バージョンの 3 つの一般公開 (GA) バージョンの Azure IoT Operations をいつでもサポートしています。

現在、使用できるマイナー バージョンは 2 つだけです。 Azure サポート は現在、次のバージョンで利用できます。

  • 1.2.x (最新のプレビュー バージョン)
  • 1.1.x (最新の GA バージョン)
  • 1.0.x (以前のマイナー GA バージョン)

Von Bedeutung

以前のマイナー バージョンでは、セキュリティ パッチは適用されません。 常に最新バージョンにアップグレードして、最新のセキュリティ更新プログラムと機能を確実に利用できるようにします。

現在のバージョンを確認するには、Azure portal で Azure IoT Operations インスタンスの概要ページを参照するか、Azure IoT Operations CLI az iot ops instance show コマンドを使用します。