The Twelve-Factor App
Official docs outline
12 sections- I. Codebase
One codebase tracked in revision control, many deploys.
- II. Dependencies
Explicitly declare and isolate dependencies.
- III. Config
Store config in the environment.
- IV. Backing services
Treat backing services as attached resources.
- V. Build, release, run
Strictly separate build and run stages.
- VI. Processes
Execute the app as stateless processes.
- VII. Port binding
Export services via port binding.
- VIII. Concurrency
Scale out via the process model.
- IX. Disposability
Fast startup and graceful shutdown.
- X. Dev/prod parity
Keep development, staging and production similar.
- XI. Logs
Treat logs as event streams.
- XII. Admin processes
Run admin tasks as one-off processes.
Each section links to the official page. Titles and summaries by Extra Credit; the docs belong to their authors.
More in Observability and operations
All 18- OCI Distribution Specification
- OCI Image Format Specification
- OCI Runtime Specification
- OpenMetrics Specification
- OpenTelemetry Protocol (OTLP)
- OpenTelemetry Semantic Conventions
- OpenTelemetry Specification
- Prometheus Exposition Format
- SLSA Specification
- Syslog Protocol (RFC 5424)
- W3C Baggage
- W3C Trace Context