Federations, How-to guides
All federation operations are performed through the Vantage CLI.
Manage federations
| Task | Command |
|---|---|
| Create a federation | uvx v8x cluster federation create <name> |
| List federations | uvx v8x cluster federation list |
| Get federation details | uvx v8x cluster federation get <name> |
| Update a federation | uvx v8x cluster federation update <name> |
| Delete a federation | uvx v8x cluster federation delete <name> |
Manage federation membership
Clusters are associated with a federation at creation or update time. Run uvx v8x cluster federation get <name> to verify which clusters belong to the federation.
Success looks like this: the membership change is applied, and the federation's cluster list reflects the update.
Route jobs to a federation
When submitting a job through the Vantage UI:
Open the job submission form
Open the job submission form.
Choose the federation
In the cluster selector, choose the federation name instead of a specific cluster.
Fill in job details
Fill in the remaining job details as usual.
Submit
Submit. Vantage routes the job to an available member cluster.
Jobs targeting a federation show the assigned cluster on the submission detail page after routing completes.
Monitor federation usage
Check which jobs ran on which cluster:
Open the submission detail page
Open the submission detail page.
Check the routed cluster
The Cluster field shows the cluster the job was routed to.
View federation metadata
Use uvx v8x cluster federation get <name> --json to see basic federation metadata.
For all CLI flags and options, see the federation section in the CLI reference.