Artifact Immutability and Promotion
On this page
Artifact Immutability & Promotion
- Build once, promote everywhere: same digest moves across envs.
- Tags are pointers; digests are identity.
- Immutability reduces drift and rollback ambiguity.
Promotion Model
- CI produces artifact digest.
- Staging deploy uses digest.
- After verification, promote digest to prod.
- Rollback is selecting a previous known-good digest.
Ops Commands
# See current rollout images (digest or tag)
kubectl -n app get deploy api -o jsonpath='{$.spec.template.spec.containers[*].image}'
# Rollback to previous revision
kubectl -n app rollout undo deploy/api
Failure Modes
- Rebuilding the “same” version: digest differs, behavior differs.
- Mutable tags in prod: investigation becomes guesswork.