Skip to content

Artifact identity: what a digest does

A container tag is a name someone may move. An image digest identifies a particular manifest by its cryptographic hash. When a release selects repository@sha256:…, the reference says which artifact should be fetched even if other tags or objects change.

That property is valuable because a review, a scan, and a signature become ambiguous if they silently refer to different image bytes. A digest provides the recurring identifier that keeps those decisions connected. It does not say whether the identified bytes are secure.

Follow the same immutable identity
  • Build → D

    D is an illustrative manifest digest, not a captured deployment.

  • Statements about D

    Signature, SPDX SBOM and provenance bind to D.

  • Git selects D

    Helm values retain the complete immutable identity.

  • Pod requests D

    Policy evaluates that requested identity and its claims.

  • Build → D Statements about Dsame digest D
  • Statements about D Git selects Dreview selects D
  • Git selects D Pod requests Dreconciliation retains D
Illustrative identity D represents one digest; it is not a recorded deployment digest.
Text equivalent and limits
  1. The build output identifies an OCI manifest by digest D.
  2. The signature, SPDX SBOM and provenance bind claims to D; authenticity does not guarantee safety.
  3. Helm values reference D rather than a mutable tag.
  4. Admission checks the requested image D and the associated trust metadata.

Read the labeled relationships as the stated contract. Optional connections are dashed and explicitly labeled; comparisons do not imply a sequential handoff. This figure explains inspected code or recorded observations, not current cloud execution.

The build-push workflow receives the source revision as the tag and build argument. Docker’s build action returns a digest output. The final-image Trivy scan uses that output as repository@digest. The signing and verification workflows receive the same digest input, rather than rebuilding or resolving a tag themselves.

Cosign signs that digest. The SPDX SBOM and SLSA v0.2 provenance are attached as attestations whose subject includes the image digest. CI checks that the signature’s manifest digest equals its expected digest and that the decoded attestations contain the expected subject digest. It also verifies provenance source commit and material commit against github.sha.

GCP promotion is a separate edit to the Helm image.digest value. The Deployment template renders image.repository@image.digest. Argo CD reconciles that selected value. Kyverno’s policy specifies verifyDigest: true, required: true, and mutateDigest: false; it is not being used as a tag-to-digest mutation service in the documented release path.

The Git revision names the source state. The image digest names a built artifact. They differ because building also incorporates a base image, package resolution, runtime updates, tool execution, and metadata. The Dockerfile writes the source revision into a label and GIT_SHA, but those are builder-generated metadata. They become useful claims when connected to authenticated provenance, not independent proof of origin.

The Python base image is selected by python:3.12-slim-trixie. The build updates package tooling and downloads packages; the runtime stage applies available Debian upgrades. This baseline therefore does not demonstrate hermetic or reproducible builds. Two builds from the same Git commit may produce different digests. Digest pinning makes the chosen output stable even when the inputs are not fully pinned.

Separate storage, shared digest
Artifact store · immutable image identity
  • Application image

    Immutable tags protect the reviewed artifact store.

  • Digest D

    Content identity binds references to the exact manifest.

Trust metadata store · mutable objects
  • Cosign metadata

    Separate mutable store permits signature/attestation metadata updates.

  • Signed statements

    Verification checks claims about D rather than trusting a mutable tag.

  • Application image Digest Dcontent address
  • Cosign metadata Signed statementssigned claim objects
  • Digest D Signed statementssubject digest binding
Image immutability and metadata mutability serve different requirements. Verification must preserve their digest binding.
Text equivalent and limits
  1. Immutable tags protect the reviewed artifact store.
  2. Content identity binds references to the exact manifest.
  3. Separate mutable store permits signature/attestation metadata updates.
  4. Verification checks claims about D rather than trusting a mutable tag.

Read the labeled relationships as the stated contract. Optional connections are dashed and explicitly labeled; comparisons do not imply a sequential handoff. This figure explains inspected code or recorded observations, not current cloud execution.

Terraform defines an immutable-tag application repository and a separate mutable-tag Cosign metadata repository. Legacy Cosign v2 metadata uses indexes such as sha256-<digest>.att, allowing more than one attestation to be appended. Making those indexes immutable would interfere with that metadata flow.

This separation does not replace cryptographic binding. The verifier reads metadata from the configured repository and checks it against the application’s digest and expected signer. Mutable metadata storage can still be deleted, made unavailable, or filled with unwanted claims by a storage writer. Availability and authenticated origin remain separate concerns. A signature object stored somewhere is not evidence until the consuming verifier validates the correct subject and identity.

Artifact Registry displays the selected image digest beginning 32a90d.
Recorded capture · Registry contains the selected immutable digest. The console displays the image digest and tag. Collection: .

Evidence boundary: Registry presence and a tag do not authenticate provenance, prove deployment or establish current registry state.

Inspect full provenance and unchanged original →

This registry view shows the selected 32a90d… digest exists in the pictured repository. Registry presence is distinct from an authenticated statement, an admission decision or the running container’s image ID.

The live-acceptance capture and baseline Helm value identify digest sha256:32a90d832fdf76794fa5477e42e1fdcec28c9eb6e0deee48ad466d1f7d9fc563. The workflow and attestation screenshots visibly show a different artifact beginning sha256:a0073f8f. They illustrate the same contract in separate observations; they cannot be assembled into one measured end-to-end trace of a single digest.

A runtime event’s image tag is not enough to establish the running image’s manifest digest. For a fresh reproduction, preserve build digest output, verified claim subjects, selected GitOps value, admitted Pod image reference, and container status image ID together. This handbook records the available historical pieces and their association limits.

The next question is what the statements bound to a digest actually mean. Read a valid signature is not enough.