Skip to content

Clarify how Helm chart updates track image updates#3615

Merged
SharpRake merged 3 commits into
chainguard-dev:mainfrom
SharpRake:helm-updates
Jul 20, 2026
Merged

Clarify how Helm chart updates track image updates#3615
SharpRake merged 3 commits into
chainguard-dev:mainfrom
SharpRake:helm-updates

Conversation

@SharpRake

Copy link
Copy Markdown
Collaborator

[ ] Check if this is a typo or other quick fix and ignore the rest :)

Type of change

Documentation Update

  • Add a "How chart updates deliver image updates" section to the Helm charts guide, explaining tag-versus-digest update behavior

What should this PR do?

resolves https://linear.app/chainguard/issue/DOCS-72/clarify-how-helm-chart-updates-track-image-updates

Clarifies how image updates propagate to customers depending on whether they reference a Chainguard Helm chart by tag or by digest.

Why are we making this change?

Customers were unclear on what happens to the underlying images when Chainguard updates them. Referencing a chart by tag keeps deployments current with the latest image digests automatically, while pinning by digest requires updating the pin to receive newer images — a distinction the guide did not spell out.

What are the acceptance criteria?

  • The guide explains that tag references continue to point to the latest image digests as images update
  • The guide explains that digest pins stay fixed until the reader updates the pin
  • The new section links to the existing "Pin to digest" section for guidance on choosing an approach

How should this PR be tested?

Any documentation published to Chainguard Academy is reviewed carefully for accuracy. GUI procedures, API commands, and CLI code snippets in a draft are run and tested thoroughly — by both the author and the reviewer — to confirm they work exactly as written. This helps ensure that readers can follow along and get the same results. See the `edu` repo's README.

  1. Check the preview link and ensure the changes look right
  2. Navigate to the Helm charts guide and confirm the new "How chart updates deliver image updates" section reads clearly and the "Pin to digest" anchor link resolves

…dates-track-image-updates

Signed-off-by: Mark Drake <mark@chainguard.dev>
@SharpRake
SharpRake requested a review from a team as a code owner July 20, 2026 17:45
@netlify

netlify Bot commented Jul 20, 2026

Copy link
Copy Markdown

Deploy Preview for ornate-narwhal-088216 ready!

Name Link
🔨 Latest commit a16aa65
🔍 Latest deploy log https://app.netlify.com/projects/ornate-narwhal-088216/deploys/6a5e8852e7078a000865d441
😎 Deploy Preview https://deploy-preview-3615--ornate-narwhal-088216.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.

@matthewhelmke matthewhelmke left a comment

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.

LGTM

…igests pin

Signed-off-by: Mark Drake <mark@chainguard.dev>
Signed-off-by: Mark Drake <mark@chainguard.dev>
@SharpRake
SharpRake merged commit e6286c7 into chainguard-dev:main Jul 20, 2026
9 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants