Arc リソース ブリッジをアップグレードする

この記事では、Arc リソース ブリッジのアップグレード方法と、アップグレードを実行できる 2 つの方法 (クラウド管理アップグレードまたは手動アップグレード) について説明します。 現在、一部のプライベート クラウド プロバイダーでは、Arc リソース ブリッジのアップグレードの処理方法が異なります。

プライベート クラウド プロバイダー

現在、プライベート クラウド プロバイダーによって、Arc リソース ブリッジのアップグレードの実行方法が異なります。 次の情報を参照して、特定のプロバイダーの Arc リソース ブリッジをアップグレードする方法を確認してください。

Arc 対応の VMware vSphere の場合、手動アップグレードとクラウド アップグレードを使用できます。 バージョン 1.0.15 以降のアプライアンスは、クラウド管理アップグレードに自動的にオプトインされます。 どちらのアップグレード オプションも機能するには、アップグレードの前提条件が満たされている必要があります。 アプライアンスが間もなくサポート終了になる場合はいつでも、Microsoft は Arc リソース ブリッジのクラウド管理アップグレードの実行を試みる可能性があります。 Microsoft はクラウド管理アップグレードを提供していますが、お客様には引き続き、Arc リソース ブリッジがサポートされている n-3 バージョン内であることを確認する責任があります。 中断によりクラウド管理アップグレードが失敗し、Arc リソース ブリッジの手動アップグレードが必要になる場合があります。 サポート終了が近づいている場合は、サポートされているバージョンを維持するために手動でアップグレードしてください。  クラウド管理アップグレードを待つ必要はありません。 バージョン 1.0.15 より前のアプライアンスはすべて手動でアップグレードする必要があります。

Azure Stack HCI 上の Azure Arc VM 管理 (プレビュー) の場合、アプライアンス バージョン 1.0.15 以降は、Azure Stack HCI ビルド 23H2 でのみ使用できます。 HCI 23H2 では、LCM ツールにより、すべての HCI、Arc リソース ブリッジ、拡張機能コンポーネントのアップグレードが "検証済みレシピ" パッケージとして管理されます。 22H2 から 23H2 に更新する前に、Arc リソース ブリッジのプレビュー バージョンを削除する必要があります。 他の HCI 環境コンポーネントから独立して Arc リソース ブリッジをアップグレードしようとすると、環境内で問題が発生し、ディザスター リカバリー シナリオになる場合があります。 詳細については、Arc VM 管理に関する FAQ ページを参照してください。

Arc 対応 System Center Virtual Machine Manager (SCVMM) の場合、アプライアンス バージョン 1.0.14 以降で手動アップグレード機能を使用できます。 バージョン 1.0.14 より前のアプライアンスでは、バージョン 1.0.15 以降にするために回復オプションを実行する必要があります。 復旧操作の実行の手順を確認し、SCVMM からアプライアンス VM を削除して、復旧手順を実行します。 これにより、新しいリソース ブリッジがデプロイされ、既存の Azure リソースが再接続されます。

前提条件

Arc リソース ブリッジをアップグレードする前に、次の前提条件を満たす必要があります。

  • アプライアンス VM はオンラインであり、"実行中" の状態で正常である必要があります。 Arc リソース ブリッジの Azure リソースをチェックして確認できます。

  • アプライアンス VM の資格情報は最新である必要があります。 Arc リソース ブリッジ VM 内の資格情報が有効であることをテストするには、Azure から Arc 対応 VM で操作を実行するか、資格情報を更新して確認します。

  • 必要なイメージをダウンロードするには、管理マシン (最大 3.5 GB) とアプライアンス VM (35 GB) に十分な領域が必要です。

  • Arc 対応 VMware の場合、リソース ブリッジをアップグレードするにはデータストアに 200 GB の空き領域が必要です。 新しいテンプレートも作成されます。

  • アプライアンス VM IP (k8snodeippoolstart/end、VM IP 1/2) から msk8s.sb.tlu.dl.delivery.mp.microsoft.com、ポート 443 への送信接続を有効にする必要があります。 Arc リソース ブリッジに必要なエンドポイントの完全な一覧も有効になっていることを確認してください。

  • 手動でアップグレードを実行する場合、Arc リソース ブリッジを最初にデプロイした管理マシンからアップグレード コマンドを実行する必要があります。それでもアプライアンス構成ファイルか、管理マシン要件を満たし、かつ、アプライアンス構成ファイルが含まれるファイルが含まれます。

  • DHCP で構成された Arc リソース ブリッジはアップグレードできないため、運用環境ではサポートされません。 代わりに、新しい Arc リソース ブリッジは静的 IP 構成を使ってデプロイする必要があります。

概要

アップグレード プロセスは、予約アプライアンス VM IP (k8snodeippoolend IP、VM IP 2) を使用して、新しいリソース ブリッジをデプロイします。 新しいリソース ブリッジが稼働すると、アクティブなリソース ブリッジになります。 古いリソース ブリッジが削除され、そのアプライアンス VM IP (k8dsnodeippoolstart、VM IP 1) が、次のアップグレードで使用される新しい予約済みアプライアンス VM IP になります。

新しいリソース ブリッジのデプロイは、クラウドからのアプライアンス イメージ (最大 3.5 GB) のダウンロード、そのイメージを使用した新しいアプライアンス VM のデプロイ、新しいリソース ブリッジが実行されていることの確認、その Azure への接続、古いアプライアンス VM の削除、その古い IP を将来のアップグレードに使用するための予約の各作業から構成されます。

全体で、アップグレードには通常、ネットワーク速度に応じて 30 分以上かかります。 古い Arc リソース ブリッジから新しい Arc リソース ブリッジへの引き渡し中に、短い断続的なダウンタイムが発生する可能性があります。 前提条件が満たされていない場合、またはネットワーク (DNS、ファイアウォール、プロキシなど) の変更が Arc リソース ブリッジのネットワーク接続に影響を与える場合、追加のダウンタイムが発生する可能性があります。

Arc リソース ブリッジをアップグレードするには、Microsoft によって管理されるクラウド管理アップグレードと、管理者が Azure CLI コマンドを実行する手動アップグレードの 2 つの方法があります。

クラウド管理アップグレード

アプライアンス バージョン 1.0.15 以降を備えたサポートされているプライベート クラウド プロバイダー上の Arc リソース ブリッジは、クラウド管理アップグレードに自動的にオプトインされます。 クラウド管理アップグレードでは、間もなくサポート対象外となるアプライアンス バージョン上に Arc リソース ブリッジがある場合、Microsoft はいつでもそのアップグレードを試みる可能性があります。 クラウド管理アップグレードが機能するには、アップグレードの前提条件が満たされている必要があります。 Microsoft はクラウド管理アップグレードを提供していますが、お客様には引き続き、リソース ブリッジが正常で、オンラインであり、"実行中" の状態であり、サポートされている n-3 バージョン内であることを確認する責任があります。 中断すると、クラウド管理アップグレードが失敗する可能性があります。 サポート終了が近づいている場合は、サポートされているバージョンを維持するために手動でアップグレードしてください。  クラウド管理アップグレードを待つ必要はありません。

リソース ブリッジの状態とアプライアンス バージョンを確認するには、管理マシンから az arcappliance show コマンドを実行するか、Arc リソース ブリッジの Azure リソースを確認します。 アプライアンス VM が正常な実行中の状態ではない場合、クラウド管理アップグレードは失敗する可能性があります。

クラウド管理アップグレードは、Azure 経由で処理されます。 アプライアンス VM のアップグレードにともなう状態を反映するために、通知が Azure にプッシュされます。 リソース ブリッジがアップグレードまで進行する間、異なるアップグレード手順間でその状態が前進および後退する可能性があります。 アプライアンス VM の statusRunning になり、provisioningStateSucceeded になると、アップグレードが完了します。

クラウド管理アップグレードの状態を確認するには、ARM で Azure リソースを確認するか、管理マシンから次の Azure CLI コマンドを実行します。

az arcappliance show --resource-group [REQUIRED] --name [REQUIRED] 

手動アップグレード

Arc リソース ブリッジは、管理マシンから手動でアップグレードできます。 アップグレードを試みる前に、すべてのアップグレードの前提条件を満たす必要があります。 管理マシンには、kubeconfig とアプライアンス構成ファイルがローカルに保存されている必要があります。そうでないと、アップグレードを実行できません。

手動アップグレードは通常、ネットワーク速度に応じて 30 ~ 90 分かかります。 upgrade コマンドは、Arc リソース ブリッジをその次のアプライアンス バージョンに変更します。これは、使用可能な最新のアプライアンス バージョンではない場合があります。 サポートされているバージョンに到達するには、複数のアップグレードが必要になる場合があります。 Arc リソース ブリッジの Azure リソースを確認することで、アプライアンスのバージョンを確認できます。

アップグレード前に、arcappliance 用の最新の Azure CLI 拡張機能が必要です。

az extension add --upgrade --name arcappliance 

リソース ブリッジを手動でアップグレードするには、次のコマンドを使用します。

az arcappliance upgrade <private cloud> --config-file <file path to ARBname-appliance.yaml> 

たとえば、VMware 上のリソース ブリッジをアップグレードするには、次を実行します。az arcappliance upgrade vmware --config-file c:\contosoARB01-appliance.yaml

SCVMM 上でリソース ブリッジをアップグレードするには、az arcappliance upgrade scvmm --config-file c:\contosoARB01-appliance.yaml を実行します。

Azure Stack HCI 上でリソース ブリッジをアップグレードするには、23H2 に移行し、組み込みのアップグレード管理ツールを使用してください。 詳細情報はこちらにあります。

バージョン リリース

Arc リソース ブリッジのバージョンは、Kubernetes バージョンなどの、アプライアンス イメージで使用される基になるコンポーネントのバージョンに関連付けられています。 アプライアンス イメージに変更が加わると、Arc リソース ブリッジのバージョンがインクリメントされます。 これは通常、新しい az arcappliance CLI 拡張機能バージョンがリリースされたときに発生します。 通常、新しい拡張機能は、月 1 回のペースで月末または月初にリリースされます。 詳細なリリース情報については、GitHub 上の Arc リソース ブリッジのリリース ノートを参照してください。

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

一般的に、アプライアンス バージョン 1.0.15 以降では、Arc リソース ブリッジの最新リリース バージョンおよび以前の 3 つのバージョン (n-3) がサポートされています。 アプライアンスのバージョンが 1.0.15 より前の Arc リソース ブリッジは、実稼働サポート ウィンドウに含まれるために、最低でもアプライアンスのバージョンが 1.0.15 になるようにアップグレードまたは再デプロイする必要があります。

たとえば、現在のバージョンが 1.0.18 の場合、一般的に n-3 でサポートされるバージョンは次のようになります。

  • 現在のバージョン: 1.0.18
  • n-1 バージョン: 1.0.17
  • n-2 バージョン: 1.0.16
  • n-3 バージョン: 1.0.15

サポートされているバージョンが連続していない場合があります。 たとえば、バージョン 1.0.18 がリリースされ、後でバグが含まれていることがわかりました。 ホット フィックスがバージョン 1.0.19 でリリースされ、バージョン 1.0.18 は削除されます。 このシナリオでは、n-3 でサポートされるバージョンは 1.0.19、1.0.17、1.0.16、1.0.15 になります。

Arc リソース ブリッジは通常、月次周期で月末に新しいバージョンをリリースしますが、遅延によってリリース日が延期される可能性があります。新しいリリースがいつ公開されるかに関わらず、n-3 以内のサポートされているバージョンであれば、Arc リソース ブリッジのバージョンはサポートされています。 リリースの最新情報を入手するには、GitHub 上の Arc リソース ブリッジのリリース ノートにアクセスしてください。

リソース ブリッジがサポートされるバージョン (n-3) のいずれにもアップグレードされないと、サポート対象からはずれるため、サポートされません。 これが発生すると、Arc リソース ブリッジで使用されるコンポーネント サービスに互換性がなくなる可能性があるため、サポートされないリソース ブリッジを新しいバージョンに常にアップグレードすることができるとは限らない場合があります。 さらに、サポートされないリソース ブリッジは、信頼性の高い監視と正常性のメトリックを提供できない場合があります。

Arc リソース ブリッジをサポートされるバージョンにアップグレードできない場合は、それを削除して、新しいリソース ブリッジをデプロイする必要があります。 使用しているプライベート クラウド製品によっては、そのリソース ブリッジを既存のリソースに再接続するために、他の手順が必要になる場合があります。 詳しくは、パートナー製品の Arc リソース ブリッジ復旧に関するドキュメントをご確認ください。

通知とアップグレードの可用性

Arc リソース ブリッジがバージョン n-3 の場合は、次のバージョンがリリースされるとリソース ブリッジがサポート対象外になることを知らせるメール通知を受け取ることがあります。 この通知を受け取った場合は、手動アップグレードで問題のデバッグ時間を確保したり、クラウド管理アップグレードでリソース ブリッジをアップグレードできなかった場合にサポート チケットを送信したりできるように、リソース ブリッジをできるだけ早くアップグレードしてください。

Arc リソース ブリッジに使用可能なアップグレードがあるかどうかを確認するには、次のコマンドを実行します。

az arcappliance get-upgrades --resource-group [REQUIRED] --name [REQUIRED] 

Arc リソース ブリッジ アプライアンスの現在のバージョンを確認するには、az arcappliance show を実行するか、Arc リソース ブリッジの Azure リソースを確認します。

次のステップ