快速开始
Rainbond Offline Installer (ROI) 是一个用于在完全离线环境下安装 Rainbond 平台的工具。
- 极简操作: 不再需要繁琐的 K8s 部署脚本。
- 全栈交付: 在完全无网的物理机或虚拟机上，ROI 可以从零开始完成全套安装。
- 生产就绪: 通过 ROI 交付的集群完全符合生产环境标准，真正实现了离线环境下的"开箱即用"。
ROI 工具介绍
功能特性:
- 一键下载: 通过简单命令下载所有必需的 K8s 和 Rainbond 离线包。
- 自动分发: 自动将离线包分发到所有集群节点，无需手动传输。
- 高可用支持: 支持单节点和多节点高可用集群安装。
- 镜像预加载: 自动将所有必需的容器镜像加载到节点，无需联网拉取。
- 多架构支持: 支持 amd64 和 arm64 架构。
工作流程:
ROI 的工作流程主要分为以下阶段:
[1/7] check → 环境检查(硬件、网络、磁盘性能)
[2/7] lvm → LVM 存储自动配置(可选)
[3/7] optimize → 系统优化(内核参数、防火墙等)
[4/7] rke2 → RKE2 Kubernetes 集群安装
[5/7] nfs → NFS 存储配置(可选)
[6/7] mysql → MySQL 数据库集群部署(可选)
[7/7] rainbond → Rainbond 平台部署
前提
- CPU: 4 核及以上
- 内存: 8GB 及以上
- 磁盘: 100GB 及以上可用空间
- 操作系统: Ubuntu 20.04+
注意
- 目前仅在 Ubuntu 20/22/24 上进行了测试，其他操作系统没有经过充分验证。
下载 ROI 工具
# amd64
curl -o roi https://get.rainbond.com/roi/roi-amd64 && chmod +x roi
# arm64
curl -o roi https://get.rainbond.com/roi/roi-arm64 && chmod +x roi
下载离线包
- 在有网络的环境中,使用以下命令下载离线包:
# 下载默认版本的所有离线包
./roi download
- 下载完成后应该看到以下文件:
offline-packages/
├── install.sh # RKE2 安装脚本
├── rke2.linux-amd64.tar.gz # RKE2 二进制包
├── rke2-images.linux-amd64.tar.zst # RKE2 镜像包
├── nfs-subdir-external-provisioner-4.0.18.tgz # NFS Provisioner Helm Chart
├── mysql-14.0.3.tgz # MySQL Helm Chart
├── rainbond-images-amd64.tar.zst # Rainbond 镜像包
├── rainbond.tgz # Rainbond Helm Chart
└── sha256sum-amd64.txt # 校验和文件
- 将
offline-packages/目录复制到目标离线环境的服务器上。
单节点快速安装
注意
单机快速安装默认 NFS 使用存储，需要您手动安装 nfs-common 包:
apt-get update && apt-get install -y nfs-common nfs-kernel-server
ROI 支持零配置的单机快速安装:
# 自动生成配置并安装
./roi up
ROI 会自动:
- 检测
offline-packages/目录并使用离线包 - 生成单机配置文件
- 配置 NFS 存储
- 安装 Kubernetes + Rainbond
多节点集群安装
信息
集群安装时必须在集群内的某个节点上执行该命令，同时该节点上还要有 offline-packages/ 目录。
./
├── roi
├── cluster.yaml
└── offline-packages/
对于生产环境,建议使用配置文件方式:
集群配置示例:
vim cluster.yaml
hosts:
- name: node-1
address: 172.16.0.134
internalAddress: 172.16.0.134
user: root
password: root
- name: node-2
address: 172.16.0.135
internalAddress: 172.16.0.135
user: root
password: root
- name: node-3
address: 172.16.0.136
internalAddress: 172.16.0.136
user: root
password: root
# Role assignment
roleGroups:
etcd: [node-1, node-2, node-3]
master: [node-1, node-2]
worker: [node-1, node-2, node-3]
nfs-server: [node-1]
rbd-gateway: [node-2, node-3]
rbd-chaos: [node-2, node-3]
# Storage configuration
storage:
nfs:
enabled: true
sharePath: /nfs-data/k8s
storageClass:
enabled: true
# Database configuration - MySQL with master-slave replication
database:
mysql:
enabled: true
masterPassword: "RootPassword123!"
replicationPassword: "ReplPassword123!"
注意
如果您启用了 NFS 存储，那么需要您手动安装 nfs-common 包:
apt-get update && apt-get install -y nfs-common
执行以下命令开始安装:
# 使用配置文件安装，默认读取 cluster.yaml
./roi up
访问 Rainbond
安装完成后，日志中会显示访问入口:
✅ Installation completed successfully!
📝 Next Steps:
1. Access Rainbond console:
http://172.16.0.135:7070
2. Check cluster status:
kubectl get nodes
kubectl get pods -n rbd-system
# 在管理节点使用 kubectl
export KUBECONFIG=/etc/rancher/rke2/rke2.yaml
/var/lib/rancher/rke2/bin/kubectl get pods -A