VKE 支持管理和配置集群 Kubernetes 核心组件自定义参数。本文介绍如何在控制台查看和配置 kube-apiserver、kube-controller-manager、kube-scheduler 组件相关自定义参数。

注意事项

修改控制面参数配置将会重启集群，请充分评估业务情况后操作！

不同 Kubernetes 版本 VKE 集群支持可配置的控制面参数不同，请以实际控制台页面显示为准。

操作步骤

登录容器服务控制台。

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

在集群管理页面左侧导航栏中选择总览，然后在总览页面选择控制面参数配置页签，查看和管理集群 Kubernetes 核心组件自定义参数。

您可以单击具体组件后的编辑图标，更新控制面参数配置。各组件参数说明，如下文所示。无特殊取值说明的参数，请参考界面提示的取值要求配置。

kube-apiserver 参数配置

kube-controller-manager 参数配置

kube-scheduler 参数配置

kube-apiserver 组件相关自定义参数说明如下所示。

参数	说明
AdmissionPlugins	kube-apiserver 额外启用的准入控制插件。目前支持如下准入控制插件： AlwaysPullImages：勾选后表示修改每个 Pod 时，都强制重新拉取镜像。 PodNodeSelector：勾选后表示强制给命名空间内所有 Pod 附加节点选择器，限制只能调度到特定标签的节点。 PodTolerationRestriction：勾选后表示统一管理命名空间内 Pod 的 Tolerations，防止滥用高权限污点容忍。
RequestTimeout	kube-apiserver 处理请求的超时时间。该参数会影响 API 请求在服务端保持打开的最长时间。
DefaultNotReadyTolerationSeconds	Pod 对节点 NotReady 状态的默认容忍时间。该参数会影响节点 NotReady 后 Pod 的默认容忍行为。
DefaultUnreachableTolerationSeconds	Pod 对节点 Unreachable 状态的默认容忍时间。该参数会影响节点控制器访问不到节点时 Pod 的默认容忍行为。
FeatureGates	kube-apiserver 的 Kubernetes 特性门控。支持配置的特性门控如下： SidecarContainers：是否开启 SidecarContainers 特性开关，支持原生 Sidecar 容器。取值： true：开启 false：关闭注意仅以下版本 VKE 集群中支持使用该特性门控： v1.30 ≤ 集群版本 ≤ v1.32 StatefulSetAutoDeletePVC：是否开启 StatefulSetAutoDeletePVC 特性开关，支持 StatefulSet 自动删除 PVC。取值： true：开启 false：关闭注意仅以下版本 VKE 集群中支持使用该特性门控： v1.28 ≤ 集群版本 ≤ v1.30 InPlacePodVerticalScaling：是否开启 InPlacePodVerticalScaling 特性开关，支持 Pod 原地垂直伸缩。取值： true：开启 false：关闭注意仅 Kubernetes v1.34 版本 VKE 集群中支持使用该特性门控。 MaxUnavailableStatefulSet：是否开启 MaxUnavailableStatefulSet 特性开关，支持为 StatefulSet 的滚动更新增加maxUnavailable配置，允许更新时同时让多个 Pod 处于不可用状态并行更新。取值： true：开启 false：关闭注意仅以下版本 VKE 集群中支持使用该特性门控：集群版本 ≥ v1.36

kube-controller-manager 组件相关自定义参数说明如下所示。

参数	说明
KubeApiQps	kube-controller-manager 访问 APIServer 的 QPS 限制。该参数会影响控制器访问 API Server 的请求速率。
KubeApiBurst	kube-controller-manager 访问 APIServer 的突发请求上限。该参数通常与 KubeApiQps 配合使用。注意 KubeApiBurst 的取值必须大于等于 KubeApiQps 取值。
NodeMonitorGracePeriod	节点失联后，被标记为 NotReady 或 Unknown 的时间。
NodeEvictionRate	节点故障场景下的 Pod 驱逐速率。当所在可用区处于健康状态时，此参数控制每秒被选中进行 Pod 驱逐的节点数。例如取值为 0.1，表示每秒驱逐 0.1 个节点，即每 10 秒驱逐 1 个节点。
SecondaryNodeEvictionRate	大面积故障时的第二档排空节点速率。当所在可用区被判定为“不健康”（故障比例超过UnhealthyZoneThreshold配置时），且节点失效时，每秒从此参数指定数量的节点上驱逐 Pod。例如取值为 0.01，表示每秒从 0.01 个节点上驱逐 Pod，即每 100 秒从 1 个节点上驱逐 Pod。
UnhealthyZoneThreshold	可用区的不健康阈值。当同一个可用区内处于 NotReady 状态的节点比例超过此数值时，控制面会判定该可用区发生了整体基础设施异常，从而触发区域级的限流驱逐策略。
LargeClusterSizeThreshold	集群的大规模阈值，节点控制器根据此阈值判断集群是否为大规模集群，以决定 Pod 驱逐策略。
TerminatedPodGCThreshold	Terminated Pod 垃圾回收阈值，即可以保留的 Terminated Pod 最大数量。
ConcurrentTTLAfterFinishedSyncs	负责清理过期 Job 的 TTLAfterFinished 控制器的并发同步协程数。
HorizontalPodAutoscalerTolerance	Pod 水平自动扩缩容（HPA）时，若实际指标与期望指标的偏差小于此容差率，则不会触发扩缩容。
HorizontalPodAutoscalerSyncPeriod	HPA 同步 Pod 数量的周期。
ConcurrentHorizontalPodAutoscalerSyncs	允许并发同步的 HPA 对象数量。数值越大，HPA 对象处理响应越快，但会占用更多 CPU 及网络资源。注意仅 Kubernetes v1.26 及以上版本集群支持该参数。
FeatureGates	kube-controller-manager 的 Kubernetes 特性门控。支持配置的特性门控如下： StatefulSetAutoDeletePVC：是否开启 StatefulSetAutoDeletePVC 特性开关，支持 StatefulSet 自动删除 PVC。取值： true：开启 false：关闭注意仅以下版本 VKE 集群中支持使用该特性门控： v1.28 ≤ 集群版本 ≤ v1.30 InPlacePodVerticalScaling：是否开启 InPlacePodVerticalScaling 特性开关，支持 Pod 原地垂直伸缩。取值： true：开启 false：关闭注意仅 Kubernetes v1.34 版本 VKE 集群中支持使用该特性门控。 MaxUnavailableStatefulSet：是否开启 MaxUnavailableStatefulSet 特性开关，支持为 StatefulSet 的滚动更新增加maxUnavailable配置，允许更新时同时让多个 Pod 处于不可用状态并行更新。取值： true：开启 false：关闭注意仅以下版本 VKE 集群中支持使用该特性门控：集群版本 ≥ v1.36

后续操作

配置完成后，建议您检查关键工作负载是否正常运行，并关注节点状态、Pod 调度状态、HPA 行为和 Kubernetes 事件。如果参数调整影响业务运行，请根据参数界面显示的默认值恢复参数配置。如无法恢复可联系您的火山引擎客户经理或提交工单获取技术支持。

参数	说明
KubeApiQps	kube-scheduler 访问 APIServer 的 QPS 限制。该参数会影响控制器访问 API Server 的请求速率。
KubeApiBurst	kube-scheduler 访问 APIServer 的突发请求上限。该参数通常与 KubeApiQps 配合使用。注意 KubeApiBurst 的取值必须大于等于 KubeApiQps 取值。
Parallelism	kube-scheduler 在执行调度算法时同时并行执行的 Goroutine（Golang 协程）数量，该参数会影响调度器同时处理调度任务的能力。
PercentageOfNodesToScore	调度 Pod 时评估的可运行节点比例，找到指定比例的节点后停止筛选。
PodInitialBackoffSeconds	Pod 初始调度退避时间。该参数会影响 Pod 调度失败后的初始重试间隔。
PodMaxBackoffSeconds	Pod 调度失败后最大回退秒数，两次调度间隔不会低于当前回退秒数。
FeatureGates	kube-scheduler 的 Kubernetes 特性门控。支持配置的特性门控如下： SidecarContainers：是否开启 SidecarContainers 特性开关，支持原生 Sidecar 容器。取值： true：开启 false：关闭注意仅以下版本 VKE 集群中支持使用该特性门控： v1.30 ≤ 集群版本 ≤ v1.32 InPlacePodVerticalScaling：是否开启 InPlacePodVerticalScaling 特性开关，支持 Pod 原地垂直伸缩。取值： true：开启 false：关闭注意仅 Kubernetes v1.34 版本 VKE 集群中支持使用该特性门控。

容器服务