Skip to main content
Version: v1.5

CLI Commands

Getting Started

  • vela env - Manage environments for vela applications to run.

  • vela init - Create scaffold for vela application.

  • vela up - Deploy one application

    Deploy one application based on local files or re-deploy an existing application. With the -n/--namespace flag, you can choose the location of the target application.

    To apply application from file, use the -f/--file flag to specify the application file location.

    To give a particular version to this deploy, use the -v/--publish-version flag. When you are deploying an existing application, the version name must be different from the current name. You can also use a history revision for the deploy and override the current application by using the -r/--revision flag.

  • vela show - Show the reference doc for component, trait, policy or workflow types. 'vela show' equals with 'vela def show'.

Managing Applications

  • vela addon - Manage addons for extension.
  • vela status - Show status of vela application.
  • vela delete - Delete an application.
  • vela exec - Execute command inside container based vela application.
  • vela port-forward - Forward local ports to container/service port of vela application.
  • vela logs - Tail logs for vela application.
  • vela ql - Show result of executing velaQL, use it like: vela ql --query "inner-view-name{param1=value1,param2=value2}" vela ql --file ./ql.cue
  • vela live-diff - Compare application and revisions
  • vela ls - List all vela applications.
  • vela dry-run - Dry-run application locally, render the Kubernetes resources as result to stdout. vela dry-run -d /definition/directory/or/file/ -f /path/to/app.yaml

You can also specify a remote url for app: vela dry-run -d /definition/directory/or/file/ -f https://remote-host/app.yaml

Continuous Delivery

Managing Extension

  • vela uischema - Manage UI schema for addons.
  • vela def - Manage X-Definitions for extension.
  • vela registry - Manage Registry of X-Definitions for extension.
  • vela provider - Authenticate Terraform Cloud Providers by managing Terraform Controller Providers with its credential secret
  • vela component - List component types installed and discover more in registry.
  • vela trait - List trait types installed and discover more in registry.


  • vela uninstall - Uninstalls KubeVela from a Kubernetes cluster.
  • vela install - The Kubevela CLI allows installing Kubevela on any Kubernetes derivative to which your kube config is pointing to.
  • vela completion - Output shell completion code for the specified shell (bash or zsh). The shell code must be evaluated to provide interactive completion of vela commands.
  • vela export - Export deploy manifests from appfile or application.
  • vela system - Manage system, incluing printing the system deployment information in vela-system namespace and diagnosing the system's health.
  • vela version - Prints vela build version information.
Auto generated by script in KubeVela.