Docker ボリュームは、コンテナ化されたアプリケーションに永続的なストレージを提供し、コンテナが停止または削除されてもデータをそのまま保持できます。インフラストラクチャが進化するにつれて、スケーリング、アップグレード、またはサービスの再配置をサポートするために、これらのボリュームを異なるホストに移行する必要が生じる場合があります。
このチュートリアルでは、ホスト間で Docker ボリュームを移行するプロセスを説明します。ボリュームの作成、データの設定、バックアップ、および新しいホストへの復元方法を学びます。この実験（Lab）の終わりには、コンテナ化された環境でデータの継続性を確保するための Docker ボリューム移行技術について明確に理解できるようになります。
Docker ボリュームは、コンテナに永続的なストレージを提供します。ボリュームを移行する前に、それらが何であるか、どのように作成するかを理解する必要があります。
Docker ボリュームは、Docker コンテナによって生成され、使用されるデータを永続化するための推奨されるメカニズムです。コンテナが削除されると失われるコンテナの書き込み可能なレイヤーに保存されるデータとは異なり、ボリュームは Docker によって完全に管理され、コンテナとは独立して存在します。
Docker ボリュームの主な利点には以下が含まれます。
まず、シンプルな Docker ボリュームを作成することから始めましょう。
docker volume create my-data-volumeこのコマンドを実行すると、Docker は my-data-volume という名前の新しいボリュームを作成します。ターミナルにボリューム名が出力されるはずです。
my-data-volume次のコマンドを使用して、システム上のすべての Docker ボリュームを一覧表示できます。
docker volume lsこれにより、すべてのボリュームのテーブルが表示されます。
DRIVER VOLUME NAME
local my-data-volumeボリュームの詳細情報を取得するには、inspect コマンドを使用します。
docker volume inspect my-data-volumeボリュームに関する詳細情報が JSON 形式で表示されます。
[
{
"CreatedAt": "2023-10-01T12:34:56Z",
"Driver": "local",
"Labels": {},
"Mountpoint": "/var/lib/docker/volumes/my-data-volume/_data",
"Name": "my-data-volume",
"Options": {},
"Scope": "local"
}
]Mountpoint の値に注目してください。これは、Docker がホストシステムにボリュームデータを保存する場所です。
ボリュームを作成したので、コンテナで使用してみましょう。ボリュームをマウントし、そこにいくつかのデータを追加するシンプルなコンテナを作成します。
docker run --name my-container -v my-data-volume:/data ubuntu /bin/bash -c "echo 'Hello from Docker volume' > /data/test.txt"このコマンドは次のことを行います。
my-container という名前のコンテナを作成します。my-data-volume をコンテナ内の /data ディレクトリにマウントします。同じボリュームをマウントする別のコンテナを作成して、データがボリュームに書き込まれたことを確認しましょう。
docker run --rm -v my-data-volume:/data ubuntu cat /data/test.txt次のような出力が表示されるはずです。
Hello from Docker volumeこれは、データがボリュームに永続的に保存され、異なるコンテナからアクセスできることを示しています。
Docker ボリュームを別のホストに移行する前に、ソースデータを準備し、移行プロセスを理解する必要があります。このステップでは、ボリュームにさらにデータを追加し、移行の準備をします。
ボリュームにさらにデータを追加するコンテナを作成しましょう。これにより、すべてのボリュームデータが正しく移行されることを実証できます。
docker run --name data-generator -v my-data-volume:/data ubuntu /bin/bash -c "mkdir -p /data/config && echo 'database_url=postgres://user:password@db:5432/mydb' > /data/config/settings.conf && echo 'This is important data' > /data/important.txt"このコマンドは、ボリューム内にサンプルコンテンツを含むディレクトリとファイルを作成します。
ボリューム内のデータ構造を確認しましょう。
docker run --rm -v my-data-volume:/data ubuntu ls -la /data次のような出力が表示されるはずです。
total 12
drwxr-xr-x 3 root root 4096 Oct 1 12:34 .
drwxr-xr-x 1 root root 4096 Oct 1 12:34 ..
drwxr-xr-x 2 root root 4096 Oct 1 12:34 config
-rw-r--r-- 1 root root 21 Oct 1 12:34 important.txt
-rw-r--r-- 1 root root 24 Oct 1 12:34 test.txtファイルのコンテンツも確認しましょう。
docker run --rm -v my-data-volume:/data ubuntu cat /data/important.txt出力：
This is important dataDocker ボリュームを移行するには、いくつかの方法があります。
この実験（Lab）では、ほとんどの環境で機能し、特別なプラグインを必要としないバックアップと復元のアプローチを使用します。
ボリュームのバックアップを作成するために、Docker コンテナを使用してボリュームの内容をアーカイブします。
docker run --rm -v my-data-volume:/source -v $(pwd):/backup ubuntu tar cvf /backup/my-data-volume-backup.tar -C /source .このコマンドは次のことを行います。
/source にボリュームをマウントします。/backup に現在のディレクトリをマウントします。/source ディレクトリ内のすべてのものの tar アーカイブを作成し、それを /backup/my-data-volume-backup.tar に保存します。バックアップファイルが作成されたことを確認します。
ls -lh my-data-volume-backup.tar次のような出力が表示されるはずです。
-rw-r--r-- 1 labex labex 10K Oct 1 12:34 my-data-volume-backup.tarすべてが正しくアーカイブされたことを確認するために、バックアップファイルの内容を調べましょう。
tar -tf my-data-volume-backup.tar出力には以下が含まれるはずです。
./
./config/
./config/settings.conf
./important.txt
./test.txtこれで、ボリュームのバックアップを作成したので、新しいホストへの移行をシミュレートする準備ができました。
実際のシナリオでは、scp、rsync、またはファイル共有サービスなどのツールを使用して、バックアップファイルを新しいホストに転送します。この実験（Lab）では、元のボリュームを削除し、データを復元するための新しいボリュームを作成することにより、移行をシミュレートします。
まず、古いコンテナをクリーンアップして、新しい環境への移行をシミュレートしましょう。
docker rm -f my-container data-generator次に、新しいホストで最初から始めることをシミュレートするために、元のボリュームを削除しましょう。
docker volume rm my-data-volume「新しいホスト」上のボリュームを表す新しいボリュームを作成します。
docker volume create my-new-host-volume次に、バックアップを新しいボリュームに復元します。
docker run --rm -v my-new-host-volume:/destination -v $(pwd):/backup ubuntu bash -c "cd /destination && tar xvf /backup/my-data-volume-backup.tar"このコマンドは次のことを行います。
/destination にマウントします。/backup にマウントします。/destination ディレクトリに展開します。すべてのデータが新しいボリュームに正しく復元されたことを確認しましょう。
docker run --rm -v my-new-host-volume:/data ubuntu ls -la /data以前と同じファイル構造が表示されるはずです。
total 12
drwxr-xr-x 3 root root 4096 Oct 1 12:34 .
drwxr-xr-x 1 root root 4096 Oct 1 12:34 ..
drwxr-xr-x 2 root root 4096 Oct 1 12:34 config
-rw-r--r-- 1 root root 21 Oct 1 12:34 important.txt
-rw-r--r-- 1 root root 24 Oct 1 12:34 test.txtデータの整合性を確認するために、ファイルのコンテンツを確認します。
docker run --rm -v my-new-host-volume:/data ubuntu cat /data/important.txt出力：
This is important data設定ファイルも確認します。
docker run --rm -v my-new-host-volume:/data ubuntu cat /data/config/settings.conf出力：
database_url=postgres://user:password@db:5432/mydbボリュームを正常に「移行」したので、新しいコンテナで使用してみましょう。
docker run --name my-new-container -v my-new-host-volume:/app/data -d nginxこれにより、復元されたボリュームを /app/data にマウントする新しい Nginx コンテナが作成されます。
コンテナがボリュームデータにアクセスできることを確認しましょう。
docker exec my-new-container ls -la /app/data以前と同じファイルが表示されるはずです。これにより、移行が成功したことが確認されます。
実際のシナリオでは、ボリュームを新しいホストに移行した後、新しいボリューム名またはパスを使用するように Docker Compose ファイルまたはコンテナ実行コマンドを更新する必要があります。たとえば、Docker Compose を使用している場合は、docker-compose.yml ファイルを次のように更新できます。
version: "3"
services:
webapp:
image: nginx
volumes:
- my-new-host-volume:/app/data
volumes:
my-new-host-volume:
external: trueこれにより、外部で作成された my-new-host-volume という名前のボリュームを使用するように Docker に指示します。
移行プロセスはこれで完了です！次のことを正常に実行しました。
Docker ボリューム移行の基本を理解したところで、ボリューム移行をより効率的かつ堅牢にするためのベストプラクティスと高度なテクニックを探ってみましょう。
ボリューム移行を計画する際には、以下の要素を考慮してください。
頻繁な移行や複数のボリュームの移行には、自動化により時間とエラーを削減できます。バックアップと復元のプロセスを自動化する簡単なシェルスクリプトを作成しましょう。
nano migrate-volume.shスクリプトに以下の内容を追加します。
#!/bin/bash
## Simple Docker volume migration script
if [ $## -ne 2 ]; then
echo "Usage: $0 <source_volume> <destination_volume>"
exit 1
fi
SOURCE_VOLUME=$1
DEST_VOLUME=$2
BACKUP_FILE="/tmp/${SOURCE_VOLUME}-backup.tar"
echo "Creating backup of ${SOURCE_VOLUME}..."
docker run --rm -v ${SOURCE_VOLUME}:/source -v /tmp:/backup ubuntu tar cf /backup/${SOURCE_VOLUME}-backup.tar -C /source .
echo "Creating destination volume ${DEST_VOLUME}..."
docker volume create ${DEST_VOLUME}
echo "Restoring backup to ${DEST_VOLUME}..."
docker run --rm -v ${DEST_VOLUME}:/destination -v /tmp:/backup ubuntu bash -c "cd /destination && tar xf /backup/${SOURCE_VOLUME}-backup.tar"
echo "Migration complete. Verifying volume contents..."
docker run --rm -v ${DEST_VOLUME}:/data ubuntu ls -la /data
echo "Done!"ファイルを保存（Ctrl+O、Enter）し、終了（Ctrl+X）します。
スクリプトを実行可能にします。
chmod +x migrate-volume.shこれで、単一のコマンドでボリュームを移行できます。
./migrate-volume.sh my-new-host-volume another-volumeこれにより、my-new-host-volume のバックアップが作成され、another-volume という名前の新しいボリュームが作成され、そこにバックアップが復元されます。
大容量ボリュームの場合、基本的な tar アプローチは非効率的になる可能性があります。以下に代替案を示します。
rsync を使用してホスト間で直接コピーします。圧縮バックアップアプローチを実装してみましょう。
docker run --rm -v my-new-host-volume:/source -v $(pwd):/backup ubuntu tar czf /backup/compressed-backup.tar.gz -C /source .tar に追加された z オプションは圧縮を有効にし、より小さなバックアップファイルになります。これは特にテキスト中心のデータに役立ちます。
圧縮バックアップから復元するには：
docker volume create compressed-volume
docker run --rm -v compressed-volume:/destination -v $(pwd):/backup ubuntu bash -c "cd /destination && tar xzf /backup/compressed-backup.tar.gz"本番環境では、以下の追加アプローチを検討できます。
これで、Docker ボリューム移行の旅は完了です。インフラストラクチャの変更中にコンテナ化されたアプリケーションのデータがそのまま維持されるように、ホスト間で Docker ボリュームを効果的に移行するための知識とツールが揃いました。
この実験（Lab）では、コンテナ化されたアプリケーションを管理するための重要なスキルである、ホスト間で Docker ボリュームを移行する方法を学びました。以下の実践的な経験を積みました。
これらのスキルにより、環境間のコンテナの移動、インフラストラクチャのスケーリング、またはシステムアップグレードの実行時にデータの継続性を維持できます。Docker ボリューム移行は、永続的なデータを必要に応じて安全かつ確実に転送できることを知って、コンテナ化されたアプリケーションを自信を持って管理できる基本的な操作です。
