单机模式

拉取代码

# 如该步骤已完成可跳过
$ git clone https://github.com/cubefs/cubefs.git

部署

脚本部署

部署基础集群

CubeFS 支持使用脚本一键部署基础集群,基础集群包含组件MasterMetaNodeDataNode,同时可额外选择启动clientObjectNode。 步骤如下:

cd ./cubefs
# 编译
make
# 生成配置文件并启动基础集群
sh ./shell/deploy.sh /home/data bond0

# 等待1分钟待集群就绪后,可选执行以下命令

# 挂载文件系统(可选,如果想体验文件存储,则执行该条命令。默认挂载在/home/data/client/mnt)
sh ./shell/deploy_client.sh /home/data

# 启动对象存储(可选,如果想体验对象存储,则执行该条命令。默认监听端口为17410)
sh ./shell/deploy_object.sh /home/data
  • bond0: 为本机网卡的名字, 根据实际填写
  • /home/data: 为本地的一个目录,用于保存集群运行日志、数据及配置文件。三个sh命令的目录应当相同
  • 机器要求
    • 需root权限
    • 能使用ifconfig
    • 内存4G以上
    • /home/data对应磁盘剩余空间20G以上
  • 查看集群状态
./build/bin/cfs-cli cluster info
[Cluster]
  Cluster name       : cfs_dev
  Master leader      : 172.16.1.101:17010
  Master-1           : 172.16.1.101:17010
  Master-2           : 172.16.1.102:17010
  Master-3           : 172.16.1.103:17010
  Auto allocate      : Enabled
  MetaNode count (active/total)    : 4/4
  MetaNode used                    : 0 GB
  MetaNode available               : 21 GB
  MetaNode total                   : 21 GB
  DataNode count (active/total)    : 4/4
  DataNode used                    : 44 GB
  DataNode available               : 191 GB
  DataNode total                   : 235 GB
  Volume count       : 2
...

文件系统的使用可参考使用文件系统章节

对象存储的使用可参考使用对象存储章节

部署纠删码子系统

提示

可选章节,如果需要使用纠删码卷则需要部署

$> cd cubefs/blobstore
$> ./run.sh --consul
...
start blobstore service successfully, wait minutes for internal state preparation
$>

纠删码子系统部署成功之后,修改Master配置文件中的ebsAddr配置项(更多配置参考),配置为Access节点注册的Consul地址,默认为http://localhost:8500

停止集群

  • 使用脚本将会stop server和挂载点
sh ./shell/stop.sh

docker 部署

部署基础集群

在docker目录下,run_docker.sh工具用来方便运行CubeFS docker-compose试用集群,包含MasterMetaNodeDataNodeObjectNode组件。

提示

请确保已经安装docker和docker-compose,并在执行docker部署前确保防火墙关闭,避免权限问题导致容器启动失败。

执行下面的命令,可创建一个最小的CubeFS集群。

注意

/data/disk是数据根目录,至少需要10GB大小空闲空间。

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

客户端启动成功后,在客户端docker容器中使用mount命令检查目录挂载状态:

$ mount | grep cubefs

在浏览器中打开http://127.0.0.1:3000,使用admin/123456登录,可查看CubeFS的grafana监控指标界面。

或者使用下面的命令分步运行:

$ docker/run_docker.sh -b
$ docker/run_docker.sh -s -d /data/disk
$ docker/run_docker.sh -c
$ docker/run_docker.sh -m

更多命令请参考帮助:

$ docker/run_docker.sh -h

监控的Prometheus和Grafana相关配置位于docker/monitor目录下。

部署纠删码子系统

注意

纠删码docker方式部署暂未与其他模块(如Master)统一,该章节目前仅用于体验纠删码子系统本身功能,后续完善

支持以下docker镜像部署方式:

  • 远端拉取构建【推荐
$> docker pull cubefs/cubefs:blobstore-v3.3.0 # 拉取镜像
$> docker run cubefs/cubefs:blobstore-v3.3.0 # 运行镜像
$> docker container ls # 查看运行中的容器
   CONTAINER ID        IMAGE                                  COMMAND                  CREATED             STATUS              PORTS               NAMES
   76100321156b        blobstore:v3.3.0                       "/bin/sh -c /apps/..."   4 minutes ago       Up 4 minutes                            thirsty_kare
$> docker exec -it thirsty_kare /bin/bash # 进入容器
  • 本地脚本编译构建
$> cd blobstore
$> ./run_docker.sh -b # 编译构建
&> Successfully built 0b29fda1cd22
   Successfully tagged blobstore:v3.3.0
$> ./run_docker.sh -r # 运行镜像
$> ... # 后续步骤同拉取构建
在github上编辑