Release Notes and Announcements
- Release Notes
- Announcements
- Release Notes
Product Introduction
Purchase Guide
- Purchase Instructions
- Purchase a TKE General Cluster
- Purchasing Native Nodes
- Purchasing a Super Node
Getting Started
Cluster Configuration
- General Cluster Overview
- Cluster Management
- Network Management
- Storage Management
- Node Management
- GPU Resource Management
- Remote Terminals
Application Configuration
- Workload Management
- Service and Configuration Management
- Component and Application Management
- Auto Scaling
- Container Login Methods
Observability Configuration
- Ops Observability
- Cost Insights and Optimization
Scheduler Configuration
- Scheduling Component Overview
- Resource Utilization Optimization Scheduling
- Business Priority Assurance Scheduling
- QoS Awareness Scheduling
Security and Stability
- TKE Security Group Settings
- Identity Authentication and Authorization
- Control Plane Security
- Application Security
- Cluster Security Enhancement Capability
Multi-cluster Management
- Planned Upgrade
- Backup Center
Cloud Native Service Guide
- Cloud Service for etcd
- TMP
- TKE Serverless Cluster Guide
- TKE Registered Cluster Guide
Use Cases
- Cluster
- Serverless Cluster
- Scheduling
- Security
- Service Deployment
- Network
- Release
- Logs
- Monitoring
- OPS
- Terraform
- DevOps
- Auto Scaling
- Containerization
- Cost Management
- Hybrid Cloud
- AI
Troubleshooting
API Documentation
- History
- Introduction
- API Category
- Making API Requests
- Elastic Cluster APIs
- Resource Reserved Coupon APIs
- Cluster APIs
- Third-party Node APIs
- Relevant APIs for Addon
- Node Pool APIs
- Network APIs
- Node APIs
- Node Pool APIs
- TKE Edge Cluster APIs
- Cloud Native Monitoring APIs
- Scaling group APIs
- Super Node APIs
- Other APIs
- Data Types
- Error Codes
- TKE API 2022-05-01
FAQs
- TKE Standard Cluster
- TKE Serverless Cluster
- About OPS
- Hidden Danger Handling
- About Services
- Image Repositories
- About Remote Terminals
- Event FAQs
- Resource Management
Service Agreement
- TKE Service Level Agreement
- TKE Serverless Service Level Agreement
Contact Us
Glossary

Customizing the Control Plane Component Parameters

Download

Focus Mode

Font Size

Last updated: 2026-10-23 14:19:31

AI-Translated

Overview
This section mainly describes how to set and manage the parameters of Kubernetes control plane components (APIServer, KubeControllerManager, and KubeScheduler) in a TKE cluster.
Notes
If the currently available parameters do not meet your business requirements, you can submit a ticket for consultation. When submitting the ticket, provide your account APPID, cluster ID, the components to be set, and their parameters.
Major version upgrades of a cluster: Since launch parameters may become incompatible after cross-version Kubernetes upgrades, please confirm whether any parameters have been deprecated before proceeding with the upgrade.
Parameter Introduction
The following tables list the customizable parameter ranges and the default values provided by the TKE cluster. Ensure that the modified parameter values are within the system-supported ranges. The specific meanings of each parameter can be obtained from the community.
The feature-gates parameters cannot be set if no feature-gate is available in the current version.
APIServer
Parameter Name
Parameter Type
Default Value
Value Range
Applicable Kubernetes Version
--feature-gates
mapStringBool
-
-
1.16+
--goaway-chance
float
0
[0, 0.02]
1.18+
--service-node-port-range
portRange
30000-32767
10500-32767
1.20+
--kubelet-preferred-address-types
strings
Hostname,InternalDNS,InternalIP,ExternalDNS,ExternalIP
('Hostname','InternalDNS','InternalIP','ExternalDNS','ExternalIP')
1.20+
KubeControllerManager
Parameter Name
Parameter Type
Default Value
Value Range
Applicable Kubernetes Version
--kube-api-burst
int
30
[30, 3000]
1.14+
--kube-api-qps
qps
20
[20, 5000]
1.14+
--node-monitor-grace-period
duration
40s
[40s, 1h]
1.14+
--node-startup-grace-period
duration
1m0s
[1m, 1h]
1.14+
--pod-eviction-timeout
duration
5m
[5m, 1h]
1.14-1.24
--cluster-signing-duration
duration
8760h0m0s
[8760h, 87600h]
1.20+
--concurrent-cron-job-syncs
int
5
[5, 20]
1.20+
--concurrent-deployment-syncs
int
5
[5, 20]
1.14+
--concurrent-endpoint-syncs
int
5
[5, 20]
1.14+
--concurrent-ephemeralvolume-syncs
int
5
[5, 20]
1.24+
--concurrent-gc-syncs
int
20
[20, 50]
1.14+
--concurrent-horizontal-pod-autoscaler-syncs
int
5
[5, 20]
1.26+
--concurrent-job-syncs
int
5
[5, 20]
1.14+
--concurrent-namespace-syncs
int
10
[10, 20]
1.14+
--concurrent-rc-syncs
int
5
[5, 20]
1.14+
--concurrent-replicaset-syncs
int
5
[5, 20]
1.14+
--concurrent-resource-quota-syncs
int
5
[5, 20]
1.14+
--concurrent-service-endpoint-syncs
int
5
[5, 20]
1.16+
--concurrent-service-syncs
int
1
[1, 5]
1.14+
--concurrent-serviceaccount-token-syncs
int
5
[5, 20]
1.14+
--concurrent-statefulset-syncs
int
5
[5, 20]
1.16+
--concurrent-ttl-after-finished-syncs
int
5
[5, 20]
1.14+
--endpoint-updates-batch-period
duration
0
[0s, 10s]
1.14+
--endpointslice-updates-batch-period
duration
0
[0s, 10s]
1.18+
--horizontal-pod-autoscaler-cpu-initialization-period
duration
5m0s
[1m,10m]
1.14+
--horizontal-pod-autoscaler-downscale-stabilization
duration
5m0s
[1m,10m]
1.14+
--horizontal-pod-autoscaler-initial-readiness-delay
duration
30s
[10s,1m]
1.14+
--horizontal-pod-autoscaler-sync-period
duration
15s
[5s, 1m]
1.14+
--horizontal-pod-autoscaler-tolerance
float
0.1
[0.01, 0.3]
1.14+
--large-cluster-size-threshold
int
50
[10, 100]
1.14+
--namespace-sync-period
duration
5m0s
[1m, 10m]
1.14+
--node-eviction-rate
float
0.1
[0.01, 0.1]
1.14+
--resource-quota-sync-period
duration
5m0s
[1m, 10m]
1.14+
--secondary-node-eviction-rate
float
0.01
[0.001, 0.01]
1.14+
--terminated-pod-gc-threshold
int
12500
[0, 12500]
1.14+
--unhealthy-zone-threshold
float
0.55
[0.55, 1]
1.14+
--feature-gates
mapStringBool
-
-
1.14+
KubeScheduler
Parameter Name
Parameter Type
Default Value
Value Range
Applicable Kubernetes Version
--evict-filter-toleration
duration
5m0s
[30s,240h]
1.18+
--hard-pod-affinity-symmetric-weight
int
1
[0,100]
1.14-1.20
--kube-api-burst
int
100
[30,3000]
1.14+
--kube-api-qps
float
50
[20,5000]
1.14+
--feature-gates
mapStringBool
-
-
1.14+
--feature-gates=EnableEvictHistory
-
-
-
1.14+
--feature-gates=EnableFitIPResource
-
-
-
1.14+
--feature-gates=EnableLocalReplicas
-
-
-
1.20,1.24+
The following feature-gates parameters can be set in the APIServer, KubeControllerManager, and KubeScheduler components:
feature-gates Parameter Name
Supported Version
StatefulSetStartOrdinal
1.26,1.28
TTLAfterFinished
1.14,1.16,1.18,1.20
MaxUnavailableStatefulSet
1.24,1.26,1.28
EphemeralContainers
1.16,1.18,1.20,1.22
Overview
Cluster Creation
1. Log in to the Tencent Cloud TKE console and click Clusters in the left sidebar.
2. On the Cluster page, click Create above the cluster list.
3. On the Create Cluster page, choose Advanced Settings > Set Kubernetes Custom Component Parameters.
Existing Clusters
1. Log in to the Tencent Cloud TKE console and click Clusters in the left sidebar.
2. On the Cluster page, select the target cluster ID to go to the Basic Information page.
3. In the left sidebar, choose Node Management. Then, choose Master&Etcd.
4. Click Edit in the Custom Parameters module to configure parameters.
﻿﻿
Attention:
Modifications to control plane component parameters require a rolling update to take effect. To avoid business impact, it is recommended that you perform this operation during off-peak hours.
Cluster Upgrade
1. Log in to the Tencent Cloud TKE console and click Clusters in the left sidebar.
2. On the Cluster page, select the target cluster ID to go to the Basic Information page.
3. In the cluster Basic Information section, click Upgrade next to the Kubernetes version and set the Kubernetes component startup parameters.
﻿﻿
Attention:
Some startup parameters will no longer be supported as Kubernetes evolves. Before upgrading, carefully check whether any parameters are deprecated or incompatible between the target version and the current version. For more information, refer to the community Kubernetes Changelog and API Migration Guide.

Help and Support

Was this page helpful?

You can also Contact sales or Submit a Ticket for help.

Help us improve! Rate your documentation experience in 5 mins.

Feedback

tencent cloud

Tencent Kubernetes Engine

Customizing the Control Plane Component Parameters

Overview

Notes

Parameter Introduction

APIServer

KubeControllerManager

KubeScheduler

Overview

Cluster Creation

Existing Clusters

Cluster Upgrade

Help and Support

Parameter Name	Parameter Type	Default Value	Value Range	Applicable Kubernetes Version
--feature-gates	mapStringBool	-	-	1.16+
--goaway-chance	float	0	[0, 0.02]	1.18+
--service-node-port-range	portRange	30000-32767	10500-32767	1.20+
--kubelet-preferred-address-types	strings	Hostname,InternalDNS,InternalIP,ExternalDNS,ExternalIP	('Hostname','InternalDNS','InternalIP','ExternalDNS','ExternalIP')	1.20+

feature-gates Parameter Name	Supported Version
StatefulSetStartOrdinal	1.26,1.28
TTLAfterFinished	1.14,1.16,1.18,1.20
MaxUnavailableStatefulSet	1.24,1.26,1.28
EphemeralContainers	1.16,1.18,1.20,1.22