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

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

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

  次の出力例では、現在のバージョンが 1.28.9 として示され、使用できるバージョンが upgrades の下に一覧表示されます。

    {
      "agentPoolProfiles": null,
      "controlPlaneProfile": {
        "kubernetesVersion": "1.28.9",
        ...
        "upgrades": [
          {
            "isPreview": null,
            "kubernetesVersion": "1.29.4"
          },
          {
            "isPreview": null,
            "kubernetesVersion": "1.29.2"
          }
        ]
      },
      ...
    }
  

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

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

   次の出力例では、現在のバージョンが 1.28.9 で、場所が eastus であることが示されています。

   Name              CurrentKubernetesVersion      Location
   ----              ------------------------      --------
   myAKSCluster      1.28.9                        eastus
   

2. Get-AzAksVersion コマンドレットを使用して、クラスターが存在するリージョンで使用できる Kubernetes アップグレード リリースを確認します。

   Get-AzAksVersion -Location eastus | Where-Object OrchestratorVersion
   

   次の出力例では、OrchestratorVersion の下に使用可能なバージョンが示されています。

   Default     IsPreview     OrchestratorType     OrchestratorVersion
   -------     ---------     ----------------     -------------------
                             Kubernetes               1.29.4
                             Kubernetes               1.29.2
   True                      Kubernetes               1.28.9
                             Kubernetes               1.28.5
   ...
   

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

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

3. サービス メニューの [設定] で、[クラスターの構成] を選択します。

4. [Kubernetes バージョン] で [Upgrade version] (バージョンのアップグレード) を選択します。 これにより、新しいページにリダイレクトされます。

5. [Kubernetes バージョン] で、バージョンを選択して利用可能なアップグレードを確認します。

   

アップグレードを使用できない場合、サポートされている Kubernetes バージョンを使用して新しいクラスターを作成し、既存のクラスターからこの新しいクラスターにワークロードを移行します。 利用可能なアップグレードがない場合、クラスターを新しい Kubernetes バージョンにアップグレードすることはサポートされていません。

• az aks upgrade コマンドを使用してクラスターをアップグレードします。

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

• アップグレード操作を確認し、コントロール プレーン "および" すべてのノード プールを選択したバージョンの Kubernetes にアップグレードするかどうかを確認するプロンプトが表示されます。

   Are you sure you want to perform this operation? (y/N): y
  Since control-plane-only argument is not specified, this will upgrade the control plane AND all nodepools to version 1.29.2. Continue? (y/N): y
  

  Note

  一度に 1 つのマイナー バージョンのみをアップグレードできます。 たとえば、1.14.x から 1.15.x にアップグレードすることはできますが、1.14.x から 1.16.x に直接アップグレードすることはできません。 1.14.x から 1.16.x にアップグレードするには、最初に 1.14.x から 1.15.x にアップグレードした後、1.15.x から 1.16.x にもう一度アップグレードする必要があります。

  次の出力例には、1.29.2 にアップグレードした結果が示されています。 kubernetesVersion が 1.29.2 として表示されていることがわかります。

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

• Set-AzAksCluster コマンドを使用してクラスターをアップグレードします。

  Set-AzAksCluster -ResourceGroupName myResourceGroup -Name myAKSCluster -KubernetesVersion <KUBERNETES_VERSION>
  

  Note

  一度に 1 つのマイナー バージョンのみをアップグレードできます。 たとえば、1.14.x から 1.15.x にアップグレードすることはできますが、1.14.x から 1.16.x に直接アップグレードすることはできません。 1.14.x から 1.16.x にアップグレードするには、まず 1.14.x から 1.15.x にアップグレードします。その後、1.15.x から 1.16.x にもう一度アップグレードします。

  次の出力例には、1.29.2 にアップグレードした結果が示されています。 KubernetesVersion が 1.29.2 として表示されていることがわかります。

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

1. Azure portal で自分の AKS クラスターに移動します。

2. サービス メニューの [設定] で、[クラスターの構成] を選択します。

3. [Kubernetes バージョン] で [Upgrade version] (バージョンのアップグレード) を選択します。 これにより、新しいページにリダイレクトされます。

4. [Kubernetes バージョン] で目的のバージョンを選択し、[保存] を選択します。

   

ノード数にもよりますが、クラスターのアップグレードには数分かかります。

• patch に設定されている --auto-upgrade-channel パラメータを含む az aks update コマンドを使用して、クラスターにアップグレード チャネルを設定します。

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

• -AutoUpgradeChannel パラメーターを Patch に設定した Set-AzAksCluster コマンドレットを使用して、クラスターに自動アップグレード チャネルを設定します。

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

1. Azure portal で自分の AKS クラスターに移動します。

2. サービス メニューの [設定] で、[クラスターの構成] を選択します。

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

4. 自動アップグレードの場合、[パッチで有効にする (推奨)]>[保存] を選択します。

   

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

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

  次の出力例は、AKS クラスターで KubernetesVersion 1.27.3 が実行されていることを示しています。

  Name          Location    ResourceGroup    KubernetesVersion    CurrentKubernetesVersion  ProvisioningState    Fqdn
  ------------  ----------  ---------------  -------------------  ------------------------  -------------------  ----------------------------------------------------------------
  myAKSCluster  eastus      myResourceGroup  1.29.2               1.29.2                    Succeeded            myaksclust-myresourcegroup-19da35-bd54a4be.hcp.eastus.azmk8s.io
  

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

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

  次の出力例は、AKS クラスターで KubernetesVersion 1.27.3 が実行されていることを示しています。

  Name             Location     KubernetesVersion     ProvisioningState
  ----             --------     -----------------     -----------------
  myAKSCluster     eastus       1.29.2                Succeeded
  

1. Azure portal で自分の AKS クラスターに移動します。

2. [概要] ページで [Kubernetes バージョン] を選び、前のステップでインストールした最新バージョンであることを確認します。

   

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

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

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

  Remove-AzResourceGroup -Name myResourceGroup
  

1. Azure portal で自分の AKS クラスターに移動します。

2. [概要] ページで [削除] を選択します。

3. [クラスターの削除の確認] ページで、[削除] を選択します。