Skip to content

Latest commit

 

History

History
24 lines (14 loc) · 449 Bytes

File metadata and controls

24 lines (14 loc) · 449 Bytes

ADR-003: Image by Digest vs Tag

Status: Accepted

Date: 2026-01-25

Context

How to reference container images in manifests.

Decision

Use digest as primary reference; tag only for readability.

Rationale

  • Digest is immutable (reproducibility guarantee)
  • Tags can be overwritten (drift risk)
  • GitOps requires determinism

Consequences

  • Pipeline must extract and persist digest
  • Rollback is always to a specific digest