クラスター ノード イメージのアップグレード中に Windows Server ノードプールが Gen2 にアップグレードされない
この記事では、Microsoft Azure Kubernetes Service (AKS) でクラスター ノード イメージがアップグレードされるときに、Windows Server ノードプールが Gen1 から Gen2 仮想マシン (VM) に自動的にアップグレードされないシナリオのトラブルシューティング方法について説明します。
Note
このシナリオは、Linux ノードプール上の Gen2 VM には適用されません。
前提条件
現象
Azure CLI で次のいずれかの方法を使用してノード イメージをアップグレード 場合 既存の Windows Server ノードプールは Gen1 から Gen2 にアップグレードされません。
クラスター全体のアップグレード ( az aks upgrade コマンドを使用)
特定の nodepool アップグレード ( az aks nodepool upgrade コマンドを使用)
原因
原因 1: 既存のノードプールが Gen2 VM に自動的にアップグレードされない
設計上、ノード イメージのアップグレードでは、既存のノード プールの更新またはアップグレードはサポートされていません。 az aks upgradeコマンドとaz aks nodepool upgrade コマンドは、ノード イメージのみを (新しいノード イメージ バージョンに) アップグレードします。 これらのコマンドは、対応する VM の生成をアップグレードしません。
原因 2: クラスターを Kubernetes バージョン 1.25 以降のバージョンにアップグレードすると、OS のみがアップグレードされる
クラスターを Kubernetes バージョン 1.25 以降のバージョンにアップグレードすると、オペレーティング システム (OS) のみが (Windows Server 2022 に) アップグレードされます。 既存のノードプールは影響を受けません。 関連付けられている VM スケール セットには、同じ Gen1 VM を持つ VM が含まれます。
原因 3: 有効な VM サイズを指定せずに Windows Server 2022 を使用して作成されたクラスターのアップグレードと新しいノードプール
クラスターを Kubernetes バージョン 1.25 以降のバージョンにアップグレードした後、ノードプールの VM で使用する OS として Windows Server 2022 を指定します。 ただし、次のいずれかの理由により、VM は Gen2 ノード イメージ参照を使用しません。
VM サイズを指定せず、リージョンの既定の VM サイズでは Gen2 VM がサポートされていません。
Gen1 専用 VM サイズを指定します。
既定の OS を Windows Server 2019 (Windows2019) から Windows Server 2022 (Windows2022) にアップグレードしても、既存のノードプールは別の VM 世代に自動的にアップグレードされません。
ソリューション
クラスターをアップグレードし、次のガイドラインに従って、そのクラスターで Gen2 VM サイズ をサポートする新しい Windows Server ノードプールを作成します。
| Kubernetes クラスターのアップグレード バージョン | クラスター作成のガイドライン |
|---|---|
| 1.25 以降のバージョン | az aks create コマンドを実行してクラスターを作成する場合は、--node-vm-size パラメーターを Gen2 VM サイズに設定します。 |
| 1.25 より前のバージョン | az aks create コマンドを実行してクラスターを作成する場合は、--os-sku パラメーター値を Windows2022 に設定し、--node-vm-size パラメーター値を Gen2 VM サイズに設定します。 |
Note
Gen2 VM のサイズとオペレーティング システムを Windows Server 2019 として指定すると、次のエラー メッセージを伴う ErrorCode_Windows2019NotSupportedWithGen2VM エラー コードが表示されます。
<virtual-machine-size> は Gen 2 専用 VM です。 Windows 2019 では、Gen 2 VM はサポートされていません。 ただし、Gen 1 VM のサイズを選択するか、os_skuを 2022 に設定できます。
この問題を回避するには、クラスターの作成時に次のいずれかのオプションを選択します。
Windows Server 2019 と共に使用する Gen1 VM サイズを選択します。
オペレーティング システム SKU を Windows Server 2022 に設定して、Gen2 VM と共に使用します。
お問い合わせはこちらから
質問がある場合やヘルプが必要な場合は、サポート要求を作成するか、Azure コミュニティ サポートにお問い合わせください。 Azure フィードバック コミュニティに製品フィードバックを送信することもできます。