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

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

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

  以下示例输出显示当前版本为 1.26.6，可用版本在 upgrades 下列出：

  {
    "agentPoolProfiles": null,
    "controlPlaneProfile": {
      "kubernetesVersion": "1.26.6",
      ...
      "upgrades": [
        {
          "isPreview": null,
          "kubernetesVersion": "1.27.1"
        },
        {
          "isPreview": null,
          "kubernetesVersion": "1.27.3"
        }
      ]
    },
    ...
  }
  

1. 升级前，请使用 Get-AzAksCluster cmdlet 检查哪些 Kubernetes 版本可用于群集和群集所在的区域。

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

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

   Name            KubernetesVersion       Location
   ----            -----------------       --------
   myAKSCluster    1.26.6                  chinaeast2
   

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

   Get-AzAksVersion -Location chinaeast2 | Where-Object OrchestratorVersion
   

   以下示例输出显示 OrchestratorVersion 下的可用版本：

   Default     IsPreview     OrchestratorType     OrchestratorVersion
   -------     ---------     ----------------     -------------------
                             Kubernetes           1.27.1
                             Kubernetes           1.27.3
   

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
  

  注意

  一次只能升级一个次要版本。 例如，可以从 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.27.3 的结果。 请注意，kubernetesVersion 现在显示 1.27.3：

  {
    "agentPoolProfiles": [
      {
        "count": 3,
        "maxPods": 110,
        "name": "nodepool1",
        "osType": "Linux",
        "vmSize": "Standard_DS1_v2",
      }
    ],
    "dnsPrefix": "myAKSClust-myResourceGroup-19da35",
    "enableRbac": false,
    "fqdn": "myaksclust-myresourcegroup-19da35-bd54a4be.hcp.chinaeast2.cx.prod.service.azk8s.cn",
    "id": "/subscriptions/<Subscription ID>/resourcegroups/myResourceGroup/providers/Microsoft.ContainerService/managedClusters/myAKSCluster",
    "kubernetesVersion": "1.27.3",
    "location": "chinaeast2",
    "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.27.3 的结果。 请注意，KubernetesVersion 现在显示 1.27.3：

  ProvisioningState       : Succeeded
  MaxAgentPools           : 100
  KubernetesVersion       : 1.27.3
  PrivateFQDN             :
  AgentPoolProfiles       : {default}
  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.27.3               1.27.3                    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.27.3              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. 在“删除群集确认”页上，选择“删除”。