Docker の Volumes と Bind mounts

Docker の Volumes と Bind mounts について、何度読んでも意味が分からないのでまとめる。

docker run コマンドの -v (--volume) オプション

リファレンス: https://docs.docker.com/engine/reference/run/#volume-shared-filesystems

-v, --volume=[host-src:]container-dest[:]

The host-src can either be an absolute path or a name value. If you supply an absolute path for the host-src, Docker bind-mounts to the path you specify. If you supply a name, Docker creates a named volume by that name.

Docker 内のファイルを共有するには、Volumes と Bind mounts という二つの方法があるが、ややこしいことに、同じオプションで Volumes と Bind mounts という異なる機能を設定する。

A name value must start with an alphanumeric character, followed by a-z0-9, _ (underscore), . (period) or - (hyphen). An absolute path starts with a / (forward slash).

• host-src が英数文字から始まる時: Volumes
• host-src が / から始まる時: Bind mounts

Volumes https://docs.docker.com/storage/volumes/

Volume を作る

$ docker volume create my-vol

Volume のリスト。いつの間にか出来ているボリュームの最後に先程作った物が出る。

$ docker volume ls
DRIVER    VOLUME NAME
local     0ac8a1264245c3d065e045e06f5509691df967bba733deb49052548a04c39c5e
...
local     my-vol

Volume の情報を見る。

$ docker volume inspect my-vol
[
    {
        "CreatedAt": "2021-09-16T01:41:33Z",
        "Driver": "local",
        "Labels": {},
        "Mountpoint": "/var/lib/docker/volumes/my-vol/_data",
        "Name": "my-vol",
        "Options": {},
        "Scope": "local"
    }
]

これを見ると /var/lib/docker/volumes/my-vol/_data に実体がありそうだが、ホストが Mac だと見えない。この Volume をマウントして cont1 と名付けたコンテナを動かし、hello ファイルを作る。

$ docker run --name cont1 -v my-vol:/my-vol ubuntu \
  bash -c 'echo "Hello, world!" > /my-vol/hello'

Volume を別の cont2 と名付けたコンテナにマウントして中を見る。

$ docker run --name cont2 -v my-vol:/my-vol ubuntu \
  cat /my-vol/hello
Hello, world!

ちゃんと共有されている。

Bind mounts https://docs.docker.com/storage/bind-mounts/

Volumes を使うとホストのどこにファイルが保存されるか分からない。ホスト側の位置を指定したい時は Bind mounts を使う。

例えば cont1 で先程作った ファイルをホストにバックアップする時はこうする。

$ mkdir backup
$ docker run --rm --volumes-from cont1 -v $PWD/backup:/backup ubuntu \
  tar cvf /backup/backup.tar /my-vol
tar: Removing leading `/' from member names
/my-vol/
/my-vol/hello

次の事が起こる。

• --volumes-from cont1: cont1 コンテナに使われた Volumes を全部マウントする。
• -v $PWD/backup:/backup: ホストの $PWD/backup をコンテナの /backup に bind mounts する。
• tar cvf /backup/backup.tar /my-vol: コンテナの /my-vol を /backup/backup.tar にバックアップする。
• コンテナの /backup/backup.tar の実体はホストの $PWD/backup:/backup/backup.tar なので、コマンドが終わるとホストに backup.tar が残る。

確認

$ tar tf backup/backup.tar
my-vol/
my-vol/hello

後片付け

$ docker container rm cont1 cont2
$ docker volume prune