基于自建 k3s 集群安装

安装前提

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

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

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

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

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

    • K3s启动默认会使用 Containerd 作为容器的运行环境，同时会安装 Traefik 作为 K3s 的 ingress controller，会出现端口冲突。
  • 确保服务器已经安装了 Docker
caution" class="reference-link">基于自建 k3s 集群安装 - 图4caution

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

安装 Docker

  1. curl sh.rainbond.com/install_docker | bash

安装 NFS 客户端

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

卸载 Traefik

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

修改 K3s 启动参数

danger" class="reference-link">基于自建 k3s 集群安装 - 图5danger

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

  1. vi /etc/systemd/system/multi-user.target.wants/k3s.service
  3. # 编辑k3s.service文件末尾行
  4. ExecStart=/usr/local/bin/k3s server --docker --disable traefik
  5. # 重新加载配置文件
  6. systemctl daemon-reload
  7. # 重新启动k3s
  8. service k3s restart
caution" class="reference-link">基于自建 k3s 集群安装 - 图6caution

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

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

安装Rainbond：

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

验证安装

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

安装问题排查