gluster/s3

docker-gluster-s3

镜像概述和主要用途

docker-gluster-s3是一个Docker镜像，主要用途是为Gluster卷提供对象接口，允许通过S3兼容协议访问Gluster存储卷。它将Gluster文件存储转换为对象存储服务，方便需要S3接口的应用程序访问Gluster数据。

核心功能和特性

• 提供S3兼容的对象存储接口，支持通过S3协议访问Gluster卷
• 支持挂载多个Gluster卷，卷名作为挂载点名称
• 允许自定义配置文件和环文件，通过绑定挂载覆盖默认配置
• 支持通过环境变量配置S3账户信息（账户名、用户名、密码）
• 容器化部署，简化Gluster对象存储服务的搭建流程

使用场景和适用范围

• 需要将Gluster存储以对象存储形式提供访问的场景
• 应用程序需要通过S3接口访问Gluster存储卷中的数据
• 在容器化环境中快速部署Gluster对象存储服务
• 需灵活配置Gluster对象存储参数的场景

详细使用方法和配置说明

构建镜像

通过以下命令从源码构建docker-gluster-s3镜像：

bash
# docker build --rm --tag gluster-s3 .

运行容器

前置要求

在主机上，需将一个或多个Gluster卷挂载到/mnt/gluster-object目录下，挂载点名称需与Gluster卷名相同。例如，若有两个Gluster卷test和test2，则应分别挂载到/mnt/gluster-object/test和/mnt/gluster-object/test2。该目录将被绑定挂载到容器内部，无需单独挂载每个卷。

同时，需在etc/sysconfig/swift-volumes中更新卷信息，例如：

S3_ACCOUNT='tv1'  # 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-s3

命令参数说明

• -d：后台运行容器
• -p：将容器端口映射到主机端口（可不相同），若省略主机端口则随机映射，支持在同一主机运行多个实例
• -v：将主机路径绑定挂载到容器内
• -e：设置环境变量，用于指定需通过对象接口导出的卷（S3_ACCOUNT）、用户名（S3_USER）和密码（S3_PASSWORD）

注意：若主机启用SELinux强制模式，运行容器前请参考下文"故障排除"部分。

自定义部署

可通过提供自定义配置文件和环文件，使容器内的swift进程使用这些文件。方法是将配置文件和环文件放在主机目录，然后绑定挂载到容器的/etc/swift目录。

示例

假设主机/tmp/swift目录包含配置文件和环文件，启动容器命令如下：

bash
# docker run -d -p 8080:8080 -v /tmp/swift:/etc/swift -v /mnt/gluster-object:/mnt/gluster-object gluster-s3

若主机启用SELinux强制模式，需先执行：

bash
# chcon -Rt svirt_sandbox_file_t /tmp/swift

故障排除

SELinux问题

当绑定挂载卷到容器时，需确保SELinux允许访问，否则容器内应用可能无法访问卷。例如：

bash
[root@f24 ~]# docker exec -i -t nostalgic_goodall /bin/bash
[root@042abf4acc4d /]# ls /mnt/gluster-object/
ls: cannot open directory /mnt/gluster-object/: Permission denied

解决方法

1. 设置SELinux上下文（理想情况下）：

   bash
   # chcon -Rt svirt_sandbox_file_t /mnt/gluster-object
   

   注意：GlusterFS目前尚不支持设置SELinux上下文1。

2. 使用特权模式运行容器：

   bash
   # docker run --privileged=true ...
   

3. 挂载时指定SELinux上下文（推荐）：

   bash
   mount -t glusterfs -o selinux,context="system_u:object_r:svirt_sandbox_file_t:s0" `hostname`:test /mnt/gluster-object/test
   

待办事项

• 从RPM包安装gluster-s3（当前从源码安装）