Dockerボリュームのバックアップとリストア｜tarで安全にデータを退避

4-2 で Named Volume を使ってデータを永続化しました。でもボリューム自体も消える事故はあります——ホストの故障、docker volume rm の誤爆、マシン移行、バージョンアップ前の保険。

この記事では、Docker公式が推奨する「一時コンテナを使った tar バックアップ」パターンと、そのリストア手順をマスターします。

目次

1. なぜボリュームをバックアップする？
2. 基本パターン：一時コンテナで tar
3. バックアップ手順
4. リストア手順
5. ハンズオン：Postgres ボリュームを退避→復元
6. 本番運用のTips
7. DB固有のダンプ併用
8. まとめ

1. なぜボリュームをバックアップする？

2. 基本パターン：一時コンテナで tar

Dockerには docker volume backup というコマンドはありません。Docker公式が推奨しているのは次のパターンです。

3. バックアップ手順

# mydata ボリュームを ./backup/mydata.tar.gz に退避
mkdir -p backup
docker run --rm \
  -v mydata:/source:ro \
  -v "$(pwd)/backup":/backup \
  alpine \
  tar czf /backup/mydata.tar.gz -C /source .

# 確認
ls -lh backup/mydata.tar.gz

4. リストア手順

バックアップの逆向き——空のボリュームに tar を展開します。

# 1. リストア先のボリュームを用意（新規でもOK、既存でもOK）
docker volume create mydata-restored

# 2. 一時コンテナで tar を展開
docker run --rm \
  -v mydata-restored:/dest \
  -v "$(pwd)/backup":/backup:ro \
  alpine \
  sh -c "cd /dest && tar xzf /backup/mydata.tar.gz"

# 3. 中身の確認（別の一時コンテナで）
docker run --rm -v mydata-restored:/data alpine ls -la /data

5. ハンズオン：Postgres ボリュームを退避→復元

4-2 で使った pgdata ボリュームを実際にバックアップ＆リストアしてみます。

5-1. データ投入（準備）

docker volume create pgdata
docker run -d --name db \
  -e POSTGRES_PASSWORD=secret \
  -v pgdata:/var/lib/postgresql/data \
  postgres:16

docker exec -it db psql -U postgres -c "CREATE TABLE users(id SERIAL PRIMARY KEY, name TEXT);"
docker exec -it db psql -U postgres -c "INSERT INTO users(name) VALUES ('Alice'),('Bob');"

5-2. Postgres を「停止してから」バックアップ

# 整合性のため、書き込み中のDBは停止する
docker stop db

# バックアップ
mkdir -p backup
docker run --rm \
  -v pgdata:/source:ro \
  -v "$(pwd)/backup":/backup \
  alpine \
  tar czf /backup/pgdata.tar.gz -C /source .

ls -lh backup/pgdata.tar.gz

# バックアップ完了後、DBを再開
docker start db

5-3. 事故シミュレーション：ボリュームを消してしまう

docker rm -f db
docker volume rm pgdata   # 😱 大事なボリュームを誤削除

docker volume ls
# pgdata が消えている

5-4. バックアップから復元

# 新規ボリュームを作る
docker volume create pgdata

# tar を展開
docker run --rm \
  -v pgdata:/dest \
  -v "$(pwd)/backup":/backup:ro \
  alpine \
  sh -c "cd /dest && tar xzf /backup/pgdata.tar.gz"

# Postgres を再起動して確認
docker run -d --name db \
  -e POSTGRES_PASSWORD=secret \
  -v pgdata:/var/lib/postgresql/data \
  postgres:16

# データ確認
docker exec -it db psql -U postgres -c "SELECT * FROM users;"
#  id | name
# ----+-------
#   1 | Alice
#   2 | Bob
# (2 rows)                     ← 完全復活🎉

6. 本番運用のTips

7. DB固有のダンプ併用

DBのボリュームtarは「データディレクトリの物理コピー」です。これに加えて、DBネイティブの論理ダンプも取っておくと安心です。

PostgreSQL

# 動作中の Postgres から論理ダンプを取る（停止不要・オンラインバックアップ）
docker exec -t db pg_dumpall -U postgres > backup/db-$(date +%Y%m%d).sql

# リストア
cat backup/db-20260420.sql | docker exec -i db psql -U postgres

MySQL

docker exec -t mysql-db mysqldump -uroot -psecret --all-databases \
  > backup/mysql-$(date +%Y%m%d).sql

cat backup/mysql-20260420.sql | docker exec -i mysql-db mysql -uroot -psecret

8. まとめ

参考リンク

• Back up, restore, or migrate data volumes（Docker公式） — 本記事のパターンの公式解説。
• PostgreSQL: SQL Dump（公式） — pg_dump / pg_dumpall の使い方。
• MySQL: mysqldump（公式） — MySQL 論理バックアップの一次情報源。

Dockerの基礎を動画で体系的に学びませんか？

実務で使う基礎だけを3時間に凝縮。環境構築から丁寧に解説しています。

クーポン割引で講座を見る →