升級 Azure Kubernetes Service (AKS) 叢集

發行項
02/28/2024

適用於：Azure Stack HCI 版本 23H2

在管理應用程式和叢集生命周期過程中，您可能想要升級至最新可用的 Kubernetes 版本。升級牽涉到移至較新版本的 Kubernetes、套用作業系統 (操作系統) 版本更新， (修補) 或兩者。 AKS Arc 支援使用最新的 OS 和運行時間更新，在工作負載叢集中升級 (或修補) 節點。

所有升級都會以連續的滾動方式執行，以確保工作負載的可用性不受中斷。當您將包含較新版組建的新 Kubernetes 背景工作角色節點引進叢集時，會將資源從舊節點移至新節點。成功完成之後，舊節點會解除委任，並從叢集中移除。

開始之前

如果您使用 Azure CLI，本文需要 Azure CLI 2.34.1 版或更新版本。執行 az --version 以尋找版本。如果您需要安裝或升級 CLI，請參閱安裝 Azure CLI。

檢查是否有可用的升級

使用下列命令檢查您的叢集可用的 Kubernetes 版本：

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

下列範例輸出會顯示目前的版本為 1.24.11 ，並列出下方 upgrades的可用版本：

{  
  "agentPoolProfiles": [  
    {  
      "kubernetesVersion": "1.24.11",  
      "upgrades": [  
        {  
          "kubernetesVersion": "1.25.7"  
        }  
      ]  
    }  
  ],  
  "controlPlaneProfile": {  
    "kubernetesVersion": "1.24.11",  
    "name": "aksarc-testupgrade",  
    "osType": "Linux",  
    "upgrades": [  
      {  
        "kubernetesVersion": "1.25.7"  
      }  
    ]  
  },  
  ...  
  "provisioningState": "Succeeded",  
  ...  
}

升級 Kubernetes 版本

當您升級支援的 AKS 叢集時，您無法略過 Kubernetes 次要版本。您必須依主要版本號碼循序執行所有升級。例如，允許從 1.24.x 升級至 1.25.x 或 1.25.x 到 1.26.x。不允許 1.24.x 到 1.26.x。

注意

如果未指定任何修補程式，叢集會自動升級至指定次要版本的最新 GA 修補程式。例如，將設定 --kubernetes-version 為 1.25 會導致叢集升級至 1.25.7。

您可以使用下列命令升級叢集：

az aksarc upgrade \
  --resource-group myResourceGroup \
  --name myAKSCluster \
  --kubernetes-version <KUBERNETES_VERSION>

使用 show 命令確認升級成功：

az aksarc show --resource-group myResourceGroup --name myAKSCluster

下列範例輸出顯示叢集現在執行 1.25.7：

{  
"extendedLocation": {  
  "name":
"/subscriptions/<subscription>/resourcegroups/<resource group>/providers/microsoft.extendedlocation/customlocations/<custom
location>",  
  "type": "CustomLocation"  
},  
"id": "/subscriptions/<subscription>/resourceGroups/<resource group>/providers/Microsoft.Kubernetes/connectedClusters/aksarc-testupgrade/providers/Microsoft.HybridContainerService/provisionedClusterInstances/default",  
"name": "default",  
"properties": {  
  "agentPoolProfiles": [  
    {  
    }  
  ],  
  "controlPlane": {  
    "availabilityZones": null,  
    "controlPlaneEndpoint": {  
      "hostIp": null,  
      "port": null  
    },  
    "count": 1,  
    "linuxProfile": {  
      "ssh": {  
        "publicKeys": null  
      }  
    },  
    "name": null,  
    "nodeImageVersion": null,  
    "osSku": "CBLMariner",  
    "osType": "Linux",  
    "vmSize": "Standard_A4_v2"  
  },  
  "kubernetesVersion": "1.25.7",  
...  
  "provisioningState": "Succeeded",  
  ...  
},  
....  
"type": "microsoft.hybridcontainerservice/provisionedclusterinstances"  
}

重要

當您從略過兩個或多個次要版本的不支援版本執行升級時，升級無法保證適當的功能。如果您的版本明顯過期，建議您改為重新建立叢集。

在升級作業期間，和 currentState 指標都會provisioningState顯示升級訊息，以反映進行中的程式。不過，如果作業逾時，provisioningState則會顯示 [失敗]，同時繼續顯示 [升級]，因為currentState升級會在背景繼續執行。不需要採取任何動作;升級會繼續進行，直到完成為止。

更新作業系統 (操作系統) 版本

只有在新映像不需要不同的 Kubernetes 版本時，才會將背景工作節點更新為較新版本的節點映射，而不需要變更 Kubernetes 版本才能運作。目前，AKS Arc 不支援支援所有 Kubernetes 版本的僅限節點映像更新。如果您需要更新節點映像，您必須將叢集升級至最新的 Kubernetes 版本，以確保所有節點映射更新都已納入。

重要

嘗試使用 node-image-only 旗標時，您會收到訊息，指出尚未支援此功能。

Share via