For upgrading existing KubeVela, please read the upgrade guide.
- Kubernetes cluster >= v1.19 && <= v1.22
KubeVela relies on Kubernetes as a control plane. The control plane could be any managed Kubernetes offering or your cluster.
For local deployment and test, you could use
For production usage, you could use your Kubernetes cluster or Kubernetes services provided by cloud providers. For offline installation, please refer to KubeVela Offline Installation Guide.
- Cloud Provider
Minikube is NOT RECOMMENDED for production.
Follow the minikube installation guide.
Then spins up a minikube cluster
Install ingress to enable service route:
The k3s is great for: Edge、IoT、Development.
- Install k3s
K3s provides an installation script that is a convenient way to install it as a service on systemd or openrc based systems.
Follow this guide to get more support.
- Copy kubeconfig
This installation applies to the production environment. Please prepare 1~N servers or VMs.
This section guides to install a RKE Kubernetes cluster, you can refer to their installation guides for more details.（1） Docker
The RKE depends on docker, Please install Docker on all servers or virtual machines, if not installed follow the docker installation guide.（2）Install RKE:
Download RKE binary from RKE release page.
If your internet access was limited, try using the binary cached by KubeVela team:
Please switch to a non-root user who has permission to operate docker and execute the following commands.
Kind is NOT RECOMMENDED for production.
Follow this guide to install kind.
Then spins up a kind cluster:
KubeVela CLI provides an easy to engage and manage your application delivery in command lines.
- Download directly from releases
Only the official release version is supported.
Update your brew first. Please note that the brew method only supports the installation of the official release version.
Then install KubeVela CLI
- Download the latest
velabinary file via release log.
- Unzip the binary file, and configure the environment variables in
$PATH, and you're done.
Installation Tips: If you are using a Mac system, it will pop up a warning that "vela" cannot be opened because the package from the developer cannot be verified.
MacOS imposes stricter restrictions on the software that can run in the system. You can temporarily solve this problem by opening
System Preference ->Security & Privacy -> Generaland clicking on
The version of vela CLI >= 1.2.3.
check out the outcome
If you are helm user, you can also use helm to install kubevela core:
helm v3.2.0+ required
This is optional if you don't use UI console of KubeVela.
VelaUX is a dashboard including UI+API services, it enables you to do everything around application delivery and management.
By default, velaux didn't have any exposed port, you can view it by:
> Cluster: local | Namespace: vela-system | Component: velaux | Kind: Service for visit.
If you have loadbalaner or ingress, please refer to VelaUX addon docs for more advanced installation ways.
VelaUX need authentication. Default username is admin and get default password as below
If there is no password in logs, you can get it from secret with the name
admin in the
Before uninstalling kubevela, you must delete all applications and disable all addons.
- Uninstall VelaUX
- Uninstall KubeVela Core
- Uninstall CRD
Before deleting, you must delete all CR resources.