文档中心

容器服务

节点池

配置节点池 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	每秒发送到 API Server 的突发请求数量上限。整数形式，取值范围为 1～1000。默认值为 100。注意该参数的取值必须大于等于kube-api-qps参数的值。
kube-api-qps	50	与 API Server 通信的每秒查询个数。整数形式，取值范围为 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 资源管理器。

配置 Kubelet 自定义参数

创建集群时配置

您可以在创建集群时，配置 Kubelet 自定义参数。

在节点池配置步骤中的高级配置模块下配置 Kubelet 自定义参数。更多配置，请参见创建集群。

创建节点池时配置

您可以在集群中创建新的节点池，并配置 Kubelet 自定义参数。

在节点池配置步骤中的高级配置模块下配置 Kubelet 自定义参数。更多配置，请参见创建节点池。

配置存量节点池

您可以配置集群中存量节点池的 Kubelet 自定义参数。

在节点池页面的目标节点池操作列中，选择... > Kubelet 自定义参数，配置 Kubelet 自定义参数。更多配置，请参见管理节点池。

同步存量节点参数

在存量节点池中添加 Kubelet 自定义参数时，默认仅对新增节点生效，不对存量节点生效。如果您需要对存量节点生效，需要执行本小节的操作。

注意

同步自定义 Kubelet 参数到存量节点时，如果存量节点已经配置了 Kubelet 参数，则相同参数会被节点池的配置覆盖。

同步过程中对应组件将重启，可能短暂影响节点状态上报、Pod 调度、容器启动和镜像拉取，请在业务低峰期操作。

在节点池页面中，单击目标节点池名称，进入节点池详情页面。

选择 Kubelet/Containerd 参数页签，单击存量节点参数同步。

在弹出的配置页面中，配置同步参数和同步范围。

配置项	说明
同步 Kubelet 自定义参数	是否同步 Kubelet 自定义参数。勾选后，系统会将节点池中配置的 Kubelet 自定义参数同步至存量节点。
同步 Containerd 自定义参数	是否同步 Containerd 自定义参数。勾选后，系统会将节点池中配置的 Containerd 自定义参数同步至存量节点。
每批最大并行数	每批次最多同时执行同步的节点数量。数值越小，单批影响范围越小，风险越可控。
最大容忍失败数	同步任务执行过程中，允许出现的最大失败节点数（状态为失败或未知的节点均计入）。超过该值后，任务将自动停止后续批次，已执行的批次不受影响。默认值为 0，表示首个节点失败即停止。
自动暂停策略	控制每批次完成后是否自动暂停任务，待人工确认后再继续。包括：不暂停：全部批次连续执行。首批暂停：第一批完成后暂停，适合先小范围验证。每批次暂停：每批完成后均暂停，适合高风险变更逐批确认。
每批次间隔时间	配置相邻两批次之间的等待时间，可用于预留观察窗口，确认参数同步后节点工作正常。不设置：每一批次执行完成后，立即执行下一批。设置时间间隔：升级批次之间的时间间隔，当前一个批次完成后，系统会暂停指定的时间再进行下一批次。说明仅自动暂停策略选择不暂停时，支持配置该参数。
同步范围	选择自定义参数的同步范围，包括：全部节点：将参数同步至节点池内所有存量节点。指定节点：仅将参数同步至手动选择的节点，适合先对部分节点进行灰度验证。

配置完成后，勾选我已知晓同步存量节点参数相关风险，单击确定，开始参数同步。

参数同步完成后，在任务记录列表中，可以查看同步任务的结果。

单击任务详情列中的查看详情，可以查看该同步任务的详细信息。包括同步节点总数、失败数等。

查看 Kubelet 自定义参数

登录容器服务控制台。

在左侧导航栏中单击集群。单击目标集群名称，进入集群管理页面。

在左侧导航栏中选择节点管理 > 节点池。

单击目标节点池名称，选择 Kubelet/Containerd 参数页签，查看节点池的 Kubelet 参数配置。

说明

您也可以单击设置 Kubelet/Containerd 参数，更新节点池的 Kubelet 参数。

最近更新时间：2026.11.02 21:16:08

这个页面对您有帮助吗？

有用

无用