跳到主要内容
返回视频教程列表

安装部署 / 多节点集群

从零开始搭建多节点集群

通过视频了解 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 下载结果

查看 ROI 版本

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

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

编写 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

执行安装命令

在 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 控制台页面可以正常加载。
  • 如果打不开页面，优先检查主机防火墙、安全组和端口访问策略。
访问 Rainbond 控制台