---
title: 自定义安装和升级
---

import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';

## 带着证书管理器安装 KubeVela

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

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

```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
```

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

```shell script
vela install --set admissionWebhooks.certManager.enabled=true
```

## 安装预发布版

```
# 查询所有可用版本
vela version list -a

# 安装指定版本
vela install --version 1.3.0-beta.2
```

## 升级

### 1. 升级 CLI

<Tabs
    className="unique-tabs"
    defaultValue="script"
    values={[
        {label: 'Script', value: 'script'},
        {label: 'Homebrew', value: 'homebrew'},
        {label: 'Download directly from releases', value: 'download'},
    ]}>
<TabItem value="script">

** MacOS/Linux **

```shell script
curl -fsSl https://kubevela.io/script/install.sh | bash -s 1.3.3
```

**Windows**

> 仅支持安装正式发行版本。

```shell script
powershell -Command "iwr -useb https://kubevela.io/script/install.ps1 | iex"
```

</TabItem>
<TabItem value="homebrew">

**macOS/Linux**

先更新下你的 brew，请注意 brew 途径仅支持安装正式发行版本。

```shell script
brew update
```

紧接着安装 KubeVela CLI

```shell script
brew install kubevela
```

</TabItem>
<TabItem value="download">

- 通过[发布日志](https://github.com/kubevela/kubevela/releases)下载最新的 `vela` 二进制文件。
- 解压二进制文件，并且在 `$PATH` 中配好环境变量，就搞定啦。

```shell script
sudo mv ./vela /usr/local/bin/vela
```

> [安装提示](https://github.com/kubevela/kubevela/issues/625):
> 如果你使用的是 Mac 系统，它会弹出 “vela” 无法打开的警告，因为来自开发者的包无法验证。
>
> MacOS 对能够在系统中运行的软件，采取了更加严格的限制。你暂时可以通过打开 'System Preference' -> 'Security & Privacy' -> General 并点击 'Allow Anyway' 来解决这个问题。

</TabItem>
</Tabs>

### 2. 升级核心控制器

```
vela install --version v1.3.3
```

### 3. 升级 VelaUX

```
vela addon enable velaux version=v1.3.3
```

> 请注意，如果安装时指定了自定义参数，比如数据库地址。请在升级时同时指定该参数。

## 安装 Kubectl KubeVela CLI 插件

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

<Tabs
className="unique-tabs"
defaultValue="krew"
values={[
{label: 'Krew', value: 'krew'},
{label: 'Script', value: 'script'},
]}>

<TabItem value="krew">

1. [先安装](https://krew.sigs.k8s.io/docs/user-guide/setup/install/) Krew。
2. 查看 Krew 上可用的插件:

```shell
kubectl krew update
```

3. 安装 Kubectl KubeVela CLI 插件:

```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
```

你也可以直接从[发布页面](https://github.com/kubevela/kubevela/releases)手动下载来使用。

</TabItem>
</Tabs>