ボリュームでデータを残す — コンテナを消すとデータも消える

ボリュームでデータを残す。コンテナと独立した保存ディスク、データのフォルダ。

※本記事はアフィリエイト広告(PR)を含みます。

コンテナを消すとデータも消えます。ボリュームで残す範囲と、消える範囲を実際に確かめます。

前回: Dockerイメージを小さくする — 1.2GBが50MBになる

これは【深掘り】の記事です。本線の順路ではありません。 読まなくても先へ進めます。 本線の Composeなら1コマンドで立ち上がる の続きとして、そこで volumes: と1行書いたものが実際には何をしているのかを確かめる回です。

この記事のコマンドは、すべてVMの中(Ubuntu Server)で打ちます。 前提: Dockerの導入を終えて、docker ps が sudo なしで通ること。 本線で作ったものには触りません。 練習用に ~/vollab を新しく作って、そこだけで完結させます。

はじめて Docker で MySQL を立てたとき、こうなりました。

コンテナを起動して、テーブルを作って、データを入れる。動く。嬉しい。翌日、設定を1つ変えたくて docker rm して docker run し直す。

mysql> SELECT * FROM memo;
ERROR 1146 (42S02): Table 'app.memo' doesn't exist

全部消えていました。

このとき私は「Docker はデータを保存できない」と思いました。違います。 保存する場所を指定していなかっただけです。そしてその指定には3種類あって、選び方がある。この回はそこを潰します。

対象レベル: 中級〜上級 / 区分: 発展

目次

この記事でわかること

  • コンテナの中に書いたファイルは、コンテナを消すと一緒に消える。これは不具合ではなく設計
  • volumes と bind mounts と tmpfs は用途が違う。名前の違いではなく、誰が管理するかが違う
  • bind mount で「Permission denied」になるのは、ホストとコンテナで利用者番号が食い違っているから
  • -v を書き忘れても、イメージによっては匿名ボリュームが勝手に作られる。それが静かにディスクを食う
  • ボリュームの中身は docker cp では取り出せないことがある。バックアップには別の型が要る

この記事でやること

  1. 練習用のフォルダを作り、コンテナを消すとデータが消えるところを実際に見る
  2. 名前付きボリュームを付けて、消えなくなることを確かめる
  3. bind mount に置き換えて、ホスト側からファイルが見えることを確かめる
  4. 権限が合わずに起動しない状態をわざと作り、直す
  5. 匿名ボリュームが溜まっているのを見つけて掃除する
  6. ボリュームをバックアップして、別のボリュームに復元する

先に知る言葉

この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。

言葉意味
書き込み可能レイヤーコンテナごとに1枚だけ乗る、書き換え用の薄い層。コンテナを消すと一緒に消える
ボリューム(volume)Docker が管理する保存領域。名前を付けて呼ぶ。実体はホストのどこかにあるが、意識しない
bind mountホストの特定のフォルダを、コンテナの中の場所に直接見せる方式
tmpfsメモリ上の置き場。再起動で消える。ディスクに残したくないものを置く
匿名ボリューム名前を付けずに作られたボリューム。docker volume ls に長い16進数の名前で並ぶ
UID / GID利用者番号とグループ番号。名前ではなく番号で権限が判定される

① まず、消えるところを見る

練習用のフォルダを作ります。

bash
$ mkdir -p ~/vollab && cd ~/vollab

MySQL を、保存先を何も指定せずに起動します。

bash
$ docker run -d --name db1 -e MYSQL_ROOT_PASSWORD=labpass mysql:8.0

labpass は練習用のダミーです。 本番のパスワードをここに書かないでください。 なお mysql:8.0 は 2026年4月30日でサポート終了。新しく作るなら 8.4 LTS です。

起動を待ってから、テーブルを作ってデータを入れます。

bash
$ docker exec -i db1 mysql -uroot -plabpass -e "CREATE DATABASE app; USE app; CREATE TABLE memo(id INT, body VARCHAR(50)); INSERT INTO memo VALUES (1,'消えるかどうか');"

入ったことを確認します。

bash
$ docker exec -i db1 mysql -uroot -plabpass -e "SELECT * FROM app.memo;"
+------+--------------------+
| id   | body               |
+------+--------------------+
|    1 | 消えるかどうか     |
+------+--------------------+

ここでコンテナを消して、作り直します。イメージは同じです。

bash
$ docker rm -f db1
$ docker run -d --name db1 -e MYSQL_ROOT_PASSWORD=labpass mysql:8.0

もう一度、同じ問い合わせをします。

bash
$ docker exec -i db1 mysql -uroot -plabpass -e "SELECT * FROM app.memo;"
ERROR 1049 (42000) at line 1: Unknown database 'app'

データベースごと消えています。

なぜ消えるのか

コンテナとイメージは別物の回で、イメージがレイヤーの積み重ねであることを見ました。コンテナを起動すると、その上に書き込み可能レイヤーが1枚乗ります。

誰のものかコンテナを消すと
イメージのレイヤーイメージ残る(他のコンテナも使う)
書き込み可能レイヤーそのコンテナだけ一緒に消える

コンテナの中に書いたファイルは、全部この1枚に入ります。だから消えます。

これは不具合ではありません。 「コンテナは使い捨て」という前提が、この設計から来ています。だから残したいものは、外に置く必要があります。

スクリーンショットを撮ってください: 01_データが消える.png SELECT が成功した画面と、コンテナを作り直したあとに Unknown database になった画面を、同じターミナルで続けて撮ってください。


② 名前付きボリュームを付ける

外に置く方法の1つ目です。Docker に「名前を付けた保存領域」を作らせて、そこに書かせます。

さっきのコンテナを消して、-v を足して起動し直します。

bash
$ docker rm -f db1
$ docker run -d --name db1 -e MYSQL_ROOT_PASSWORD=labpass -v labdata:/var/lib/mysql mysql:8.0

-v labdata:/var/lib/mysql の読み方はこうです。

部分意味
labdataボリュームの名前。無ければ Docker が作る
:区切り
/var/lib/mysqlコンテナの中のどこに見せるか。MySQL がデータを書く場所

データを入れます。

bash
$ docker exec -i db1 mysql -uroot -plabpass -e "CREATE DATABASE app; USE app; CREATE TABLE memo(id INT, body VARCHAR(50)); INSERT INTO memo VALUES (1,'今度は残るか');"

コンテナを消して、作り直します。 さっきと同じ操作です。

bash
$ docker rm -f db1
$ docker run -d --name db1 -e MYSQL_ROOT_PASSWORD=labpass -v labdata:/var/lib/mysql mysql:8.0
$ sleep 15
$ docker exec -i db1 mysql -uroot -plabpass -e "SELECT * FROM app.memo;"
+------+--------------------+
| id   | body               |
+------+--------------------+
|    1 | 今度は残るか       |
+------+--------------------+

残りました。 コンテナは別物になっているのに、データは同じです。

ボリュームの実体はどこにあるのか

一覧を見ます。

bash
$ docker volume ls
DRIVER    VOLUME NAME
local     labdata

中身の場所を調べます。

bash
$ docker volume inspect labdata

Mountpoint に、ホスト側の実体の場所が出ます。/var/lib/docker/volumes/labdata/_data のような場所です。

この場所を直接触らないでください。 読むだけなら sudo ls で見えますが、Docker が管理している領域なので、外から書き換えると壊れます。 中身を触るときは、次に出てくる一時コンテナ経由でやります。

「実体の場所を意識しなくていい」ことが、名前付きボリュームの利点です。 名前で呼べば、どこにあるかは Docker が知っています。


③ bind mount に置き換える

外に置く方法の2つ目です。ホストの特定のフォルダを、そのままコンテナに見せます。

こちらはデータベースではなく、設定ファイルやソースコードで使うのが本来の用途です。まず、それを実感します。

bash
$ mkdir -p ~/vollab/html
$ echo "<h1>ホスト側で書きました</h1>" > ~/vollab/html/index.html
$ docker run -d --name web1 -p 8080:80 -v ~/vollab/html:/usr/share/nginx/html:ro nginx:alpine

確認します。

bash
$ curl http://localhost:8080/
<h1>ホスト側で書きました</h1>

ホスト側でファイルを書き換えて、もう一度叩いてみます。

bash
$ echo "<h1>書き換えました</h1>" > ~/vollab/html/index.html
$ curl http://localhost:8080/
<h1>書き換えました</h1>

コンテナを再起動していないのに、変わりました。 ホストのフォルダをそのまま見ているからです。

末尾の :ro は read only(読み取り専用) の意味です。コンテナ側から書き換えられないようにしています。設定ファイルを渡すときは、付けておくと事故が減ります。

3つの方式を並べる

名前付きボリュームbind mounttmpfs
実体Docker が管理する領域ホストの指定フォルダメモリ
場所を意識するかしない(名前で呼ぶ)する(パスを書く)なし
ホストから直接見えるか見えるが触らない見える。触ってよい見えない
再起動で残るか残る残る消える
向いているものデータベース、アップロードされたファイル設定ファイル、開発中のソース秘密情報、一時ファイル
移植性高い(環境に依存しない)低い(パスが環境ごとに違う)高い

迷ったら名前付きボリュームです。 bind mount は「ホスト側から触りたい理由があるとき」だけ使います。

tmpfs も試しておきます。

bash
$ docker run --rm --tmpfs /tmp/secret:size=10m alpine sh -c "echo 'メモリの上' > /tmp/secret/a.txt; cat /tmp/secret/a.txt; df -h /tmp/secret | tail -1"
メモリの上
tmpfs             10.0M      4.0K     10.0M   0% /tmp/secret

tmpfs と出ています。ディスクには一切書かれません。


④ bind mount で権限が合わずに起動しない

bind mount で一番よくハマるのがここです。わざと起こします。

ホスト側にデータ用のフォルダを作って、MySQL に使わせます。公式の MySQL イメージは、root のまま起動したときは自分でフォルダの持ち主を mysql(番号 999)に直してから動くので、そのままでは落ちません。そこで --user 999:999 を付けて最初から mysql の番号で起動させ、この自動の直しを飛ばします。

bash
$ mkdir -p ~/vollab/mysqldata
$ docker rm -f db1
$ docker run -d --name db2 --user 999:999 -e MYSQL_ROOT_PASSWORD=labpass -v ~/vollab/mysqldata:/var/lib/mysql mysql:8.0

数秒待ってから状態を見ます。

bash
$ docker ps -a --filter name=db2
CONTAINER ID   IMAGE       ...   STATUS                     NAMES
xxxxxxxxxxxx   mysql:8.0   ...   Exited (1) 3 seconds ago   db2

落ちています。 理由をログで見ます。

bash
$ docker logs db2 | tail -5
mysqld: Can't create/write to file '/var/lib/mysql/is_writable' (OS errno 13 - Permission denied)
... [ERROR] [MY-010460] [Server] --initialize specified but the data directory exists and is not writable. Aborting.

何が起きているのか

ホストとコンテナで、利用者を「番号」で照合しているからです。

ホスト側のフォルダの持ち主を見ます。

bash
$ ls -ldn ~/vollab/mysqldata
drwxrwxr-x 2 1000 1000 4096 Sep 22 10:00 /home/ユーザー名/vollab/mysqldata

1000 は自分の番号です。一方、MySQL のイメージは中で mysql という利用者(番号 999)として動きます。

bash
$ docker run --rm mysql:8.0 id mysql
uid=999(mysql) gid=999(mysql) groups=999(mysql)

999 の利用者が、1000 の持ち物に書こうとして拒否されました。

名前ではなく番号で判定されます。 ホスト側の mysql とコンテナ側の mysql は、名前が同じでも別人です。ここはLinuxの権限の回と権限をもう一段で見た話がそのまま出てきます。

直し方は3つある

方法やり方向き不向き
① 名前付きボリュームにする-v labdata:/var/lib/mysqlこれが正解。データベースでbind mountを使う理由はほぼ無い
② ホスト側の持ち主を合わせるsudo chown -R 999:999 ~/vollab/mysqldata動くが、ホスト側から触りにくくなる
③ コンテナ側の番号を指定する--user "$(id -u):$(id -g)"イメージによっては別の場所で失敗する

②で直してみます。

bash
$ sudo chown -R 999:999 ~/vollab/mysqldata
$ docker rm -f db2
$ docker run -d --name db2 --user 999:999 -e MYSQL_ROOT_PASSWORD=labpass -v ~/vollab/mysqldata:/var/lib/mysql mysql:8.0
$ sleep 15
$ docker ps --filter name=db2 --format "{{.Names}} {{.Status}}"
db2 Up 15 seconds

起動しました。 ホスト側にファイルができていることも確認できます。

bash
$ sudo ls ~/vollab/mysqldata | head -5

ただし、これは「動かすため」の対処です。 データベースを bind mount で運用しないでください。 権限の管理が増えるうえ、ホスト側のファイルシステムによっては性能も落ちます。データベースは名前付きボリュームが原則です。

スクリーンショットを撮ってください: 02_権限で落ちる.png docker logs db2 の Permission denied の行と、ls -ldn で 1000 1000 と出ている画面を一緒に撮ってください。


⑤ 匿名ボリュームが静かに溜まる

これは気づきにくい罠です。

最初の実験を思い出してください。-v を書かずに MySQL を起動しました。あのとき、データは消えました。では、書いていたデータはどこへ行ったのか。

一覧を見ます。

bash
$ docker volume ls
DRIVER    VOLUME NAME
local     3f8a1c...(長い16進数)
local     9b2e77...(長い16進数)
local     labdata

名前を付けていないボリュームが、勝手に作られています。

mysql のイメージには VOLUME /var/lib/mysql という指定が入っています。-v を書かなくても、Docker が匿名のボリュームを作ってそこに割り当てるのです。

bash
$ docker image inspect mysql:8.0 --format '{{.Config.Volumes}}'
map[/var/lib/mysql:{}]

問題は、コンテナを消しても、この匿名ボリュームは残ることです。docker rm を繰り返すたびに増えていきます。

どれくらい食っているか見ます。

bash
$ docker system df -v | grep -A 20 "Local Volumes space usage"

掃除します。

bash
$ docker volume ls -qf dangling=true

消す前に、必ずこの一覧を確認してください。 dangling=true は「どのコンテナからも使われていない」という意味で、停止中のコンテナが使っているものは含まれません。それでも、大事なデータが混じっていないか目で見てから消します。

bash
$ docker volume prune

labdata は名前が付いているので、いまの既定では消える候補に入りません。 Docker 23 以降の prune は匿名ボリュームだけを消し、名前付きまで消すのは --all(-a)を付けたときです。

教訓は1つです。 -v は「保存するため」だけでなく、「どこに保存されたか分かるようにするため」に書きます。


⑥ ボリュームをバックアップして、復元する

ボリュームの中身は docker cp では取り出せないことがあります。 docker cp はユーザーが付けたマウント(ボリューム)の中身をコピーできない、と公式に書かれているからです。

一時コンテナを経由するのが定石です。

まず、db1 を名前付きボリュームで立て直してデータを入れます。

bash
$ docker rm -f db1 db2 2>/dev/null
$ docker run -d --name db1 -e MYSQL_ROOT_PASSWORD=labpass -v labdata:/var/lib/mysql mysql:8.0
$ sleep 15
$ docker exec -i db1 mysql -uroot -plabpass -e "CREATE DATABASE IF NOT EXISTS app; USE app; CREATE TABLE IF NOT EXISTS memo(id INT, body VARCHAR(50)); INSERT INTO memo VALUES (2,'バックアップの練習');"

方法A:ボリュームをまるごと固める

コンテナを止めてからやります。動いたまま固めると、書きかけの状態が混ざります。

bash
$ docker stop db1
$ docker run --rm -v labdata:/from -v ~/vollab:/to alpine tar -czf /to/labdata.tar.gz -C /from .
$ ls -lh ~/vollab/labdata.tar.gz

読み方はこうです。

部分意味
--rm終わったらこのコンテナを消す
-v labdata:/fromバックアップしたいボリュームを /from に見せる
-v ~/vollab:/to保存先のホストフォルダを /to に見せる
tar -czf /to/... -C /from ./from の中身を固めて /to に置く

ボリューム用の特別なコマンドは要りません。 ボリュームを見せた一時コンテナの中で、普通の tar を使うだけです。

復元する

別のボリュームに戻して、中身が同じか確かめます。

bash
$ docker volume create labdata_restored
$ docker run --rm -v labdata_restored:/to -v ~/vollab:/from alpine tar -xzf /from/labdata.tar.gz -C /to
$ docker run -d --name db3 -e MYSQL_ROOT_PASSWORD=labpass -v labdata_restored:/var/lib/mysql mysql:8.0
$ sleep 15
$ docker exec -i db3 mysql -uroot -plabpass -e "SELECT * FROM app.memo;"
+------+--------------------------+
| id   | body                     |
+------+--------------------------+
|    2 | バックアップの練習       |
+------+--------------------------+

戻りました。

方法B:データベースなら、データベースの道具を使う

これが本命です。 MySQL なら mysqldump です。

bash
$ docker start db1 && sleep 15
$ docker exec db1 mysqldump -uroot -plabpass app > ~/vollab/app.sql
$ head -3 ~/vollab/app.sql
ボリュームをまるごと固めるmysqldump
止める必要ある無い
バージョンをまたげるか危ない(内部形式に依存)できる
中身を見られるか見られないテキストなので読める
戻す速さ速い遅い(全部流し直す)

ボリュームのバックアップは「データベース以外」に向いています。 アップロードされた画像や、生成されたファイルなどです。データベースは本線のデプロイと運用の回でやったとおり、mysqldump で取って、戻せることを確かめるのが原則です。

スクリーンショットを撮ってください: 03_復元できた.png labdata_restored から起動した db3 で SELECT が通っている画面を撮ってください。


VPS で動かす場合は、この手順がそのまま本番のバックアップになります。たとえばさくらのVPSはバックアップ機能が標準・オプションともに無い(公式 FAQ、2026-11 時点)ので、ボリュームの中身を退避して別の場所に置く流れを自分で設計する前提になります。初期費用無料・完全定額制で、東京・大阪・石狩からリージョンを選べます。

⑦ Compose ではどう書くか

本線のComposeの回で書いた volumes: が、ここまでの話とどう対応するか整理します。

services:
  db:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: labpass
    volumes:
      - labdata:/var/lib/mysql          # 名前付きボリューム
      - ./initdb:/docker-entrypoint-initdb.d:ro   # bind mount(読み取り専用)

volumes:
  labdata:
書き方どれになるか
labdata:/var/lib/mysql名前付きボリューム(下の volumes: で宣言が要る)
./initdb:/...bind mount(. や / で始まるとこちら)
宣言なしで /var/lib/mysql だけ匿名ボリューム(避ける)

. で始まるかどうかで意味が変わります。 labdata と ./labdata は別物です。前者はボリューム、後者はホストのフォルダです。

docker compose down ではボリュームは消えません。 消すには docker compose down -v が要ります。逆に言えば、-v を付けると本当に消えます。 練習用のデータベースを何度も作り直すときに便利ですが、打つ前に対象を確認してください。


つまずいたところ

docker run の直後に docker exec して、Can't connect to local MySQL server が出た。 MySQL は起動に十数秒かかります。コンテナが Up でも、中の MySQL はまだ準備中です。sleep 15 を挟むか、docker logs db1 | grep "ready for connections" が出るまで待ちます。本番なら Compose の healthcheck を使います。

ホストのフォルダを bind mount したら、コンテナの中で空に見えた。 パスを間違えていました。存在しないパスを指定しても、Docker はエラーにせず空のフォルダを作ります。 -v ~/vollab/html:/... の ~ がシェルで展開されずに -v '~/vollab/html:/...' のようになっていると、フォルダはできず、ボリューム名として読まれて includes invalid characters for a local volume name(use absolute path)というエラーになります。

docker volume prune -a で、残しておきたいボリュームまで消した。 実験用だったので実害はありませんでしたが、-a(--all)を付けた prune は、名前付きも含めて「使われていないもの」を全部消します(付けなければ匿名ボリュームだけ。Docker 23 以降)。 停止中のコンテナが使っているものは残りますが、コンテナを消した後のボリュームは対象です。先に docker volume ls -qf dangling=true で一覧を出す癖を付けました。

:ro を付けたのに、コンテナの中で書けてしまった。 別のパスにも同じフォルダを :ro なしでマウントしていました。同じフォルダを2か所に見せると、緩いほうが効きます。

バックアップした .tar.gz が 0 バイトだった。 -C /from . の最後の . を書き忘れていました。tar は「何を固めるか」を明示しないと何も入りません。 イメージを小さくする回でも同じ形で詰まりました。

sudo chown -R 999:999 をホームディレクトリ全体にやりそうになった。 ~/vollab/mysqldata のつもりが、タブ補完で途中まで打って Enter を押しかけました。chown -R は打つ前に、対象を ls -ld で確認するのを型にしています。


後片づけ

作ったものを全部消します。 順番があります。

bash
$ docker rm -f db1 db3 web1 2>/dev/null
$ docker volume rm labdata labdata_restored
$ docker volume ls

匿名ボリュームが残っていないか確認して、消します。

bash
$ docker volume ls -qf dangling=true
$ docker volume prune

権限を変えたフォルダごと消します。

bash
$ sudo rm -rf ~/vollab

イメージも消す場合(他で使っていなければ)。

bash
$ docker rmi mysql:8.0 nginx:alpine alpine
$ docker system df

本線で作ったものが無事か確認します。

bash
$ ls ~/server ~/hitokoto 2>/dev/null

まとめ — 理解できたこと

  • コンテナの中に書いたファイルは、書き込み可能レイヤーに入る。コンテナを消すと一緒に消える。これは設計であって不具合ではない
  • 外に置く方法は3つ。名前付きボリューム / bind mount / tmpfs。違いは「実体がどこにあるか」ではなく誰が管理するか
  • データベースは名前付きボリューム。設定ファイルとソースは bind mount。秘密情報は tmpfs
  • bind mount の Permission denied は、ホストとコンテナで利用者番号が食い違っているから。名前ではなく番号で判定される
  • -v を書かなくても匿名ボリュームが作られるイメージがある。消し忘れると静かに溜まる
  • -v は保存のためだけでなく、「どこに保存されたか分かるようにするため」に書く
  • ボリュームのバックアップは一時コンテナに tar を走らせる。ただしデータベースは mysqldump が原則
  • Compose では . で始まるかどうかで、ボリュームと bind mount が変わる
  • docker compose down ではボリュームは消えない。-v を付けると消える

参考リンク


次に読む

この記事は 【深掘り】Docker の 5 / 11 本目です。

記事
← 前の記事Dockerイメージを小さくする — 1.2GBが50MBになる
→ 次の記事コンテナのネットワーク — localhostで繋がらないのは当然

上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。

全体の順路は はじめに にあります。

roadmap.sh のどこをやっているか

DevOps›Docker — Data Persistence
  • volumes / bind mounts / tmpfs の使い分け
  • ボリュームのバックアップと復元

この記事は、上の項目を実際に手を動かして確かめる回です。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

コメント

コメントする

目次