Name: docker-lvm-plugin
Owner: Project Atomic
Description: Docker volume plugin for LVM volumes
Created: 2016-03-24 18:20:54.0
Updated: 2018-05-24 06:43:20.0
Pushed: 2018-05-13 07:21:48.0
Size: 1630
Language: Go
GitHub Committers
User | Most Recent Commit | # Commits |
---|
Other Committers
User | Most Recent Commit | # Commits |
---|
Docker Volume Driver for lvm volumes
This plugin can be used to create lvm volumes of specified size, which can
then be bind mounted into the container using docker run
command.
1) git clone git@github.com:shishir-a412ed/docker-lvm-plugin.git
2) cd docker-lvm-plugin
3) make
4) sudo make install
1) Start the docker daemon before starting the docker-lvm-plugin daemon. You can start docker daemon using command:
systemctl start docker
2) Once docker daemon is up and running, you can start docker-lvm-plugin daemon using command:
systemctl start docker-lvm-plugin
NOTE: docker-lvm-plugin daemon is on-demand socket activated. Running docker volume ls
command
will automatically start the daemon.
3) Since logical volumes (lv's) are based on a volume group, it is the
responsibility of the user (administrator) to provide a volume group name.
You can choose an existing volume group name by listing volume groups on
your system using vgs
command OR create a new volume group using
vgcreate
command.
e.g.
eate vg1 /dev/hda
where /dev/hda is your partition or whole disk on which physical volumes were created.
4) Add this volume group name in the config file
/docker/docker-lvm-plugin
5) The docker-lvm-plugin also supports the creation of thinly-provisioned volumes. To create a thinly-provisioned volume, a user (administrator) must first create a thin pool using the lvcreate
command.
eate -L 10G -T vg1/mythinpool
This will create a thinpool named mythinpool
of size 10G under volume group vg1
.
NOTE: thinpools are special kind of logical volumes carved out of the volume group.
Hence in the above example, to create the thinpool mythinpool
you must have atleast 10G of freespace in volume group vg1
.
docker volume create
command supports the creation of regular lvm volumes, thin volumes, snapshots of regular and thin volumes.
Usage: docker volume create [OPTIONS]
--driver string Specify volume driver name (default "local")
bel list Set metadata for a volume (default [])
me string Specify volume name
--opt map Set driver specific options (default map[])
Following options can be passed using -o
or --opt
t size
t thinpool
t snapshot
t keyfile
Please see examples below on how to use these options.
cker volume create -d lvm --opt size=0.2G --name foobar
This will create a lvm volume named foobar
of size 208 MB (0.2 GB).
er volume create -d lvm --opt size=0.2G --opt thinpool=mythinpool --name thin_vol
This will create a thinly-provisioned lvm volume named thin_vol
in mythinpool.
er volume create -d lvm --opt snapshot=foobar --opt size=100M --name foobar_snapshot
This will create a snapshot volume of foobar
named foobar_snapshot
. For thin snapshots, use the same command above but don't specify a size.
er volume create -d lvm --opt size=0.2G --opt keyfile=/root/key.bin --name crypt_vol
This will create a LUKS encrypted lvm volume named crypt_vol
with the contents of /root/key.bin
as a binary passphrase. Snapshots of encrypted volumes use the same key file. The key file must be present when the volume is created, and when it is mounted to a container.
Use docker volume ls --help
for more information.
cker volume ls
This will list volumes created by all docker drivers including the default driver (local).
Use docker volume inspect --help
for more information.
cker volume inspect foobar
This will inspect foobar
and return a JSON.
{
"Driver": "lvm",
"Labels": {},
"Mountpoint": "/var/lib/docker-lvm-plugin/foobar",
"Name": "foobar",
"Options": {
"size": "0.2G"
},
"Scope": "local"
}
Use docker volume rm --help
for more information.
cker volume rm foobar
This will remove lvm volume foobar
.
cker run -it -v foobar:/home fedora /bin/bash
This will bind mount the logical volume foobar
into the home directory of the container.
Fedora, RHEL, Centos, Ubuntu (>= 16.04)
GNU GPL