201 lines
4.4 KiB
Plaintext
201 lines
4.4 KiB
Plaintext
---
|
|
title: Custom Installation/Upgrade
|
|
---
|
|
|
|
import Tabs from '@theme/Tabs';
|
|
import TabItem from '@theme/TabItem';
|
|
|
|
## Upgrade
|
|
|
|
:::caution
|
|
If you're trying to upgrade from a big version later (e.g. from 1.2.x to 1.4.x), please refer to [version migration](./system-operation/migration-from-old-version) for more guides.
|
|
:::
|
|
|
|
### 1. Upgrade 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
|
|
```
|
|
|
|
**Windows**
|
|
|
|
:::tip
|
|
Pre-release versions will not be listed.
|
|
:::
|
|
|
|
```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">
|
|
|
|
- Download the latest `vela` binary file via [release log](https://github.com/kubevela/kubevela/releases).
|
|
- Unzip the binary file, and configure the environment variables in `$PATH`, and you're done.
|
|
|
|
```shell script
|
|
sudo mv ./vela /usr/local/bin/vela
|
|
```
|
|
|
|
:::caution
|
|
[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. Upgrade Vela Core
|
|
|
|
:::note
|
|
Please make sure you already upgraded the Vela CLI to latest stable version.
|
|
:::
|
|
|
|
```shell
|
|
vela install
|
|
```
|
|
|
|
### 3. Upgrade VelaUX
|
|
|
|
```shell
|
|
vela addon enable velaux
|
|
```
|
|
|
|
:::tip
|
|
You can use advanced parameters provided by [addons](../reference/addons/overview).
|
|
:::
|
|
|
|
## Uninstall
|
|
|
|
Before uninstalling kubevela, you must delete all applications and disable all addons.
|
|
|
|
1. Uninstall VelaUX
|
|
|
|
```
|
|
vela addon disable velaux
|
|
```
|
|
|
|
2. Uninstall KubeVela Core
|
|
|
|
```
|
|
vela uninstall
|
|
```
|
|
|
|
3. Uninstall CRD
|
|
|
|
Before deleting, you must delete all CR resources.
|
|
|
|
```
|
|
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.3.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>
|