• #handover

引き継ぎメモ（Claude向け）

✅ 完了: GitHub Actions による Cloudflare Pages 自動デプロイ

背景

  • もともとローカルから wrangler pages deploy でDirect Uploadしていた
  • git push で自動デプロイしたかった
  • Cloudflare Pages の Git 統合を試したが、Workers 統合後の問題で「Hello world」しか表示されなかった
  • 結局 GitHub Actions + Direct Upload 方式に変更して成功

完了した作業

  1. ✅ deploy.yml にプロジェクト作成ステップを追加
    • wrangler pages project create を追加（|| true で既存時はスキップ）
  2. ✅ GitHub Secrets 設定
    • CLOUDFLARE_ACCOUNT_ID
    • CLOUDFLARE_API_TOKEN
  3. ✅ デプロイ成功
    • GitHub Actions でビルド & デプロイが正常動作
    • https://mdx-playground.pages.dev でサイト表示確認
  4. ✅ ドキュメント更新
    • CLAUDE.md - デプロイセクションを更新（GitHub Actions 推奨）
    • apps/web/README.md - デプロイセクションを更新（Git 統合は非推奨と明記）
    • 2025-12-07/cloudflare-github-actions-migration.md - 完了した作業を追記
    • 2025-12-07/handover-note.md - 解決済みに更新

現在の運用

# master ブランチにプッシュするだけで自動デプロイ
git push origin master

教訓

  • Cloudflare Pages の Git 統合は Workers 統合後に挙動が変わった
  • 静的サイトは GitHub Actions + Direct Upload 方式が確実
  • ローカルでの wrangler pages deploy と同じ方式を CI で使えばよかった

関連ファイル

  • .github/workflows/deploy.yml - GitHub Actions ワークフロー
  • apps/web/wrangler.toml - Cloudflare Pages 設定
  • apps/web/content/2025-12-07/cloudflare-github-actions-migration.md - 詳細な経緯