Installation
For upgrading existing KubeVela, please read the upgrade guide.
the 1.2 version is released, go to install
#
1. Choose Control Plane ClusterRequirements:
- Kubernetes cluster >= v1.18.0
kubectl
installed and configured
KubeVela relies on Kubernetes as control plane. The control plane could be any managed Kubernetes offering or your own cluster.
For local deployment and test, you could use kind
or minikube
. For production usage, you could use Kubernetes services provided by cloud providers.
- Kind
- RKE
- Minikube
- Cloud Provider
Follow the minikube installation guide.
Then spins up a minikube cluster
Install ingress to enable service route:
{" "}
(1)Install docker:The rke depend on docker, Follow the docker installation guide.
{" "}
(2)Install rke:Download rke binary from rke release page.
If you have limited Internet access:
{" "}
(3)Install kubernetes cluster:Follow this guide to install kind.
Then spins up a kind cluster:
Install ingress to enable service route:
- Alibaba Cloud ACK Service
- AWS EKS Service
- Azure AKS Service
- Google GKE Service
Please ensure ingress-nginx is installed and enabled.
#
2. Install KubeVelaBefore install, you have to make sure the Helm is available. Follow this guide to install helm.
If you find it hard to install Helm, Click this
Add and update Helm chart repo for KubeVela
Install KubeVela
You can refer to advanced installation guide for more custom ways.
Verify chart installed successfully
Click to see the expected output of helm test
#
3. [Optional] Get KubeVela CLIKubeVela CLI gives you a simplified workflow to manage applications with optimized output. It is not mandatory though.
KubeVela CLI could be installed as kubectl plugin, or install as standalone binary.
- Script
- Homebrew
- Download directly from releases
macOS/Linux
Windows
macOS/Linux
Update your brew firstly.
Then install kubevela client.
- Download the latest
vela
binary from the releases page. - Unpack the
vela
binary and add it to$PATH
to get started.
Known Issue(https://github.com/kubevela/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.
#
4. [Optional] Enable AddonsKubeVela support a dozen of out-of-box addons, please at least enable following addons to make sure KubeVela functioning well:
Helm and Kustomize Components addons
Terraform addon
Terraform Provider addon for Alibaba Cloud
Enable Terraform Alibaba Cloud Provider as below to provision and/or consume cloud resources.
Here is how to get access key. Set the value for
ALICLOUD_REGION
by picking oneRegionId
from Alibaba Cloud region list. You can also set the value for parameterALICLOUD_SECURITY_TOKEN
, which is optional, per this doc.Terraform Provider addon for Azure
Enable Terraform Azure Provider as below to provision and/or consume cloud resources.
Set these parameters below per Authenticate Terraform to Azure.
Terraform Provider addon for AWS
Enable Terraform AWS Provider as below to provision and/or consume cloud resources.
Set these parameters below per Authenticate Terraform to AWS.
#
5. VerifyYou can also using
kubectl get comp -A
andkubectl get trait -A
instead if you haven't installed CLI.
Get built-in component types by
vela
CLI:Outputs
Get built-in traits by
vela
CLI:Outputs
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.
#
What's Next- Start to deploy our first application.
- See the advanced installation guide to learn more about installation details.