gluster/gluster-centos

CentOS GlusterFS 镜像文档

1. 镜像概述和主要用途

本镜像是基于 CentOS 7 操作系统构建的官方 GlusterFS 容器化实现，集成最新稳定版 GlusterFS 分布式文件系统。主要用途是提供高性能、可扩展的分布式文件存储服务，支持通过容器化方式快速部署和管理 GlusterFS 集群，适用于构建灵活的共享存储架构。

2. 核心功能和特性

2.1 分布式存储架构

• 采用无元数据服务器设计，避免单点故障，所有节点平等参与存储和管理
• 支持将数据分散存储在多个节点，提升并行读写性能

2.2 高可用性保障

• 提供副本（Replicate）和纠删码（Erasure Code）两种数据冗余机制，支持数据自动修复
• 节点故障时自动切换至可用副本，保障数据访问连续性

2.3 线性扩展能力

• 支持在线横向扩展，新增节点后可动态调整存储容量和性能
• 理论存储容量和性能随节点数量线性增长

2.4 灵活的卷类型支持

• 分布式卷（Distributed）：数据分散存储在多个 brick，不提供冗余
• 复制卷（Replicated）：数据在多个 brick 间复制，提供冗余
• 分布式复制卷（Distributed-Replicated）：结合分布式和复制特性，平衡性能与冗余
• 条带卷（Striped）：数据分片存储，提升大文件读写性能
• 分布式条带卷（Distributed-Striped）：结合分布式和条带特性

2.5 企业级特性

• POSIX 兼容：支持标准文件系统接口，兼容现有应用
• 快照与克隆：支持文件系统级快照创建、删除及快照克隆
• 配额管理：支持对目录或用户设置存储配额
• 卷加密：支持传输中和静态数据加密（需配置 TLS 和磁盘加密）

3. 使用场景和适用范围

3.1 企业级共享存储

• 作为部门级或全公司共享文件系统，替代传统 NAS 设备
• 支持多客户端同时访问，提供统一命名空间

3.2 云平台后端存储

• 为 OpenStack、Kubernetes 等云平台提供持久化存储服务
• 支持动态卷供应（Dynamic Provisioning）和存储类（StorageClass）集成

3.3 大数据处理存储

• 作为 Hadoop、Spark 等大数据框架的底层存储，提供高吞吐量
• 支持 PB 级数据容量扩展，满足海量数据存储需求

3.4 容器化环境存储

• 为容器集群提供跨节点共享存储，支持容器数据持久化
• 兼容 Docker Volume、Kubernetes PV/PVC 等容器存储接口

4. 使用方法和配置说明

4.1 前置要求

• Docker 1.13+ 环境
• 节点间网络互通（建议使用 --net=host 模式或开放以下端口：24007-24008、49152-49251）
• 每个节点需准备用于存储数据的目录/设备（建议通过 --volume 挂载至容器内）

4.2 快速启动（单节点测试）

bash
docker run -d \
  --name gluster-test \
  --net=host \
  --volume /data/gluster/brick1:/brick1 \
  -e GLUSTER_VOLUME_NAME=testvol \
  -e GLUSTER_VOLUME_TYPE=distributed \
  -e BRICK_PATH=/brick1 \
  centos-glusterfs

参数说明：

• --net=host：使用主机网络，避免端口映射复杂性（生产环境推荐）
• /data/gluster/brick1:/brick1：将宿主机数据目录挂载为 GlusterFS brick
• 环境变量用于指定卷配置（见 4.3 节）

4.3 环境变量说明

4.4 集群部署示例（分布式复制卷）

步骤 1：在所有节点启动 Gluster 容器

节点 1（192.168.1.10）：

bash
docker run -d \
  --name gluster-node1 \
  --net=host \
  --volume /data/gluster/brick1:/brick1 \
  --volume /var/lib/glusterd:/var/lib/glusterd \  # 持久化 Gluster 配置
  centos-glusterfs

节点 2（192.168.1.11）：

bash
docker run -d \
  --name gluster-node2 \
  --net=host \
  --volume /data/gluster/brick1:/brick1 \
  --volume /var/lib/glusterd:/var/lib/glusterd \
  centos-glusterfs

步骤 2：创建集群并配置卷

1. 在节点 1 容器内添加节点 2 至集群：

bash
docker exec -it gluster-node1 gluster peer probe 192.168.1.11

2. 验证集群状态：

bash
docker exec -it gluster-node1 gluster peer status

3. 创建分布式复制卷（2 副本）：

bash
docker exec -it gluster-node1 gluster volume create testvol replica 2 \
  192.168.1.10:/brick1/testvol \
  192.168.1.11:/brick1/testvol

4. 启动卷：

bash
docker exec -it gluster-node1 gluster volume start testvol

4.5 docker-compose 集群示例

yaml
version: '3'

services:
  gluster-node1:
    image: centos-glusterfs
    container_name: gluster-node1
    network_mode: host
    volumes:
      - /data/gluster/brick1:/brick1
      - /var/lib/glusterd:/var/lib/glusterd
    environment:
      - GLUSTER_VOLUME_NAME=prodvol
      - GLUSTER_VOLUME_TYPE=distributed-replicated
      - REPLICA_COUNT=2
    restart: always

  gluster-node2:
    image: centos-glusterfs
    container_name: gluster-node2
    network_mode: host
    volumes:
      - /data/gluster/brick1:/brick1
      - /var/lib/glusterd:/var/lib/glusterd
    restart: always

4.6 客户端挂载卷

在客户端主机执行以下命令挂载 Gluster 卷：

bash
mount -t glusterfs 192.168.1.10:testvol /mnt/gluster

5. 注意事项

• 数据持久化：生产环境必须通过 --volume 将 brick 目录和 /var/lib/glusterd（配置目录）挂载至宿主机，避免容器重启后数据丢失
• 集群通信：多节点集群需确保所有节点间 TCP 端口 24007-24008、49152-49251 互通
• 性能优化：根据负载类型调整卷类型（如大文件用条带卷，小文件用分布式复制卷）
• 安全加固：生产环境建议启用 TLS 加密（gluster volume set <vol> client.ssl on server.ssl on）和访问控制列表（gluster volume set <vol> auth.allow <cidr>）