github.com/shishir-a412ed/docker-lvm-plugin-1

Docker volume plugin for LVM volumes


License
LGPL-3.0
Install
go get github.com/shishir-a412ed/docker-lvm-plugin-1

Documentation

docker lvm plugin

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.

Setup

1) git clone git@github.com:shishir-a412ed/docker-lvm-plugin.git
2) cd docker-lvm-plugin
3) make
4) sudo make install

Usage

1) Start the docker daemon before starting the docker-lvm-plugin daemon. You can start docker daemon using command:

sudo systemctl start docker

2) Once docker daemon is up and running, you can start docker-lvm-plugin daemon using command:

sudo systemctl start docker-lvm-plugin

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.

vgcreate volume_group_one /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

/etc/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.

lvcreate -L 1G -T volume_group_one/mythinpool

Volume Creation

$ docker volume create -d lvm --name foobar --opt size=0.2G

This will create a lvm volume named foobar of size 208 MB (0.2 GB).

docker volume create -d lvm --name thin --opt size=0.2G --opt thinpool=mythinpool

This will create a thinly-provisioned lvm volume in mythinpool.

docker volume create -d lvm --name foobar_snapshot --opt snapshot=foobar --opt size=100M

This will create a snapshot volume of foobar. For thin snapshots, don't specify a size.

Volume List

$ docker volume ls

This will list volumes created by all docker drivers including the default driver (local).

Volume Inspect

$ docker volume inspect foobar

This will inspect foobar and return a JSON.

[
    {
        "Name": "foobar",
        "Driver": "lvm",
        "Mountpoint": "/var/lib/docker-lvm-plugin/foobar123"
    }
]

Volume Removal

$ docker volume rm foobar

This will remove lvm volume foobar.

Bind Mount lvm volume inside the container

$ docker run -it -v foobar:/home fedora /bin/bash

This will bind mount the logical volume foobar into the home directory of the container.

License

GNU GPL