Production Checklist
Use this checklist before production deployment.
Build and Configuration
- Run
forj build. - Confirm
.goforj.ymlmatches intended components. - Confirm
*_SUPPORTED_DRIVERSincludes all runtime drivers. - Confirm secrets are provided by the deployment environment.
- Confirm
APP_ENVandAPP_DEBUGare production-safe.
Runtime Topology
- Choose standalone or split runtime processes.
- Run HTTP, workers, and scheduler through explicit commands.
- Ensure scheduler singleton or locking behavior is correct.
- Set shutdown timeouts deliberately.
Data
- Run migrations intentionally.
- Verify database readiness.
- Confirm cache is not source-of-truth storage.
- Confirm storage disks and object storage permissions.
- Verify
forj buildhas refreshed generated named resources.
Observability
- Verify health and readiness endpoints.
- Configure
APP_DIAG_TOKEN. - Verify metrics scrape targets.
- Confirm high-cardinality labels are not introduced.
- Confirm logs are high-signal and secrets are not logged.
- Enable Lighthouse only where appropriate.
Async
- Confirm job handlers are registered.
- Confirm workers use the intended queue driver.
- Confirm retry and idempotency behavior.
- Confirm queue shutdown timeout.
- Confirm event drivers match process topology.
Final Check
- Run smoke tests.
- Inspect
route:list. - Validate one health check.
- Validate one readiness check.
- Validate metrics output.
- Validate expected runtime processes start and stop cleanly.
