Dockerボリューム(Volume)のコピー、‘なぜ’そうする必要があるのか？

最も一般的なシナリオです。稼働中の db_data ボリュームをテスト用の db_data_test ボリュームにコピーしたい場合があります。

🤔 WHY: なぜ一時コンテナを使うのか？

Dockerボリュームはホストファイルシステムのどこか(/var/lib/docker/volumes/...など)に保存されますが、Dockerデーモンがこのパスを管理します。このパスに直接アクセスして cp コマンドを使用することは推奨されておらず、権限の問題やデータの整合性の問題を引き起こす可能性があります。

代わりに、私たちは 2つのボリュームを同時にマウントした 一時コンテナを実行します。

1. コンテナが /from パスに 元のボリューム(source_volume)をマウントします。

2. コンテナが /to パスに 対象ボリューム(new_volume)をマウントします。

3. コンテナは起動するとすぐに /from のすべてのデータを /to にコピーする簡単なLinuxコマンド(cpまたはtar)を実行します。

4. コマンドが終了すると、コンテナは自動的に削除されます(--rmオプション)。

このコンテナはデータコピーのための‘ツール’としてのみ使用されます。

🚀 HOW: コマンドの例

source_data ボリュームのデータを target_data ボリュームにコピーする例です。

1. テスト用ボリューム作成 (オプション)

docker volume create source_data
docker volume create target_data
# (source_dataにデータがあると仮定します。)

1. 一時コンテナを利用したコピー

docker run --rm \
       -v source_data:/from \
       -v target_data:/to \
       alpine \
       sh -c "cp -a /from/. /to/"

💡 コマンド解説

• docker run --rm: --rm フラグはコンテナが作業を完了し終了すると 即座にコンテナを削除 することを意味します。短期的な作業に必須です。

• -v source_data:/from: source_data ボリュームをコンテナ内部の /from ディレクトリにマウントします。

• -v target_data:/to: target_data ボリュームをコンテナ内部の /to ディレクトリにマウントします。

• alpine: cpやshなどの基本ユーティリティを含みつつも、非常に軽量な alpine Linuxイメージを使用します。

• sh -c "...": alpineコンテナが起動するときに実行するコマンドです。

• cp -a /from/. /to/:

  • -a (archive): このフラグが核心です。単なるコピー(cp -r)ではなく 所有権や権限、タイムスタンプなどすべての属性を保持して コピーします。データベースファイルなど敏感なデータを扱う際に非常に重要です。

  • /from/.: /from ディレクトリではなく、/from 内部のすべてのコンテンツ (隠しファイルも含む)を意味します。

2. ボリュームデータをホストファイルシステムにコピーする (バックアップ)

ボリュームのデータをローカルマシンやサーバーの特定のディレクトリに .tar ファイルなどでバックアップしたいときに使用します。

🤔 WHY: どのように機能するのか？

原理は1番と同じです。ただし、対象が‘Dockerボリューム’ ではなく‘ホストディレクトリ’に変わっただけです。

Dockerはホストの特定のディレクトリをコンテナにマウントする バインドマウント(Bind Mount) 機能をサポートしています。

1. コンテナが /data パスに 元のボリューム(source_volume)をマウントします。

2. コンテナが /backup パスに ホストの特定ディレクトリ($(pwd)/backup)をマウントします。

3. コンテナは /data の内容を /backup ディレクトリにコピー(または圧縮)します。

4. この作業はコンテナ内で行われますが、 /backup は実際のホストディレクトリと接続されているため、結果はホストに残ります。

🚀 HOW: コマンドの例

source_data ボリュームのデータを現在の位置($(pwd))の backup ディレクトリにコピーします。

# ホストにバックアップを取るためのディレクトリを作成
mkdir -p $(pwd)/backup

docker run --rm \
       -v source_data:/data:ro \
       -v $(pwd)/backup:/backup \
       alpine \
       cp -a /data/. /backup/

💡 コマンド解説

• -v source_data:/data:ro: :ro (Read-Only) フラグを追加しました。バックアップはデータを読むだけで済むため、誤って元のボリュームを修正するのを防ぐために 読み取り専用でマウント することが推奨されます。

• -v $(pwd)/backup:/backup: source_data (ボリューム名)とは異なり、 / で始まるか $(pwd)(現在のパス)を含む 絶対/相対パスはホストのディレクトリを指します。

3. 重要なコピーのヒント (Tips)

docker run --rm \
       -v source_data:/from \
       -v target_data:/to \
       alpine \
       sh -c "cd /from && tar -cf - . | (cd /to && tar -xf -)"

docker run --rm \
       -v source_data:/data:ro \
       -v $(pwd):/backup \
       alpine \
       tar -czf /backup/backup.tar.gz -C /data .

# $(pwd)/backup ディレクトリのデータを new_data ボリュームに復元
docker run --rm \
       -v new_data:/data \
       -v $(pwd)/backup:/backup:ro \
       alpine \
       cp -a /backup/. /data/