Skip to main content
Version: v1.6

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 top - Launch UI to display platform overview information and diagnose the status for any specific application.
  • 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

  • vela auth -
  • vela cluster - Manage Kubernetes Clusters for Continuous Delivery.
  • vela config - Manage the configs, such as the terraform provider, image registry, helm repository, etc.
  • vela kube -
  • vela workflow - Operate the Workflow during Application Delivery. Note that workflow command is both valid for Application Workflow and WorkflowRun(expect for [restart, rollout] command, they're only valid for Application Workflow). The command will try to find the Application first, if not found, it will try to find WorkflowRun. You can also specify the resource type by using --type flag.

Managing Extension


  • 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.