【Docker】WordPressローカル環境構築を徹底解説

2024-07-22

Dockerを使ってWordPress環境を構築することは、開発や運用を効率化する強力な手段です。

しかし、単に環境を構築するだけではなく、継続的なメンテナンスが成功のカギを握っています。セキュリティを確保し、サイトのパフォーマンスを最適化するためには、どのようにメンテナンスを行うべきか理解することが重要です。

この記事では、Dockerを使ったWordPress環境構築のポイントと、継続的なメンテナンスの重要性について詳しく解説します。

DockerとWordPressの基礎知識

Dockerとは？

Dockerは、アプリケーションをコンテナという軽量な仮想化環境で実行するためのオープンプラットフォームです。Dockerを使用すると、開発者はアプリケーションとその依存関係を一つのパッケージとしてまとめ、どの環境でも一貫して実行できるようにします。

コンテナは、OSレベルの仮想化を利用して、アプリケーションとその依存関係を隔離します。これにより、複数のコンテナが同じホストOS上で動作しながらも、互いに独立した環境を維持できます。

Dockerの主なメリットは、環境の一貫性、迅速なデプロイメント、スケーラビリティです。開発環境と本番環境で同じコンテナを使用することで、「私のマシンでは動いたのに」という問題を回避できます。また、コンテナの軽量性により、アプリケーションの迅速な起動と停止が可能です。

WordPressとは？

WordPressは、世界で最も人気のあるオープンソースのコンテンツ管理システム（CMS）です。ブログやウェブサイトの作成と管理を簡単に行えるように設計されています。

WordPressの主な特徴は、使いやすさ、拡張性、カスタマイズ性です。テーマやプラグインを使用して、ウェブサイトの外観や機能を簡単に変更できます。ブログ、企業サイト、オンラインショップなど、さまざまな用途に対応しています。

WordPressは、投稿とページの作成、メディアの管理、ユーザー管理、SEOの最適化など、多くの機能を標準で提供します。これにより、初心者から上級者まで、誰でも簡単にプロフェッショナルなウェブサイトを構築できます

Dockerを使ったWordPress環境の構築手順

STEP

Dockerのインストール

Dockerのインストールは、公式サイトから簡単にダウンロードして行えます。WindowsとMac OSそれぞれに対応したインストーラーが提供されています。

詳細の手順は、下記記事で解説してますのでご使用のパソコン似合った記事ご確認ください。

Docker Composeの設定

Docker Composeは、マルチコンテナのDockerアプリケーションを定義し、実行するためのツールです。docker-compose.ymlファイルを使用して、サービス・ネットワーク・ボリュームの設定などのアプリケーションのサービス構成を定義することで、複数のコンテナを一括して管理できます。

docker-compose.ymlファイルの作成方法

テキストエディタを使用して、以下のようなdocker-compose.ymlファイルを作成します。

version: '3.8'

services:
  db:
    image: mysql:8.0
    volumes:
      - ./db_data:/var/lib/mysql  # MySQLのデータを永続化するためのボリューム
    restart: always  # コンテナが停止した場合に自動的に再起動
    environment:
      MYSQL_ROOT_PASSWORD: password  # MySQLのルートユーザーパスワード設定
      MYSQL_DATABASE: wordpress  # 作成するデータベース名
      MYSQL_USER: wordpress  # WordPress用のMySQLユーザー
      MYSQL_PASSWORD: wordpress  # 上記ユーザーのパスワード

  wordpress:
    image: wordpress:latest
    volumes:
      - ./wordpress_data:/var/www/html  # WordPressのデータを永続化するためのボリューム
    ports:
      - "8000:80"  # ホストのポート8000をコンテナのポート80にマッピング
    restart: always  # コンテナが停止した場合に自動的に再起動
    depends_on:
     - db
    environment:
      WORDPRESS_DB_HOST: db:3306  # MySQLデータベースのホストとポート
      WORDPRESS_DB_USER: wordpress  # MySQLデータベースのユーザー
      WORDPRESS_DB_PASSWORD: wordpress  # 上記ユーザーのパスワード
      WORDPRESS_DB_NAME: wordpress  # 使用するデータベース名

volumes:
  db_data:  # MySQLデータの永続化に使用するボリューム
  wordpress_data:  # WordPressデータの永続化に使用するボリューム

STEP

WordPressコンテナの起動

Docker Composeを使用して、作成したdocker-compose.ymlファイルからWordPressコンテナを起動します。

ターミナルまたはコマンドプロンプトで、docker-compose.ymlファイルがあるディレクトリに移動し、docker-compose up -dコマンドを実行します。これにより、バックグラウンドでコンテナが起動します。エラーが表示されず、以下のようになれば正常に稼働しています。

[+] Running 34/2
 ✔ wordpress 21 layers [⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿]      0B/0B      Pulled     13.1s 
 ✔ db 11 layers [⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿]      0B/0B      Pulled                      22.1s 
[+] Building 0.0s (0/0)                                    docker:desktop-linux
[+] Running 3/3
 ✔ Network startwordpress_default        Created                           0.0s 
 ✔ Container startwordpress-db-1         Started                           0.3s 
 ✔ Container startwordpress-wordpress-1  Started                           0.0s

起動時のエラートラブルシューティング

起動時にエラーが発生した場合、docker-compose logs コマンドを使用してログを確認し、問題を特定します。一般的なエラーとしては、ファイルパスの誤りや環境変数の設定ミスが考えられます。

具体例1: ファイルパスの誤り

問題: docker-compose.ymlファイルで定義したボリュームのパスが正しくないと、以下のようなエラーが表示されます。

ERROR: for db  Cannot start service db: Mounts denied: 
The path /invalid/path/to/db_data is not shared from OS X and is not known to Docker.

対処法: docker-compose.ymlファイルのパスを確認し、正しいパスを指定します。

volumes:
  - /correct/path/to/db_data:/var/lib/mysql

具体例2: 環境変数の設定ミス

問題: 環境変数が正しく設定されていないと、以下のようなエラーが表示されます。

ERROR: for wordpress  Cannot create container for service wordpress: Invalid environment variable: WORDPRESS_DB_USE

対処法: 不正な環境変数WORDPRESS_DB_USEが設定されているため、docker-compose.ymlファイルを確認し、正しい値を設定します。

environment:
  WORDPRESS_DB_HOST: db:3306
  WORDPRESS_DB_USER: wordpress
  WORDPRESS_DB_PASSWORD: wordpress
  WORDPRESS_DB_NAME: wordpress

具体例3: 命令セットアーキテクチャ（ISA）の不一致

問題:この問題はM1チップのMacを使用している場合に発生することがあります。M1チップのプラットフォームはarm64であるのに対し、mysqlのイメージのサポートプラットフォームがAMD64となっているためです。

no matching manifest for linux/arm64/v8 in the manifest list entries

// マニフェストリストのエントリにlinux/arm64/v8に一致するマニフェストがありません

対処法: 環境変数 docker-compose.yml ファイルにプラットフォームを指定する処理を追記します

services:
   db:
    platform: linux/x86_64 // この行を追加。
    image: mysql:8.0
(省略)

これらの具体例を参考に、ログを確認し、適切な対策を講じることで、起動時のエラーを解決できます。

STEP

ブラウザでのWordPressサイト確認

コンテナが正常に起動したら、ブラウザを開き、http://localhost:8000 にアクセスします。WordPressの初期セットアップ画面が表示されるはずです。画面に表示される指示に従ってのセットアップを完了することで、ローカル環境でWordPressの使用を開始することができます。