Installation

1. Install VelaD

VelaD packages KubeVela with all dependencies that enables you to run KubeVela on any of docker compatible environments or linux system.

  • VelaD provides Kubernetes by leveraging K3s on linux or k3d on docker environment.
  • KubeVela along with all related images, and vela command line are packaged together that enables air-gapped installation.
  • VelaD suits great for local development and quick demos, while we strongly recommend you to install KubeVela with managed Kubernetes services for production usage.

Prerequisites

  • Docker v20.10.5+ (runc >= v1.0.0-rc93) or Linux system

Download VelaD

It will download and place the binary in your system PATH, so you may be required for root privilege during the installation process. If you don’t need the automation with root access, you can download from the release page and uncompress manually.

  • MacOS/Linux
  1. curl -fsSl https://static.kubevela.net/script/install-velad.sh | bash -s v1.4.8
  • Windows

Only the official release version is supported.

Run following command in powershell:

  1. powershell -Command "iwr -useb https://static.kubevela.net/script/install-velad.ps1 | iex"

Check velad and vela command line tools are exist in /usr/local/bin/ for MacOS/Linux or C:\vela\ for Windows.

Setup

  1. velad install

expected output:

  1. Preparing K3s images...
  2. Successfully prepare k3s image:  /Users/sunjianbo/.vela/velad/k3s/k3s-airgap-images-amd64.tgz
  3. Successfully prepare k3d images
  5. ...snip...
  7. KubeVela control plane has been successfully set up on your cluster.
  8. If you want to enable dashboard, please run "vela addon enable /Users/sunjianbo/.vela/addons/velaux"
  10. Keep the token below if you want to restart the control plane
  11. K1075e7f6c77555e6ebdaf4854e4a2f39ae4287cfad23f27cdac5b33608d44633fe::server:zSpzbdbGzVxOwfBvvjgT
  13. 🚀  Successfully install KubeVela control plane
  14. 🔭  See available commands with `vela help`

Export the Kubernetes config

  1. export KUBECONFIG=$(velad kubeconfig --host)
  2. vela comp

2. Install VelaUX

This is optional if you don’t use UI console of KubeVela.

VelaUX is a dashboard including UI console and API services.

  1. vela addon enable ~/.vela/addons/velaux

expected output:

  1. Addon: velaux enabled Successfully.

By default, velaux didn’t have any exposed port, If there is the browser in local, you can view it by:

  1. vela port-forward addon-velaux -n vela-system 8080:80

Choose > Cluster: local | Namespace: vela-system | Component: velaux | Kind: Service for visit.

If you are installing it in a remote environment such as a virtual machine, you can refer to VelaUX addon document to expose an endpoint or other advanced installation arguments.

VelaUX needs authentication. The default username is admin and the password is VelaUX12345.

It requires you to override with a new password for the first login, please make sure to remember the new password.

3. Cleanup

  1. velad uninstall

This command will clean up KubeVela controllers along with the Kubernetes cluster, refer to the advanced guide for more detailed steps.

Next Step