Arc リソース ブリッジをアップグレードする
この記事では、Arc リソース ブリッジのアップグレード方法と、アップグレードを実行できる 2 つの方法 (クラウド管理アップグレードまたは手動アップグレード) について説明します。 現在、一部のプライベート クラウド プロバイダーでは、Arc リソース ブリッジのアップグレードの処理方法が異なります。
プライベート クラウド プロバイダー
現在、プライベート クラウド プロバイダーによって、Arc リソース ブリッジのアップグレードの実行方法が異なります。 次の情報を参照して、特定のプロバイダーの Arc リソース ブリッジをアップグレードする方法を確認してください。
Arc 対応 VMware vSphere の場合、手動アップグレードとクラウド管理アップグレードを使用できます。 バージョン 1.0.15 以降のアプライアンスは、クラウド管理アップグレードに自動的にオプトインされます。 クラウド管理アップグレードは、アプライアンス VM が、最新バージョンではなく、n-3 でサポートされているバージョン内で確実に維持されるようにするのに役立ちます。 最新バージョンで維持する場合は、手動でアップグレードする必要があります。 どちらのアップグレード オプションも機能するには、アップグレードの前提条件が満たされている必要があります。 アプライアンスが間もなくサポート終了になる場合、Microsoft はいつでも Arc リソース ブリッジのクラウド管理アップグレードの実行を試みる場合があります。 Microsoft はクラウド管理アップグレードを提供していますが、お客様には引き続き、Arc リソース ブリッジがサポートされている n-3 バージョン内であることを確認する責任があります。 中断によりクラウド管理アップグレードが失敗し、Arc リソース ブリッジの手動アップグレードが必要になる場合があります。 Arc リソース ブリッジのサポート終了が近づいている場合は、クラウド管理のアップグレードを待つのではなく、手動でアップグレードして、サポートされているバージョンを維持することをお勧めします。
Azure Stack HCI 上の Azure Arc VM 管理 (プレビュー) の場合、アプライアンス バージョン 1.0.15 以降は、Azure Stack HCI ビルド 23H2 でのみ使用できます。 HCI 23H2 では、LCM ツールにより、すべての HCI、Arc リソース ブリッジ、拡張機能コンポーネントのアップグレードが "検証済みレシピ" パッケージとして管理されます。 22H2 から 23H2 に更新する前に、Arc リソース ブリッジのプレビュー バージョンを削除する必要があります。 他の HCI 環境コンポーネントから独立して Arc リソース ブリッジをアップグレードしようとすると、環境内で問題が発生し、ディザスター リカバリー シナリオになる場合があります。 詳細については、「Azure Stack HCI の更新について」を参照してください。
Arc 対応 System Center Virtual Machine Manager (SCVMM) に関しては、手動アップグレード機能を利用できるのはアプライアンス バージョン 1.0.15 以上においてです。 1.0.15 より前のバージョンを実行しているアプライアンスは、バージョン 1.0.15 以降に到達するために回復オプションを実行する必要があります。 回復操作の実行のための手順を確認してください。 これにより、新しいリソース ブリッジがデプロイされ、既存の Azure リソースが再接続されます。
前提条件
Arc リソース ブリッジをアップグレードする前に、次の前提条件を満たす必要があります。
アプライアンス VM は、一般提供バージョン (1.0.15 以降) である必要があります。 そうでない場合は、Arc リソース ブリッジ VM を再デプロイする必要があります。 Arc 対応 VMware/AVS を使用している場合は、ディザスター リカバリーを実行できます。 Arc 対応 SCVMM を使用している場合は、このディザスター リカバリー ガイドに従います。
アプライアンス VM はオンラインであり、
Running
状態で正常である必要があります。 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 バージョン内であることを確認する責任があります。 中断すると、クラウド管理アップグレードが失敗する可能性があります。 Arc リソース ブリッジのサポート終了が近づいている場合は、クラウド管理のアップグレードを待つのではなく、手動でアップグレードして、サポートされているバージョンを維持することをお勧めします。
リソース ブリッジの状態とアプライアンス バージョンを確認するには、管理マシンから az arcappliance show
コマンドを実行するか、Arc リソース ブリッジの Azure リソースを確認します。 アプライアンス VM が正常な実行中の状態ではない場合、クラウド管理アップグレードは失敗する可能性があります。
クラウド管理アップグレードは、Azure 経由で処理されます。 アプライアンス VM のアップグレードにともなう状態を反映するために、通知が Azure にプッシュされます。 リソース ブリッジがアップグレードまで進行する間、異なるアップグレード手順間でその状態が前進および後退する可能性があります。 アプライアンス VM の status
が Running
になり、provisioningState
が Succeeded
になると、アップグレードが完了します。
クラウド管理アップグレードの状態を確認するには、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 に移行し、組み込みのアップグレード管理ツールを使用します。 詳細については、「Azure Stack HCI バージョン 23H2 の更新プログラムについて」を参照してください。
バージョン リリース
Arc リソース ブリッジのバージョンは、Kubernetes バージョンなどの、アプライアンス イメージで使用される基になるコンポーネントのバージョンに関連付けられています。 アプライアンス イメージに変更が加わると、Arc リソース ブリッジのバージョンがインクリメントされます。 これは通常、新しい az arcappliance
CLI 拡張機能バージョンがリリースされたときに発生します。 通常、新しい拡張機能は、月 1 回のペースで月末または月初にリリースされます。 詳細なリリース情報については、Arc リソース ブリッジのリリース ノートを参照してください。
サポートされているバージョン
一般的に、Arc リソース ブリッジの最新リリース バージョンおよび以前の 3 つのバージョン (n-3) がサポートされます。 サポートされていないバージョンの Arc リソース ブリッジは、アップグレードするか、運用環境のサポートウィンドウに再デプロイする必要があります。
たとえば、現在のバージョンが 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 リソース ブリッジのバージョンはサポートされています。 リリースの最新情報を入手するには、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 リソースを確認します。
次のステップ
- Arc リソース ブリッジのメンテナンス操作について学習します。
- Arc リソース ブリッジのトラブルシューティングについて学習します。