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 的默认容忍行为。
GoawayChance	配置 kube-apiserver 随机结束 HTTP/2 长连接的概率，可减少客户端长期复用同一连接造成的实例负载不均。默认值为 0，表示关闭该功能。
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 及以上版本集群支持该参数。
NodeStartupGracePeriod	节点控制器等待新节点上报健康状态的宽限时长。该参数用于为节点启动和初始化预留时间，避免启动较慢的节点被过早判定为异常。
ConcurrentCronJobSyncs	CronJob 控制器可同时处理的 CronJob 数量。该参数用于调节大量定时任务集中触发时的状态检查和 Job 创建并发度，并平衡任务处理效率与控制面负载。注意仅 Kubernetes v1.28 及以上版本集群支持该参数。
ConcurrentEphemeralVolumeSyncs	临时卷控制器可同时处理的通用临时卷数量。该参数用于调节大量 Pod 同时创建通用临时卷时的处理并发度，并平衡卷创建效率与控制面负载。
ConcurrentJobSyncs	Job 控制器可同时处理的 Job 数量。该参数用于调节大量 Job 集中创建、更新或完成时的处理并发度，并平衡任务处理效率与控制面负载。注意仅 Kubernetes v1.28 及以上版本集群支持该参数。
ConcurrentResourceQuotaSyncs	ResourceQuota 控制器可同时重新计算的资源配额数量。该参数用于调节大量命名空间的资源配额同时发生变化时的处理并发度，并平衡配额更新效率与控制面负载。
ConcurrentServiceAccountTokenSyncs	ServiceAccount Token 控制器可同时处理的服务账号令牌数量。该参数用于调节大量服务账号令牌集中创建或更新时的处理并发度，并平衡令牌处理效率与控制面负载。
EndpointUpdatesBatchPeriod	Endpoints 控制器批量合并端点变更的等待时长。该参数用于在 Pod 频繁变化时合并一段时间内的更新，平衡更新请求数量与 Service 后端地址的刷新时效。
EndpointSliceUpdatesBatchPeriod	EndpointSlice 控制器批量合并端点变更的等待时长。该参数用于在 Pod 频繁变化时合并一段时间内的更新，平衡更新请求数量与 EndpointSlice 的刷新时效。
HorizontalPodAutoscalerCpuInitializationPeriod	HPA 忽略 Pod 启动初期 CPU 指标的时长。该参数用于过滤应用预热阶段的 CPU 波动，避免不稳定的初始指标干扰扩缩容决策。
HorizontalPodAutoscalerDownscaleStabilization	HPA 缩容时回看历史期望副本数的时长。该参数用于缓冲指标短时下降造成的副本数变化，减少工作负载频繁缩容。
HorizontalPodAutoscalerInitialReadinessDelay	HPA 将尚未稳定就绪的 Pod 视为初始化状态的时长。该参数用于过滤 Pod 启动阶段的就绪状态波动，避免尚未稳定运行的 Pod 干扰扩缩容决策。
ResourceQuotaSyncPeriod	ResourceQuota 控制器重新计算资源配额使用量的周期。该参数用于控制配额使用量的刷新频率，平衡资源变化的统计时效与控制面负载。
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 集群中支持使用该特性门控。

容器服务