Skip to main content

How-to guides

Task-oriented recipes for creating and managing compute federations.

Federations — How-to guides

All federation operations are performed through the Vantage CLI.

Manage federations

TaskCommand
Create a federationvantage cluster federation create <name>
List federationsvantage cluster federation list
Get federation detailsvantage cluster federation get <name>
Update a federationvantage cluster federation update <name>
Delete a federationvantage cluster federation delete <name>

Manage federation membership

Clusters are associated with a federation at creation or update time. Run vantage cluster federation get <name> to verify which clusters belong to the federation.

Route jobs to a federation

When submitting a job through the Vantage UI:

  1. Open the job submission form.
  2. In the cluster selector, choose the federation name instead of a specific cluster.
  3. Fill in the remaining job details as usual.
  4. 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:

  1. Open the submission detail page.
  2. The Cluster field shows the cluster the job was routed to.
  3. Use vantage cluster federation get <name> --json to see basic federation metadata.

For all CLI flags and options, see the CLI reference.

Ask AI
Ask a question about Vantage Compute...