Skip to main content

CLI Command Reference

This document provides a comprehensive reference for all available CLI commands and their options.


Usage: vantage [OPTIONS] COMMAND [ARGS]...

╭─ Options ────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ version Show version and exit. │
│ login Authenticate against the Vantage CLI by obtaining an authentication token. │
│ logout Log out of the vantage-cli and clear saved user credentials. │
│ whoami Display information about the currently authenticated user. │
│ app Manage applications │
│ cloud Manage cloud provider configurations and integrations for your Vantage infrastructure. │
│ cluster Manage Vantage compute clusters for high-performance computing workloads. │
│ config Manage Vantage CLI configuration and settings. │
│ deployment Create and manage application deployments on Vantage compute clusters. │
│ job Manage computational jobs, scripts, submissions, and job templates for HPC workloads. │
│ license Manage software licenses, license servers, and licensing configurations. │
│ network Manage virtual networks, subnets, and network configurations for cloud infrastructure. │
│ notebook Manage Jupyter notebooks and computational notebooks for data science and research. │
│ profile Manage Vantage CLI profiles to work with different environments and configurations. │
│ storage Manage storage volumes, disks, and storage configurations for cloud infrastructure. │
│ cli-dash Vantage CLI Dashboard - Interactive terminal dashboard │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯


Authentication Commands

Login


Usage: vantage login [OPTIONS]

Authenticate against the Vantage CLI by obtaining an authentication token.

╭─ Options ────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ --json -j Output in JSON format │
│ --verbose -v Enable verbose terminal output │
│ --profile -p TEXT Profile name to use [default: default] │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯


Logout


Usage: vantage logout [OPTIONS]

Log out of the vantage-cli and clear saved user credentials.

╭─ Options ────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ --json -j Output in JSON format │
│ --verbose -v Enable verbose terminal output │
│ --profile -p TEXT Profile name to use [default: default] │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯


Whoami


Usage: vantage whoami [OPTIONS]

Display information about the currently authenticated user.

╭─ Options ────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ --json -j Output in JSON format │
│ --verbose -v Enable verbose terminal output │
│ --profile -p TEXT Profile name to use [default: default] │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯


Version Information


Usage: vantage version [OPTIONS]

Show version and exit.

╭─ Options ────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ --json -j Output in JSON format │
│ --verbose -v Enable verbose terminal output │
│ --profile -p TEXT Profile name to use [default: default] │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯


App Management


Usage: vantage app [OPTIONS] COMMAND [ARGS]...

Manage applications

╭─ Options ────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ list List available applications │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯


Cloud Management


Usage: vantage cloud [OPTIONS] COMMAND [ARGS]...

Manage cloud provider configurations and integrations for your Vantage infrastructure.

╭─ Options ────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ add Add a new cloud configuration. │
│ delete Delete a cloud configuration. │
│ get Get details of a specific cloud configuration. │
│ list List all configured cloud providers. │
│ update Update an existing cloud configuration. │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯


Cluster Management


Usage: vantage cluster [OPTIONS] COMMAND [ARGS]...

Manage Vantage compute clusters for high-performance computing workloads.

╭─ Options ────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ create Create a new Vantage cluster. │
│ delete Delete a Vantage cluster. │
│ get Get details of a specific Vantage cluster. │
│ list List all Vantage clusters. │
│ federation Manage Vantage compute federations for distributed workloads. │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯


Deployment Management


Usage: vantage deployment [OPTIONS] COMMAND [ARGS]...

Create and manage application deployments on Vantage compute clusters.

╭─ Options ────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ list List all active deployments from ~/.vantage-cli/deployments.yaml. │
│ slurm-juju-localhost Commands for slurm-juju-localhost. │
│ jupyterhub-microk8s-localhost Commands for jupyterhub-microk8s-localhost. │
│ slurm-microk8s-localhost Commands for slurm-microk8s-localhost. │
│ slurm-multipass-localhost Commands for slurm-multipass-localhost. │
│ keycloak-microk8s-localhost Commands for keycloak-microk8s-localhost. │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯


Job Management


Usage: vantage job [OPTIONS] COMMAND [ARGS]...

Manage computational jobs, scripts, submissions, and job templates for HPC workloads.

╭─ Options ────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ script Manage job scripts for computational workloads and batch processing. │
│ submission Manage job submissions │
│ template Manage job templates │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯


License Management


Usage: vantage license [OPTIONS] COMMAND [ARGS]...

Manage software licenses, license servers, and licensing configurations.

╭─ Options ────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ booking License booking management commands │
│ server Manage license servers for software licensing and compliance. │
│ product Manage license products and software licensing definitions. │
│ configuration Manage license configurations and policy settings. │
│ deployment Manage license deployments for software distribution and activation. │
│ feature Feature management commands │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯


Network Management


Usage: vantage network [OPTIONS] COMMAND [ARGS]...

Manage virtual networks, subnets, and network configurations for cloud infrastructure.

╭─ Options ────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ attach Attach a network interface to an instance. │
│ create Create a new virtual network. │
│ delete Delete a virtual network. │
│ detach Detach a network interface from an instance. │
│ get Get details of a specific virtual network. │
│ list List all virtual networks. │
│ update Update a virtual network configuration. │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯


Notebook Management


Usage: vantage notebook [OPTIONS] COMMAND [ARGS]...

Manage Jupyter notebooks and computational notebooks for data science and research.

╭─ Options ────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ create Create a new Jupyter notebook server. │
│ delete Delete notebook server. │
│ get Get notebook server details. │
│ list List notebook servers. │
│ update Update a Jupyter notebook configuration. │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯


Profile Management


Usage: vantage profile [OPTIONS] COMMAND [ARGS]...

Manage Vantage CLI profiles to work with different environments and configurations.

╭─ Options ────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ create Create a new Vantage CLI profile. │
│ delete Delete a Vantage CLI profile. │
│ get Get details of a specific Vantage CLI profile. │
│ list List all Vantage CLI profiles. │
│ use Activate a profile for use in the current session. │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯


Storage Management


Usage: vantage storage [OPTIONS] COMMAND [ARGS]...

Manage storage volumes, disks, and storage configurations for cloud infrastructure.

╭─ Options ────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ attach Attach a storage volume to an instance. │
│ create Create a new storage volume. │
│ delete Delete a storage volume. │
│ detach Detach a storage volume from an instance. │
│ get Get details of a specific storage volume. │
│ list List all storage volumes. │
│ update Update a storage volume configuration. │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯


Configuration Management


Usage: vantage config [OPTIONS] COMMAND [ARGS]...

Manage Vantage CLI configuration and settings.

╭─ Options ────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ clear Clear all user tokens and configuration. │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯