Azure Kubernetes Service (AKS) ノードイメージのアップグレード

2025-05-03

Azure Kubernetes Service (AKS) では新しいノードイメージが定期的に提供されるため、最新の AKS 機能を使用するには、ノードイメージを頻繁にアップグレードすると便利です。 Linux のノードイメージは毎週更新され、Windows のノードイメージは毎月更新されます。イメージのアップグレードのお知らせは AKS リリースノートに含まれています。これらの更新がすべてのリージョンで提供されるまでには最大 1 週間かかる場合があります。また、ノードイメージのアップグレードを自動的に実行し、計画メンテナンスを使用してスケジュールすることもできます。詳細については、「ノードイメージを自動的にアップグレードする」をご覧ください。

この記事では、AKS クラスターノードイメージをアップグレードする方法と、Kubernetes バージョンをアップグレードせずにノードプールイメージを更新する方法について説明します。お使いのクラスターの Kubernetes バージョンのアップグレードの詳細については、「AKS クラスターのアップグレード」をご覧ください。

注

AKS クラスターでは、ノードに仮想マシンスケールセットを使用する必要があります。

ノードイメージのバージョン (例えば AKSUbuntu-2204 を AKSUbuntu-1804 に、または AKSUbuntu-2204-202308.01.0 を AKSUbuntu-2204-202307.27.0 に) ダウングレードしたりすることはできません。

AKS クラスターに接続する

[az aks get-credentials][az-aks-get-credentials] コマンドを使用して AKS クラスターに接続します。
```
az aks get-credentials \
    --resource-group $AKS_RESOURCE_GROUP \
    --name $AKS_CLUSTER
```

使用可能なノードイメージのアップグレードを確認する

az aks nodepool get-upgrades コマンドを使用して、使用可能なノードイメージのアップグレードを確認します。

az aks nodepool get-upgrades \
    --nodepool-name $AKS_NODEPOOL \
    --cluster-name $AKS_CLUSTER \
    --resource-group $AKS_RESOURCE_GROUP

出力で、latestNodeImageVersion の値を見つけてメモします。この値は、ノードプールで使用できる最新のノードイメージバージョンです。

az aks nodepool show コマンドを使用して、現在のノードイメージバージョンを確認して最新のバージョンと比較します。

az aks nodepool show \
    --resource-group $AKS_RESOURCE_GROUP \
    --cluster-name $AKS_CLUSTER \
    --name $AKS_NODEPOOL \
    --query nodeImageVersion

nodeImageVersion の値が latestNodeImageVersion と異なる場合は、ノードイメージをアップグレードできます。

すべてのノードプールのすべてのノードイメージをアップグレードする

az aks upgrade フラグを指定した --node-image-only コマンドを使用して、クラスター内のすべてのノードプール内のすべてのノードイメージをアップグレードします。
```
az aks upgrade \
    --resource-group $AKS_RESOURCE_GROUP \
    --name $AKS_CLUSTER \
    --node-image-only \
    --yes
```
kubectl get nodes コマンドを使用して、ノードイメージの状態を確認できます。

注

このコマンドは、お使いのシェルによって若干異なる場合があります。 Windows および PowerShell 環境の詳細については、Kubernetes JSONPath のドキュメントを参照してください。
```
kubectl get nodes -o jsonpath='{range .items[*]}{.metadata.name}{"\t"}{.metadata.labels.kubernetes\.azure\.com\/node-image-version}{"\n"}{end}'
```
アップグレードが完了したら、az aks show コマンドを使用して、更新されたノードプールの詳細を取得します。現在のノードイメージが nodeImageVersion プロパティに表示されます。
```
az aks show \
    --resource-group $AKS_RESOURCE_GROUP \
    --name $AKS_CLUSTER
```

特定のノードプールのアップグレード

az aks nodepool upgrade フラグを指定した --node-image-only コマンドを使用して、Kubernetes クラスターをアップグレードせずにノードプールの OS イメージを更新します。
```
az aks nodepool upgrade \
    --resource-group $AKS_RESOURCE_GROUP \
    --cluster-name $AKS_CLUSTER \
    --name $AKS_NODEPOOL \
    --node-image-only
```
kubectl get nodes コマンドを使用して、ノードイメージの状態を確認できます。

注

このコマンドは、お使いのシェルによって若干異なる場合があります。 Windows および PowerShell 環境の詳細については、Kubernetes JSONPath のドキュメントを参照してください。
```
kubectl get nodes -o jsonpath='{range .items[*]}{.metadata.name}{"\t"}{.metadata.labels.kubernetes\.azure\.com\/node-image-version}{"\n"}{end}'
```
アップグレードが完了したら、az aks nodepool show コマンドを使用して、更新されたノードプールの詳細を取得します。現在のノードイメージが nodeImageVersion プロパティに表示されます。
```
az aks nodepool show \
    --resource-group $AKS_RESOURCE_GROUP \
    --cluster-name $AKS_CLUSTER \
    --name $AKS_NODEPOOL
```

ノードサージを使用したノードイメージのアップグレード

ノードイメージのアップグレードプロセスを高速化するために、カスタマイズ可能なノードサージ値を使用して、ノードイメージをアップグレードすることができます。既定では、AKS は 1 つの追加ノードを使ってアップグレードを構成します。

az aks nodepool update フラグを指定した --max-surge コマンドを使用してノードサージのあるノードイメージをアップグレードし、アップグレードに使用するノードの数を構成します。

注

さまざまな --max-surge 設定のトレードオフの詳細については、「--max-surge」を参照してください。
```
az aks nodepool update \
    --resource-group $AKS_RESOURCE_GROUP \
    --cluster-name $AKS_CLUSTER \
    --name $AKS_NODEPOOL \
    --max-surge 33% \
    --no-wait
```

kubectl get nodes コマンドを使用して、ノードイメージの状態を確認できます。

kubectl get nodes -o jsonpath='{range .items[*]}{.metadata.name}{"\t"}{.metadata.labels.kubernetes\.azure\.com\/node-image-version}{"\n"}{end}'

az aks nodepool show コマンドを使用して、更新されたノードプールの詳細を取得します。現在のノードイメージが nodeImageVersion プロパティに表示されます。
```
az aks nodepool show \
    --resource-group $AKS_RESOURCE_GROUP \
    --cluster-name $AKS_CLUSTER \
    --name $AKS_NODEPOOL
```

次のステップ

最新のノードイメージの詳細については、AKS のリリースノートをご覧ください。
「AKS クラスターのアップグレード」によって Kubernetes バージョンをアップグレードする方法を確認します。
GitHub Actions でクラスターとノードプールのアップグレードを自動的に適用します。
複数ノードプールの詳細については、「複数ノードプールの作成」を参照してください。
AKS パッチとアップグレードガイダンスでベストプラクティスのアップグレードについて説明します。

次の方法で共有

Azure Kubernetes Service (AKS) ノード イメージのアップグレード

AKS クラスターに接続する

使用可能なノード イメージのアップグレードを確認する

すべてのノード プールのすべてのノード イメージをアップグレードする

特定のノード プールのアップグレード

ノード サージを使用したノード イメージのアップグレード