@@ -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
108108default.
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+
110123This example configuration also shifts (with ``shardOverrides``) the primary to cluster ``2``,
111124for the shard ``sc-0``, which can reduce latency for users operating in the region where cluster ``2``
112125is 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
143156that a single field is updated, and the ``replace`` value indicates that the
144157complete parent object is overridden.
145158
159+
146160Customize Persistence and Statefulset Settings
147161~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
148162
0 commit comments