ハンズオン:ボリュームを使ってみよう

ストレージ管理については、実際に操作しながら理解するのが一番です。

まずはボリュームから見ていきます。ここでは、MySQLコンテナを使って、ボリュームによるデータ永続化を体験します。コンテナを削除しても、ボリュームに保存されたデータベースのデータが残ることを確認しましょう。

📝 MySQLとは
MySQLは、世界で最も広く使われているオープンソースのリレーショナルデータベース管理システム(RDBMS)です。Webアプリケーションのバックエンドとして、アプリケーションで利用する様々なデータを保存するために使用されます。

1. ボリュームの作成

以下のコマンドで、Docker がインストールされていることを確認します。

docker --version

以下のように Docker のバージョンが表示されれば、インストールは確認できています。

Docker version 27.x.x, build xxxxxxx

バージョンが表示されない場合は、Docker Desktopのインストール を先に実施してください。

インストールが確認できたら、MySQLのデータを保存するためのボリュームを作成します。

docker volume create mysql-data

docker volume createコマンドは、Dockerが管理するボリュームを作成します。引数にはボリューム名を指定します。ここではmysql-dataという名前のボリュームを作成しています。作成したボリュームは、後でコンテナにマウントして使用します。

2. MySQLコンテナの起動

ボリュームをマウントしたMySQLコンテナを起動します。

docker container run -d \
  -v mysql-data:/var/lib/mysql \
  -e MYSQL_ROOT_PASSWORD=password \
  -e MYSQL_DATABASE=testdb \
  --name mysql-container \
  mysql:8.0

-v mysql-data:/var/lib/mysqlは、先ほど作成したボリュームをコンテナ内のディレクトリにマウントするオプションです。コロンの左側(mysql-data)がボリューム名、右側(/var/lib/mysql)がコンテナ内のマウント先パスです。MySQLはデータを/var/lib/mysqlに保存するため、ここにボリュームをマウントすることで、データベースのデータがボリュームに保存されるようになります。

その他のオプションは、MySQLコンテナの起動に必要な設定です。

  • -d: コンテナをバックグラウンドで実行します
  • -e MYSQL_ROOT_PASSWORD=password: rootユーザのパスワードを設定します
  • -e MYSQL_DATABASE=testdb: 起動時に作成するデータベース名を指定します
  • --name mysql-container: コンテナに名前を付けます

3. データの登録

MySQLに接続して、テストデータを登録します。

docker container exec -it mysql-container mysql -u root -ppassword testdb

mysql -u root -ppassword testdbの部分は、コンテナ内で実行するMySQLクライアントのコマンドです。-u rootでrootユーザとして接続し、-ppasswordでパスワードを指定しています(-pの直後にスペースなしでパスワードを記述します)。最後のtestdbは接続先のデータベース名です。

接続に成功するとmysql>というプロンプトが表示されます。これはMySQLがコマンドの入力を待っている状態です。このプロンプトが表示されたら、テーブルを作成してデータを登録します。

データベースの操作にはSQL(Structured Query Language)というデータベース専用の言語を使用します。SQLの詳細な説明は省略しますが、以下の手順でテーブルの作成とデータの登録を行います。

まず、CREATE TABLEでテーブルを作成します。

CREATE TABLE users (id INT PRIMARY KEY, name VARCHAR(50));

次に、INSERT INTOでデータを登録します。

INSERT INTO users VALUES (1, 'Taro'), (2, 'Hanako');

最後に、SELECTで登録されたデータを確認します。

SELECT * FROM users;

以下のように表示されれば、データが登録されています。

+----+-------+
| id | name  |
+----+-------+
|  1 | Taro   |
|  2 | Hanako |
+----+-------+

MySQLから抜けます。

exit

4. コンテナの削除

ここで一度、MySQLコンテナを停止・削除します。通常であれば、このタイミングでデータも一緒に消えてしまいますが、ボリュームを使っているためデータを残すことができます。

docker container stop mysql-container
docker container rm mysql-container

5. データが残っていることの確認

データが再び利用できることを確認するために、同じボリュームをマウントして、新しいMySQLコンテナを起動します。

docker container run -d \
  -v mysql-data:/var/lib/mysql \
  -e MYSQL_ROOT_PASSWORD=password \
  --name mysql-container-2 \
  mysql:8.0

起動を待ってから、MySQLに接続してデータを確認します。

docker container exec -it mysql-container-2 mysql -u root -ppassword testdb

SQLのSELECT文を実行して、データを確認します。

SELECT * FROM users;

先程登録したデータと同じデータが検索できます。これにより、ボリュームにデータが残っており、再び起動したときにそれを利用できます。

+----+-------+
| id | name  |
+----+-------+
|  1 | Taro   |
|  2 | Hanako |
+----+-------+

確認が終わったら、MySQLから抜けておきます。

exit

これがボリュームの最大のメリットです。データベースコンテナをバージョンアップする際や、コンテナに問題が発生して再作成する際にも、データを失うことなく運用を継続できます。

6. ボリュームの保存場所の確認

ボリュームのデータは、どこに保存されているのでしょうか。docker volume inspectコマンドで確認できます。

docker volume inspect mysql-data
[
    {
        "CreatedAt": "2024-01-15T10:30:00Z",
        "Driver": "local",
        "Labels": null,
        "Mountpoint": "/var/lib/docker/volumes/mysql-data/_data",
        "Name": "mysql-data",
        "Options": null,
        "Scope": "local"
    }
]

Mountpointにボリュームの保存場所が表示されています。WindowsやmacOSでDocker Desktopを使っている場合、このパスはDocker Desktopの仮想マシン内のパスです。そのため、FinderやExplorerから直接このフォルダを開くことはできません。

ボリューム内のファイルを確認したい場合は、コンテナ経由でアクセスします。以下のコマンドで、ボリューム内のファイル一覧を確認できます。

docker container run --rm -v mysql-data:/data alpine ls -la /data

以下のようにMySQLのデータファイルが表示されます。

total 96780
drwxrwxrwt    8 999      999           4096 Jan 15 10:35 .
drwxr-xr-x    1 root     root          4096 Jan 15 10:40 #
-rw-r-----    1 999      999             56 Jan 15 10:30 auto.cnf
-rw-r-----    1 999      999           3085 Jan 15 10:30 ca-key.pem
-rw-r-----    1 999      999           1112 Jan 15 10:30 ca.pem
-rw-r-----    1 999      999           1112 Jan 15 10:30 client-cert.pem
-rw-r-----    1 999      999           1680 Jan 15 10:30 client-key.pem
-rw-r-----    1 999      999        3955928 Jan 15 10:35 ib_buffer_pool
-rw-r-----    1 999      999       12582912 Jan 15 10:35 ibdata1
drwxr-x---    2 999      999           4096 Jan 15 10:30 mysql
drwxr-x---    2 999      999           4096 Jan 15 10:30 performance_schema
-rw-r-----    1 999      999           1680 Jan 15 10:30 private_key.pem
-rw-r-----    1 999      999            452 Jan 15 10:30 public_key.pem
-rw-r-----    1 999      999           1112 Jan 15 10:30 server-cert.pem
-rw-r-----    1 999      999           1680 Jan 15 10:30 server-key.pem
drwxr-x---    2 999      999           4096 Jan 15 10:30 sys
drwxr-x---    2 999      999           4096 Jan 15 10:32 testdb

testdbディレクトリが、先ほど作成したデータベースです。このように、MySQLのデータがボリューム内に保存されていることが確認できます。

💡 ポイント
Linux上でDockerを直接動かしている場合は、Mountpointのパス(/var/lib/docker/volumes/mysql-data/_data)に直接アクセスしてファイルを確認できます。

7. 不要リソースの削除

ハンズオンが終わったら、作成したリソースを削除します。ボリュームはコンテナにマウントされている間は削除できないため、まずコンテナを停止・削除してからボリュームを削除します。

コンテナを停止します。

docker container stop mysql-container-2

次に、コンテナを削除します。

docker container rm mysql-container-2

最後に、ボリュームを削除します。

docker volume rm mysql-data

docker volume rmは、指定したボリュームを削除するコマンドです。コンテナを削除しても、ボリュームは自動的には削除されません。これは、データを誤って消してしまうことを防ぐための仕様です。ボリュームを削除するには、このコマンドを明示的に実行する必要があります。

8. ボリューム関連コマンドまとめ

今回のハンズオンで使用したボリューム関連のコマンドをまとめます。

コマンド 説明
docker volume create <ボリューム名> 新しいボリュームを作成する
docker volume inspect <ボリューム名> ボリュームの詳細情報を表示する
docker volume rm <ボリューム名> ボリュームを削除する
docker container run -v <ボリューム名>:<コンテナ内パス> コンテナ起動時にボリュームをマウントする