自定义安装

带着证书管理器安装 KubeVela

默认情况下，KubeVela 使用 kube-webhook-certgen 提供的自签名证书以便使用参数校验等 Webhook 功能。 你可以对接证书管理软件（Cert Manager），但是你需要提前安装好。

1. 安装 Cert Manager (如果已经安装，可省略)

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

2. 安装 KubeVela 同时启用证书管理器：

helm install --create-namespace -n vela-system --set admissionWebhooks.certManager.enabled=true kubevela kubevela/vela-core

安装预发布版

在使用 helm search 命令时，添加标记参数 --devel 即可搜索出预发布版。预发布版的版本号格式为 <next_version>-rc-master，例如 0.4.0-rc-master，代表的是一个基于 master 分支构建的发布候选版。

helm search repo kubevela/vela-core -l --devel

NAME CHART VERSION APP VERSION DESCRIPTION

kubevela/vela-core 0.4.0-rc-master 0.4.0-rc-master A Helm chart for KubeVela core

kubevela/vela-core 0.3.2 0.3.2 A Helm chart for KubeVela core

kubevela/vela-core 0.3.1 0.3.1 A Helm chart for KubeVela core

然后尝试跟着以下的命令安装一个预发布版。

helm install --create-namespace -n vela-system kubevela kubevela/vela-core --version <next_version>-rc-master

NAME: kubevela

LAST DEPLOYED: Thu Apr 1 19:41:30 2021

NAMESPACE: vela-system

STATUS: deployed

REVISION: 1

NOTES:

Welcome to use the KubeVela! Enjoy your shipping application journey!

安装 Kubectl KubeVela CLI 插件

安装 Kubectl KubeVela CLI 插件，可以更好的进行应用交付操作。

Krew

1. 先安装 Krew。
2. 查看 Krew 上可用的插件:

kubectl krew update

3. 安装 Kubectl KubeVela CLI 插件:

kubectl krew install vela

Script

macOS/Linux

curl -fsSl https://kubevela.io/script/install-kubectl-vela.sh | bash

你也可以直接从发布页面手动下载来使用。

升级

第一步 更新 Helm 仓库

通过以下命令获取 KubeVela 最新发布的 chart：

helm repo update

helm search repo kubevela/vela-core -l

第二步 升级 KubeVela 的 CRDs

kubectl apply -f https://raw.githubusercontent.com/kubevela/kubevela/release-1.1/charts/vela-core/crds/core.oam.dev_appdeployments.yaml

kubectl apply -f https://raw.githubusercontent.com/kubevela/kubevela/release-1.1/charts/vela-core/crds/core.oam.dev_applicationrevisions.yaml

kubectl apply -f https://raw.githubusercontent.com/kubevela/kubevela/release-1.1/charts/vela-core/crds/core.oam.dev_applications.yaml

kubectl apply -f https://raw.githubusercontent.com/kubevela/kubevela/release-1.1/charts/vela-core/crds/core.oam.dev_approllouts.yaml

kubectl apply -f https://raw.githubusercontent.com/kubevela/kubevela/release-1.1/charts/vela-core/crds/core.oam.dev_clusters.yaml

kubectl apply -f https://raw.githubusercontent.com/kubevela/kubevela/release-1.1/charts/vela-core/crds/core.oam.dev_componentdefinitions.yaml

kubectl apply -f https://raw.githubusercontent.com/kubevela/kubevela/release-1.1/charts/vela-core/crds/core.oam.dev_definitionrevisions.yaml

kubectl apply -f https://raw.githubusercontent.com/kubevela/kubevela/release-1.1/charts/vela-core/crds/core.oam.dev_envbindings.yaml

kubectl apply -f https://raw.githubusercontent.com/kubevela/kubevela/release-1.1/charts/vela-core/crds/core.oam.dev_healthscopes.yaml

kubectl apply -f https://raw.githubusercontent.com/kubevela/kubevela/release-1.1/charts/vela-core/crds/core.oam.dev_manualscalertraits.yaml

kubectl apply -f https://raw.githubusercontent.com/kubevela/kubevela/release-1.1/charts/vela-core/crds/core.oam.dev_policydefinitions.yaml

kubectl apply -f https://raw.githubusercontent.com/kubevela/kubevela/release-1.1/charts/vela-core/crds/core.oam.dev_resourcetrackers.yaml

kubectl apply -f https://raw.githubusercontent.com/kubevela/kubevela/release-1.1/charts/vela-core/crds/core.oam.dev_scopedefinitions.yaml

kubectl apply -f https://raw.githubusercontent.com/kubevela/kubevela/release-1.1/charts/vela-core/crds/core.oam.dev_traitdefinitions.yaml

kubectl apply -f https://raw.githubusercontent.com/kubevela/kubevela/release-1.1/charts/vela-core/crds/core.oam.dev_workflowstepdefinitions.yaml

kubectl apply -f https://raw.githubusercontent.com/kubevela/kubevela/release-1.1/charts/vela-core/crds/core.oam.dev_workloaddefinitions.yaml

kubectl apply -f https://raw.githubusercontent.com/kubevela/kubevela/release-1.1/charts/vela-core/crds/standard.oam.dev_rollouts.yaml

提示：如果看到诸如 * is invalid: spec.scope: Invalid value: "Namespaced": filed is immutable 之类的错误，请删除出错的 CRD 后再重新安装。

kubectl delete crd \

scopedefinitions.core.oam.dev \

traitdefinitions.core.oam.dev \

workloaddefinitions.core.oam.dev

第三步 升级 KubeVela Helm chart

helm upgrade --install --create-namespace --namespace vela-system kubevela kubevela/vela-core --version <the_new_version> --wait

启用多集群管理

KubeVela 提供了跨集群编排应用的能力。上文的安装命令已经启用了该功能，如果你是从旧版本 KubeVela 升级上来，或是在安装时没有选用多集群管理的能力，你可以运行以下命令启用该能力

helm upgrade --install kubevela kubevela/vela-core -n vela-system --set multicluster.enabled=true --create-namespace --wait

你可以运行以下命令来检查多集群功能是否正常启用。

> kubectl get APIService v1alpha1.cluster.core.oam.dev

NAME SERVICE AVAILABLE AGE

v1alpha1.cluster.core.oam.dev vela-system/kubevela-cluster-gateway-service True 7h40m

插件列表

插件	简介	对应的内置功能	插件对应开源项目
terraform	提供云资源	-	https://github.com/oam-dev/terraform-controller
fluxcd	提供 Helm、Kustomize 组件的部署功能	kustomize、helm	https://fluxcd.io/
kruise	提供比 Kubernetes 原生更强大的工作负载套件	cloneset	https://openkruise.io/
prometheus	提供基于 Promethus 的基础监控功能	-	https://prometheus.io/
keda	提供基于事件驱动的工作负载自动扩缩容功能	-	https://keda.sh/
ocm	提供多集群功能的系统插件	-	http://open-cluster-management.io/
observability	为 KubeVela core 提供系统级别的监控，也可以为应用提供业务级别的监控。	-	-

1. 查看可用的插件

vela addon list

2. 安装插件，以 fluxcd 插件为例

vela addon enable fluxcd

3. 禁用插件

vela addon disable fluxcd

禁用前请先清理使用插件功能的应用，否则将禁用失败。

卸载

运行命令:

helm uninstall -n vela-system kubevela

rm -r ~/.vela

命令会卸载 KubeVela 服务和相关的依赖组件，同时会清理本地 CLI 的缓存
然后清理 CRDs（默认情况下，helm 不会移除 CRDs）

kubectl delete crd \

appdeployments.core.oam.dev \

applicationconfigurations.core.oam.dev \

applicationcontexts.core.oam.dev \

applicationrevisions.core.oam.dev \

applications.core.oam.dev \

approllouts.core.oam.dev \

clusters.core.oam.dev \

componentdefinitions.core.oam.dev \

components.core.oam.dev \

containerizedworkloads.core.oam.dev \

definitionrevisions.core.oam.dev \

envbindings.core.oam.dev \

healthscopes.core.oam.dev \

initializers.core.oam.dev \

manualscalertraits.core.oam.dev \

podspecworkloads.standard.oam.dev \

policydefinitions.core.oam.dev \

resourcetrackers.core.oam.dev \

rollouts.standard.oam.dev \

rollouttraits.standard.oam.dev \

scopedefinitions.core.oam.dev \

traitdefinitions.core.oam.dev \

workflows.core.oam.dev \

workflowstepdefinitions.core.oam.dev \

workloaddefinitions.core.oam.dev