將節點遷移至 cgroup v2

Cgroup版本說明

Linux核心提供cgroup v1和cgroup v2兩個版本，用於限制、記錄和隔離進程組使用的實體資源（如CPU、記憶體、I/O等）。cgroup v2是新一代的cgroup 介面，在設計上解決了 v1 的多控制器層級問題，提供了更一致的資源控制能力。兩者在通用介面與子系統組織方式上存在差異，直接存取 cgroup 檔案系統的應用程式需進行適配。

詳見cgroup v1與cgroup v2的區別。

Kubernetes 自 1.31 起將cgroup v1支援調整為維護模式，自1.35版本起不再支援 cgroup v1。建議遷移至cgroup v2。cgroup v2主要優勢包括：

• 提升穩定性：採用統一的記憶體核算模型，有效管理頁面緩衝（Page Cache），解決cgroup v1中高磁碟I/O應用搶佔記憶體、導致其他應用被OOMKilled的問題。

• 統一的層級結構：所有資源控制器（如 CPU、記憶體）集中於單一層級，避免cgroup v1中多層級並存帶來的配置衝突與管理複雜性，簡化資源檢視與策略定義。

• 增強資源可觀測性：引入壓力失速資訊（Pressure Stall Information, PSI），量化應用因等待 CPU、記憶體或 I/O 資源而阻塞的時間，為效能瓶頸分析提供精細化指標支援。

檢查節點cgroup版本

遷移前，可登入節點，執行以下命令來確認當前的cgroup版本。

# 登入到目標節點後執行
stat -fc %T /sys/fs/cgroup/

# 預期輸出:
# cgroup2fs  --> 代表 cgroup v2
# tmpfs      --> 代表 cgroup v1

遷移步驟

生產環境使用建議

• 應用相容性

  審查自研應用或指令碼，確保其不依賴cgroup v1檔案系統（如 cpu.cfs_quota_us）。由於檔案系統介面不相容，此類邏輯在cgroup v2下將失效，必須進行適配。

• 節點自訂配置

  更換作業系統會重設節點。所有自訂修改需通過節點池功能進行持久化，否則在節點重建後將丟失。相關配置方式及注意事項，請參見：

  • 自訂節點池kubelet配置

  • 自訂節點池containerd配置

  • 管理節點池OS參數（sysctl、THP）

• 監控警示：建議啟用阿里雲Prometheus監控，持續觀測叢集整體健康狀態及關鍵容器的資源使用趨勢，及時發現異常。