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

この記事のポイント

・docker compose up -d 1コマンドでWordPress＋MySQLを同時起動できる
・docker-compose.ymlでサービス間の依存・ネットワーク・ボリュームを一元管理する
・コンテナが起動しない時はdocker compose logsで原因を即座に特定できる
・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

# 使用中のポートを確認
$ 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