使用技術一覧

プロジェクトの詳細と環境構築の手順については こちら をご参照ください：

目次

1. 環境
2. ディレクトリ構成
3. 開発環境構築
4. デプロイ
5. トラブルシューティング
6. 参考資料

環境

ディレクトリ構成

❯ tree -a -I "node_modules|.next|.git|.pytest_cache|static" -L 2

.
├── .cz-config.cjs
├── .env.example
├── .gitignore
├── .husky
├── Makefile
├── README.md
├── build
├── docker
│   ├── app
│   ├── browsersync
│   └── mysql
├── docker-compose.init.yml
├── docker-compose.yml
├── package.json
├── pnpm-lock.yaml
├── scripts
├── src
└── wordpress

環境構築手順

1. 環境変数の設定

env.exampleを基に.envファイルを作成します。

# -------------------------------------------
# Wordpress
# -------------------------------------------
WP_VERSION=

# -------------------------------------------
# Mysql
# -------------------------------------------
MYSQL_DATABASE=
MYSQL_USER=
MYSQL_PASSWORD=
MYSQL_ROOT_PASSWORD=
MYSQL_HOST=

2. 初期セットアップ

初めて環境を構築する場合は、以下の手順を実行します。

make init

http://localhost にアクセスし、WordPress の初期設定を行います。完了後、コンテナを停止します。

make down

3. 既存プロジェクトの移行

srcフォルダに既存の WordPress 関連ファイルを配置します。 データベースを本番環境と同期させる場合は、ダンプファイルをdocker/mysql/initdbに配置します。

make prepare

再びコンテナを起動します。

make down

4. デプロイについて

手動デプロイ

手動でデプロイを行う場合の手順です。

1. スクリプトを実行し、buildフォルダにデプロイ情報を生成します。

   sh export_all.sh
   

2. WordPress のみデプロイする場合は、scripts/export_src.shを実行します。

   sh export_src.sh
   

3. データベースのみデプロイする場合は、scripts/export_db.shを実行します。

   sh export_db.sh
   

自動デプロイ

自動でデプロイを行う場合の手順です。

A. ブランチの変更

1. コードのプッシュ
   • メインブランチに変更をプッシュすると、自動的にデプロイプロセスが開始されます。
   • 具体的には、GitHub Actions がトリガーされ、デプロイ用のスクリプトが実行されます。
2. GitHub Actions の確認
   • GitHub リポジトリの Actions タブをクリックして、デプロイジョブの進行状況を確認できます。
   • ジョブが正常に完了すると、変更がデプロイ先のサーバーに反映されます。
3. デプロイの確認
   • デプロイが成功したかどうかを確認するためには、デプロイ先の Web サイトにアクセスし、変更内容が反映されているか確認してください。
4. main ブランチが更新されると自動でデプロイされます。

B. Github から実行

1. GitHub リポジトリにアクセス
   • GitHub リポジトリの Actions タブにアクセスします。
2. 手動でワークフローをトリガー
   • 左側のメニューから手動でトリガーしたいワークフローを選択します。
   • ページ右上の Run workflow ボタンをクリックします。
3. デプロイの確認
   • ワークフローの実行が開始されるので、進行状況を確認します。
   • ジョブが正常に完了すると、変更がデプロイ先のサーバーに反映されます。
   • デプロイが成功したかどうかを確認するためには、デプロイ先の Web サイトにアクセスし、変更内容が反映されているか確認してください。

デプロイ後

[!WARNING] デプロイ先のフォルダパス (FTP_SERVER_DIR) に書き間違えがないように注意してください。不正確なパスはデプロイの失敗や、予期しないディレクトリへのデプロイを引き起こす可能性があります。

デプロイの確認

デプロイが成功したかどうかを確認するためには、デプロイ先の Web サイトにアクセスし、変更内容が反映されているか確認してください。

プロジェクトの概要

コマンド一覧

デプロイ

このプロジェクトのデプロイは GitHub Actions を利用して自動化されています。以下の手順に従ってデプロイを行います。

デプロイに必要な情報は GitHub リポジトリのシークレットに定義されています。以下のシークレットが設定されていることを確認してください：

トラブルシューティング

ビルドエラー

.htaccess にコピペ

# BEGIN WordPress
# The directives (lines) between "BEGIN WordPress" and "END WordPress" are
# dynamically generated, and should only be modified via WordPress filters.
# Any changes to the directives between these markers will be overwritten.
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
RewriteBase /
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
</IfModule>

# END WordPress

Xdebug のログファイルの設定エラー

1. php.iniの編集

php.iniファイルに以下の設定を追加します：

zend_extension=xdebug.so
xdebug.mode=debug
xdebug.start_with_request=yes
xdebug.client_host=host.docker.internal
xdebug.client_port=9004
xdebug.log=/var/log/xdebug.log

2. ログファイルディレクトリの作成と権限設定

コンテナ内で以下のコマンドを実行します：

docker-compose exec app bash
mkdir -p /var/log
touch /var/log/xdebug.log
chmod 777 /var/log/xdebug.log
exit

参考資料

Wordpress の Docker 環境作成 (PHP8, apache, MariaDB, Xdebug)