Skip to main content
Version: v1.1

Custom Installation

Install KubeVela with cert-manager

By default, KubeVela will use a self-signed certificate provided by kube-webhook-certgen for admissionWebhooks. You can also use cert-manager if it's available. Note that you need to install cert-manager before the KubeVela chart.

helm repo add jetstack
helm repo update
helm install cert-manager jetstack/cert-manager --namespace cert-manager --version v1.2.0 --create-namespace --set installCRDs=true

Install kubevela with enabled certmanager:

helm install --create-namespace -n vela-system --set admissionWebhooks.certManager.enabled=true kubevela kubevela/vela-core --wait

Install Pre-release

Add flag --devel in command helm search to choose a pre-release version in format <next_version>-rc-master. It means a release candidate version build on master branch, such as 0.4.0-rc-master.

helm search repo kubevela/vela-core -l --devel
    NAME                      CHART VERSION         APP VERSION           DESCRIPTION
kubevela/vela-core 0.4.0-rc-master 0.4.0-rc-master A Helm chart for KubeVela core
kubevela/vela-core 0.3.2 0.3.2 A Helm chart for KubeVela core
kubevela/vela-core 0.3.1 0.3.1 A Helm chart for KubeVela core

And try the following command to install it.

helm install --create-namespace -n vela-system kubevela kubevela/vela-core --version <next_version>-rc-master --wait
NAME: kubevela
LAST DEPLOYED: Thu Apr 1 19:41:30 2021
NAMESPACE: vela-system
STATUS: deployed
Welcome to use the KubeVela! Enjoy your shipping application journey!

Install Kubectl Vela Plugin

Install vela kubectl plugin can help you to ship applications more easily!

  1. Install and set up Krew on your machine.
  2. Discover plugins available on Krew:
kubectl krew update
  1. install kubectl vela:
kubectl krew install vela

For more usage please reference kubectl plugin.


Step 1. Update Helm repo

You can explore the newly released chart versions of KubeVela by run:

helm repo update
helm search repo kubevela/vela-core -l

Step 2. Upgrade KubeVela CRDs

kubectl apply -f
kubectl apply -f
kubectl apply -f
kubectl apply -f
kubectl apply -f
kubectl apply -f
kubectl apply -f
kubectl apply -f
kubectl apply -f
kubectl apply -f
kubectl apply -f
kubectl apply -f
kubectl apply -f
kubectl apply -f
kubectl apply -f
kubectl apply -f
kubectl apply -f

Tips: If you see errors like * is invalid: spec.scope: Invalid value: "Namespaced": filed is immutable. Please delete the CRD which reports error and re-apply the kubevela crds.

 kubectl delete crd \ \ \

Step 3. Upgrade KubeVela Helm chart

helm upgrade --install --create-namespace --namespace vela-system  kubevela kubevela/vela-core --version <the_new_version> --wait


NameDescriptioncapabilityOpen Source Project Reference
terraformBasic addon to Provide Cloud Resources-
fluxcdSupport Deployment of Helm and Kustomize componentskustomize、helm
kruiseSupport more powerful workload featurecloneset
prometheusSupport basic observability from Promethus-
kedaSupport event driven auto scaling-
ocmSupport Multi-cluster Application Deployment-
observabilitySupport KubeVela core observability--
  1. Search all addons
vela addon list
  1. Install addons (use fluxcd as example)
vela addon enable fluxcd
  1. Disable addons
vela addon disable fluxcd

Please remove all application using this addon before disable it.

Multi-Cluster Management

KubeVela can orchestrate applications across multiple Kubernetes clusters. This capability is enabled by default, but you can enable it manually by running the following command:

helm upgrade --install kubevela kubevela/vela-core -n vela-system --set multicluster.enabled=true --create-namespace --wait

Verify that multi-cluster is enabled:

> kubectl get APIService
NAME SERVICE AVAILABLE AGE vela-system/kubevela-cluster-gateway-service True 7h40m

Clean Up


helm uninstall -n vela-system kubevela
rm -r ~/.vela

This will uninstall KubeVela server component and its dependency components. This also cleans up local CLI cache.

Then clean up CRDs (CRDs are not removed via helm by default):

 kubectl delete crd \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \