VKE 支持管理和配置集群 Kubernetes 核心组件自定义参数。本文介绍如何在控制台查看和配置 kube\-apiserver、kube\-controller\-manager、kube\-scheduler 组件相关自定义参数。 ## 注意事项 * 修改控制面参数配置将会重启集群，请充分评估业务情况后操作！ * 不同 Kubernetes 版本 VKE 集群支持可配置的控制面参数不同，请以实际控制台页面显示为准。 ## 操作步骤 1. 登录 [容器服务控制台](https://console.volcengine.com/vke)。 2. 在左侧导航栏中选择 **集群**，单击目标集群名称，进入集群管理页面。 3. 在集群管理页面左侧导航栏中选择 **总览**，然后在 **总览** 页面选择 **控制面参数配置** 页签，查看和管理集群 Kubernetes 核心组件自定义参数。您可以单击具体组件后的编辑图标，更新控制面参数配置。各组件参数说明，如下文所示。无特殊取值说明的参数，请参考界面提示的取值要求配置。 kube-apiserver 参数配置 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 参数配置 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 集群中支持使用该特性门控。

注意

仅以下版本 VKE 集群中支持使用该特性门控：

集群版本 ≥ v1.36

| kube-scheduler 参数配置 kube\-scheduler 组件相关自定义参数说明如下所示。 |**参数** |**说明** | |---|---| |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 集群中支持使用该特性门控。

| ## 后续操作配置完成后，建议您检查关键工作负载是否正常运行，并关注节点状态、Pod 调度状态、HPA 行为和 Kubernetes 事件。如果参数调整影响业务运行，请根据参数界面显示的默认值恢复参数配置。如无法恢复可联系您的火山引擎客户经理或 [提交工单](https://console.volcengine.com/workorder/create?step=1) 获取技术支持。 ## 相关文档 [UpdateClusterConfig - 更新集群配置](https://docs.volcengine.com/docs/6460/115189)