Docker ボリュームを別のホストに移行する方法 - データ移行とコンテナ管理

はじめに

Docker ボリュームは、コンテナ化されたアプリケーションに永続的なストレージを提供し、コンテナが停止または削除されてもデータをそのまま保持できます。インフラストラクチャが進化するにつれて、スケーリング、アップグレード、またはサービスの再配置をサポートするために、これらのボリュームを異なるホストに移行する必要が生じる場合があります。

このチュートリアルでは、ホスト間で Docker ボリュームを移行するプロセスを説明します。ボリュームの作成、データの設定、バックアップ、および新しいホストへの復元方法を学びます。この実験（Lab）の終わりには、コンテナ化された環境でデータの継続性を確保するための Docker ボリューム移行技術について明確に理解できるようになります。

Docker ボリュームの理解と作成

Docker ボリュームは、コンテナに永続的なストレージを提供します。ボリュームを移行する前に、それらが何であるか、どのように作成するかを理解する必要があります。

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

Docker ボリュームの検査

ボリュームの詳細情報を取得するには、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 ボリュームの使用

ボリュームを作成したので、コンテナで使用してみましょう。ボリュームをマウントし、そこにいくつかのデータを追加するシンプルなコンテナを作成します。

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 data

ボリューム移行のアプローチの理解

Docker ボリュームを移行するには、いくつかの方法があります。

ホスト間直接コピー（Direct host-to-host copy）: ホスト間でボリュームデータを直接コピーします。
バックアップと復元（Backup and restore）: バックアップアーカイブを作成し、新しいホストで復元します。
Docker プラグインの使用（Using Docker plugins）: 一部のストレージプラグインには、組み込みのレプリケーション機能があります。

この実験（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 にマウントします。
tar アーカイブを /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 ボリュームを作成し、データを追加しました。
ボリュームデータをバックアップしました。
シミュレートされた「新しいホスト」上に新しいボリュームを作成しました。
バックアップデータを新しいボリュームに復元しました。
データの整合性を検証しました。
新しいコンテナを移行されたボリュームに接続しました。

ベストプラクティスと高度な移行テクニック

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 ボリュームプラグイン: ストレージシステム用の特殊なプラグインを使用します。
データベースバックアップ: データベースボリュームの場合は、データベースネイティブのバックアップツールを使用します。
スケジュールされた移行: cron などのツールを使用して定期的なバックアップをスケジュールします。

これで、Docker ボリューム移行の旅は完了です。インフラストラクチャの変更中にコンテナ化されたアプリケーションのデータがそのまま維持されるように、ホスト間で Docker ボリュームを効果的に移行するための知識とツールが揃いました。

まとめ

この実験（Lab）では、コンテナ化されたアプリケーションを管理するための重要なスキルである、ホスト間で Docker ボリュームを移行する方法を学びました。以下の実践的な経験を積みました。

Docker ボリュームの作成と管理
Docker ボリュームへのデータの追加とアクセス
tar コマンドを使用したボリュームデータのバックアップ
新しいホストへのボリュームデータの復元
移行後のデータの整合性の検証
ボリューム移行のための自動化スクリプトの作成
大容量ボリュームを含むさまざまな移行シナリオの処理

これらのスキルにより、環境間のコンテナの移動、インフラストラクチャのスケーリング、またはシステムアップグレードの実行時にデータの継続性を維持できます。Docker ボリューム移行は、永続的なデータを必要に応じて安全かつ確実に転送できることを知って、コンテナ化されたアプリケーションを自信を持って管理できる基本的な操作です。