Zenn
🐳

docker composeでWordPressを1分立ち上げる。コピペでできます。

2024/04/30に公開
Docker
MySQL
PHP
WordPress
tech

概要

  • クイックにWordpressを動かせる環境が欲しかったのでdocker composeで立ち上げられるようにしました。
  • 本番運用にも使えるように、動的に追加されるデータはファイルシステム上に保管されて永続化されるようにしました。
  • 良い感じのサンプルが見つからなかったので作成しました。

成果物

以下に置きました。forkして使うのが良いと思います。

https://github.com/matsubo/wordpress-docker-template

説明

docker composeの設定を作るときにこだわったポイントは以下です。

  • 動的に生成されるMySQLのデータや、WordPressでアップロードしたメディアやプラグイン、テーマはファイルシステム上に保存されます。
  • 必要最低限のパーミッションなので万が一クラックされても汚染されるスコープが狭い。
  • WordPress本体のバージョンの更新はイメージで行い、プラグインやテーマの更新はWeb上から動的に行えます。

以下に docker-compose.yml をペーストしておきます。

services:
  mysql:
    user: "${UID:-1000}:${GID:-1000}"
    image: mysql:latest
    restart: always
    volumes:
      - ./mysql/data:/var/lib/mysql
      - ./mysql/conf/custom.cnf:/etc/mysql/conf.d/custom.cnf
    environment:
      MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}
      MYSQL_DATABASE: ${MYSQL_DATABASE:-wordpress}
      MYSQL_USER: ${MYSQL_USER:-root}
      MYSQL_PASSWORD: ${MYSQL_PASSWORD}

  wordpress:
    image: wordpress:latest
    user: "${UID:-1000}:${GID:-1000}"
    restart: always
    volumes:
      - ./wordpress/themes:/var/www/html/wp-content/themes
      - ./wordpress/plugins:/var/www/html/wp-content/plugins
      - ./wordpress/uploads:/var/www/html/wp-content/uploads
    links:
      - mysql
    depends_on:
      - mysql
    ports:
      - "${EXPOSE_PORT:-8080}:80"
    environment:
      WORDPRESS_DB_HOST: mysql
      WORDPRESS_DB_NAME: ${MYSQL_DATABASE:-wordpress}
      WORDPRESS_DB_USER: ${MYSQL_USER:-root}
      WORDPRESS_DB_PASSWORD: ${MYSQL_PASSWORD}

セットアップ

テンプレとなるレポジトリをcloneしてきます。

% git clone git@github.com:matsubo/wordpress-docker-template.git
% cd  wordpress-docker-template

以下のコマンドを打って動作に必要な環境変数を一通り自動で作成します。

echo -n > .env
echo "MYSQL_DATABASE=wordpress" >> .env
echo "MYSQL_USER=wordpress" >> .env
echo "MYSQL_ROOT_PASSWORD=$(tr -dc A-Za-z0-9 </dev/urandom | head -c 15)" >> .env
echo "MYSQL_PASSWORD=$(tr -dc A-Za-z0-9 </dev/urandom | head -c 15)" >> .env
echo "EXPOSE_PORT=8080" >> .env
echo "UID=$(id -u)" >> .env
echo "GID=$(id -g)" >> .env

そのあと、docker compose up すれば初期設定が行われて、サーバ環境が立ち上がります。

% docker compose up

その後はブラウザで表示すれば以下のページが見られるので初期設定を進めればOKです。

alt text

ユースケース

このテンプレートの良いところは既存のオンプレで運用しているWordpressから簡単に移行できることと、ホストOS側でバックアップが取りやすいというところです。

以下に運用時に想定される様々なユースケースに対するコマンド実行例を記載しておきます。

既存のWordPressからDockerに移行する方法

% cp -ra /old/wordpress/wp-content/{plugins,themes,uploads} wordpress/
% mysqldump -u ${OLD_MYSQL_USER} --password=${OLD_MYSQL_PASSWORD} ${OLD_MYSQL_DB_NAME} | bzip2 > dump.sql.bz2
% docker compose cp dump.sql.bz2 mysql:/dump.sql.bz2
% docker compose exec mysql bash -c 'bzcat /dump.sql.bz2 | mysql -u $MYSQL_USER -p$MYSQL_PASSWORD $MYSQL_DATABASE'
% docker compose exec mysql bash rm /dump.sql.bz2

新しいWordPressサイトを立ち上げる方法

mysqlコンテナをWordPressごとに立ち上げるとメモリを消費してしまうので、mysqlを1つ立ち上げて複数のWordPressサイトから接続して使うほうが効率的です。

そのためには、WordpPressのコンテナの定義をコピペして一部ハードコードして使うのが良いと思います。

例えば、以下のような行を追加します。

  new_wordpress:
    image: wordpress:latest
    user: "${UID:-1000}:${GID:-1000}"
    restart: always
    volumes:
      - ./new_wordpress/themes:/var/www/html/wp-content/themes
      - ./new_wordpress/plugins:/var/www/html/wp-content/plugins
      - ./new_wordpress/uploads:/var/www/html/wp-content/uploads
    links:
      - mysql
    depends_on:
      - mysql
    ports:
      - "8081:80"
    environment:
      WORDPRESS_DB_HOST: mysql
      WORDPRESS_DB_NAME: ${MYSQL_DATABASE:-wordpress}
      WORDPRESS_DB_USER: ${MYSQL_USER:-root}
      WORDPRESS_DB_PASSWORD: ${MYSQL_ROOT_PASSWORD}

WordPressのバージョン更新

% docker pull wordpress:latest
% docker compose down && docker compose up -d

削除

環境を潰して、元どうりにする場合の方法

% docker compose down
% rm -rf mysql/data/*
% rm -rf wordpress/*/*

フルバックアップ

一時停止するけど簡単な方法。

% docker compose down
% tar jcf /path/to/backup.tar.bz2 .

古バックアップからのリストア

% tar xf /path/to/backup.tar.bz2

まとめ

  • WordPressを簡単に立ち上げられるテンプレを用意しました。
  • MySQLが起動直後でも200MBぐらい消費するので要注意です。128MBに制限したらメモリ不足で立ち上がりませんでした。
  • 細かいところにこだわった良い感じの設定です。

Discussion