Modifying Cluster Configurations
Cluster configuration parameters define node behavior, resource allocation, communication rules, and scaling policies in a distributed system. They affect the cluster's performance, stability, scalability, and fault tolerance. You can customize the core components of a CCE cluster by adjusting these parameter settings. The following table lists cluster configuration parameters that you can adjust as needed.
|
Category |
Description |
|---|---|
|
Control resource scheduling, manage requests, ensure security, and toggle feature statuses to maintain efficient cluster operation and proper resource allocation. Modifying kube-apiserver parameters will restart the cluster and terminate existing persistent connections. Exercise caution when performing this operation. |
|
|
Manage and optimize resource scheduling, request control, and GPU resource allocation in clusters. You can dynamically adjust scheduling policies based on cluster loads and resource requirements to ensure efficient cluster running and maximize resource utilization. |
|
|
Control the behavior and synchronization frequency of different controllers in a cluster to optimize cluster resource management and task scheduling. |
|
|
Network component configurations (supported only by CCE Turbo clusters) |
Control and optimize the management of network resources in clusters, especially in heavy-load and large-scale clusters, to ensure efficient network running and proper resource allocation. |
|
Network component configurations (supported only by CCE clusters using VPC networks) |
Specify the IP address range that does not require SNAT. This avoids unnecessary SNAT and optimizes network performance. |
|
External controller manager configurations (supported only by clusters v1.21 or later) |
Restrict the resource usage in the namespace to ensure fair and reasonable resource allocation. |
|
kube-proxy Configurations (Supported Only by Clusters that Use IPVS) |
Control the IPVS scheduling policy of nodes in the default node pool in a cluster. |
Modifying Cluster Configuration Parameters
You can use either of the following ways.
- Log in to the CCE console. In the navigation pane, choose Clusters.
- Locate the target cluster, click ... to view more operations on the cluster, and choose Manage. This function allows you to modify parameter settings of Kubernetes native components and proprietary components.
Figure 1 Configuration management
- In the Manage Component window, modify the Kubernetes parameter values based on service requirements. For details about the parameters, see kube-apiserver configurations.
You can modify the CCE cluster configuration parameters using an API. For details, see API Reference. For details about how to call an API, see Making an API Request.
PUT /api/v3/projects/{project_id}/clusters/{cluster_id}/nodepools/master/configuration
|
Parameter |
Description |
|---|---|
|
project_id |
Project ID. For details about how to obtain the project ID, see How to Obtain Parameters in the API URI. |
|
cluster_id |
Cluster ID. For details about how to obtain the cluster ID, see How to Obtain Parameters in the API URI. |
The request body is as follows:
{
"kind" : "Configuration",
"apiVersion" : "v3",
"metadata" : {
"name" : "configuration"
},
"spec" : {
"packages" : [ {
"name" : "kube-apiserver",
"configurations" : [ {
"name" : "default-not-ready-toleration-seconds",
"value" : 300
}, {
"name" : "default-unreachable-toleration-seconds",
"value" : 300
} ]
} ]
}
}
In this example, the configuration parameters of the cluster server (kube-apiserver) are modified as follows:
- Toleration time for nodes in the NotReady state during container migration (default-not-ready-toleration-seconds): 300
- Toleration time for nodes in the unreachable state during container migration (default-unreachable-toleration-seconds): 300
Cluster Configuration Parameters
The table below describes the supported configurations.
kube-proxy Configurations (Supported Only by Clusters that Use IPVS)
|
Item |
Parameter |
Description |
Value |
Configuration Method |
|---|---|---|---|---|
|
IPVS Scheduling Policy |
CLUSTER_IPVS_SCHEDULER |
The IPVS load-balancing algorithm for control plane nodes. If this parameter is not set, the round robin (RR) algorithm will be used by default. The options are as follows:
Cluster versions: v1.28.15-r60, v1.29.15-r20, v1.30.14-r20, v1.31.10-r20, v1.32.6-r20, v1.33.5-r10, or later |
Default: rr |
Console/API |
To modify the configuration, you need to add the CRD resource below to the cluster. The options field is an object in key/value format and needs to be converted into a JSON character string to transfer parameters. The key is the name of the IPVS scheduling algorithm parameter (CLUSTER_IPVS_SCHEDULER), and the value is the IPVS scheduling algorithm.
{
"apiVersion": "version.cce.io/v1beta1",
"kind": "PackageVersion",
"metadata": {
"name": "common-config"
},
"spec": {
"packageTemplate": [
{
"name": "kube-proxy",
"options": "{\"CLUSTER_IPVS_SCHEDULER\":\"dh\"}"
}
]
}
}
References
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot
