教程 - 升级 Azure Kubernetes 服务 (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 cmdlet 检查群集的当前 Kubernetes 版本和区域。

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

   以下示例输出显示了群集的当前版本和位置：

   Name              CurrentKubernetesVersion      Location
   ----              ------------------------      --------
   myAKSCluster      1.33.7                        chinaeast2
   

2. 使用 cmdlet 列出群集所在的 Get-AzAksVersion 区域中可用的 Kubernetes 版本。

   Get-AzAksVersion -Location chinaeast2 | Where-Object OrchestratorVersion
   

   以下示例输出显示了 OrchestratorVersion 下的区域版本：

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

   若要确定潜在的升级目标，请将高于集群当前版本的版本与 Kubernetes 版本升级规则 进行比较。 此 cmdlet 列出了区域可用性，并且不会验证特定群集的升级路径。

使用 Azure 门户获取可用的群集版本

1. 登录 Azure 门户。

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.eastus.cx.prod.service.azk8s.cn",
  "id": "/subscriptions/<Subscription ID>/resourcegroups/myResourceGroup/providers/Microsoft.ContainerService/managedClusters/myAKSCluster",
  "kubernetesVersion": "1.34.10",
      "location": "eastus",
  "name": "myAKSCluster",
  "type": "Microsoft.ContainerService/ManagedClusters"
  ...
}

使用 Azure PowerShell 手动升级群集

使用 Set-AzAksCluster cmdlet 升级群集。 此示例将群集升级到版本 1.34.10：

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

以下示例输出显示了升级的结果。 该值 KubernetesVersion 现在与示例 cmdlet 中指定的版本匹配：

...
ProvisioningState        : Succeeded
MaxAgentPools            : 100
KubernetesVersion        : 1.34.10
CurrentKubernetesVersion : 1.34.10
...
ResourceGroupName        : myResourceGroup
Name                     : myAKSCluster
Type                     : Microsoft.ContainerService/ManagedClusters
    Location                 : chinaeast2
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 标准群集上，使用 az aks update 命令设置自动升级通道。 以下示例使用 stable 通道：

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

在 AKS 标准群集上，使用 Set-AzAksCluster cmdlet 设置自动升级通道。 以下示例使用 Stable 通道：

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

1. 在Azure portal中，导航到 AKS 群集资源。

2. 在服务菜单中的 “设置”下，选择“ 升级”。

3. 通过 Kubernetes 版本，选择 “升级版本”。

   

4. 对于 AKS 标准群集，请在 “升级 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  chinaeast2      myResourceGroup  1.34.10              1.34.10                   Succeeded            myaksclust-myresourcegroup-12ab34-cd56e7fg.hcp.chinaeast2.cx.prod.service.azk8s.cn

使用 Azure PowerShell 验证升级

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

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

以下示例输出显示 AKS 群集运行目标 Kubernetes 版本：

Name             Location     KubernetesVersion     ProvisioningState
----             --------     -----------------     -----------------
myAKSCluster     chinaeast2       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 cmdlet 删除资源组、容器服务和所有相关资源。

Remove-AzResourceGroup -Name myResourceGroup

1. 在Azure portal中，导航到 AKS 群集资源。
2. 在“概览” 页上，选择“删除” 。
3. 在“删除群集确认”页上，选择“删除”。