実行環境とデプロイの単位
「ローカルで動くものが、本番ではどこで動くか」を確認する資料です。 初参加時は開発環境を動かすを使ってください。 本番へ反映する作業では、この配置図に加えて末尾の運用手順を確認します。
ローカル Docker Compose
migrate が完了してから API と worker が起動します。web-dev profile は
Vite HMR を追加しますが、API・DB・queue の構成は変わりません。
本番
デプロイ単位
| 対象 | 方法 |
|---|---|
| frontend | Cloudflare Workers Static Assets + GitHub Actions CD |
| API | cd apps/api && npm run deploy |
| DB | DATABASE_URL=... npm run db:migrate |
| worker | container image を ECR へ push し Lambda image を更新 |
| Cloudflare binding | Wrangler (wrangler.jsonc) |
| Hyperdrive cache / R2 CORS | 手動承認付き cloudflare-resources.yml |
| AWS worker infrastructure | Terraform |
| ドキュメント | 関連する変更がmainへ入り、CIが成功すると、GitHub Actions CDが両言語をCloudflare Worker videoq-docsへ公開 |
上のコマンドは各作業の入口です。本番のAPI・worker・DBは .github/workflows/cd.yml の手順と順序も確認します。
新しい列を使うコードを先に公開すると、古いDBに対して動かなくなる場合があります。
詳細は infra/DEPLOY.md を参照してください。
文書サイトは専用のWorkerから docs.videoq.jp で公開し、日本語は /ja/ です。本文・翻訳・サイト設定の変更は、mainのCI成功後に自動公開します。npm run deploy:docsで現在の作業ツリーを手動公開することもできます。文書サイトのデプロイ手順を参照してください。