チュートリアル - Azure Kubernetes Service (AKS) クラスターのアップグレード

Azure CLI を使用する場合、このチュートリアルでは、Azure CLI バージョン 2.34.1 以降が必要です。 バージョンを確認するには、az --version を実行します。 インストールまたはアップグレードする必要がある場合は、Azure CLI のインストールに関するページを参照してください。

Azure PowerShell を使用する場合、このチュートリアルでは、Azure PowerShell バージョン 5.9.0 以降が必要です。 バージョンを確認するには、Get-InstalledModule -Name Az を実行します。 インストールまたはアップグレードする必要がある場合は、Azure PowerShell のインストールに関するページをご覧ください。

Azure CLIを使用して使用可能なクラスター バージョンを取得する

アップグレードする前に、 az aks get-upgrades コマンドを使用して、クラスターで使用できる Kubernetes リリースを確認します。

az aks get-upgrades --resource-group myResourceGroup --name myAKSCluster

次の出力例は、クラスターの現在のバージョンを示し、 upgradesの下に新しいバージョンを一覧表示します。

  {
    "agentPoolProfiles": null,
    "controlPlaneProfile": {
      "kubernetesVersion": "1.33.7",
      ...
      "upgrades": [
        {
          "isPreview": null,
          "kubernetesVersion": "1.34.10"
        },
        {
          "isPreview": null,
          "kubernetesVersion": "1.34.9"
        }
      ]
    },
    ...
  }

Azure PowerShellを使用して使用可能なクラスター バージョンを取得する

1. アップグレードする前に、 Get-AzAksCluster コマンドレットを使用して、クラスターの現在の Kubernetes のバージョンとリージョンを確認します。

   Get-AzAksCluster -ResourceGroupName myResourceGroup -Name myAKSCluster |
     Select-Object -Property Name, CurrentKubernetesVersion, Location
   

   次の出力例は、クラスターの現在のバージョンと場所を示しています。

   Name              CurrentKubernetesVersion      Location
   ----              ------------------------      --------
   myAKSCluster      1.33.7                        westus2
   

2. Get-AzAksVersion コマンドレットを使用して、クラスターが存在するリージョンで使用可能な Kubernetes リリースを一覧表示します。

   Get-AzAksVersion -Location westus2 | Where-Object OrchestratorVersion
   

   次の出力例は、 OrchestratorVersionのリージョン バージョンを示しています。

   Default     IsPreview     OrchestratorType     OrchestratorVersion
   -------     ---------     ----------------     -------------------
                             Kubernetes               1.34.10
                             Kubernetes               1.34.9
   True                      Kubernetes               1.33.7
   ...
   

   潜在的なアップグレード ターゲットを特定するには、クラスターの現在のバージョンより新しいバージョンを Kubernetes バージョンのアップグレード規則と比較します。 このコマンドレットは、リージョンの可用性を一覧表示し、特定のクラスターのアップグレード パスを検証しません。

Azure ポータルを使用して使用可能なクラスター バージョンを取得する

1. Azure portal にサインインします。

2. AKS クラスター リソースに移動します。

3. サービス メニューの [設定] で、[ アップグレード] を選択します。

4. Kubernetes のバージョンで、[バージョンのアップグレード] を選択します。

   

5. [ Kubernetes バージョンのアップグレード ] ページで、 Kubernetes の [バージョン ] ドロップダウンを選択して、アップグレードに使用できる Kubernetes のバージョンを表示します。

   

アップグレードが利用できない場合は、クラスターが既に利用可能な最新バージョンであるか、クラスターのバージョンがサポート期間外である可能性があります。 バージョンがサポートされておらず、AKS で復旧アップグレードが提供されていない場合は、サポートされている Kubernetes バージョンで新しいクラスターを作成し、ワークロードを移行します。 詳細については、 Kubernetes バージョンの AKS サポート ポリシーを参照してください。

Azure CLIを使用してクラスターを手動でアップグレードする

az aks upgrade コマンドを使用してクラスターをアップグレードします。 この例では、クラスターをバージョン 1.34.10 にアップグレードします。

az aks upgrade \
    --resource-group myResourceGroup \
    --name myAKSCluster \
    --kubernetes-version 1.34.10

次の出力例は、アップグレードの結果を示しています。 kubernetesVersion値は、コマンド例で指定したバージョンと一致するようになりました。

{
  ...
  "agentPoolProfiles": [
    {
      ...
      "count": 3,
      "currentOrchestratorVersion": "1.34.10",
      "maxPods": 110,
      "name": "nodepool1",
      "nodeImageVersion": "AKSUbuntu-2204gen2containerd-202608.26.0",
      "orchestratorVersion": "1.34.10",
      "osType": "Linux",
      "upgradeSettings": {
        "drainTimeoutInMinutes": null,
        "maxSurge": "10%",
        "nodeSoakDurationInMinutes": null,
        "undrainableNodeBehavior": null
      },
      "vmSize": "Standard_DS2_v2",
      ...
    }
  ],
  ...
  "currentKubernetesVersion": "1.34.10",
  "dnsPrefix": "myAKSClust-myResourceGroup-12ab34",
  "enableRbac": false,
  "fqdn": "myaksclust-myresourcegroup-12ab34-cd56e7fg.hcp.westus2.azmk8s.io",
  "id": "/subscriptions/<Subscription ID>/resourcegroups/myResourceGroup/providers/Microsoft.ContainerService/managedClusters/myAKSCluster",
  "kubernetesVersion": "1.34.10",
  "location": "westus2",
  "name": "myAKSCluster",
  "type": "Microsoft.ContainerService/ManagedClusters"
  ...
}

Azure PowerShellを使用してクラスターを手動でアップグレードする

Set-AzAksCluster コマンドレットを使用してクラスターをアップグレードします。 この例では、クラスターをバージョン 1.34.10 にアップグレードします。

Set-AzAksCluster -ResourceGroupName myResourceGroup -Name myAKSCluster -KubernetesVersion 1.34.10

次の出力例は、アップグレードの結果を示しています。 KubernetesVersion値は、コマンドレット例で指定したバージョンと一致するようになりました。

...
ProvisioningState        : Succeeded
MaxAgentPools            : 100
KubernetesVersion        : 1.34.10
CurrentKubernetesVersion : 1.34.10
...
ResourceGroupName        : myResourceGroup
Name                     : myAKSCluster
Type                     : Microsoft.ContainerService/ManagedClusters
Location                 : westus2
Tags                     :

Azure ポータルを使用してクラスターを手動でアップグレードする

1. Azure portal で、ご使用の AKS クラスター リソースに移動します。

2. サービス メニューの [設定] で、[ アップグレード] を選択します。

3. Kubernetes のバージョンで、[バージョンのアップグレード] を選択します。

   

4. [ Kubernetes バージョンのアップグレード ] ページで、 Kubernetes の [バージョン ] ドロップダウンを選択して、アップグレードに使用できる Kubernetes のバージョンを表示します。

   

5. アップグレードする Kubernetes のバージョンを選択し、[ 保存] を選択します。

アップグレード期間は、ノードの数、サージ設定、ワークロードの中断の制約、ドレイン タイムアウト、ノード のソーク期間などの要因によって異なります。 既定のドレイン タイムアウトはノードあたり 30 分で、5 分から 24 時間まで構成できます。 ノードのソーク期間は、ノードあたり 0 ~ 30 分を追加できます。 詳細については、「 ノード プールの急増と使用できない設定のカスタマイズ」を参照してください。

Azure CLIを使用してクラスターの自動アップグレードを構成する

Azure PowerShellを使用してクラスターの自動アップグレードを構成する

Azure ポータルを使用してクラスターの自動アップグレードを構成する

AKS Standard クラスターで、 az aks update コマンドを使用して自動アップグレード チャネルを設定します。 次の例では、 stable チャネルを使用します。

az aks update --resource-group myResourceGroup --name myAKSCluster --auto-upgrade-channel stable

AKS Standard クラスターで、 Set-AzAksCluster コマンドレットを使用して自動アップグレード チャネルを設定します。 次の例では、 Stable チャネルを使用します。

Set-AzAksCluster -ResourceGroupName myResourceGroup -Name myAKSCluster -AutoUpgradeChannel Stable

1. Azure portal で、ご使用の AKS クラスター リソースに移動します。

2. サービス メニューの [設定] で、[ アップグレード] を選択します。

3. Kubernetes のバージョンで、[バージョンのアップグレード] を選択します。

   

4. AKS Standard クラスターの場合、[ Kubernetes バージョンのアップグレード ] ページで、[ 自動アップグレード ] ドロップダウンを選択し、[ 安定した状態で有効] を選択して、[ 保存] を選択します。

   

Azure CLIを使用してアップグレードを検証する

az aks show コマンドを使用して、アップグレードが成功したことを確認します。

az aks show --resource-group myResourceGroup --name myAKSCluster --output table

次の出力例は、AKS クラスターがターゲット Kubernetes バージョンを実行していることを示しています。

Name          Location    ResourceGroup    KubernetesVersion    CurrentKubernetesVersion  ProvisioningState    Fqdn
------------  ----------  ---------------  -------------------  ------------------------  -------------------  ----------------------------------------------------------------
myAKSCluster  westus2      myResourceGroup  1.34.10              1.34.10                   Succeeded            myaksclust-myresourcegroup-12ab34-cd56e7fg.hcp.westus2.azmk8s.io

Azure PowerShellを使用してアップグレードを検証する

Get-AzAksCluster コマンドレットを使用して、アップグレードが成功したことを確認します。

Get-AzAksCluster -ResourceGroupName myResourceGroup -Name myAKSCluster |
  Select-Object -Property Name, Location, KubernetesVersion, ProvisioningState

次の出力例は、AKS クラスターがターゲット Kubernetes バージョンを実行していることを示しています。

Name             Location     KubernetesVersion     ProvisioningState
----             --------     -----------------     -----------------
myAKSCluster     westus2       1.34.10               Succeeded

Azure ポータルを使用してアップグレードを検証する

1. Azure portal で、ご使用の AKS クラスター リソースに移動します。
2. [ 概要 ] ページの [ 要点] で、 Kubernetes のバージョン を確認して、アップグレードが成功したことを確認します。

Azure CLIを使用してクラスターを削除する

Azure PowerShellを使用してクラスターを削除する

Azure ポータルを使用してクラスターを削除する

az group delete コマンドを使用して、リソース グループ、コンテナー サービス、およびすべての関連リソースを削除します。

az group delete --name myResourceGroup --yes --no-wait

Remove-AzResourceGroup コマンドレットを使用して、リソース グループ、コンテナー サービス、およびすべての関連リソースを削除します。

Remove-AzResourceGroup -Name myResourceGroup

1. Azure portal で、ご使用の AKS クラスター リソースに移動します。
2. [概要] ページで [削除] を選択します。
3. [クラスターの削除の確認] ページで、[削除] を選択します。