gluster/glusterfs-client

GlusterFS Docker镜像文档

概述和主要用途

本仓库包含用于构建GlusterFS容器（包括服务器、客户端和S3服务器）的Dockerfile，基于CentOS和Fedora操作系统。GlusterFS社区维护这些镜像，旨在简化用户部署GlusterFS环境的流程，提供稳定、便捷的分布式存储解决方案。支持多种GlusterFS版本，满足不同场景下的存储需求。

支持版本矩阵

核心功能和特性

• 多版本支持：涵盖GlusterFS v3.10至v4.0等稳定版本，适应不同业务需求。
• 多基础镜像：提供基于CentOS和Fedora的容器，兼容不同操作系统环境。
• 持久化存储：通过绑定挂载主机目录，确保GlusterFS元数据、配置和日志持久化。
• 灵活网络配置：支持--net=host模式，最大化网络吞吐量。
• 特权模式支持：可暴露主机/dev/目录，便于在容器内创建存储砖（brick）。
• 系统集成：容器内预装并运行systemd，确保服务管理兼容性。
• S3兼容接口：提供Gluster S3服务器容器，支持通过S3协议访问GlusterFS卷。

使用场景和适用范围

• 快速部署GlusterFS集群：适用于开发、测试及生产环境中快速搭建GlusterFS存储集群。
• 存储服务测试：便于开发人员在隔离环境中测试GlusterFS功能和性能。
• S3兼容对象存储：通过Gluster S3容器提供低成本、兼容S3协议的对象存储服务。
• 日志和元数据持久化：满足对存储服务可监控性和数据一致性有要求的场景。

详细使用方法和配置说明

1. GlusterFS服务器容器

1.1 拉取镜像

从Docker Hub拉取预构建镜像：

• Fedora基础镜像：

  bash
  $ docker pull gluster/gluster-fedora
  

• CentOS基础镜像：

  bash
  $ docker pull gluster/gluster-centos
  

1.2 从Dockerfile构建镜像

如需自定义构建，可克隆源码仓库并构建：

bash
# 克隆仓库
$ git clone git@github.com:gluster/gluster-containers.git

# 构建Fedora镜像
$ docker build -t gluster-fedora Fedora

# 构建CentOS镜像
$ docker build -t gluster-centos CentOS

1.3 运行容器

前置条件：

• 在主机创建以下目录并确保为空：/etc/glusterfs、/var/lib/glusterd、/var/log/glusterfs
• 启动主机NTP服务（如chronyd/ntpd），确保容器时间同步

运行命令：

bash
$ docker run -v /etc/glusterfs:/etc/glusterfs:z \
  -v /var/lib/glusterd:/var/lib/glusterd:z \
  -v /var/log/glusterfs:/var/log/glusterfs:z \
  -v /sys/fs/cgroup:/sys/fs/cgroup:ro \
  -d --privileged=true --net=host -v /dev/:/dev \
  gluster/gluster-centos  # 或gluster-fedora

参数说明：

• --net=host（可选）：使用主机网络，提升网络吞吐量
• --privileged=true（可选）：特权模式，允许容器访问主机/dev/目录以创建存储砖
• 绑定挂载目录作用：
  • /var/lib/glusterd：持久化GlusterFS元数据
  • /var/log/glusterfs：持久化GlusterFS日志
  • /etc/glusterfs：持久化GlusterFS配置文件

1.4 验证容器运行状态

查看运行中的容器：

bash
$ docker ps -a

输出示例：

CONTAINER ID   IMAGE                         COMMAND          CREATED         STATUS         PORTS                                                                                                                              NAMES
d273cc739c9d   gluster/gluster-fedora:latest "/usr/sbin/init" 3 minutes ago   Up 3 minutes   49157/tcp, 49161/tcp, 49158/tcp, 38466/tcp, 8080/tcp, 2049/tcp, 24007/tcp, ...   angry_morse

1.5 检查容器IP地址

使用容器ID获取IP：

bash
$ docker inspect d273cc739c9d

在输出中查找IPAddress字段，例如：

json
"IPAddress": "172.17.0.2"

1.6 进入容器并验证服务

bash
# 进入容器
$ docker exec -ti d273cc739c9d bash

# 检查glusterd进程
-bash-4.3# ps aux | grep glusterd
root       34  0.0  0.0 448092 15800 ?        Ssl  06:01   0:00 /usr/sbin/glusterd -p /var/run/glusterd.pid

# 检查节点状态
-bash-4.3# gluster peer status
Number of Peers: 0

# 检查GlusterFS版本
-bash-4.3# gluster --version

1.7 捕获核心转储

容器内已配置/var/log/core目录用于存储核心转储。可通过以下步骤配置和提取：

bash
# 在主机设置核心转储路径
$ sysctl -w kernel.core_pattern=/var/log/core/core_%e.%p

# 从容器复制核心转储到主机
$ docker cp d273cc739c9d:/var/log/core/ <主机目标路径>

2. Gluster S3服务器容器

2.1 拉取镜像

bash
$ docker pull gluster/gluster-s3

2.2 运行容器

前置配置：

• 在主机/mnt/gluster-object目录下挂载GlusterFS卷，挂载点名称需与卷名一致（例如卷test挂载至/mnt/gluster-object/test）。
• 配置/etc/sysconfig/swift-volumes文件，设置卷名（如S3_ACCOUNT='tv1'）。

运行命令：

bash
$ docker run -d --privileged \
  -v /sys/fs/cgroup/:/sys/fs/cgroup/:ro \
  -p 8080:8080 \
  -v /mnt/gluster-object:/mnt/gluster-object \
  -e S3_ACCOUNT="tv1" \
  -e S3_USER="admin" \
  -e S3_PASSWORD="redhat" \
  gluster/gluster-s3

参数说明：

• -p 8080:8080：映射S3服务端口
• -v /mnt/gluster-object:/mnt/gluster-object：挂载主机GlusterFS卷目录
• 环境变量：
  • S3_ACCOUNT：GlusterFS卷名
  • S3_USER：S3访问用户名
  • S3_PASSWORD：S3访问密码

2.3 测试S3服务

可通过S3客户端工具（如s3cmd）进行对象的上传和下载测试，详细步骤参考https://github.com/gluster/gluster-swift/blob/master/doc/markdown/quick_start_guide.md#using_swift%E3%80%82

3. 参考链接

• GlusterFS容器文档
• https://github.com/gluster/gluster-swift/blob/master/doc/markdown/quick_start_guide.md