trajano/glusterfs-volume-plugin

GlusterFS卷插件

镜像概述

这是一个托管式Docker卷插件，用于让Docker容器访问GlusterFS卷。无需在主机上安装GlusterFS客户端，所有操作均在插件内部管理。

核心功能

1. 支持三种互斥的操作模式（按推荐优先级排序）：仅名称模式、指定服务器模式、指定选项模式
2. 通过--alias安装插件可管理多个GlusterFS集群实例
3. 可通过docker plugin set配置服务器列表，控制部署栈的访问范围

使用场景

• 生产环境中Docker容器访问GlusterFS分布式存储的场景
• 微服务架构下的数据持久化与共享存储需求
• 多环境部署中隔离不同GlusterFS集群访问的场景

配置说明

注意事项

• 仅支持托管插件，无legacy支持
• 安装时建议用--alias区分不同版本或集群实例
• 每个插件实例仅支持一个GlusterFS集群，不同集群需创建不同别名实例
• SERVERS初始为空，需通过docker plugin set设置，设置后将用于所有服务器且不允许低级选项

操作模式

1. 仅名称模式（推荐）

依赖已配置的SERVERS，通过卷名称指定挂载的卷和子目录，适合生产环境。

安装配置示例：

bash
docker plugin install --alias glusterfs \
  trajano/glusterfs-volume-plugin \
  --grant-all-permissions --disable
docker plugin set glusterfs SERVERS=store1,store2
docker plugin enable glusterfs

docker-compose.yml示例：

yaml
volumes:
  sample:
    driver: glusterfs
    name: "volume/subdir"

注：name值作为--volfile-id和--subdir-mount，不能以/开头。

2. 指定服务器模式

通过driver_opts.servers定义服务器列表，卷名称规则同前。

docker-compose.yml示例：

yaml
volumes:
  sample:
    driver: glusterfs
    driver_opts:
      servers: store1,store2
    name: "volume/subdir"

3. 指定选项模式

通过driver_opts.glusterfsopts传递GlusterFS FUSE客户端完整选项，卷名称不用于挂载。

docker-compose.yml示例：

yaml
volumes:
  sample:
    driver: glusterfs
    driver_opts:
      glusterfsopts: "--volfile-server=SERVER --volfile-id=abc --subdir-mount=sub"
    name: "whatever"

非swarm环境测试示例

bash
docker plugin install trajano/glusterfs-volume-plugin --grant-all-permissions
docker plugin enable trajano/glusterfs-volume-plugin
docker volume create -d trajano/glusterfs-volume-plugin --opt servers=store1 trajano
docker run -it -v trajano:/mnt alpine