digest
A SHA-256 hash of an image's manifest that identifies its exact content and can never be moved to other bytes.
In more detail
Referring to an image by digest guarantees every environment runs identical bytes, which is why releases are promoted by digest rather than by tag. It is written after an at sign, as in name@sha256: followed by the hash.
Examples
docker pull alpine@sha256:<digest>In AWS: A long fingerprint of an image content that never changes, written as sha256: followed by 64 characters.The same idea applies to any artifact: the course build prints a digest derived from the archive contents, so the version names the release and the digest names the exact bytes.trivy image --exit-code 1 --severity HIGH,CRITICAL registry.example/app@sha256:deadbeefRelated terms
- image promotion — Moving the exact same, already-tested image through environments, such as staging to production, without rebuilding it.
- SHA-256 — A widely used hash function that turns any data into a 256-bit fingerprint, shown as 64 hexadecimal characters.
- tag — A human-readable label such as 3.20 or latest attached to an image in a repository, which can be moved to point at a different image.
- hash — A short fixed-length fingerprint calculated from data, which changes completely if even one byte of the data changes.
- pinning — Fixing an exact version or digest of something you depend on so it cannot change without you noticing.
- content addressing — Storing and finding data by a hash of its content instead of by a name someone chose.
- image — A read-only package containing a program and everything it needs to run, used as the template for containers.
- rollback — Returning a system to a previous known-good version after a bad change.
- task definition — The JSON document that describes an ECS task: which images to run, how much processor and memory, networking, role and logging.
- artifact — A file produced by a build, such as a compiled program or an image, that is stored and passed on to later steps.
- semantic versioning — A version numbering scheme of three numbers, major.minor.patch, raised for breaking changes, new features and fixes respectively.
- image scanning — Checking the packages inside an image against lists of known vulnerabilities.
Taught in
- Three Edits At 2 A.M.: Drift And Reconciliation — Certified GitOps Associate (CGOA) Exam Prep
- Someone Cleaned Up The History: Versioned And Immutable — Certified GitOps Associate (CGOA) Exam Prep
- An Hour Without Payments: Continuously Reconciled — Certified GitOps Associate (CGOA) Exam Prep
- What Does CI Still Do? CI, CD And Where GitOps Starts — Certified GitOps Associate (CGOA) Exam Prep
- Related Practices Sprint: One Change, Five Practices — Certified GitOps Associate (CGOA) Exam Prep
- Thursday, With A Way Back: Promotion, Deploy And Release — Certified GitOps Associate (CGOA) Exam Prep
- A Bucket Nobody Wrote Down: State Stores Beyond Git — Certified GitOps Associate (CGOA) Exam Prep
- Tooling Sprint: The CTO's Shopping List — Certified GitOps Associate (CGOA) Exam Prep
- Forty-Six Of Sixty: The Mock And What It Tells You — Certified GitOps Associate (CGOA) Exam Prep
- The Evening Before: Final Review — Certified GitOps Associate (CGOA) Exam Prep
- Building and Pushing Container Images — Continuous Integration & Continuous Delivery Pipelines
- Artifact Promotion: Staging to Production — Continuous Integration & Continuous Delivery Pipelines
- What is GitOps? — Continuous Integration & Continuous Delivery Pipelines
- Repository Layout for Environments — Continuous Integration & Continuous Delivery Pipelines
- Container Images The Exam Way — Certified Kubernetes Application Developer (CKAD) Exam Prep
- Design And Build: Timed Drill And Checkpoint — Certified Kubernetes Application Developer (CKAD) Exam Prep
- Kustomize Bases, Overlays And Patches — Certified Kubernetes Application Developer (CKAD) Exam Prep
- Minimal Base Images: Less To Attack — Certified Kubernetes Security Specialist (CKS) Exam Prep
- SBOMs: Knowing What You Ship — Certified Kubernetes Security Specialist (CKS) Exam Prep
- Allowed Registries: Admission That Refuses Images — Certified Kubernetes Security Specialist (CKS) Exam Prep
- Signing And Verifying Images With Cosign — Certified Kubernetes Security Specialist (CKS) Exam Prep
- Containers on AWS (ECS and EKS) — Cloud Infrastructure & Hyperscaler Architecture
- Supply Chain Security: SBOMs & Cosign Signing — Cloud Security & DevSecOps Engineering
- CloudTrail Logging, Integrity Validation & Athena — Cloud Security & DevSecOps Engineering
- Continuous Integration — DevOps & Site Reliability Engineering
- Building And Versioning The Artifact — DevOps & Site Reliability Engineering
- Containers And Orchestration Context — DevOps & Site Reliability Engineering
- Docker, OCI, The Engine And The CLI — Docker Architecture & Production Containers
- Pull And Inspect A Third Party Image — Docker Architecture & Production Containers
- FROM, WORKDIR, COPY And ADD — Docker Architecture & Production Containers
- Tags, Digests And Reproducible Image References — Docker Architecture & Production Containers
- Authenticate, Tag, Push And Pull From A Registry — Docker Architecture & Production Containers
- Scan, Patch And Inspect The Software Supply Chain — Docker Architecture & Production Containers
- Build, Test And Promote The Same Image In CI — Docker Architecture & Production Containers
- From Local Containers To Kubernetes — Docker Architecture & Production Containers
- Packaging Into A Container — Modern Java: Virtual Threads & High-Throughput Services
- Lockfiles And Reproducible Builds — Application Security & Threat Modeling for Engineers
- Provenance And Signing — Application Security & Threat Modeling for Engineers
- Container Security: Minimal Bases And Non Root — Application Security & Threat Modeling for Engineers
- Image Scanning And Trivy — Application Security & Threat Modeling for Engineers
References
- GitHub Docs: Working with the Container registry
- Docker CLI: docker image push
- OCI descriptor and digests
- docker image pull reference (pull by digest)
- OCI image specification: descriptors and digests
- OCI Image Format Specification