Skip to content

Commit d1b8300

Browse files
DOCSP-47926 -- add unidirectional scaling note (#2076)
* DOCSP-47926 -- add unidirectional scaling note * DOCSP-47926 -- unidirectional scaling external review * DOCSP-47926 -- external review
1 parent f99018e commit d1b8300

File tree

1 file changed

+14
-0
lines changed

1 file changed

+14
-0
lines changed

source/multi-cluster-sharded-cluster.txt

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -107,6 +107,19 @@ But in the overrides we change shard ``sc-0`` to have five members, two on clust
107107
``1``, two on cluster ``2``, and cluster ``3`` still has one shard as per the
108108
default.
109109

110+
.. note:: Only unidirectional scaling is supported.
111+
112+
When you scale shard, config server, or mongos replicas you can only scale
113+
resources up or down in order to ensure the correctness of scaling. This rule
114+
applies to both single |k8s| cluster deployments and those that are
115+
distributed across multiple |k8s| clusters. Additionally, in multi-cluster
116+
deployments the unidirectional scaling rule applies to all resource types.
117+
For example, you can't add more nodes (scaling up) to shards while simultaneously
118+
removing (scaling down) config servers or mongos. You can no longer "move" one
119+
node from one cluster to another without changing the total number of members.
120+
Rather, you must first perform a scale-up operation and then execute a separate
121+
change for scaling down.
122+
110123
This example configuration also shifts (with ``shardOverrides``) the primary to cluster ``2``,
111124
for the shard ``sc-0``, which can reduce latency for users operating in the region where cluster ``2``
112125
is located. In this way, you still have resilience across the clusters
@@ -143,6 +156,7 @@ defined in the override definition are removed.The ``merge`` value indicates
143156
that a single field is updated, and the ``replace`` value indicates that the
144157
complete parent object is overridden.
145158

159+
146160
Customize Persistence and Statefulset Settings
147161
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
148162

0 commit comments

Comments
 (0)