-
Notifications
You must be signed in to change notification settings - Fork 7
Troubleshooting
hieuck edited this page Jul 5, 2026
·
1 revision
| Symptom | Likely cause | Quick fix |
|---|---|---|
| Docker container exits with JWT errors | Missing JWT_SECRET / API_KEY_HMAC_SECRET
|
apps/api/docker-entrypoint.sh now auto-generates random secrets if absent |
| Dashboard shows stale data / API unreachable | Browser calling absolute API_BASE_URL
|
Web API calls now proxy through /api-gateway and /uploads via Next.js rewrites |
| Product images broken in production | Cross-origin /uploads path |
resolveProductImageUrl() keeps paths relative; use /uploads/* rewrite |
| Node.js deprecation warnings in Actions | Old action versions | Upgraded to actions/checkout@v6, actions/setup-node@v6, actions/cache@v5, pnpm/action-setup@v6
|
| Version mismatch across services | Hardcoded versions | Run node scripts/audit-version-ssot.js
|
Detailed runbooks live in docs/runbooks/, including:
incident-runbook.mdrelease-playbook.mdrollback-playbook.mdsupport-triage-sop.mdtroubleshooting-matrix.md