Federation walkthroughs
Walk through creating a federation, adding clusters, and submitting jobs that route across clusters.
Create a federation and submit a cross-cluster job
This tutorial walks through creating a federation, adding clusters, and submitting a job that routes to an available cluster.
Prerequisites: Vantage CLI installed and authenticated, two or more connected clusters.
Create the federation
uvx v8x cluster federation create cross-region-pool --description "US and EU cluster pool"
Success looks like this: the tutorial step completes, and the expected resource or configuration is in place.
Verify it was created
uvx v8x cluster federation list shows the new federation. Each entry includes the name, description, and number of associated clusters.
Add clusters to the federation
Associate clusters during cluster creation or update by specifying the federation name. Run uvx v8x cluster federation get cross-region-pool to confirm the clusters appear in the federation's cluster list.
Submit a job targeting the federation
In the job submission form, select the federation instead of a specific cluster from the cluster dropdown. Vantage routes the job to whichever member cluster has capacity.
Monitor routing
The submission detail page shows which cluster the job was routed to. If no cluster can accept the job, it waits in the federation queue and retries automatically as capacity opens up.
Route jobs across regions
Use federations to distribute workloads across clusters in different geographic regions.
Create clusters in multiple regions
For example, one AWS cluster in us-east-1 and one in eu-west-1.
Create a federation
uvx v8x cluster federation create multi-region
Associate both clusters
When updating or configuring each cluster, set the federation target to multi-region.
Submit jobs without a region preference
Vantage picks the cluster with available capacity. If your US cluster is fully occupied, the job routes to the EU cluster instead of waiting.
Burst from on-premises to cloud
Handle peak demand by pairing a small on-premises cluster with one or more cloud clusters.
Connect your on-premises cluster
Install the Vantage connector on your infrastructure. See the on-premises guide for setup instructions.
Create a cloud cluster
Set up an AWS, Azure, or GCP cluster with auto-scaling compute pools and a low minimum node count.
Create a federation
uvx v8x cluster federation create burst-pool
Associate both clusters
Add the on-premises and cloud clusters to the federation.
Submit jobs normally
Day-to-day jobs run on the on-premises cluster. When demand spikes, Vantage routes overflow jobs to the cloud cluster automatically.
For federation CLI commands, see the federation section in the CLI reference.