krisdavison/xtreemfs-common

XtreemFS Docker镜像文档

概述

XtreemFS Docker镜像用于在单台机器上运行XtreemFS服务集群（DIR、MRC、OSD），主要用于演示目的。镜像基于Ubuntu基础镜像构建，所有服务组件均从XtreemFS Git仓库编译，通过通用基础镜像xtreemfs/xtreemfs-common派生。

核心功能

• 基于统一基础镜像xtreemfs/xtreemfs-common构建DIR、MRC、OSD服务组件
• 支持单节点集群快速部署与演示
• 提供客户端容器用于集群功能测试
• 支持文件复制策略配置（如QUORUM、ALL等）

使用场景

• XtreemFS分布式文件系统功能演示
• 分布式存储技术学习与测试环境
• 开发阶段的集群功能验证

使用方法

构建准备

1. 拉取基础镜像
   确保本地有最新的Ubuntu基础镜像：

   bash
   docker pull ubuntu
   

2. 获取源码
   克隆XtreemFS Docker仓库：

   bash
   git clone https://github.com/kris-davison/xtreemfs-docker.git
   cd xtreemfs-docker
   

构建镜像

运行构建脚本（构建过程可能耗时较长，部分阶段出现临时错误属正常现象）：

bash
./build.sh

启动集群

使用docker-compose启动XtreemFS集群：

bash
docker-compose -p xd -f docker-compose.yml up -d

客户端测试

启动客户端容器

bash
docker run -t -i --privileged xtreemfs/xtreemfs-client /bin/bash

创建XtreemFS卷

替换<your-ip-address>为实际IP地址：

bash
mkfs.xtreemfs <your-ip-address>/MyVolume

挂载卷到本地目录

1. 创建本地挂载点：

   bash
   mkdir ~/MyLocalFolder
   

2. 挂载远程卷：

   bash
   mount.xtreemfs <your-ip-address>/MyVolume ~/MyLocalFolder
   

文件操作测试

1. 进入挂载目录：

   bash
   cd ~/MyLocalFolder
   

2. 创建测试文件：

   bash
   touch my-file.txt
   

3. 查看文件存储节点：

   bash
   xtfsutil my-file.txt
   

复制策略配置

支持以下复制策略：

• WQRQ/QUORUM：按集群多数节点级别复制文件
• RONLY/READONLY：所有副本设为只读
• WAR1/ALL：在集群所有节点上复制文件

设置复制策略

bash
# 示例：设置为QUORUM策略并完整复制（非按需加载）
xtfsutil -r WQRQ --full ~/my-file.txt

管理文件副本

1. 列出可用副本节点：

   bash
   xtfsutil -l ~/my-file.txt
   

2. 自动添加副本：

   bash
   xtfsutil -a auto ~/my-file.txt
   

注：复制策略同样适用于目录，目录下所有文件将继承该策略

参考链接

• GitHub仓库：https://github.com/xtreemfs/xtreemfs-docker
• XtreemFS官网：[***]