この記事のポイント

・コンテナのデータはデフォルトで揮発性。永続化にはvolumeかバインドマウントを使う
・docker volume createで名前付きボリュームを作り、-vオプションでコンテナに接続する
・バインドマウントはホストのディレクトリを直接マウントし、開発環境のソース共有に向く
・Docker ComposeではvolumesセクションでDB・アプリのデータを永続化して管理する

# 名前付きボリュームを作成する
$ docker volume create mydb_data

# ボリューム一覧を確認する
$ docker volume ls
DRIVER    VOLUME NAME
local     mydb_data

# ボリュームの詳細情報を確認する
$ docker volume inspect mydb_data
[
    {
        "CreatedAt": "2026-07-01T09:00:00+09:00",
        "Driver": "local",
        "Labels": {},
        "Mountpoint": "/var/lib/docker/volumes/mydb_data/_data",
        "Name": "mydb_data",
        "Options": {},
        "Scope": "local"
    }
]

# -vオプション: "ボリューム名:コンテナ内パス" の形式で指定する
$ docker run -d \
  --name mysql_test \
  -e MYSQL_ROOT_PASSWORD=secret \
  -e MYSQL_DATABASE=testdb \
  -v mydb_data:/var/lib/mysql \
  mysql:8.0

# コンテナが起動していることを確認する
$ docker ps
CONTAINER ID   IMAGE       COMMAND                  CREATED         STATUS         PORTS                 NAMES
a1b2c3d4e5f6   mysql:8.0   "docker-entrypoint.s…"  30 seconds ago  Up 29 seconds  3306/tcp, 33060/tcp   mysql_test

# MySQLにテーブルを作成してデータを書き込む
$ docker exec -it mysql_test mysql -uroot -psecret testdb -e \
  "CREATE TABLE users (id INT, name VARCHAR(50)); INSERT INTO users VALUES (1, 'Miyazaki');"

# コンテナを停止・削除する（データが消えるはず？）
$ docker stop mysql_test
$ docker rm mysql_test

# 同じボリュームを使って新しいコンテナを起動する
$ docker run -d \
  --name mysql_new \
  -e MYSQL_ROOT_PASSWORD=secret \
  -e MYSQL_DATABASE=testdb \
  -v mydb_data:/var/lib/mysql \
  mysql:8.0

# データが残っているか確認する
$ docker exec -it mysql_new mysql -uroot -psecret testdb -e "SELECT * FROM users;"
+------+----------+
| id   | name     |
+------+----------+
|    1 | Miyazaki |
+------+----------+
1 row in set (0.00 sec)

# ホスト側に設定ファイルと公開ディレクトリを用意する
$ mkdir -p ~/nginx-demo/html ~/nginx-demo/conf.d
$ echo "
Hello from Docker Bind Mount
" > ~/nginx-demo/html/index.html

# バインドマウントでNginxコンテナを起動する
# -v "ホストの絶対パス:コンテナ内パス" の形式で指定する
$ docker run -d \
  --name nginx_demo \
  -p 8080:80 \
  -v ~/nginx-demo/html:/usr/share/nginx/html:ro \
  nginx:1.26

# ホスト側でindex.htmlを更新するとコンテナ側にも即時反映される
$ echo "
Updated!
" > ~/nginx-demo/html/index.html
$ curl http://localhost:8080
Updated!

# ~/myapp/compose.yml

services:
  db:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: secret
      MYSQL_DATABASE: appdb
    volumes:
      # 名前付きボリュームをマウントする
      - db_data:/var/lib/mysql
    restart: always

  web:
    image: nginx:1.26
    ports:
      - "80:80"
    volumes:
      # バインドマウント（開発用ソースコード）
      - ./html:/usr/share/nginx/html:ro
      # 設定ファイルをホストから注入する
      - ./nginx.conf:/etc/nginx/nginx.conf:ro
    depends_on:
      - db

# トップレベルのvolumesセクションで名前付きボリュームを宣言する
volumes:
  db_data:

# コンテナを起動する
$ docker compose up -d
[+] Running 3/3
 ✔ Volume "myapp_db_data"  Created
 ✔ Container myapp-db-1    Started
 ✔ Container myapp-web-1   Started

# 作成されたボリュームを確認する（プロジェクト名_ボリューム名 の命名規則）
$ docker volume ls
DRIVER    VOLUME NAME
local     myapp_db_data

# コンテナのマウント状況を確認する
$ docker inspect myapp-db-1 | grep -A 10 '"Mounts"'
        "Mounts": [
            {
                "Type": "volume",
                "Name": "myapp_db_data",
                "Source": "/var/lib/docker/volumes/myapp_db_data/_data",
                "Destination": "/var/lib/mysql",
                "Driver": "local",
                "Mode": "z",
                "RW": true,
                "Propagation": ""
            }
        ],

# docker compose downはデフォルトでボリュームを削除しない
$ docker compose down
[+] Running 3/3
 ✔ Container myapp-web-1  Removed
 ✔ Container myapp-db-1   Removed
 ✔ Network myapp_default  Removed

# ボリュームはまだ残っている
$ docker volume ls
DRIVER    VOLUME NAME
local     myapp_db_data

# ボリュームも含めてすべて削除する場合は -v オプションを付ける（注意：データが消える）
$ docker compose down -v
[+] Running 2/2
 ✔ Container myapp-db-1  Removed
 ✔ Volume myapp_db_data  Removed

# tmpfsマウントでコンテナの/tmpをRAMに割り当てる
$ docker run -d \
  --name redis_cache \
  --tmpfs /tmp:size=256m \
  redis:7

# コンテナログで Permission denied を確認する
$ docker logs nginx_demo
2026/07/01 00:10:00 [warn] 1#1: could not build optimal types_hash...
open() "/usr/share/nginx/html/index.html" failed (13: Permission denied)

# ホスト側ディレクトリの所有者を確認する
$ ls -la ~/nginx-demo/html/
drwxr-xr-x 2 root root 4096 Jul  1 09:00 .

# コンテナ内のnginxプロセスが動くユーザーIDを確認する（nginx:1.26はUID=101）
# ホスト側の所有者を合わせるか、その他ユーザー(o)に書き込み権を付ける
$ chmod o+r ~/nginx-demo/html/
# または chown 101:101 ~/nginx-demo/html/ で所有者を合わせる

# どのコンテナにも使われていない（dangling）ボリュームを確認する
$ docker volume ls -f dangling=true
DRIVER    VOLUME NAME
local     old_project_db_data
local     test_vol_20260501

# 未使用ボリュームをまとめて削除する（注意：削除前に必ず内容を確認すること）
$ docker volume prune
WARNING! This will remove anonymous local volumes not used by at least one container.
Are you sure you want to continue? [y/N] y
Deleted Volumes:
old_project_db_data
test_vol_20260501

Total reclaimed space: 2.34 GB

# NG: トップレベルのvolumesに宣言がない
services:
  db:
    volumes:
      - db_data:/var/lib/mysql  # ← エラー: db_data が宣言されていない
# volumes: セクションがない

# OK: トップレベルのvolumesで宣言する
services:
  db:
    volumes:
      - db_data:/var/lib/mysql
volumes:
  db_data:   # ← ここに宣言が必要