--- title: 快速安装 --- import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; > 如果是要升级现有的 KubeVela,请直接阅读[升级指南](../platform-engineers/advanced-install#升级). ## 1. 选择放置控制平面的集群 确保: - Kubernetes 集群版本 >= v1.18.0 - 安装并配置 kubectl 命令行工具 KubeVela 得以成为控制平面,主要是依赖 Kubernetes 。它可以放置在任何托管 Kubernetes 作为底座的产品或你自己的集群中。 下面,我们使用 minikube 或 kind 在本地部署、测试来熟悉学习 KubeVela, > 注意: 如果你不是使用 minikube 或 kind 来进行学习,请确保[安装或启用 ingress-nginx](https://kubernetes.github.io/ingress-nginx/deploy/)。 先使用 minikube [安装指南](https://minikube.sigs.k8s.io/docs/start/)。 安装 minikube 后,创建一个集群: ```shell script minikube start ``` 安装 ingress: ```shell script minikube addons enable ingress ``` 请按照本[指南](https://kind.sigs.k8s.io/docs/user/quick-start/#installation)进行安装。 然后拉起一个 kind 集群: ```shell script cat < ## 2. 安装 KubeVela 1. 添加 KubeVela helm chart 仓库 ```shell script helm repo add kubevela https://charts.kubevela.net/core ``` 2. 更新 chart 仓库 ```shell script helm repo update ``` 3. 安装 KubeVela ```shell script helm install --create-namespace -n vela-system kubevela kubevela/vela-core ``` 默认情况下,它将使用 [kube-webhook-certgen](https://github.com/jet/kube-webhook-certgen) 提供的自签名证书启用 webhook。你也可以用 [`cert-manager`](../platform-engineers/advanced-install#install-kubevela-with-cert-manager) 安装。 4. 验证 chart 安装是否成功 ```shell script helm test kubevela -n vela-system ```
可以点开看看输出会是什么样子 ```shell Pod kubevela-application-test pending Pod kubevela-application-test pending Pod kubevela-application-test running Pod kubevela-application-test succeeded NAME: kubevela LAST DEPLOYED: Tue Apr 13 18:42:20 2021 NAMESPACE: vela-system STATUS: deployed REVISION: 1 TEST SUITE: kubevela-application-test Last Started: Fri Apr 16 20:49:10 2021 Last Completed: Fri Apr 16 20:50:04 2021 Phase: Succeeded TEST SUITE: first-vela-app Last Started: Fri Apr 16 20:49:10 2021 Last Completed: Fri Apr 16 20:49:10 2021 Phase: Succeeded NOTES: Welcome to use the KubeVela! Enjoy your shipping application journey! ```
## 3. 安装 KubeVela CLI KubeVela CLI 可以让你更便捷地来管理应用交付。不过,它不是必须使用的。 KubeVela CLI 也可以通过 [kubectl plugin](../platform-engineers/advanced-install#install-kubectl-vela-plugin) 的方式来安装,或者通过二进制文件. ** macOS/Linux ** ```shell script curl -fsSl https://kubevela.io/script/install.sh | bash ``` **Windows** ```shell script powershell -Command "iwr -useb https://kubevela.io/script/install.ps1 | iex" ``` **macOS/Linux** 先更新下你的 brew ```shell script brew update ``` 紧接着安装 KubeVela ```shell script brew install kubevela ``` - 通过[发布日志](https://github.com/oam-dev/kubevela/releases)下载最新的 `vela` 二进制文件。 - 解压二进制文件,并且在 `$PATH` 中配好环境变量,就搞定啦。 ```shell script sudo mv ./vela /usr/local/bin/vela ``` > [安装提示](https://github.com/oam-dev/kubevela/issues/625): > 如果你使用的是 Mac 系统,它会弹出 “vela” 无法打开的警告,因为来自开发者的包无法验证。 > > MacOS 对能够在系统中运行的软件,采取了更加严格的限制。你暂时可以通过打开 'System Preference' -> 'Security & Privacy' -> General 并点击 'Allow Anyway' 来解决这个问题。 ## 4. 打开 Helm 支持 KubeVela 调用 [Flux v2](https://github.com/fluxcd/flux2) 的 [Helm](https://helm.sh/) 控制器来部署组件系统。 你可以通过如下命令打开这个功能: ```shell vela addon enable fluxcd ``` 或者你也可以通过 Flux v2 的文档来安装完整版本。 ## 5. 验证是否安装成功 通过 `vela` CLI 来看看有哪些应用程序的组件和特征: ```shell script vela components ``` ```console NAME NAMESPACE WORKLOAD DESCRIPTION task vela-system jobs.batch Describes jobs that run code or a script to completion. webservice vela-system deployments.apps Describes long-running, scalable, containerized services that have a stable network endpoint to receive external network traffic from customers. worker vela-system deployments.apps Describes long-running, scalable, containerized services that running at backend. They do NOT have network endpoint to receive external network traffic. ``` 以上的这些能力都是已经内置的,随取随用。而由于 KubeVela 从一开始就被设计成可编程的,你可以按玩乐高积木一样,添加任何你需要的功能。 并且,一旦这些自定力的能力被加入到 KubeVela 控制平面中,你立即就能从上面的输出中看到了。 ## 下一步 安装完毕 KubeVela,开始动手编写[第一个应用部署计划](./first-application)。