跳到主要内容

基于自建 k3s 集群安装

安装前提​

  • 推荐 Helm版本 >= 3.0 根分区磁盘保证50G+

  • 确保服务器 80、443、6060、6443、7070、8443 端口能够访问

  • 确保服务器安装了 NFS 客户端

    • 对接外部存储时，则无需安装

  • K3s 的启动需要指定启动参数 –-docker –-disable traefik

    • K3s启动默认会使用 Containerd 作为容器的运行环境，同时会安装 Traefik 作为 K3s 的 ingress controller，会出现端口冲突。

  • 确保服务器已经安装了 Docker

caution

注意：Rainbond 默认会使用 Docker 作为容器的运行时，同时 Rainbond 的 rbd-gatway 网关会作为 Ingress controller，所以需要修改 K3s 的启动参数，并卸载已安装的 Traefik 或指定没有安装 Traefik 的节点为 Rainbond的网关节点。

安装 Docker​

curl sh.rainbond.com/install_docker | bash

安装 NFS 客户端​

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

卸载 Traefik​

kubectl delete -f /var/lib/rancher/k3s/server/manifests/traefik.yaml

修改 K3s 启动参数​

danger

警告：如果你的 K3s 原本使用 Containerd 作为容器运行时，修改为 Docker 作为容器运行时后会导致 Containerd 的数据丢失，不会在 Docker 中出现。

vi /etc/systemd/system/multi-user.target.wants/k3s.service

# 编辑k3s.service文件末尾行
ExecStart=/usr/local/bin/k3s server --docker --disable traefik
# 重新加载配置文件
systemctl daemon-reload
# 重新启动k3s
service k3s restart
caution

注意：K3s 默认的配置文件路径，Helm无法识别，将 /etc/rancher/k3s/k3s.yaml 软连接到 ~/.kube/config，供 helm 使用。 

mkdir ~/.kube
ln -s /etc/rancher/k3s/k3s.yaml ~/.kube/config

安装Rainbond：​

  • 安装helm
wget https://pkg.goodrain.com/pkg/helm && chmod +x helm && mv helm /usr/local/bin/
  • 创建rbd-system 命名空间
kubectl create namespace rbd-system
  • 添加chart仓库
helm repo add rainbond https://openchart.goodrain.com/goodrain/rainbond
  • 安装rainbond
    • 参考 values.yaml 详解 了解更多自定义配置项，以及如何为已有 Rainbond 集群变更配置。
helm install rainbond rainbond/rainbond-cluster -n rbd-system

验证安装​

  • 查看pod状态
kubectl get po -n rbd-system | grep rbd-app-ui
  • 等待 rbd-app-ui pod为 Running 状态即安装成功。
  • 安装成功以后，可通过 $gatewayIngressIPs:7070 访问 Rainbond 控制台。

安装问题排查​

下一步​

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