自定义安装和升级
安装 KubeVela 生产环境
1. 安装条件:
- Kubernetes cluster >= v1.19 && <= v1.22
KubeVela 依赖 Kubernetes 作为管控平面,你需要自行搭建生产可用的 Kubernetes 集群,支持的方式包括:
- Alibaba Cloud ACK Service
- AWS EKS Service
- Azure AKS Service
- Google GKE Service
- Rancher K3s or RKE
2. 安装 KubeVela 命令行
KubeVela CLI 提供了常用的集群和应用管理能力。
- Script
- Homebrew
- Download directly from releases
- Docker
MacOS/Linux
curl -fsSl https://kubevela.net/script/install.sh | bash -s v1.4.9
Windows
powershell -Command "iwr -useb https://kubevela.net/script/install.ps1 | iex"
macOS/Linux
Update your brew first. Please note that the brew method only supports the installation of the official release version.
brew update
Then install KubeVela CLI
brew install kubevela
- 通过 release log 下载二进制压缩文件。
- 解压文件并将二进制文件移动到 $PATH 路径下。
sudo mv ./vela /usr/local/bin/vela
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 -> General
and clicking onAllow Anyway
.
如果你需要在容器环境中使用 Vela CLI,我们提供了 CLI 镜像 oamdev/vela-cli
:
$ docker run --rm -it -v ~/.kube:/root/.kube oamdev/vela-cli version
CLI Version: master
Core Version: v1.3.4
GitRevision: git-1d823780
GolangVersion: go1.17.10
参考 使用 Vela CLI 镜像文档 获取更多用法。
3. Install KubeVela Core
- Default
- Helm
$ vela install --version v1.4.9
正常安装出现下述日志
...
Watching for changes to Job kubevela-vela-core-cluster-gateway-tls-secret-patch with timeout of 18m0s
Add/Modify event for kubevela-vela-core-cluster-gateway-tls-secret-patch: ADDED
kubevela-vela-core-cluster-gateway-tls-secret-patch: Jobs active: 0, jobs failed: 0, jobs succeeded: 0
Add/Modify event for kubevela-vela-core-cluster-gateway-tls-secret-patch: MODIFIED
kubevela-vela-core-cluster-gateway-tls-secret-patch: Jobs active: 1, jobs failed: 0, jobs succeeded: 0
Add/Modify event for kubevela-vela-core-cluster-gateway-tls-secret-patch: MODIFIED
kubevela-vela-core-cluster-gateway-tls-secret-patch: Jobs active: 1, jobs failed: 0, jobs succeeded: 0
Add/Modify event for kubevela-vela-core-cluster-gateway-tls-secret-patch: MODIFIED
Starting delete for "kubevela-vela-core-admission" ServiceAccount
Starting delete for "kubevela-vela-core-admission" ClusterRole
Starting delete for "kubevela-vela-core-admission" ClusterRoleBinding
Starting delete for "kubevela-vela-core-admission" Role
Starting delete for "kubevela-vela-core-admission" RoleBinding
Starting delete for "kubevela-vela-core-admission-patch" Job
Starting delete for "kubevela-vela-core-cluster-gateway-admission" ServiceAccount
Starting delete for "kubevela-vela-core-cluster-gateway-admission" Role
Starting delete for "kubevela-vela-core-cluster-gateway-admission" RoleBinding
Starting delete for "kubevela-vela-core-cluster-gateway-tls-secret-patch" Job
KubeVela control plane has been successfully set up on your cluster.
If you want to enable dashboard, please run "vela addon enable velaux"
如果你是 Helm 用户,你可以通过 Helm 命令完成 VelaCore 的安装和升级:
helm v3.2.0+ required
helm repo add kubevela https://charts.kubevela.net/core
helm repo update
helm install --create-namespace -n vela-system kubevela kubevela/vela-core --version 1.4.9 --wait
4 安装 VelaUX
请参考 VelaUX 插件文档.
升级
1. 升级 CLI
- Script
- Homebrew
- Download directly from releases
- Docker
MacOS/Linux
curl -fsSl https://kubevela.io/script/install.sh | bash -s v1.4.9
Windows
Only the official release version is supported.
powershell -Command "iwr -useb https://kubevela.io/script/install.ps1 | iex"
macOS/Linux
Update your brew first. Please note that the brew method only supports the installation of the official release version.
brew update
Then install KubeVela CLI
brew install kubevela
- 通过 release log 下载二进制压缩文件。
- 解压文件并将二进制文件移动到 $PATH 路径下。
sudo mv ./vela /usr/local/bin/vela
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 -> General
and clicking onAllow Anyway
.
Pull the latest image from the docker registry, or specify a version as tag:
docker pull oamdev/vela-cli:latest
2. 升级 Vela Core
请先升级 Vela CLI 到最新的稳定版本,默认情况下将安装与 CLI 匹配的 Vela Core 版本。
vela install --version v1.4.9
3. 升级 VelaUX
vela addon enable velaux --version v1.4.7
Uninstall
在卸载 KubeVela 之前,请确保已删除所有应用和禁用所有插件。
- 卸载 VelaUX
vela addon disable velaux
- 卸载 KubeVela Core
vela uninstall
- 卸载 CRD
kubectl get crd |grep oam | awk '{print $1}' | xargs kubectl delete crd
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 https://charts.jetstack.io
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:
vela install --set admissionWebhooks.certManager.enabled=true
Install Pre-release
# List all releases
vela version list -a
# Install the specified version.
vela install --version 1.4.0-beta.2
Install Kubectl Vela Plugin
kubectl-vela
provides the same features with vela
CLI, it helps you to integrate with kubectl better.
- Krew
- Script
- Install and set up Krew on your machine.
- Discover plugins available on Krew:
kubectl krew update
- install kubectl vela:
kubectl krew install vela
macOS/Linux
curl -fsSl https://kubevela.io/script/install-kubectl-vela.sh | bash
You can also download the binary from release pages ( >= v1.0.3) manually. Kubectl will discover it from your system path automatically.