For upgrading existing KubeVela, please read the upgrade guide.
- Kubernetes cluster >= v1.15.0
kubectlinstalled and configured
KubeVela is a simple custom controller that can be installed on any Kubernetes cluster including managed offerings or your own clusters. The only requirement is please ensure ingress-nginx is installed and enabled.
For for local deployment and test, you could use
Follow the minikube installation guide.
Then spins up a minikube cluster
Follow this guide to install kind.
Then spins up a kind cluster:
Then install ingress for kind:
Add helm chart repo for KubeVelahelm repo add kubevela https://kubevelacharts.oss-accelerate.aliyuncs.com/core
Update the chart repohelm repo update
Install KubeVelahelm install --create-namespace -n vela-system kubevela kubevela/vela-core
Verify chart installed successfullyhelm test kubevela -n vela-system
Click to see the expected output of helm testPod kubevela-application-test pendingPod kubevela-application-test pendingPod kubevela-application-test runningPod kubevela-application-test succeededNAME: kubevelaLAST DEPLOYED: Tue Apr 13 18:42:20 2021NAMESPACE: vela-systemSTATUS: deployedREVISION: 1TEST SUITE: kubevela-application-testLast Started: Fri Apr 16 20:49:10 2021Last Completed: Fri Apr 16 20:50:04 2021Phase: SucceededTEST SUITE: first-vela-appLast Started: Fri Apr 16 20:49:10 2021Last Completed: Fri Apr 16 20:49:10 2021Phase: SucceededNOTES:Welcome to use the KubeVela! Enjoy your shipping application journey!
Using KubeVela CLI gives you a simplified workflow with optimized output comparing to using
kubectl. It is not mandatory though.
Here are three ways to get KubeVela Cli:
- Download directly from releases
Update your brew firstly.
Then install kubevela client.
- Download the latest
velabinary from the releases page.
- Unpack the
velabinary and add it to
$PATHto get started.
Known Issue(https://github.com/oam-dev/kubevela/issues/625): If you're using mac, it will report that “vela” cannot be opened because the developer cannot be verified.
The new version of MacOS is stricter about running software you've downloaded that isn't signed with an Apple developer key. And we haven't supported that for KubeVela yet.
You can open your 'System Preference' -> 'Security & Privacy' -> General, click the 'Allow Anyway' to temporarily fix it.
You can enable this feature by installing a minimal Flux v2 chart as below:
Or you could install full Flux v2 following its own guide of course.
Checking available application components and traits by
vela CLI tool:
These capabilities are built-in so they are ready to use if showed up. KubeVela is designed to be programmable and fully self-service, so the assumption is more capabilities will be added later per your own needs.
Also, whenever new capabilities are added in the platform, you will immediately see them in above output.
See the advanced installation guide to learn more about installation details.