Skip to content

Add image digest glossary term#3627

Open
VarshaUN wants to merge 1 commit intocncf:mainfrom
VarshaUN:img-digest
Open

Add image digest glossary term#3627
VarshaUN wants to merge 1 commit intocncf:mainfrom
VarshaUN:img-digest

Conversation

@VarshaUN
Copy link
Copy Markdown

Describe your changes

Related issue number or link (ex: resolves #issue-number)

This PR resolves kubernetes/website#55017

Checklist before opening this PR (put x in the checkboxes)

  • This PR does not contain plagiarism
    • don’t copy other people’s work unless you are quoting and contributing it to them.
  • I have signed off on all commits
    • signing off (ex: git commit -s) is to affirm that commits comply DCO. If you are working locally, you could add an alias to your gitconfig by running git config --global alias.ci "commit -s".

Signed-off-by : Varsha U N varshaun58@gmail.com

@netlify
Copy link
Copy Markdown

netlify bot commented Mar 26, 2026

Deploy Preview for cncfglossary ready!

Name Link
🔨 Latest commit 444abe1
🔍 Latest deploy log https://app.netlify.com/projects/cncfglossary/deploys/69c4c6ce48106c00086ef4a8
😎 Deploy Preview https://deploy-preview-3627--cncfglossary.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Signed-off-by: Varsha U N <varshaun58@gmail.com>
Signed-off-by: VarshaUN <varshaun58@gmail.com>
@VarshaUN
Copy link
Copy Markdown
Author

VarshaUN commented Apr 3, 2026

@caniszczyk kindly review this

Copy link
Copy Markdown
Collaborator

@Okabe-Junya Okabe-Junya left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you for your work 👍
left some comments, PTAL when you have time

tags: ["application", "fundamental", ""]
---

An image digest is a unique, content-based identifier for a [container image](/container/),
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
An image digest is a unique, content-based identifier for a [container image](/container/),
An image digest is a unique, content-based identifier for a [container image](/container-image/),

I think, we have a page for container image - https://glossary.cncf.io/container-image/

title: Image Digest
status: Completed
category: concept
tags: ["application", "fundamental", ""]
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
tags: ["application", "fundamental", ""]
tags: ["application", "fundamental"]

nit

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

And I think image digest is not "fundamental",
How about "security" instead?

teams ensure they are always running the exact same image,
regardless of what happens to its tag.
This is especially important for security audits, reproducible builds,
and [supply chain](/cloud-native-security/) integrity in production environments. No newline at end of file
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
and [supply chain](/cloud-native-security/) integrity in production environments.
and supply chain integrity in production environments.

I think we don't need to link to "Cloud Native security" page

teams ensure they are always running the exact same image,
regardless of what happens to its tag.
This is especially important for security audits, reproducible builds,
and [supply chain](/cloud-native-security/) integrity in production environments. No newline at end of file
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You can add ## Related terms sectons (container image, container)

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just a small suggestion: the intro and the "Problem it addresses" section have some overlap regarding "tag vs. digest."

I recommend focusing the "Problem ..." section strictly on the risks of tag mutability (security/reproducibility) and moving any solution-related details to "How it helps" for better flow, WDYT?

tags: ["application", "fundamental", ""]
---

An image digest is a unique, content-based identifier for a [container image](/container/),
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

content-based identifier

I think "content-addressable identity" would be better word based on OCI spec

https://specs.opencontainers.org/image-spec/#overview

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think it would be good to mention "OCI" in this document (e.g.,

Copy link
Copy Markdown
Collaborator

@Okabe-Junya Okabe-Junya left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

lang/en for English

Projects

Status: 📋 Backlog

Development

Successfully merging this pull request may close these issues.

Link to Docker, about image digests not relevant

2 participants