1. 系统安装部署

1.1 环境要求

1.1.1 硬件要求

芯片架构及操作系统

芯片架构	操作系统	说明
x86_64	Linux
arm64	Linux
x86_64	MacOS	用于开发环境
arm64	MacOS	待测试，用于开发环境
x86_64	Win64/WSL	待测试，用于开发环境

生产环境中，所有节点安装64位Linux（CentOS7/8/9、Debian 12/13、Ubuntu 20/22/24/26）等。

内存需求

头节点：≥8GB
计算节点：按需，推荐 ≥8GB

存储空间

头节点：≥100GB
计算节点：按需，推荐 ≥100GB

1.1.2 软件依赖

容器引擎/容器运行时

计算节点

容器引擎/容器运行时	版本号	说明
docker-ce	20.10⁺
singularity	3.8⁺
podman	4.8⁺	待测试
containerd + nerdctl	1.6⁺	待测试
apptainer		待测试
Kata Containers		待测试

头节点：docker-ce 20.10⁺

数据库

头节点：postgresql 18⁺，以容器化部署

集群存储（可选）

所有节点上安装集群存储客户端，构建统一的集群存储
- glusterfs
- NFS

网络配置

头节点、计算节点属于内网的同一子网内
若需支持跨集群计算，头节点及相关传输节点需与其他集群通信的外网地址

1.2 安装步骤

1.2.1 基础安装

头节点的docker安装配置

docker安装的具体操作参见附录7
docker配置

# add user scalebox
useradd scalebox
usermod -aG docker scalebox
# set a unified password for the scalebox user of all nodes in the cluster
passwd scalebox

软件包获取

在头节点上安装git，获取软件安装包：

git clone github.com/kaichao/scalebox

容器镜像获取

在头节点上下载容器镜像

docker pull scalebox.net/platform/controld:latest
docker pull scalebox.net/platform/actuator:latest
docker pull scalebox.net/platform/database:latest

1.2.2 集群部署

本示例中有1个HEAD节点、4个NODE节点。相关配置如下：

名称	类型	IP地址
h0	HEAD	10.0.6.100
n0	NODE	10.0.6.101
n1	NODE	10.0.6.102
n2	NODE	10.0.6.103
n3	NODE	10.0.6.104

每个节点配置：

类型	值
CPU	4核
内存	16GB
本地硬盘	200GB
操作系统	CentOS 8

所有节点配置

设置时间同步NTP
安装集群存储软件glusterfs（可选）

主节点配置

设置免密登录到HEAD节点

ssh-copy-id root@10.0.6.100

设置HEAD节点上host文件

hostname h0

cat >> /etc/hosts << EOF
10.0.6.100  h0
10.0.6.101  n0
10.0.6.102  n1
10.0.6.103  n2
10.0.6.104  n3
EOF

计算节点配置

设置HEAD节点到NODE节点root账号的ssh免密登录

ssh-keygen
ssh-copy-id n0
ssh-copy-id n1
ssh-copy-id n2
ssh-copy-id n3

设置主机名及hostname

scp /etc/hosts n0:/etc
scp /etc/hosts n1:/etc
scp /etc/hosts n2:/etc
scp /etc/hosts n3:/etc

ssh n0 hostname n0
ssh n1 hostname n1
ssh n2 hostname n2
ssh n3 hostname n3

1. 系统安装部署

1.1 环境要求

1.1.1 硬件要求

芯片架构及操作系统

内存需求

存储空间

1.1.2 软件依赖

容器引擎/容器运行时

数据库

集群存储（可选）

网络配置

1.2 安装步骤

1.2.1 基础安装

头节点的docker安装配置

软件包获取

容器镜像获取

1.2.2 集群部署

所有节点配置

主节点配置

计算节点配置

网络连通性测试

配置glusterfs

1.3 配置说明

1.3.1 基础配置

1.3.2 高级配置

1.4 验证安装

1.4.1 健康检查

1.4.2 性能基准