Skip to content

Commit 7eb9504

Browse files
committed
Recommendation around master node sizing to handle upgrades
This commit: - Adds a recommendation around master node sizing to handle upgrades and failures on large and dense clusters as the resource usage is expected to increase in such situations. - Adds a note that the data points are only valid for OpenShift clusters using OpenShiftSDN as the network plugin.
1 parent 8361c56 commit 7eb9504

File tree

1 file changed

+12
-0
lines changed

1 file changed

+12
-0
lines changed

modules/master-node-sizing.adoc

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -26,11 +26,23 @@ The control plane node resource requirements depend on the number of nodes in th
2626

2727
|===
2828

29+
On a cluster with three masters or control plane nodes, the CPU and memory usage will spike up when one of the nodes is stopped, rebooted or fails because the remaining two nodes must handle the load in order to be highly available. This is also expected during upgrades because the masters are cordoned, drained, and rebooted serially to apply the operating system updates, as well as the the control plane Operators update. To avoid cascading failures on large and dense clusters, keep the overall resource usage on the master nodes to at least half of all available capacity to handle the resource usage spikes. Increase the CPU and memory on the master nodes accordingly.
30+
31+
[IMPORTANT]
32+
====
33+
The node sizing varies depending on the number of nodes and object counts in the cluster. It also depends on whether the objects are actively being created on the cluster. During object creation, the control plane is more active in terms of resource usage compared to when the objects are in the `running` phase.
34+
====
35+
2936
[IMPORTANT]
3037
====
3138
Because you cannot modify the control plane node size in a running {product-title} {product-version} cluster, you must estimate your total node count and use the suggested control plane node size during installation.
3239
====
3340

41+
[IMPORTANT]
42+
====
43+
The recommendations are based on the data points captured on {product-title} clusters with OpenShiftSDN as the network plug-in.
44+
====
45+
3446
[NOTE]
3547
====
3648
In {product-title} {product-version}, half of a CPU core (500 millicore) is now reserved by the system by default compared to {product-title} 3.11 and previous versions. The sizes are determined taking that into consideration.

0 commit comments

Comments
 (0)