ハンズオン:ボリュームを使ってみよう
ストレージ管理については、実際に操作しながら理解するのが一番です。
まずはボリュームから見ていきます。ここでは、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 <ボリューム名>:<コンテナ内パス> |
コンテナ起動時にボリュームをマウントする |