CubeFS单机部署实战指南

前言

CubeFS作为一款高性能分布式文件系统，其单机部署模式非常适合开发者快速体验和验证系统功能。本文将详细介绍三种不同的单机部署方式，帮助用户快速搭建CubeFS测试环境。

部署方式一：脚本自动化部署

环境准备

• 操作系统：Linux
• 权限要求：root权限
• 硬件要求：
  • 内存：4GB以上
  • 磁盘空间：/home/data目录需20GB以上可用空间
  • 网络：需配置正确的网卡名称

部署步骤

1. 获取代码并编译

git clone cubefs.git
cd cubefs
make

2. 启动基础集群

sh ./shell/deploy.sh /home/data bond0

3. 可选组件部署

# 挂载文件系统
sh ./shell/deploy_client.sh /home/data

# 启动对象存储
sh ./shell/deploy_object.sh /home/data

关键参数说明

• bond0：本机网卡名称，需根据实际情况修改
• /home/data：用于存储集群运行数据的基础目录

集群状态检查

./build/bin/cfs-cli cluster info

部署方式二：Docker容器化部署

环境准备

• 已安装Docker和Docker Compose
• 关闭防火墙
• 确保/data/disk目录有10GB以上可用空间

快速部署命令

docker/run_docker.sh -r -d /data/disk

分步部署命令

# 构建镜像
docker/run_docker.sh -b

# 启动服务
docker/run_docker.sh -s -d /data/disk

# 启动客户端
docker/run_docker.sh -c

# 启动监控
docker/run_docker.sh -m

验证部署

1. 检查挂载状态：

mount | grep cubefs

2. 访问监控界面：

http://127.0.0.1:3000
用户名：admin
密码：123456

部署方式三：手动编译部署

环境准备

• Ubuntu 20.04系统
• Go 1.17.13环境
• 依赖包：cmake、gflags、snappy等

代码修改

由于默认配置需要3副本，单机部署需修改代码：

func (c *Cluster) doCreateVol(req *createVolReq) (vol *Vol, err error) {
    vv := volValue{
        ReplicaNum: defaultReplicaNum,
    }
    vv.ReplicaNum = 1  // 添加此行
    ...
}

组件配置与启动

1. Master节点

{
  "clusterName": "cfs_single_test1",
  "ip": "192.168.12.60",
  "listen": "17010",
  "singleNodeMode":"true"
}

2. MetaNode节点

{
  "role": "metanode",
  "listen": "17210",
  "masterAddr": ["192.168.12.60:17010"]
}

3. DataNode节点

{
  "role": "datanode",
  "listen": "17310",
  "disks":["/data1:1024000000"],
  "masterAddr": ["192.168.12.60:17010"]
}

创建卷与挂载

1. 创建单副本卷：

./cfs-cli volume create test test --capacity 1 --replica-num 1

2. 客户端挂载配置：

{
    "masterAddr": "192.168.12.60:17010",
    "mountPoint": "/mnt/cubefs",
    "volName": "test"
}

功能验证

文件存储验证

在挂载点/mnt/cubefs进行常规文件操作，验证基本功能。

对象存储验证

1. 获取用户凭证：

./cfs-cli user info test

2. 使用AWS CLI测试：

aws s3api --endpoint-url http://192.168.12.60:17410 put-object \
    --bucket test --key testfile --body ./localfile

注意事项

1. 单机部署仅适用于测试验证，不具备高可用性
2. 生产环境必须使用多节点部署
3. 纠删码功能在单机模式下有限制
4. 资源监控对系统调优非常重要

通过以上三种方式，开发者可以快速搭建CubeFS测试环境，体验其文件存储和对象存储功能，为后续的深入使用和开发奠定基础。