Docker Compose入門｜複数コンテナでWordPress環境を構築するハンズオン

この記事のポイント

・docker compose up -d 1コマンドでWordPress＋MySQLを同時起動できる
・docker-compose.ymlでサービス間の依存・ネットワーク・ボリュームを一元管理する
・コンテナが起動しない時はdocker compose logsで原因を即座に特定できる
・docker compose runでDBマイグレーション・テストを一時コンテナで実行できる
・--scale や deploy.replicas でコンテナを複数台に増やして負荷分散の基礎を体験できる
・profilesでサービスに開発・本番のプロファイルを割り当て、docker compose --profile dev up で環境ごとに起動するコンテナを1ファイルで管理できる
・docker compose watchのsync・rebuild・sync+restartを使い分けてファイル変更を自動反映できる
・docker compose down でコンテナ・ネットワークをまとめてクリーンアップできる

# v2の確認方法
$ docker compose version
Docker Compose version v2.27.1

# Docker公式リポジトリを追加
$ sudo dnf config-manager --add-repo https://download.docker.com/linux/rhel/docker-ce.repo

# Docker Engine・Compose Pluginを一括インストール
$ sudo dnf install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin

# サービスを起動・自動起動設定
$ sudo systemctl enable --now docker

# 動作確認
$ docker compose version
Docker Compose version v2.27.1

# 依存パッケージを追加
$ sudo apt-get install -y ca-certificates curl

# Docker GPGキーを追加
$ sudo install -m 0755 -d /etc/apt/keyrings
$ sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg \
    -o /etc/apt/keyrings/docker.asc

# リポジトリを追加してapt updateを実行
$ sudo apt-get update && sudo apt-get install -y \
    docker-ce docker-ce-cli containerd.io docker-compose-plugin

# 動作確認
$ docker compose version
Docker Compose version v2.27.1

# dockerグループへの追加（user_nameを自分のユーザー名に変更）
$ sudo usermod -aG docker user_name

# 設定反映（再ログインまたはnewgrp）
$ newgrp docker

# 確認
$ docker info | grep -i server
Server Version: 26.1.4

# Dockerデーモンの状態を確認する
$ sudo systemctl status docker

# 停止していれば起動する
$ sudo systemctl start docker

$ mkdir ~/wordpress-compose && cd ~/wordpress-compose

services:
  db:
    image: mysql:8.0
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: rootpassword
      MYSQL_DATABASE: wordpress
      MYSQL_USER: wpuser
      MYSQL_PASSWORD: wppassword
    volumes:
      - db_data:/var/lib/mysql
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-u", "root", "-prootpassword"]
      interval: 10s
      timeout: 5s
      retries: 5

  wordpress:
    image: wordpress:6.5-php8.3-apache
    restart: always
    depends_on:
      db:
        condition: service_healthy
    ports:
      - "8080:80"
    environment:
      WORDPRESS_DB_HOST: db:3306
      WORDPRESS_DB_USER: wpuser
      WORDPRESS_DB_PASSWORD: wppassword
      WORDPRESS_DB_NAME: wordpress
    volumes:
      - wp_data:/var/www/html

volumes:
  db_data:
  wp_data:

# .envファイルを作成
$ cat > .env << 'EOF'
MYSQL_ROOT_PASSWORD=rootpassword
MYSQL_DATABASE=wordpress
MYSQL_USER=wpuser
MYSQL_PASSWORD=wppassword
EOF

# .gitignoreに追加してGitに含めない（本番パスワードの流出防止）
$ echo ".env" > .gitignore

# docker-compose.yml の db セクション（抜粋）
  db:
    environment:
      MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}
      MYSQL_DATABASE: ${MYSQL_DATABASE}
      MYSQL_USER: ${MYSQL_USER}
      MYSQL_PASSWORD: ${MYSQL_PASSWORD}

# wordpress セクション（抜粋）
  wordpress:
    environment:
      WORDPRESS_DB_USER: ${MYSQL_USER}
      WORDPRESS_DB_PASSWORD: ${MYSQL_PASSWORD}
      WORDPRESS_DB_NAME: ${MYSQL_DATABASE}

# バックグラウンドで起動（-d = detachedモード）
$ docker compose up -d

# 実際の出力例
[+] Running 4/4
 ✔ Network wordpress-compose_default    Created   0.1s
 ✔ Volume "wordpress-compose_db_data"  Created   0.0s
 ✔ Volume "wordpress-compose_wp_data"  Created   0.0s
 ✔ Container wordpress-compose-db-1    Started   0.4s
 ✔ Container wordpress-compose-wp-1    Started   0.8s

$ docker compose ps

NAME                       IMAGE                          STATUS      PORTS
wordpress-compose-db-1     mysql:8.0                      Up          3306/tcp, 33060/tcp
wordpress-compose-wp-1     wordpress:6.5-php8.3-apache   Up          0.0.0.0:8080->80/tcp

# 実行後にコンテナを自動削除する（推奨パターン）
$ docker compose run --rm web python manage.py migrate
Operations to perform:
  Apply all migrations: admin, auth, contenttypes, sessions
Running migrations:
  Applying contenttypes.0001_initial... OK
  Applying auth.0001_initial... OK

# --rmなしで実行するとコンテナが停止状態で残り続ける（NG）
$ docker ps -a
CONTAINER ID   IMAGE     COMMAND              STATUS                     NAMES
d4a9e7f1c3b8   app-web   "python manage.py"   Exited (0) 7 seconds ago   app-web-run-1

# CIやシェルスクリプトから呼び出す場合（-Tを付ける）
$ docker compose run --rm -T web pytest tests/ | tee test-results.txt

# Laravelのマイグレーションをデプロイスクリプトに組み込む例
$ docker compose run --rm -T app php artisan migrate --force

# DjangoのDBマイグレーション（Ubuntu 24.04 LTS + Docker Compose v2.27 での実測）
$ docker compose run --rm -T web python manage.py migrate
[+] Running 1/1
 ✔ Container myapp-db-1  Healthy
Operations to perform:
  Apply all migrations: admin, auth, contenttypes, myapp, sessions
Running migrations:
  Applying myapp.0001_initial... OK
  Applying myapp.0002_add_user_profile... OK

# テスト実行（終了コード1=失敗をCIがそのまま受け取れる）
$ docker compose run --rm -T web pytest tests/ -v
...
4 failed, 43 passed in 12.38s
$ echo $?
1

# 稼働中のwebコンテナには影響を与えずに新しいシェルを開く
$ docker compose run --rm web bash
root@7f3c4a1b2d9e:/app# python manage.py shell
Python 3.12.3
>>> from myapp.models import User
>>> User.objects.count()
1523
>>> exit()
root@7f3c4a1b2d9e:/app# exit
# --rmでコンテナは自動削除される

# wordpressサービスを3台で起動する
$ docker compose up --scale wordpress=3 -d

# 実行中のコンテナを確認する（ポートを "80" に変更済みの場合）
$ docker compose ps
NAME                           SERVICE     STATUS      PORTS
wordpress-compose-db-1         db          Up (healthy)  3306/tcp
wordpress-compose-wordpress-1  wordpress   Up          0.0.0.0:49153->80/tcp
wordpress-compose-wordpress-2  wordpress   Up          0.0.0.0:49154->80/tcp
wordpress-compose-wordpress-3  wordpress   Up          0.0.0.0:49155->80/tcp

# NG：ホストポートを固定するとスケール不可（2台目でエラー）
ports:
  - "8080:80"

# OK：コンテナポートのみ公開（ホスト側はDockerがランダムに割り当てる）
ports:
  - "80"

# 3台から1台に縮小する（wordpress-2・wordpress-3が自動削除）
$ docker compose up --scale wordpress=1 -d

# docker-compose.yml（wordpressサービスの抜粋）
  wordpress:
    image: wordpress:6.5-php8.3-apache
    deploy:
      replicas: 3     # --scale指定なしでも3台起動する

# --scale不要。定義通り3台が起動する
$ docker compose up -d
[+] Running 4/4
 ✔ Container wordpress-compose-db-1          Started
 ✔ Container wordpress-compose-wordpress-1   Started
 ✔ Container wordpress-compose-wordpress-2   Started
 ✔ Container wordpress-compose-wordpress-3   Started

# docker-compose.yml（WordPress環境にprofiles設定を追加）
services:
  db:
    image: mysql:8.0
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}
      MYSQL_DATABASE: ${MYSQL_DATABASE}
      MYSQL_USER: ${MYSQL_USER}
      MYSQL_PASSWORD: ${MYSQL_PASSWORD}
    volumes:
      - db_data:/var/lib/mysql
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-u", "root", "-p${MYSQL_ROOT_PASSWORD}"]
      interval: 10s
      timeout: 5s
      retries: 5

  wordpress:
    image: wordpress:6.5-php8.3-apache
    restart: always
    depends_on:
      db:
        condition: service_healthy
    ports:
      - "8080:80"
    environment:
      WORDPRESS_DB_HOST: db:3306
      WORDPRESS_DB_USER: ${MYSQL_USER}
      WORDPRESS_DB_PASSWORD: ${MYSQL_PASSWORD}
      WORDPRESS_DB_NAME: ${MYSQL_DATABASE}
    volumes:
      - wp_data:/var/www/html

  # 開発専用：phpMyAdmin（本番には絶対に公開しない）
  phpmyadmin:
    image: phpmyadmin:latest
    profiles:
      - dev
    ports:
      - "8081:80"
    environment:
      PMA_HOST: db
    depends_on:
      - db

volumes:
  db_data:
  wp_data:

# 開発環境（WordPress・MySQL・phpMyAdminを起動）
$ docker compose --profile dev up -d
[+] Running 4/4
 ✔ Network wordpress-compose_default          Created
 ✔ Container wordpress-compose-db-1           Started
 ✔ Container wordpress-compose-wp-1           Started
 ✔ Container wordpress-compose-phpmyadmin-1   Started

# 本番相当（WordPress・MySQLのみ起動。phpMyAdminは除外）
$ docker compose up -d
[+] Running 3/3
 ✔ Container wordpress-compose-db-1   Started
 ✔ Container wordpress-compose-wp-1   Started

# 開発環境の .env（Gitにコミットしない）
COMPOSE_PROFILES=dev
MYSQL_ROOT_PASSWORD=rootpassword
MYSQL_DATABASE=wordpress
MYSQL_USER=wpuser
MYSQL_PASSWORD=wppassword

# --profileフラグなしでも .env の COMPOSE_PROFILES が適用される
$ docker compose up -d
[+] Running 4/4
 ✔ Container wordpress-compose-db-1           Started
 ✔ Container wordpress-compose-wp-1           Started
 ✔ Container wordpress-compose-phpmyadmin-1   Started

$ docker compose version
Docker Compose version v2.27.1

services:
  db:
    image: mysql:8.0
    # ... (前述のdb設定と同じ)

  wordpress:
    image: wordpress:6.5-php8.3-apache
    restart: always
    depends_on:
      db:
        condition: service_healthy
    ports:
      - "8080:80"
    environment:
      WORDPRESS_DB_HOST: db:3306
      WORDPRESS_DB_USER: wpuser
      WORDPRESS_DB_PASSWORD: wppassword
      WORDPRESS_DB_NAME: wordpress
    volumes:
      - wp_data:/var/www/html
    develop:
      watch:
        - action: sync
          path: ./themes/my-theme
          target: /var/www/html/wp-content/themes/my-theme
          ignore:
            - "*.log"

volumes:
  db_data:
  wp_data:

# コンテナをバックグラウンドで起動
$ docker compose up -d

# watchを開始（フォアグラウンド動作。Ctrl+Cで停止）
$ docker compose watch
Watch enabled
Watching...

# themes/my-theme/style.css を保存するとsyncが自動実行される
syncing service "wordpress" after changes were detected

# compose.yml（Node.js + nodemon）
services:
  api:
    build:
      context: .
      target: development
    ports:
      - "3000:3000"
    develop:
      watch:
        - path: ./src
          action: sync
          target: /app/src
          ignore:
            - node_modules
        - path: package.json
          action: rebuild
        - path: .env
          action: sync+restart
          target: /app/.env

# Dockerfile（マルチステージ・開発と本番を分離）
FROM node:20-slim AS base
WORKDIR /app
COPY package*.json ./
RUN npm ci

FROM base AS development
RUN npm install -g nodemon
COPY src/ ./src/
CMD ["nodemon", "src/app.js"]

FROM base AS production
RUN npm ci --only=production
COPY src/ ./src/
CMD ["node", "src/app.js"]

# compose.yml（FastAPI + uvicorn --reload）
services:
  api:
    build: .
    ports:
      - "8000:8000"
    develop:
      watch:
        - path: ./app
          action: sync
          target: /app/app
          ignore:
            - __pycache__
            - "*.pyc"
        - path: requirements.txt
          action: rebuild

[tomohiro@dev01 ~/fastapi-app]$ docker compose up --watch
[+] Running 1/1
 ✔ Container fastapi-app-api-1  Started
Watch enabled
 - watch path ./app target /app/app action sync
 - watch path requirements.txt action rebuild
# ./app/main.pyを編集して保存したときの出力
Syncing "app/main.py" after change
INFO:     Reloading...
INFO:     Application startup complete.

# 使用中のポートを確認
$ ss -tlnp | grep 8080

# 別のポートに変更する（例: 8081）
# docker-compose.yml の ports セクションを変更
ports:
  - "8081:80"

# ログでMySQLの初期化状況を確認
$ docker compose logs db | tail -20

# 「ready for connections」が表示されるまで待ってからWordPressにアクセスする
2024-06-26T10:23:45.123456Z 1 [System] [MY-011011] [Server] ready for connections. Version: '8.0.37'

# yamlの構文チェック（エラーがなければ展開済みの設定が出力される）
$ docker compose config

name: wordpress-compose
services:
  db:
    ...

# 自分のユーザーをdockerグループに追加
$ sudo usermod -aG docker $USER

# 再ログインまたはグループを即時反映
$ newgrp docker

# 確認
$ groups | grep docker
user_name docker

Cannot connect to the Docker daemon at unix:///var/run/docker.sock.
Is the docker daemon running?

# デーモンの状態を確認する
$ sudo systemctl status docker

# 停止していれば起動する
$ sudo systemctl start docker

# 自動起動が無効になっていれば有効化する
$ sudo systemctl enable docker

# Ubuntu 24.04でのアップデート
$ sudo apt-get update && sudo apt-get install docker-compose-plugin

# Rocky Linux 9でのアップデート
$ sudo dnf update docker-compose-plugin

# バージョン確認
$ docker compose version
Docker Compose version v2.27.1

# NG: ホストの絶対パスを指定している
- path: /home/tomohiro/myapp/src

# OK: compose.ymlからの相対パスで指定する
- path: ./src

# compose.yml があるディレクトリで存在確認
$ ls -la ./themes/my-theme/
total 28
drwxr-xr-x 2 user user 4096 Jul 24 10:00 .
drwxr-xr-x 5 user user 4096 Jul 24 09:00 ..
-rw-r--r-- 1 user user  512 Jul 24 10:00 style.css

# NG：ホストポートを固定するとスケール不可（2台目でエラー）
ports:
  - "8080:80"

# OK：コンテナポートのみ公開（ホスト側はDockerが自動割当）
ports:
  - "80"

# NG: CIでパイプに渡す際にTTYエラーが出る
$ docker compose run --rm app pytest tests/ | tee results.txt
the input device is not a TTY

# OK: -T を付けて非対話モードで実行する
$ docker compose run --rm -T app pytest tests/ | tee results.txt

# 停止済みコンテナを確認する
$ docker ps -a --filter "status=exited"
CONTAINER ID   IMAGE     COMMAND               STATUS
d4a9e7f1...   app-web   "python manage.py"   Exited (0) 2 hours ago   app-web-run-1
a1b2c3d4...   app-web   "pytest tests/"       Exited (0) 1 hour ago    app-web-run-2

# 停止済みコンテナをまとめて削除する
$ docker container prune
WARNING! This will remove all stopped containers.
Are you sure you want to continue? [y/N] y
Total reclaimed space: 128MB

# 今後は --rm を付ける
$ docker compose run --rm web python manage.py migrate

# 症状: phpmyadminが起動しない
$ docker compose up -d
$ docker compose ps
# phpmyadmin が一覧に表示されない

# 設定の展開結果を確認（インデントミスの検出に有効）
$ docker compose --profile dev config

# profilesサービスも含めて全コンテナを削除する場合
$ docker compose --profile dev down