341 lines
8.9 KiB
Plaintext
341 lines
8.9 KiB
Plaintext
---
|
||
title: 自定义安装和升级
|
||
---
|
||
|
||
import Tabs from '@theme/Tabs';
|
||
import TabItem from '@theme/TabItem';
|
||
|
||
## 安装 KubeVela 生产环境
|
||
|
||
### 1. 安装条件:
|
||
|
||
- Kubernetes cluster >= v1.19 && <= v1.22
|
||
|
||
KubeVela 依赖 Kubernetes 作为管控平面，你需要自行搭建生产可用的 Kubernetes 集群，支持的方式包括：
|
||
|
||
- Alibaba Cloud [ACK Service](https://www.aliyun.com/product/kubernetes)
|
||
- AWS [EKS Service](https://aws.amazon.com/cn/eks)
|
||
- Azure [AKS Service](https://azure.microsoft.com/en-us/services/kubernetes-service)
|
||
- Google [GKE Service](https://cloud.google.com/kubernetes-engine)
|
||
- Rancher [K3s](https://rancher.com/docs/k3s/latest/en/quick-start/) or [RKE](https://github.com/rancher/rke/releases)
|
||
|
||
### 2. 安装 KubeVela 命令行
|
||
|
||
KubeVela CLI 提供了常用的集群和应用管理能力。
|
||
|
||
<Tabs
|
||
className="unique-tabs"
|
||
defaultValue="script"
|
||
values={[
|
||
{label: 'Script', value: 'script'},
|
||
{label: 'Homebrew', value: 'homebrew'},
|
||
{label: 'Download directly from releases', value: 'download'},
|
||
{label: 'Docker', value: 'docker'},
|
||
]}>
|
||
<TabItem value="script">
|
||
|
||
** MacOS/Linux **
|
||
|
||
```shell script
|
||
curl -fsSl https://kubevela.net/script/install.sh | bash -s 1.4.1
|
||
```
|
||
|
||
**Windows**
|
||
|
||
```shell script
|
||
powershell -Command "iwr -useb https://kubevela.net/script/install.ps1 | iex"
|
||
```
|
||
|
||
</TabItem>
|
||
<TabItem value="homebrew">
|
||
|
||
**macOS/Linux**
|
||
|
||
Update your brew first. Please note that the brew method only supports the installation of the official release version.
|
||
|
||
```shell script
|
||
brew update
|
||
```
|
||
|
||
Then install KubeVela CLI
|
||
|
||
```shell script
|
||
brew install kubevela
|
||
```
|
||
|
||
</TabItem>
|
||
<TabItem value="download">
|
||
|
||
- 通过 [release log](https://github.com/kubevela/kubevela/releases) 下载二进制压缩文件。
|
||
- 解压文件并将二进制文件移动到 $PATH 路径下。
|
||
|
||
```shell script
|
||
sudo mv ./vela /usr/local/bin/vela
|
||
```
|
||
|
||
> [Installation Tips](https://github.com/kubevela/kubevela/issues/625):
|
||
> 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 on `Allow Anyway`.
|
||
|
||
</TabItem>
|
||
<TabItem value="docker">
|
||
|
||
如果你需要在容器环境中使用 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 镜像文档](./system-operation/vela-cli-image) 获取更多用法。
|
||
|
||
</TabItem>
|
||
</Tabs>
|
||
|
||
### 3. Install KubeVela Core
|
||
|
||
<Tabs
|
||
className="unique-tabs"
|
||
defaultValue="vela"
|
||
values={[
|
||
{label: 'Default', value: 'vela'},
|
||
{label: 'Helm', value: 'helm'},
|
||
]}>
|
||
<TabItem value="vela">
|
||
|
||
```shell script
|
||
$ vela install --version v1.4.1
|
||
```
|
||
|
||
<details> <summary> 正常安装出现下述日志 </summary>
|
||
|
||
```shell
|
||
...
|
||
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"
|
||
```
|
||
|
||
</details>
|
||
|
||
</TabItem>
|
||
|
||
<TabItem value="helm">
|
||
|
||
如果你是 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.1 --wait
|
||
```
|
||
|
||
</TabItem>
|
||
</Tabs>
|
||
|
||
### 4 安装 VelaUX
|
||
|
||
请参考 [VelaUX 插件文档](../reference/addons/velaux).
|
||
|
||
## 升级
|
||
|
||
### 1. 升级 CLI
|
||
|
||
<Tabs
|
||
className="unique-tabs"
|
||
defaultValue="script"
|
||
values={[
|
||
{label: 'Script', value: 'script'},
|
||
{label: 'Homebrew', value: 'homebrew'},
|
||
{label: 'Download directly from releases', value: 'download'},
|
||
{label: 'Docker', value: 'docker'},
|
||
]}>
|
||
<TabItem value="script">
|
||
|
||
** MacOS/Linux **
|
||
|
||
```shell script
|
||
curl -fsSl https://kubevela.io/script/install.sh | bash -s 1.4.1
|
||
```
|
||
|
||
**Windows**
|
||
|
||
> Only the official release version is supported.
|
||
|
||
```shell script
|
||
powershell -Command "iwr -useb https://kubevela.io/script/install.ps1 | iex"
|
||
```
|
||
|
||
</TabItem>
|
||
<TabItem value="homebrew">
|
||
|
||
**macOS/Linux**
|
||
|
||
Update your brew first. Please note that the brew method only supports the installation of the official release version.
|
||
|
||
```shell script
|
||
brew update
|
||
```
|
||
|
||
Then install KubeVela CLI
|
||
|
||
```shell script
|
||
brew install kubevela
|
||
```
|
||
|
||
</TabItem>
|
||
<TabItem value="download">
|
||
|
||
- 通过 [release log](https://github.com/kubevela/kubevela/releases) 下载二进制压缩文件。
|
||
- 解压文件并将二进制文件移动到 $PATH 路径下。
|
||
|
||
```shell script
|
||
sudo mv ./vela /usr/local/bin/vela
|
||
```
|
||
|
||
> [Installation Tips](https://github.com/kubevela/kubevela/issues/625):
|
||
> 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 on `Allow Anyway`.
|
||
|
||
</TabItem>
|
||
|
||
<TabItem value="docker">
|
||
|
||
Pull the latest image from the docker registry, or specify a version as tag:
|
||
|
||
```shell script
|
||
docker pull oamdev/vela-cli:latest
|
||
```
|
||
|
||
</TabItem>
|
||
</Tabs>
|
||
|
||
### 2. 升级 Vela Core
|
||
|
||
> 请先升级 Vela CLI 到 1.4.1 版本。
|
||
|
||
```shell
|
||
vela install --version v1.4.1
|
||
```
|
||
|
||
### 3. 升级 VelaUX
|
||
|
||
```shell
|
||
vela addon enable velaux version=v1.4.0
|
||
```
|
||
|
||
## Uninstall
|
||
|
||
在卸载 KubeVela 之前，请确保已删除所有应用和禁用所有插件。
|
||
|
||
1. 卸载 VelaUX
|
||
|
||
```
|
||
vela addon disable velaux
|
||
```
|
||
|
||
2. 卸载 KubeVela Core
|
||
|
||
```
|
||
vela uninstall
|
||
```
|
||
|
||
3. 卸载 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](https://github.com/jet/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.
|
||
|
||
```shell script
|
||
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:
|
||
|
||
```shell script
|
||
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.
|
||
|
||
<Tabs
|
||
className="unique-tabs"
|
||
defaultValue="krew"
|
||
values={[
|
||
{label: 'Krew', value: 'krew'},
|
||
{label: 'Script', value: 'script'},
|
||
]}>
|
||
<TabItem value="krew">
|
||
|
||
1. [Install and set up](https://krew.sigs.k8s.io/docs/user-guide/setup/install/) Krew on your machine.
|
||
2. Discover plugins available on Krew:
|
||
|
||
```shell
|
||
kubectl krew update
|
||
```
|
||
|
||
3. install kubectl vela:
|
||
|
||
```shell script
|
||
kubectl krew install vela
|
||
```
|
||
|
||
</TabItem>
|
||
<TabItem value="script">
|
||
|
||
**macOS/Linux**
|
||
|
||
```shell script
|
||
curl -fsSl https://kubevela.io/script/install-kubectl-vela.sh | bash
|
||
```
|
||
|
||
You can also download the binary from [release pages ( >= v1.0.3)](https://github.com/kubevela/kubevela/releases) manually.
|
||
Kubectl will discover it from your system path automatically.
|
||
|
||
</TabItem>
|
||
</Tabs>
|