# Deployment versioning

StellaOps uses environment-specific version tags and promotion steps to keep
deployments reproducible and auditable.

Version tags
- Release tags follow semver (X.Y.Z).
- Environment variants add suffixes (for example, airgap).
- Immutable deployments use digests instead of tags.

Promotion model
- Dev to staging: unit and integration tests are green.
- Staging to prod: end-to-end, security, and performance gates pass.
- Prod to airgap: offline validation and bundle verification complete.

Naming conventions
- registry/<service>:<version>
- registry/<service>:<version>-<variant>
- registry/<service>@sha256:<digest>

Operational guidance
- Keep version matrices in sync with release bundles.
- Use pinned digests for air-gapped imports.
- Record promotion metadata with evidence bundles.

Related references
- docs/deployment/VERSION_MATRIX.md
- docs/13_RELEASE_ENGINEERING_PLAYBOOK.md