Cloud Run Backend
Deploy FastAPI backend from the fastapi/ folder to Google Cloud Run.
Steps
- Build/deploy service from
fastapi/ - Apply backend env variables
- Ensure service is reachable from frontend and worker
- Verify health endpoint
Health check:
GET /health
Expected response:
{"status":"ok"}
Common errors
| Error | Cause | Fix |
|---|---|---|
| 500 on startup | Invalid env config | Validate all required backend env vars |
| 401 webhook/auth issues | Clerk secret mismatch | Align backend Clerk secrets |
| Worker proxy errors | Wrong Cloud Run URL in worker env | Update worker CLOUD_RUN_URL |
