Container Service for Kubernetes：CreateClusterNodePool - 建立節點池

節點池名稱。

節點池類型，取值範圍：

• ess：普通節點池（包含託管功能和自動Auto Scaling功能）。

• edge：邊緣節點池。

• lingjun：靈駿節點池。

• hybrid：混合雲節點池。

節點池的資源群組 ID，節點池彈出的執行個體將屬於該資源群組內。

一個資源只能歸屬於一個資源群組。根據不同的業務情境，您可以將資源群組映射為專案、應用或組織等概念。

是否啟用自動調整，取值：

• true：開啟節點池自動調整功能。當叢集的容量規劃無法滿足應用 Pod 調度時，ACK 會根據配置的最小和最大執行個體數自動擴縮節點資源。1.24 及以上版本的叢集預設啟用節點即時彈性； 1.24 以下版本的叢集預設啟用節點自動調整。更多資訊，請參見節點伸縮。

• false：不開啟自動調整，ACK 會根據配置的期望節點數調整節點池中的節點數，將節點數始終維持在期望節點數。

當取值為 false 時，auto_scaling內的其他配置參數將不生效。

預設值：false。

自動Auto Scaling執行個體類型。僅當enable=true生效，取值：

• cpu：普通執行個體型。

• gpu：GPU 執行個體型。

• gpushare：GPU 共用型。

• spot：搶佔式執行個體型。

預設值：cpu。

節點池中可伸縮的最大執行個體數，不包含您已有的執行個體。僅當enable=true生效。

取值範圍[min_instances, 2000]，預設值為 0。

節點池中可伸縮的最小執行個體數，不包含您已有的執行個體。僅當enable=true生效。

取值範圍[0, max_instances]，預設值為 0。

【該欄位已廢棄】該欄位已廢棄，請使用 internet_charge_type 和 internet_max_bandwidth_out 替代。

是否綁定 EIP。取值：

• true：綁定 EIP。

• false：不綁定 EIP。

預設值：false。

【該欄位已廢棄】請使用 internet_charge_type 和 internet_max_bandwidth_out 替代。

EIP 計費類型。取值：

• PayByBandwidth：按固定頻寬計費。

• PayByTraffic：按使用流量計費。

預設值：PayByBandwidth。

【該欄位已廢棄】請使用 internet_charge_type 和 internet_max_bandwidth_out 替代。

EIP 頻寬峰值。單位：Mbps。

是否開啟節點池的託管功能，取值：

• true：開啟託管功能。

• false：不開啟託管功能，只有當 enable=true 時，其他相關配置才生效。

預設值：false。

是否自動修複節點，僅當enable=true時生效。

• true：自動修複

• false：不自動修複

預設值為true

是否自動修複 CVE 漏洞，僅當enable=true時生效。

• true：允許自動修複 CVE。

• false：不允許自動修複 CVE。

預設值為true。

是否自動升級節點，僅當enable=true時生效。

• true：啟用自動升級。

• false：不啟用自動升級。

預設值為true。

節點池節點付費類型，取值：

• PrePaid：預付費執行個體。

• PostPaid：隨用隨付執行個體。

預設值：PostPaid。

節點池節點訂用帳戶時間長度，僅當instance_charge_type取值為PrePaid時生效，且為必選值。

• 當period_unit=Week時，period取值範圍：{ 1、2、3、4}。

• 當period_unit=Month時，period 取值範圍：{1、2、3、4、5、6、7、8、9、12、24、36、48、60}。

節點池節點付費周期，僅當instance_charge_type取值為PrePaid時生效，且為必選值。

• Month：以月為計時單位。

• Week：以周為計算單位。

預設值：Month。

節點池節點是否開啟自動續約，當instance_charge_type取值為PrePaid時才生效。取值：

• true：自動續約。

• false：不自動續約。

預設值：false。

單次自動續約的續約時間長度。取值範圍：

• PeriodUnit=Week 時：1、2、3。

• PeriodUnit=Month 時：1、2、3、6、12、24、36、48、60。

預設值：1。

搶佔式執行個體類型。取值：

• NoSpot：非搶佔式執行個體。

• SpotWithPriceLimit：設定搶佔執行個體價格上限。

• SpotAsPriceGo：系統自動出價，跟隨當前市場實際價格。

更多資訊，請參見搶佔式執行個體。

作業系統鏡像類型，取值範圍：

• AliyunLinux：Alinux2 鏡像。

• AliyunLinuxSecurity：Alinux2 鏡像 UEFI 版。

• AliyunLinux3：Alinux3 鏡像。

• AliyunLinux3Arm64：Alinux3 鏡像 ARM 版。

• AliyunLinux3Security：Alinux3 鏡像 UEFI 版。

• CentOS：CentOS 鏡像。

• Windows：Windows 鏡像。

• WindowsCore：WindowsCore 鏡像。

• ContainerOS：容器最佳化鏡像。

• AliyunLinux3ContainerOptimized: Alinux3 鏡像容器最佳化版。

自訂鏡像 ID，預設使用系統提供的鏡像。

節點系統硬碟類型，取值：

• cloud_efficiency：高效雲端硬碟。

• cloud_ssd：SSD 雲端硬碟。

• cloud_essd：ESSD 雲端硬碟。

• cloud_auto：ESSD AutoPL 雲端硬碟。

• cloud_essd_entry：ESSD Entry 雲端硬碟。

預設值：cloud_efficiency。

節點系統硬碟大小，單位：GiB。

取值範圍：[20,2048]。

節點系統硬碟磁碟效能，只對 ESSD 磁碟生效。磁碟效能等級和磁碟大小有關。更多資訊，請參見 ESSD 雲端硬碟。

• PL0：並發極限 I/O 效能中等，讀寫時延較為穩定。

• PL1：並發極限 I/O 效能中等，讀寫時延較為穩定。

• PL2：並發極限 I/O 效能較高，讀寫時延穩定。

• PL3：並發極限 I/O 效能極高，讀寫時延極穩定。

是否加密系統硬碟。取值範圍：

• true：加密。

• false：不加密。

系統硬碟使用的 KMS 金鑰識別碼。

系統硬碟採用的密碼編譯演算法。取值範圍：aes-256。

節點系統硬碟是否開啟 Burst（效能突發）。 取值：

• true：是。

• false：否。

當system_disk_category取值為cloud_auto時才支援設定該參數。更多資訊，請參見ESSD AutoPL 雲端硬碟。

節點系統硬碟預配置的讀寫 IOPS。

可能值：0~min{50,000, 1000*容量-基準效能}。 基準效能=min{1,800+50*容量, 50000}。

當system_disk_category取值為cloud_auto時才支援設定該參數。更多資訊，請參見ESSD AutoPL 雲端硬碟。

免密登入金鑰組名稱，和login_password二選一。

SSH 登入密碼，和key_pair二選一。密碼規則為 8~30 個字元，且至少同時包含三項（大小寫字母、數字和特殊符號）。

彈出的 ECS 執行個體是否使用以非 root 使用者登入。

• true：以非 root 使用者（ecs-user）登入。

• false：以 root 使用者登入。

【已廢棄】請使用參數 security_hardening_os 替代。

是否開啟等保加固，僅當系統鏡像選擇 Alibaba Cloud Linux 2 或 Alibaba Cloud Linux 3 時，可為節點開啟等保加固。阿里雲為 Alibaba Cloud Linux 2 和 Alibaba Cloud Linux 3 等保 2.0 三級版鏡像提供等保合規的基準檢查標準和掃描程式。

阿里雲 OS 安全強化。取值：

• true：開啟阿里雲 OS 安全強化。

• false：不開啟阿里雲 OS 安全強化。

預設值：false。

公網 IP 收費類型。取值：

• PayByBandwidth：按固定頻寬計費。

• PayByTraffic：按使用流量計費。

節點公網 IP 出頻寬最大值，單位為 Mbps（Mega bit per second），取值範圍：[1,100]

節點池期望節點數量。

節點池應該維持的總節點數量，建議至少配置 2 個節點，以確保叢集組件正常運行。您可以通過調整期望節點數，達到擴容或縮容節點池的目的。

如無需建立節點，可填寫為 0，後續再手動調整，增加節點數。

多可用性區域伸縮組 ECS 執行個體擴縮容策略。取值：

• PRIORITY：根據您定義的虛擬交換器（VSwitchIds.N）擴縮容。當優先順序較高的虛擬交換器所在可用性區域無法建立 ECS 執行個體時，自動使用下一優先順序的虛擬交換器建立 ECS 執行個體。

• COST_OPTIMIZED：按 vCPU 單價從低到高進行嘗試建立。當伸縮配置設定了搶佔式計費方式的多執行個體規格時，優先建立對應搶佔式執行個體。您可以繼續通過CompensateWithOnDemand參數指定當搶佔式執行個體由於庫存等原因無法建立時，是否自動嘗試以隨用隨付的方式建立。

  說明

  COST_OPTIMIZED僅在伸縮配置設定了多執行個體規格或者選用了搶佔式執行個體的情況下生效。

• BALANCE：在伸縮組指定的多可用性區域之間均勻分配 ECS 執行個體。如果由於庫存不足等原因可用性區域之間變得不平衡，您可以通過 API RebalanceInstances 平衡資源。

預設值：PRIORITY。

伸縮組模式，取值：

• release：標準模式，根據申請資源值的使用量，通過建立、釋放 ECS 的方式進行伸縮。

• recycle：極速模式，通過建立、停機、啟動的方式進行伸縮，提高再次伸縮的速度（停機時計算資源不收費，只收取儲存費用，本地碟機型除外）。

預設值：release。

伸縮組所需要按量執行個體個數的最小值，取值範圍：[0,1000]。當按量執行個體個數少於該值時，將優先建立按量執行個體。

伸縮組滿足最小按量執行個體數（on_demand_base_capacity）要求後，超出的執行個體中按量執行個體應占的比例。取值範圍：[0,100]。

指定可用執行個體規格的個數，伸縮組將按成本最低的多個規格均衡建立搶佔式執行個體。取值範圍：[1,10]。

是否開啟補齊搶佔式執行個體。開啟後，當收到搶佔式執行個體將被回收的系統訊息時，伸縮組將嘗試建立新的執行個體，替換掉將被回收的搶佔式執行個體。取值：

• true：開啟補齊搶佔式執行個體。

• false：不開啟補齊搶佔式執行個體。

當multi_az_policy取值為COST_OPTIMIZED時，如果因價格、庫存等原因無法建立足夠的搶佔式執行個體，是否允許自動嘗試建立按量執行個體滿足 ECS 執行個體數量要求。取值：

• true：允許自動嘗試建立按量執行個體滿足 ECS 執行個體數量要求。

• false：不允許自動嘗試建立按量執行個體滿足 ECS 執行個體數量要求。

部署集 ID。您可以使用部署集將節點池彈出的 ECS 執行個體分散部署在不同的物理伺服器上，以保證業務的高可用性和底層容災能力。在部署集內建立 ECS 執行個體時，根據事先設定的部署策略，分散啟動指定地區下的 ECS 執行個體。

節點池安全性群組 ID，與security_group_ids二選一，推薦使用security_group_ids。

【該欄位已廢棄】請使用image_type參數代替。

作業系統發行版。取值：

• CentOS

• AliyunLinux

• Windows

• WindowsCore

預設值：AliyunLinux。

Worker RAM 角色名稱。

• 為空白時，將使用叢集預設建立的 Worker RAM 角色。

• 不為空白時，指定的 RAM 角色必須是一個普通服務角色，並且它的可信服務配置必須是雲端服務器，更多資訊，請參見建立普通服務角色。當指定的 RAM 角色不是叢集預設建立的 Worker RAM 角色時，角色的名稱不能以KubernetesMasterRole-或KubernetesWorkerRole-開頭。

ECS 執行個體中繼資料訪問配置。

系統硬碟快照策略。

Kubelet 參數配置。

容器運行時名稱，ACK 支援以下三種容器運行時。

• containerd：推薦使用，支援所有叢集版本。

• Sandboxed-Container.runv：安全沙箱容器，提供更高的隔離性，支援 1.31 及以下版本叢集。

• docker：已停止維護，支援 1.22 及以下版本叢集。

預設值：containerd。

容器運行時版本。

節點 CPU 管理原則。當叢集版本在 1.12.6 及以上時支援以下兩種策略：

• static：允許為節點上具有某些資源特徵 Pod 增強其 CPU 親和性和獨佔性。

• none：表示啟用現有的預設 CPU 親和性方案。

預設值：none。

執行個體自訂資料。節點加入叢集後，將運行您指定的執行個體自訂資料指令碼。請參見User-Data 指令碼。

擴容後的節點是否不可調度。

• true：不可調度。

• false：可調度。

是否在 ECS 節點上安裝CloudMonitor，安裝後可以在CloudMonitor控制台查看所建立 ECS 執行個體的監控資訊，推薦開啟。取值：

• true：在 ECS 節點上安裝CloudMonitor。

• false：不在 ECS 節點上安裝CloudMonitor。

預設值：false。

自訂節點名稱。自訂節點名稱後，將同時更改節點名稱、ECS 執行個體名稱、ECS 執行個體 Hostname。

節點名稱由首碼、節點 IP 位址及尾碼三部分組成：

• 總長度為 2-64 個字元。節點名稱首尾必須為小寫字母和數字。

• 首碼和尾碼允許使用大小寫字母、數字、連字號（-）和點號（.）。必須以大小寫字母開頭，不能以連字號（-）或點號（.）開頭或結尾。不能連續使用連字號（-）或點號（.）。

• 首碼必選（ECS 限制），尾碼可選。

• 節點 IP 為完整的節點私網 IP 位址。

例如：節點 IP 位址為 192.XX.YY.55，指定首碼為 aliyun.com，尾碼為 test。

• 如果節點為 Linux 節點，則節點名稱、ECS 執行個體、ECS 執行個體 Hostname 均為 aliyun.com192.XX.YY.55test。

• 如果節點為 Windows 節點，則 ECS 執行個體 Hostname 為 192-XX-YY-55，節點名稱、ECS 執行個體名稱均為 aliyun.com192.XX.YY.55test。

執行個體預自訂資料。節點加入叢集前，將運行您指定的執行個體預自訂資料指令碼。請參見User-Data 指令碼。

是否開啟加密計算叢集。

• true：開啟加密計算。

• false：不開啟加密計算。

【該欄位已廢棄】

邊緣增強型節點池綁定的雲企業網執行個體 ID(CENID)。

【該欄位已廢棄】

邊緣增強型節點池綁定的雲串連網執行個體 ID(CCNID)。

【該欄位已廢棄】

邊緣增強型節點池綁定的雲串連網執行個體所屬的地區。

【該欄位已廢棄】

邊緣增強型節點池的網路頻寬，單位：Mbps。

【該欄位已廢棄】

邊緣增強型節點池的購買時間長度，單位：月。

建立靈駿節點池時需要關聯的靈駿叢集 ID。

建立靈駿節點池時需要關聯的靈駿叢集的靈駿分組 ID。

是否開啟智能託管模式。 取值：

• true：開啟智能託管模式，僅當叢集開啟智能託管模式時可以開啟。

• false：不開啟智能託管模式。