集群安装

通过视频了解 Rainbond 多节点集群安装流程，完成集群安装前准备、节点配置和控制台访问验证。

时长 01:13预计操作 15 分钟准备在多台服务器上部署 Rainbond 集群的用户

集群安装多节点

点击封面后将在新窗口打开 Rainbond 官方 B 站视频。B 站打开

本教程共 7 个操作步骤

准备环境

先确认主机数量、资源规格、节点连通性和端口状态，避免安装过程被基础环境阻断。

准备至少 3 台 Linux 主机，所有节点内网互通并可访问互联网。
生产环境建议每台机器至少 8 核 CPU、16GB 内存、200GB 磁盘。
bootstrap 节点需能通过 root SSH 访问其它节点，并开放 7070、80、443、6060 端口。

检查节点连通性和基础资源

for host in 192.168.1.10 192.168.1.11 192.168.1.12; do
  echo "===== $host ====="
  ssh -o ConnectTimeout=5 root@$host 'hostname; hostname -I; nproc; free -h | awk "/Mem:/ {print \$2}"; df -h / | awk "NR==2 {print \$4}"'
done

检查关键端口占用

for host in 192.168.1.10 192.168.1.11 192.168.1.12; do
  echo "===== $host ====="
  ssh root@$host "sudo ss -lntp | grep -E ':(7070|80|443|6060)\b' || echo '端口未被占用'"
done

下载 ROI

在 bootstrap 节点按服务器架构下载 ROI 命令行工具，X86 和 ARM 二选一即可。

Intel、AMD 服务器通常选择 X86(amd64) 版本。
鲲鹏、飞腾等服务器通常选择 ARM(arm64) 版本。
下载命令已经包含 chmod +x，执行后 ROI 会具备可执行权限。

X86(amd64) 下载命令

curl -o roi https://get.rainbond.com/roi/roi-amd64 && chmod +x roi

ARM(arm64) 下载命令

curl -o roi https://get.rainbond.com/roi/roi-arm64 && chmod +x roi

查看 ROI 版本

下载完成后执行 version 命令，确认 ROI 可以正常运行，并查看默认安装的 Rainbond 版本。

如果命令可以正常输出版本信息，说明 ROI 已经准备完成。
如果提示权限不足，检查是否执行过 chmod +x roi。
记录输出中的 Rainbond 版本，便于后续排查和升级。

查看 ROI 版本

./roi version

编写 cluster.yaml

在 bootstrap 节点创建 cluster.yaml，配置所有节点的 SSH 信息、节点角色和默认存储。

hosts 中填写每台节点的名称、IP、root 用户、密码和 SSH 端口。
bootstrap: true 只能配置在一个 master 节点上，也就是执行 roi up 的节点。
roleGroups 中指定 etcd、master、worker、rbd-gateway、rbd-chaos、nfs-server 所在节点。
默认示例使用 ROI 配置集群内 NFS，并自动安装 nfs-client-provisioner StorageClass。

cluster.yaml 配置示例yaml

hosts:
  - name: node1
    address: 192.168.1.10
    internalAddress: 192.168.1.10
    user: root
    password: "your-password"
    port: 22
    bootstrap: true

  - name: node2
    address: 192.168.1.11
    internalAddress: 192.168.1.11
    user: root
    password: "your-password"
    port: 22

  - name: node3
    address: 192.168.1.12
    internalAddress: 192.168.1.12
    user: root
    password: "your-password"
    port: 22

roleGroups:
  etcd:
    - node1
  master:
    - node1
  worker:
    - node1
    - node2
    - node3
  rbd-gateway:
    - node1
  rbd-chaos:
    - node1
  nfs-server:
    - node1

storage:
  nfs:
    enabled: true
    sharePath: /nfs-data/k8s
    storageClass:
      enabled: true

执行安装命令

在 bootstrap 节点执行安装命令，ROI 会根据 cluster.yaml 安装 RKE2 Kubernetes 集群和 Rainbond 平台。

确认当前目录下已经有 roi 和 cluster.yaml。
执行安装后保持终端连接，不要中断安装过程。
如果需要排查安装过程，可以追加 -d 查看调试日志。

执行集群安装

./roi up -f cluster.yaml

等待安装成功提示并记录控制台地址

安装命令执行完成后，先查看终端中的成功提示，并记录日志里输出的 Rainbond 控制台访问地址。

成功日志中会输出 Rainbond 安装完成提示。
重点记录控制台访问地址，通常为 http://节点IP:7070。
如果安装失败，先根据终端错误信息处理阻塞项，再重新执行安装命令。

打开控制台并验证安装结果

安装完成后，在浏览器中打开 Console 地址。如果页面可以正常打开，说明集群环境已经可用。

在浏览器访问 http://你的IP:7070。
确认 Rainbond 控制台页面可以正常加载。
如果打不开页面，优先检查主机防火墙、安全组和端口访问策略。