文档中心

容器服务

请输入

节点池

配置节点池 Kubelet 参数

Kubelet 提供了一系列配置用于调整节点行为，容器服务支持通过控制台配置节点的 Kubelet 参数。本文介绍如何配置节点的 Kubelet 参数。

说明

容器服务仅支持在控制台配置常见的 Kubelet 参数，详情请参见下文。如果您需要配置其他参数，请参见自定义集群 Kubelet 参数。

使用限制

升级集群时，Kubelet 参数的变更和保留逻辑如下：

通过本文介绍方式配置的 Kubelet 参数不会变更。

可能清理与目标版本不兼容的 Feature Gate 参数，例如升级至 v1.28 及以上版本时，会自动清理 QoSResourceManager 参数。

默认节点池不支持 Kubelet 自定义参数配置。

配置节点池的 Kubelet 参数后，如果选择存量节点参数同步，且存量节点已经配置了 Kubelet 参数，则相同参数会被节点池的配置覆盖。

支持的 Kubelet 参数

目前支持配置如下表所示的 Kubelet 自定义参数。

注意

修改 topology-manager-policy、topology-manager-scope 和特性门控（feature-gates）中的 QoSResourceManager 参数会重启 Kubelet，并且以更改后的策略重新计算容器实例的资源分配，因此可能会导致已经运行的容器实例重启，甚至无法进行资源分配。请谨慎操作。

字段	默认值	描述
cpu-manager-policy	none	CPU 管理器策略，取值： none：默认策略。 static：允许为节点上具有某些资源特征的 Pod 赋予更强的 CPU 亲和性和独占性。
eviction-hard	imagefs.available < 15% memory.available < 300Mi nodefs.available < 10% nodefs.inodesFree < 5%	触发 Pod 驱逐操作的一组硬性门限。详细参数解释，请参见官方文档。
fail-swap-on	true	当节点开启了 Swap 交换分区时，是否允许运行 kubelet。取值： true：禁止节点在开启 Swap 的情况下运行 kubelet。这是 Kubernetes 的默认保护机制。由于 Swap 会干扰内存限制（memory limit）的精确控制，导致容器实际占用的内存超出预期，进而影响 Pod 调度和 OOM 判断的准确性。 false：允许节点在开启 Swap 的情况下运行 kubelet。适用于对内存隔离要求不严格、或需要在已有 Swap 配置的存量节点上运行 Kubernetes 的场景。
feature-gates	-	特性门控，即描述 Kubernetes 特性的一组键值对。详细说明，请参见下方特性门控（feature-gates）列表。注意该特性门控仅支持在以下版本的集群中使用： v1.24.15-vke.13 ≤ 集群版本 < v1.26 v1.26.10-vke.13 ≤ 集群版本 < v1.28
image-gc-high-threshold-percent	85	镜像垃圾回收触发阈值。当磁盘使用率超过该值时，将触发垃圾回收，清理未使用的镜像以释放磁盘空间。整数形式，取值范围为 0～100。单位为百分比。注意配置该参数时，需保证image-gc-low-threshold-percent小于image-gc-high-threshold-percent。即使仅修改其中一个参数，系统也会结合另一个参数的默认值或原有配置进行校验。实际配置时，该参数允许配置为 100，但这意味着磁盘使用率为 100% 才会触发清理，属于极端保守，生产环境不推荐。
image-gc-low-threshold-percent	80	镜像垃圾回收停止阈值。在镜像垃圾回收执行过程中，当磁盘使用率降到该百分比以下时，停止回收。整数形式，取值范围为 0～100。单位为百分比。注意配置该参数时，需保证image-gc-low-threshold-percent小于image-gc-high-threshold-percent。即使仅修改其中一个参数，系统也会结合另一个参数的默认值或原有配置进行校验。实际配置时，该参数允许配置为 0，但这意味着系统要把磁盘清理到 0% 才会停止，几乎不可能达到，不具备实际意义。
image-maximum-gc-age	0s	未使用镜像被垃圾回收前的最长保留时长。超过该时间未被使用的镜像，在下次垃圾回收时将被清理。字符串格式，支持使用时间单位，例如 30m、168h。默认值为 0s，表示不按时间限制清理镜像，仅依据磁盘使用率（image-gc-high-threshold-percent）触发回收。注意当该参数配置为非 0s 取值时，必须大于image-minimum-gc-age。仅 Kubernetes v1.30 及以上版本集群，支持配置该参数。
image-minimum-gc-age	2m	未使用镜像被垃圾回收前的最短保留时长。在该时间内，镜像不会被垃圾回收，即使磁盘使用率已超过回收阈值。字符串格式，支持时间单位，例如 2m、30m。该参数可防止刚拉取的镜像被立即回收，保障镜像拉取与容器启动之间的时间窗口。说明该值不宜设置过大，否则在磁盘紧张时无法及时清理新近下载但短期未使用的镜像，可能加剧磁盘压力。
kube-api-burst	100	每秒发送到 APIServer 的突发请求数量上限。整数形式，取值范围为 1～1000。默认值为 100。注意该参数的取值必须大于等于kube-api-qps参数的值。
kube-api-qps	50	与 APIServer 通信的每秒查询个数。整数形式，取值范围为 1～500。默认值为 50。
kube-reserved	系统默认资源预留策略，请参见节点资源预留策略。	Kubernetes 系统预留资源，您可以自定义配置 CPU 和内存资源预留值。如果未配置kube-reserved，系统会使用默认值配置资源预留。
system-reserved	系统默认资源预留策略，请参见节点资源预留策略。	VKE 系统预留资源，您可以自定义配置 CPU 和内存资源预留值。如果未配置system-reserved，系统会使用默认值配置资源预留。
max-pods	110	节点支持的最大 Pod 数量。
pod-max-pids	-1	限制单个 Pod 内所有容器可使用的进程 ID（PID）数量上限，避免单个 Pod 创建过多进程而耗尽节点的 PID 资源。整数形式，取值范围为 -1 或正整数。单位为个。当取值为 -1 时，表示不限制单个 Pod 可使用的 PID 数量。说明该配置仅限制单个 Pod 的 PID 使用量，Pod 实际可用的 PID 数量还会受到节点内核 PID 上限及节点上其他进程 PID 使用情况的影响。不建议将该参数设置为 -1。建议结合节点的 PID 容量、单个 Pod 的进程规模及节点可运行的 Pod 数量合理设置，避免单个 Pod 耗尽节点 PID 资源；同时避免设置过小，导致 Pod 无法正常创建进程。
registry-burst	10	集群从镜像仓库拉取镜像的突发阈值，整数形式，取值范围为 1～100。取值必须大于等于registry-qps参数的值。
registry-qps	5	集群从镜像仓库拉取镜像的 QPS 阈值。整数形式，取值范围为 1～50。
serialize-image-pulls	false	是否串行拉取镜像，取值： true：串行拉取镜像。 false：（默认值）并行拉取镜像，能够提高 Pod 启动速度。
topology-manager-policy	none	拓扑管理策略，取值： none：（默认值）禁用拓扑管理策略。 restricted：Kubelet 仅接受在所请求资源上实现最佳 NUMA（Non-Uniform Memory Access，非一致存储访问结构）的 Pod。 best-effort：Kubelet 会优先选择在 CPU 和设备资源上实现 NUMA 的 Pod。 single-numa-node：Kubelet 仅允许在同一个节点的 CPU 和设备资源上实现 NUMA 的 Pod。
topology-manager-scope	container	拓扑管理策略的资源粒度，取值为 container，表示资源对齐粒度为容器级。

特性门控（feature-gates）列表

特性门控	默认值	描述
QoSResourceManager	false	是否启用 QoS 资源管理器，用于支持微拓扑调度。取值如下： true：启用 QoS 资源管理器。 false：（默认值）不启用 QoS 资源管理器。