【Docker】bind mount vs volume完全比較ガイド｜10軸比較・実測ベンチ・5問判定・20シナリオ別正解・混在運用

# bind mount：ホストのパスを明示
docker run --mount type=bind,source="$(pwd)/app",target=/app ...
# 旧記法：/で始まる or ./で始まる → bind扱い
docker run -v "$(pwd)/app":/app ...

# volume：Dockerが管理、名前指定
docker run --mount type=volume,source=db_data,target=/var/lib/mysql ...
# 旧記法：名前だけなら volume扱い
docker run -v db_data:/var/lib/mysql ...

# ① VirtioFS有効化（macOS Docker Desktop）
#   Settings → General → "Use Virtualization framework" をON
#   File sharing → "VirtioFS" を選択（4.30以降がデフォルト）

# ② WSL2ファイルシステム利用（Windows）
#   プロジェクトを C:\Users\... ではなく \\wsl$\Ubuntu\home\... に置く

# ③ 遅いディレクトリをanonymous volumeで上書き
services:
  app:
    volumes:
      - ./app:/var/www/html              # bind（ソース）
      - /var/www/html/node_modules        # anonymous volume（上書き）
      - /var/www/html/vendor

# ④ :delegated / :cached を付与（レガシー環境向け）
volumes:
  - ./app:/var/www/html:delegated

Q1: コンテナ内で生成されるデータ？
    （DB・uploads・ログ・キャッシュなど）
    YES → Q2
    NO  → Q3

Q2: 永続化が必要？
    YES → 【named volume】一択
    NO  → 【tmpfs】（メモリ上の高速一時）

Q3: ホストから頻繁に編集する？
    （ソース・設定・テストデータ）
    YES → 【bind mount】
    NO  → Q4

Q4: コンテナ間で共有する？
    YES → 【named volume】（共有に向く）
    NO  → Q5

Q5: ホスト特有のファイルを参照？
    （/etc/hostsや~/.aws等）
    YES → 【bind mount :ro】
    NO  → 【named volume】がデフォルト推奨

services:
  web:
    image: nginx:1.27-alpine
    ports: ["8080:80"]
    volumes:
      - ./public:/var/www/html/public:ro    # bind: 公開アセット
      - ./nginx.conf:/etc/nginx/conf.d/default.conf:ro   # bind: 設定

  app:
    build: ./docker/php
    volumes:
      - ./:/var/www/html                     # bind: ソース全体
      - /var/www/html/vendor                 # anonymous: vendor隔離
      - /var/www/html/node_modules           # anonymous: 依存隔離
      - laravel_storage:/var/www/html/storage/app   # named: 永続

  db:
    image: mariadb:11
    volumes:
      - db_data:/var/lib/mysql               # named: DB永続
      - ./docker/mysql/my.cnf:/etc/mysql/conf.d/custom.cnf:ro  # bind: 設定

  redis:
    image: redis:7-alpine
    volumes:
      - redis_data:/data                     # named

volumes:
  db_data:
  redis_data:
  laravel_storage:

services:
  web:
    image: node:20-alpine
    working_dir: /app
    command: npm run dev
    ports: ["3000:3000"]
    volumes:
      - .:/app                               # bind: ソース
      - /app/node_modules                    # anonymous: node_modules隔離（超重要）
      - /app/.next                           # anonymous: ビルドキャッシュ
    environment:
      - WATCHPACK_POLLING=true               # macOS/Winでfile watch対策

  postgres:
    image: postgres:16-alpine
    volumes:
      - postgres_data:/var/lib/postgresql/data   # named
      - ./docker/postgres/init.sql:/docker-entrypoint-initdb.d/init.sql:ro   # bind: 初期化

volumes:
  postgres_data:

services:
  wordpress:
    image: wordpress:6.7-php8.3-apache
    ports: ["8080:80"]
    volumes:
      # WP本体（wp-admin／wp-includes）はマウントしない
      # 編集対象だけbind
      - ./wp-content/themes:/var/www/html/wp-content/themes        # bind: テーマ開発
      - ./wp-content/plugins:/var/www/html/wp-content/plugins      # bind: プラグイン開発
      - wp_uploads:/var/www/html/wp-content/uploads                 # named: アップロード
      - ./uploads.ini:/usr/local/etc/php/conf.d/uploads.ini:ro     # bind: PHP設定

  db:
    image: mariadb:11
    volumes:
      - db_data:/var/lib/mysql                # named

volumes:
  db_data:
  wp_uploads:

# 前提：./db-data:/var/lib/mysql で運用していた

# ① 新規volumeを作成
docker volume create db_data

# ② 既存データをvolumeへコピー（コンテナ停止必須）
docker compose stop db

docker run --rm \
  -v "$(pwd)/db-data":/from:ro \
  -v db_data:/to \
  alpine sh -c "cd /from && cp -a . /to/"

# ③ compose.yml を書き換え
# 旧: - ./db-data:/var/lib/mysql
# 新: - db_data:/var/lib/mysql

# ④ volumes top-level に追加
# volumes:
#   db_data:

# ⑤ 起動して動作確認
docker compose up -d db
docker compose exec db mariadb -u root -proot -e "SHOW DATABASES"

# ⑥ 古いbind mount dirをバックアップ＋削除
tar czf db-data-backup.tar.gz db-data/
rm -rf db-data/

# ① volume内容を取り出し
docker run --rm \
  -v db_data:/from:ro \
  -v "$(pwd):/to" \
  alpine tar czf /to/db_data.tar.gz -C /from .

# ② 展開
mkdir -p ./db-data
tar xzf db_data.tar.gz -C ./db-data

# ③ compose.yml変更→起動

# コンテナ内のプロセスUIDを確認
docker compose exec app id
# uid=33(www-data)

# ホスト側ディレクトリの所有者変更
sudo chown -R 33:33 ./wp-content

# または開発環境のみ全権限
chmod -R 777 ./wp-content    # 本番NG

# SELinuxならラベル付与
docker run -v ./app:/app:z ...

services:
  web:
    volumes:
      - .:/app
      - /app/node_modules    # ← これが重要

# コンテナ内で npm install するとvolume側に入り、
# ホスト側の./node_modulesは空のまま