基于 K3s 安装

安装前提

安装 Helm 3.0+
确保 80、443、6060、7070、8443 未被占用
确保服务器安装了 NFS 客户端
K3s 的启动需要指定启动参数 –-disable traefik

安装 NFS 客户端

yum -y install nfs-utils    # Cenots系统
apt -y install nfs-common  # ubuntu系统

安装 K3s

在安装 K3s 时需添加 --disable traefik 禁用 Traefik 的安装，Traefik 与 Rainbond 网关会产生冲突，更多请参阅 K3s 安装文档。

Containerd
Docker

Rainbond 默认会安装私有镜像仓库，通过创建 /etc/rancher/k3s/registries.yaml 文件来配置使用私有镜像仓库。

configs:
  "goodrain.me":
    tls:
      insecure_skip_verify: true

安装 K3s

curl -sfL https://get.k3s.io | INSTALL_K3S_EXEC="--disable traefik" sh -s -

# install docker
curl -sfL https://get.rainbond.com/install_docker | bash
# install k3s
curl -sfL https://get.k3s.io | INSTALL_K3S_EXEC="--docker --disable traefik" sh -s -

复制 K3s Kubeconfig 文件到 ~/.kube/config。

cp /etc/rancher/k3s/k3s.yaml ~/.kube/config

安装 Rainbond

添加 Helm Chart 仓库

helm repo add rainbond https://openchart.goodrain.com/goodrain/rainbond
helm repo update

创建 rbd-system 命名空间

kubectl create namespace rbd-system

Containerd
Docker

K3s 使用 Containerd 作为容器运行时，需指定 useK3sContainerd 参数为 true。

helm install rainbond rainbond/rainbond-cluster -n rbd-system \
--set useK3sContainerd=true

使用 Helm 安装 Rainbond

helm install rainbond rainbond/rainbond-cluster -n rbd-system

info

更多 Helm Chart 参数请参考 Chart 安装选项。

安装进度查询

执行完安装命令后，Rainbond 进行环境检查, 检查通过后开始安装。

环境检查

当你开始执行安装命令后，如果返回如下报错，则说明环境检测失败。

Error: failed pre-install: job failed: BackoffLimitExceeded

此时你需要执行以下命令检查失败日志信息，根据失败信息进行处理。

kubectl logs -f -l name=env-checker -n rbd-system

如果一切顺利，你执行完命令后，应该会看到以下输出。

NAME: rainbond
LAST DEPLOYED: Fri May 27 18:09:08 2022
NAMESPACE: rbd-system
STATUS: deployed
REVISION: 1
TEST SUITE: None
NOTES:
安装过程大概持续10分钟左右，如遇问题可以参考 helm 问题排查文档：
https://www.rainbond.com/docs/installation/install-troubleshoot/helm-install-troubleshoot
动态查看 rainbond 安装进度命令：
watch kubectl get po -n rbd-system
等待 rbd-app-ui 的 pod 状态为 Running 时，即可访问 Rainbond 控制台，以下为访问地址：
  192.168.3.163:7070

安装问题排查

安装过程中如果长时间未完成，那么请参考文档 Helm 安装问题排查指南，进行故障排查。或加入微信群、钉钉群寻求帮助。

下一步

参考快速入门部署你的第一个应用。