教學課程 - 升級 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 cmdlet 檢查叢集目前的 Kubernetes 版本和區域。

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

   以下範例輸出顯示叢集目前的版本與位置：

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

2. 使用 Get-AzAksVersion cmdlet 列出你的叢集所在區域中可用的 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 入口網站。

2. 前往您的 AKS 資源群組。

3. 在服務選單中，在 設定中選擇 升級。

4. 依 Kubernetes 版本，選擇 升級版本。

   

5. 在 升級 Kubernetes 版本 頁面，選擇 Kubernetes 版本 下拉選單，以查看可升級的 Kubernetes 版本。

   

如果沒有可用的升級選項，你的叢集可能已經是最新版本，或者叢集版本已經超出支援視窗。 如果該版本不支援且 AKS 沒有提供復原升級，請建立一個支援的 Kubernetes 版本的新叢集，並遷移你的工作負載。 欲了解更多資訊，請參閱 AKS 關於 Kubernetes 版本的支援政策。

使用 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 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                 : westus2
Tags                     :

手動升級叢集時，請使用 Azure 入口網站

1. 在 Azure 入口網站中，瀏覽至您的 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 cmdlet 設定自動升級通道。 以下範例使用 Stable 通道：

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

1. 在 Azure 入口網站中，瀏覽至您的 AKS 叢集資源。

2. 在服務選單中，在 設定中選擇 升級。

3. 依 Kubernetes 版本，選擇 升級版本。

   

4. 對於 AKS Standard 叢集，在 Upgrade 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 cmdlet 確認升級是否成功。

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 portal 驗證升級

1. 在 Azure 入口網站中，瀏覽至您的 AKS 叢集資源。
2. 在 概覽 頁面的 Essentials 下，檢查 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 入口網站中，瀏覽至您的 AKS 叢集資源。
2. 在 [概觀] 頁面上，按一下 [刪除]。
3. 在 [刪除叢集確認] 頁面上，選取 [刪除]。