在 Azure Kubernetes Service (AKS) 中調整節點集區

您可能想要變更虛擬機器 (VM) 的大小,以容納不斷增加的部署數量或執行更大的工作負載。 一定要透過 AKS API 調整節點池大小。 請勿直接調整底層 虛擬機器擴展集 的大小,如 AKS 支援政策所述:

AKS 代理程式節點在 Azure 入口網站中會顯示為一般的 Azure IaaS 資源。 但這些虛擬機器會部署到自訂的 Azure 資源群組 (通常前面加上 MC_*)。 您無法使用 IaaS API 或資源直接自訂這些節點。 任何未透過 AKS API 完成的自訂變更都不會透過升級、調整、更新或重新開機來保存。

重要事項

本文適用於基於 虛擬機器擴展集 的節點池。 使用 虛擬機器 基礎的節點池時,您可以透過單一 Azure CLI 指令更新現有節點池中的 VM 大小,並在同一節點池中設定多個虛擬機大小。 如需詳細資訊,請參閱 虛擬機器節點集區文件。

選擇調整大小的方法

我們建議您以單一指令就地調整 節點池 大小。 如果原地調整無法支援您的情境,請 建立一個與目標虛擬機大小相同的節點池 ,並將工作負載移至該池。

選項 1:在原地調整節點池大小

當您使用 az aks nodepool update --node-vm-size <new-size>,變更現有節點池的虛擬機大小(SKU)時,AKS 會透過以下方式進行滾動升級:

  1. 使用目標 VM 大小快速擴增新節點。
  2. 正在封鎖隔離並清空舊節點。
  3. 刪除舊的節點。

重新調整推出的大小如何運作

重新調整推出的大小會使用與節點映像升級和 Kubernetes 版本升級相同的滾動升級引擎,因此會遵循節點集區上已設定的下列升級相關設定。 尤其是,重新調整大小遵循:

  • 最大突增 (--max-surge):控制在部署過程中新增多少與目標虛擬機大小相同的節點。 較高的值會更快調整池大小,但會消耗更多運算與 IP 配額;較低的數值較慢,但干擾較小。 AKS 預設為 1,且 33% 建議用於生產節點池。
  • 節點清理逾時 (--drain-timeout):AKS 在強制刪除每個舊節點前,等待 pod 驅逐的時間。 預設值為 30 分鐘。 將此項目結合適當的 PodDisruptionBudgets ,所以工作負載得以安全清空。
  • 節點靜置時間(--node-soak-duration):在新節點達到 Ready 狀態後,AKS 等待多久才進入下一個批次。 這有助於讓工作負載先在新的 VM 規格上穩定運作,再繼續部署。

先決條件

  • 已安裝並設定 Azure CLI 2.93.0 或更新版本。 執行 az --version 以尋找版本。 如果您需要安裝或升級,請參閱 安裝 Azure CLI。
  • AKS API 版本 2026-02-01 或更新版本。
  • 由於調整大小會重複使用 最大突波升級 管線,因此適用相同的先決條件:
    • 確保您的訂閱有足夠的目標 VM 大小替換容量,以及可用於突波節點的子網路 IP。
    • 您的 PodDisruptionBudgets 允許至少一次淘汰一個複本,否則在清空節點時調整大小可能會被阻擋。
    • 關於端對端的建議,請參閱 AKS 節點池升級的最佳實務。

調整節點池大小

使用 az aks nodepool update 帶有 --node-vm-size 參數的指令來更改現有基於 VMSS 的節點池的虛擬機大小:

az aks nodepool update \
    --resource-group MyResourceGroup \
    --cluster-name MyManagedCluster \
    --name nodepool1 \
    --node-vm-size Standard_D4s_v3

附註

就地調整大小需要額外容量,才能先以目標 VM 大小佈建新節點,再清空舊節點。 如果節點集區已設定為 --max-surge 0(也就是說,--max-unavailable 生效),則調整大小要求會遭到拒絕,並傳回 400 Bad Request。 若要繼續,使用調整大小功能時,請將 --max-surge 設定為至少 1

az aks nodepool update \
    --resource-group MyResourceGroup \
    --cluster-name MyManagedCluster \
    --name nodepool1 \
    --node-vm-size Standard_D4s_v3 \
    --max-surge 33%

並可選擇在調整大小完成後,還原原始的 --max-surge 和 --max-unavailable 值。

了解是否支援原地節點池大小調整

原地調整 尺寸僅支援特定情境。 這取決於您的節點池配置、作業系統,以及目前與目標虛擬機大小是否使用相同的磁碟控制器類型(SCSI 或 NVMe)。 AKS 會在變更任何節點前先驗證並拒絕不符合條件的要求,因此節點池會維持在目前的虛擬機容量。

以下變更 不支援 作為就地 VMSS 調整的一部分。 使用 選項二:透過建立新節點池來調整大小:

  • 改變 CPU 架構 (例如從 x64 改為 ARM64)。
  • 變更 機密運算 支援(例如啟用或停用 SNP)。
  • 變更 作業系統磁碟類型 (例如,將使用臨時 作業系統磁碟 的節點池調整為無法在同一位置承載作業系統磁碟的虛擬機大小)。
  • 將縮放與 Kubernetes 版本升級 或 節點數量 變更結合在同一操作中。

可跨磁碟控制器類型與 Hyper-V 世代調整大小

當目標虛擬機大小需要與目前節點池所使用的不同磁碟控制器或虛擬機管理程式世代時,AKS 會更新磁碟控制器。 如有需要,AKS 會在同一滾動升級中將節點池切換至其節點映像的第二代版本。

附註

磁碟控制器類型移轉僅適用於 節點集區是否符合磁碟控制器移轉資格 中所述的節點集區。

下表總結了 AKS 如何處理跨磁碟控制器類型或虛擬機監控器世代的調整大小:

目前節點池 目標虛擬機大小 Result
SCSI 大小的 Gen2 節點映像檔(例如,Standard_D4ds_v5) Gen2,僅限 NVMe 規格(例如,Standard_D4s_v6) 支援 符合資格的節點池。 新節點使用 NVMe 磁碟控制器。 節點影像不會改變。 其他節點集區會因 DiskControllerTypeIncompatible 而失敗
支援 Gen1 與 Gen2 的大小,搭配 SCSI(例如 Standard_D4ds_v5),製作 Gen1 節點映像檔 Gen2,僅限 NVMe 規格(例如,Standard_D4s_v6) 支援 符合資格的節點池。 AKS 會將節點池切換到同一作業系統映像的第二代版本(例如 AKSUbuntu-2404gen2containerd),並切換到 NVMe 磁碟控制器。 其他節點池因 DiskControllerTypeIncompatible 而失敗。
Gen1 節點映像適用於僅限 Gen1 的機型(例如 Standard_D3_v2) Gen2,僅限 NVMe 的規格(例如,Standard_D4s_v6) 不支援單一步驟。 使用 兩步調整大小。
Gen1 節點映像,適用於僅支援 Gen1 的規格 支援第一代與第二代的大小 支援(標準調整大小)。 節點池會保留其 Gen1 節點映像。
SCSI 規格 支援 SCSI 與 NVMe 的大小(例如,Standard_E4bds_v5) 支援(標準調整大小)。 節點池保留 SCSI 磁碟控制器。
NVMe 大小 僅限 SCSI 的大小 不支援。 請求因 DiskControllerTypeIncompatible 而失敗。
Gen2 節點映像 僅限Gen1尺寸 不支援。 請求會以 HypervisorGenerationIncompatible 失敗;若目前大小為 NVMe,則會以 DiskControllerTypeIncompatible 失敗。

當 AKS 將節點池從 Gen1 切換到 Gen2 時,節點池會保留其 OS SKU、OS 版本和 Kubernetes 版本。 只有節點映像世代、韌體(BIOS 到 UEFI)和磁碟控制器會改變。

節點集區是否符合磁碟控制器移轉資格

重要事項

以下需求 僅 適用於變更磁碟控制器類型的調整大小。 不符合這些條件的節點池,仍可在相同磁碟控制器類型下,使用虛擬機大小間的標準調整大小。 若要將這些節點池移至僅限 NVMe 的大小,請改為 建立新的節點池。

若要從 SCSI 大小調整為僅限 NVMe 大小,無論是否搭配 Gen1 到 Gen2 交換器,節點池必須符合 以下所有 要求:

  • 作業系統:節點池使用標準的 Gen1 或 Gen2 節點映像,適用於 Ubuntu 22.04、Ubuntu 24.04 或 Azure Linux 3.0。 其他作業系統 SKU 與映像變體不被支援,包括 Windows、Azure Container Linux、Ubuntu 26.04,以及支援 FIPS 的 Trusted Launch、機密 VM、Arm64 和 Kata(pod 沙盒)節點映像檔。

  • 節點池設定:節點池和叢集都必須處於 Running 狀態,且節點池不得:

  • 虛擬機大小:目前和目標虛擬機大小都不能是啟用 GPU 或機密運算的 VM 大小(例如 DC、EC 或 NP 系列)。

  • 請求:除了 適用於每次就地調整大小的限制外,該請求也無法更改自動縮放器的設定、節點映像版本、可用區域、節點標籤、VM 標籤、NSG 設定(allowedHostPorts、applicationSecurityGroups)或自訂 CA 信任。

從僅 Gen1 尺寸調整為僅 NVMe 尺寸

重要事項

你無法直接將節點池從僅 Gen1 的大小(例如 Standard_D3_v2)調整成 Gen2、僅 NVMe 的大小(例如 Standard_D4s_v6)。 改用兩個步驟調整大小。 第二步是磁碟控制器遷移,因此節點池必須符合 資格要求。

  1. 將節點池調整大小至支援 Gen1 與 Gen2 的 SCSI 大小,例如 Standard_DS3_v2。 節點池會保留其 Gen1 節點映像。 這個步驟是標準調整大小。

    az aks nodepool update \
        --resource-group MyResourceGroup \
        --cluster-name MyManagedCluster \
        --name nodepool1 \
        --node-vm-size Standard_DS3_v2
    
  2. 第一次調整完成後,將節點池調整至僅限 NVMe 的大小。 AKS 會將節點池切換到 Gen2 節點映像檔與 NVMe 磁碟控制器。

    az aks nodepool update \
        --resource-group MyResourceGroup \
        --cluster-name MyManagedCluster \
        --name nodepool1 \
        --node-vm-size Standard_D4s_v6
    

附註

由於基於 NVMe 的虛擬機器上的作業系統磁碟是以 NVMe 裝置(例如 /dev/nvme0n1)而非 SCSI 裝置(例如 /dev/sda)呈現,請在調整大小前,檢查任何直接參考裝置路徑的工作負載、DaemonSet 或指令碼。

選項 2:透過建立新節點池來調整大小

當原 地調整 大小不支援您的情境時,請使用此方法。 你建立一個新的節點池,使用目標虛擬機大小,透過封鎖並排空現有節點將工作負載移到該池,然後刪除現有節點池。

使用所需的 SKU 建立新的節點集區

附註

每個 AKS 叢集必須包含至少一個系統節點集區,且當中至少要有一個節點。 在此範例中,我們使用 --mode of System 來新增系統節點集區,以取代我們想要調整大小的系統節點集區。 您可以隨時 更新節點集區的模式 。 您也可以透過設定 --mode 為 User來新增使用者節點集區。

重設大小時,請務必考慮所有工作負載需求 (例如可用性區域),並據以設定您的 VMSS 節點集區。 您可能需要修改下列命令以最符合您的需求。 如需組態選項的完整清單,請參閱 az aks nodepool add 參考頁面。

  1. 使用命令 az aks nodepool add 建立新的節點集區。 在此範例中,我們會建立新的節點集區 mynodepool,其中包含三個節點和 Standard_DS3_v2 VM SKU,以取代具有 nodepool1 VM SKU 的現有節點集區 Standard_DS2_v2。

    az aks nodepool add \
        --resource-group myResourceGroup \
        --cluster-name myAKSCluster \
        --name mynodepool \
        --node-count 3 \
        --node-vm-size Standard_DS3_v2 \
        --mode System \
        --no-wait
    

    建立新的節點集區需要幾分鐘的時間。

  2. 使用命令 kubectl get nodes 取得新節點集區的狀態。

    kubectl get nodes
    

    您的輸出應該類似下列範例輸出,同時顯示新的節點集區 mynodepool 和現有的節點集區 nodepool1:

    NAME                                 STATUS   ROLES   AGE   VERSION
    aks-mynodepool-98765432-vmss000000   Ready    agent   23m   v1.21.9
    aks-mynodepool-98765432-vmss000001   Ready    agent   23m   v1.21.9
    aks-mynodepool-98765432-vmss000002   Ready    agent   23m   v1.21.9
    aks-nodepool1-12345678-vmss000000    Ready    agent   10d   v1.21.9
    aks-nodepool1-12345678-vmss000001    Ready    agent   10d   v1.21.9
    aks-nodepool1-12345678-vmss000002    Ready    agent   10d   v1.21.9
    

封鎖現有節點

封鎖將指定的節點標示為不可排程,並防止更多 Pod 新增至節點。

  1. 使用命令 kubectl get nodes 取得您要封鎖的節點名稱。

    kubectl get nodes
    

    您的輸出應該類似下列範例輸出,顯示您要封鎖的現有節點集區 nodepool1 中的節點:

    NAME                                STATUS   ROLES   AGE     VERSION
    aks-nodepool1-12345678-vmss000000   Ready    agent   7d21h   v1.21.9
    aks-nodepool1-12345678-vmss000001   Ready    agent   7d21h   v1.21.9
    aks-nodepool1-12345678-vmss000002   Ready    agent   7d21h   v1.21.9
    
  2. 使用指令 kubectl cordon 封鎖現有節點,在空格分隔的清單中指定所需的節點。 例如:

    kubectl cordon aks-nodepool1-12345678-vmss000000 aks-nodepool1-12345678-vmss000001 aks-nodepool1-12345678-vmss000002
    

    您的輸出應該類似下列範例輸出,顯示節點已封鎖:

    node/aks-nodepool1-12345678-vmss000000 cordoned
    node/aks-nodepool1-12345678-vmss000001 cordoned
    node/aks-nodepool1-12345678-vmss000002 cordoned
    

清空現有節點

重要事項

若要成功清空節點並收回執行 Pod,請確定任何 PodDisruptionBudgets (PDB) 至少允許一次移動一個 Pod 複本。 否則,清空/收回作業會失敗。 若要檢查此項目,您可以執行 kubectl get pdb -A 並確定 ALLOWED DISRUPTIONS 至少為 1 或以上。

當您清空節點時,在其上執行的 Pod 會被收回,並在其他可排程的節點上重新建立。

  1. 使用 kubectl drain 命令和 --ignore-daemonsets 旗標,以及 --delete-emptydir-data,清空現有節點,並在空格分隔的清單中指定所需的節點。 例如:

    重要事項

    需要使用 --delete-emptydir-data 來收回 AKS 建立的 coredns 和 metrics-server Pod。 如果您不使用此旗標,則會收到錯誤。 如需詳細資訊,請參閱下列 emptydir 上的文件。

    kubectl drain aks-nodepool1-12345678-vmss000000 aks-nodepool1-12345678-vmss000001 aks-nodepool1-12345678-vmss000002 --ignore-daemonsets --delete-emptydir-data
    
  2. 清空作業完成後,所有 Pod (不包括由常駐程式集控制的 Pod) 都應該在新的節點集區上執行。 您可以使用kubectl get pods命令加以確認。

    kubectl get pods -o wide -A
    

針對 Pod 收回問題進行疑難排解

清空節點時,您可能會遇到下列錯誤:

Error when evicting pods/[podname] -n [namespace] (will retry after 5s): Cannot evict pod as it would violate the pod's disruption budget.

根據預設,您的叢集具有 coredns-pdb 為 konnectivity-agent 的由 AKS 管理的 Pod 中斷預算 (例如 MinAvailable 或 1)。 例如,如果有兩個 coredns Pod 正在執行,那麼一次只能中斷一個。 當其中一個 Pod 重新建立且無法使用時,另一個 coredns Pod 會因 Pod 中斷預算而無法被收回。 這個問題會在排程並執行初始 coredns Pod 之後自行解決,讓第二個 Pod 能夠正確收回並重新建立。

秘訣

請考慮逐一清空節點,以取得更順暢的收回體驗,並避免節流。 如需詳細資訊,請參閱

移除現有的節點集區

重要事項

當您刪除節點集區時,AKS 不會執行封鎖和清空。 針對目前正在您打算刪除之節點集區上執行且重新排程的 Pod,若要將中斷降到最低,請先在節點集區的所有節點上執行隔離和清空,然後再刪除。

  1. 使用命令 az aks nodepool delete 刪除原始節點集區。

    az aks nodepool delete \
        --resource-group myResourceGroup \
        --cluster-name myAKSCluster \
        --name nodepool1
    
  2. 使用 kubectl get nodes 命令驗證您的 AKS 叢集是否只有新的節點集區,且應用程式和 Pod 是否正常運作。

    kubectl get nodes
    

    您的輸出應該類似下列範例輸出,只顯示新的節點集區 mynodepool:

    NAME                                 STATUS   ROLES   AGE   VERSION
    aks-mynodepool-98765432-vmss000000   Ready    agent   63m   v1.21.9
    aks-mynodepool-98765432-vmss000001   Ready    agent   63m   v1.21.9
    aks-mynodepool-98765432-vmss000002   Ready    agent   63m   v1.21.9
    

後續步驟