trajano/glusterfs-volume-plugin
Managed volume plugin for glusterfs
1M+
This is a managed Docker volume plugin to allow Docker containers to access GlusterFS volumes. The GlusterFS client does not need to be installed on the host and everything is managed within the plugin.
--alias
when installing the plugin.--alias
to define separate instancesSERVERS
is initially blank it needs docker plugin glusterfs set SERVERS=store1,store2
if it is set then it will be used for all servers and low level options will not be allowed. Primarily this is to control what the deployed stacks can perform.There are three operating modes listed in order of preference. Each are mutually exclusive and wlil result in an error when performing a docker volume create
if more than one operating mode is configured.
This is the recommended approach for production systems as it will prevent stacks from specifying any random server. It also prevents the stack configuration file from containing environment specific servers and instead defers that knowledge to the plugin only which is set on the node level. This relies on SERVERS
being configured and will use the name as the volume mount set by docker plugin set
. This can be done in an automated fashion as:
docker plugin install --alias PLUGINALIAS \
trajano/glusterfs-volume-plugin \
--grant-all-permissions --disable
docker plugin set PLUGINALIAS SERVERS=store1,store2
docker plugin enable PLUGINALIAS
If there is a need to have a different set of servers, a separate plugin alias should be created with a different set of servers.
Example in docker-compose.yml:
volumes:
sample:
driver: glusterfs
name: "volume/subdir"
The volumes.x.name
specifies the volume and optionally a subdirectory mount. The value of name
will be used as the --volfile-id
and --subdir-mount
. Note that volumes.x.name
must not start with /
.
This uses the driver_opts.servers
to define a comma separated list of servers. The rules for specifying the volume is the same as the previous section.
Example in docker-compose.yml assuming the alias was set as glusterfs
:
volumes:
sample:
driver: glusterfs
driver_opts:
servers: store1,store2
name: "volume/subdir"
The volumes.x.name
specifies the volume and optionally a subdirectory mount. The value of name
will be used as the --volfile-id
and --subdir-mount
. Note that volumes.x.name
must not start with /
. The values above correspond to the following mounting command:
glusterfs -s store1 -s store2 --volfile-id=volume \
--subdir-mount=subdir [generated_mount_point]
This passes the driver_opts.glusterfsopts
to the glusterfs
command followed by the generated mount point. This is the most flexible method and gives full range to the options of the glusterfs FUSE client. Example in docker-compose.yml assuming the alias was set as glusterfs
:
volumes:
sample:
driver: glusterfs
driver_opts:
glusterfsopts: "--volfile-server=SERVER --volfile-id=abc --subdir-mount=sub"
name: "whatever"
The value of name
will not be used for mounting; the value of driver_opts.glusterfsopts
is expected to have all the volume connection information.
This is an example of mounting and testing a store outside the swarm. It is assuming the server is called store1
and the volume name is trajano
.
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
docker plugin install trajano/glusterfs-volume-plugin