====== Docker & LVM ======
https://docs.docker.com/storage/storagedriver/device-mapper-driver/#configure-direct-lvm-mode-for-production

===== Install prerequisites =====
<code bash>
apt-get install -y lvm2 thin-provisioning-tools && reboot
</code>

===== Set variables =====
<code bash>
export device=/dev/xvdf
export vgname=docker
export lvname=thinpool
</code>

===== Create physical Volume =====
<code bash>
pvcreate $device
</code>

===== Create volume group =====
<code bash>
vgcreate $vgname $device
</code>
===== 
Create logical volumes =====
<code bash>
lvcreate --wipesignatures y -n ${lvname} ${vgname} -l 95%VG
lvcreate --wipesignatures y -n ${lvname}meta ${vgname} -l 1%VG
</code>

===== Convert logical volumes to thinpools =====
<code bash>
sudo lvconvert -y --zero n -c 512K --thinpool ${vgname}/${lvname} --poolmetadata ${vgname}/${lvname}meta
</code>

===== Create thinpool monitoring policy =====
<code bash>
mkdir -p /etc/lvm/profile/
tee /etc/lvm/profile/${vgname}-${lvname}.profile << EOF
activation {
  thin_pool_autoextend_threshold=80
  thin_pool_autoextend_percent=20
}
EOF

lvchange --metadataprofile ${vgname}-${lvname} ${vgname}/${lvname}
lvs -o+seg_monitor
</code>

===== Add Storage Options to /etc/docker/daemon.json =====
Adding "-tpool" to dm.tinpooldev is important on debian systems.
<code json>
{
    "storage-driver": "devicemapper",
    "storage-opts": [
      "dm.thinpooldev=/dev/mapper/docker-thinpool-tpool",
      "dm.use_deferred_removal=true",
      "dm.use_deferred_deletion=true",
      "dm.mountopt=mand"
    ]
}
</code>

{{tag>kb linux docker}}