困ったとき
デプロイとトラブルシューティング
静的生成したガイドサイトを安全に公開し、起動時のよくあるエラーを切り分けます。
コンテナの状態を確認する
docker compose ps
docker compose logs -f
公開用ファイルを作る
エックスサーバーへはNuxtの静的生成結果を配置します。公開URLを指定してから生成してください。
NUXT_PUBLIC_SITE_URL=https://headless-wp.cakizaki.com npm run generate
生成結果は .output/public/ に作られます。この中には各ガイドページのHTML、robots.txt、sitemap.xml、OGP画像が含まれます。
Nuxtに接続エラーが出る
WordPressの初期設定が完了しているか確認し、http://localhost:8080/wp-json でJSONが表示されるか確認します。
docker compose restart nuxt
データを守る
docker compose down -v はMySQLの保存領域も削除します。原因が分からない段階では実行しないでください。ZIPを別名のフォルダへ展開した場合は、Dockerが別プロジェクトとして扱い、投稿が消えたように見えることがあります。