@@ -310,23 +310,15 @@ helm upgrade $RELEASE_NAME vcluster-platform \
310310```
311311### Multiple agent replicas deployment
312312
313- For high availability and scalability, the platform agent can be deployed with multiple replicas. However, certain agent tasks must be executed by only one pod
313+ For high availability and scalability, the platform agent can be [ deployed with multiple replicas](../configure/high-availability) . However, certain agent tasks must be executed by only one pod
314314at a time to prevent duplicate actions, race conditions, or data corruption. Other tasks, such as concurrent background processing, can safely run in parallel
315315across replicas.
316316
317- #### Leader election
318-
319- Before scaling the platform agent beyond a single replica, you must enable leader election. This ensures that only one pod performs “singleton” tasks while
317+ Thus, by default, the leader election is enabled when [installing vCluster through Helm](../../install/helm) or [using vCluster CLI](../../install/quick-start-guide).
318+ This ensures that only one pod performs “singleton” tasks while
320319others act as standby or worker agents. Without leader election, multiple pods may perform the same critical operation, leading to inconsistent or
321320conflicting results.
322321
323- #### Recommended operational practices
324- - Enable leader election prior to scaling the agent above one replica.
325- - For sensitive operations (e.g., storage migrations or major version upgrades), temporarily scale the agent to a single replica, complete and validate the operation, then scale back up with leader election enabled.
326-
327- The agent is deployed and managed as a Helm release when the platform connects to a cluster. Configure replicas and leader election settings through Helm values,
328- not manual scaling, to ensure consistent configuration and reliable leader election.
329-
330322:::warning Avoid manual scaling of agent replicas
331323Do not manually scale Deployment replicas outside of Helm. Doing so can start extra pods without the expected flags or config, resulting in no leader
332324being elected, race conditions, or duplicate execution of singleton activities.
0 commit comments