教程 - 升级 Azure Kubernetes 服务 (AKS) 群集

• 升级前，使用 az aks get-upgrades 命令检查哪些 Kubernetes 版本可用于群集。

  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 cmdlet 检查哪些 Kubernetes 版本可用于群集和群集所在的区域。

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

   以下示例输出显示当前版本为 1.28.9，位置为“eastus”：

   Name              CurrentKubernetesVersion      Location
   ----              ------------------------      --------
   myAKSCluster      1.28.9                 chinaeast2
   

2. 使用 Get-AzAksVersion cmdlet 检查群集所在的区域中可用的 Kubernetes 升级版本。

   Get-AzAksVersion -Location chinaeast2 | 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 门户。

2. 导航到 AKS 群集。

3. 在服务菜单中的“设置”下，选择“群集配置”。

4. 在“Kubernetes 版本”中，选择“升级版本”。 这样，可以重定向到新页。

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
  

  注意

  一次只能升级一个次要版本。 例如，可以从 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.cx.prod.service.azk8s.cn",
    "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 cmdlet 升级群集。

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

  注意

  一次只能升级一个次要版本。 例如，可以从 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                 : chinaeast2
  Tags                     :
  

1. 在 Azure 门户中，导航到 AKS 群集。

2. 在服务菜单中的“设置”下，选择“群集配置”。

3. 在“Kubernetes 版本”中，选择“升级版本”。 这样，可以重定向到新页。

4. 在“Kubernetes 版本”中，选择所需的版本，然后选择“保存”。

   

升级群集需要几分钟时间，具体取决于有多少节点。

• 使用 --auto-upgrade-channel 参数设为 patch 的 az aks update 命令在群集上设置自动升级通道。

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

• 使用 -AutoUpgradeChannel 参数设为 Patch 的 Set-AzAksCluster cmdlet 在群集上设置自动升级通道。

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

1. 在 Azure 门户中，导航到 AKS 群集。

2. 在服务菜单中的“设置”下，选择“群集配置”。

3. 在“Kubernetes 版本”中，选择“升级版本”。

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.cx.prod.service.azk8s.cn
  

• 使用 Get-AzAksCluster cmdlet 确认升级成功。

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

  以下示例输出显示 AKS 群集运行 KubernetesVersion 1.27.3：

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

1. 在 Azure 门户中，导航到 AKS 群集。

2. 在“概述”页上选择“Kubernetes 版本”，确保它是在上一步安装的最新版本。

   

• 使用 az group delete 命令删除资源组、容器服务和所有相关资源。

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

• 使用 Remove-AzResourceGroup cmdlet 删除资源组、容器服务和所有相关资源。

  Remove-AzResourceGroup -Name myResourceGroup
  

1. 在 Azure 门户中，导航到 AKS 群集。

2. 在“概览” 页上，选择“删除” 。

3. 在“删除群集确认”页上，选择“删除”。