image-mapper: helm chart support#256
Merged
ribbybibby merged 2 commits intochainguard-demo:mainfrom Jan 5, 2026
Merged
Conversation
When migrating a Helm chart to Chainguard it's a bit of a chore to figure out: 1. Which values you need to override 2. Which images you should replace the values with 3. Whether there are any tags you need to adjust. This change adds subcommands that streamline the process. This involves quite a lot of changes to the existing mapper: 1. Make it possible to match inactive tags by fetching the full list of tags from data.chaingurd.dev. Helm charts are tightly coupled to specific versions and therefore it isn't reasonable to expect users to bump a given version of a chart to active tags. Therefore, we need to aim to match the closest version possible. 2. Make it possible to map to a custom repository prefix. Chances are, users are using an internal mirror or proxy when they deploy images via Helm. 3. Make it possible for the mapper to ignore certain tags. We typically don't want/need to use -dev tags in Helm charts as our non-dev images *should* drop in nicely. 4. Nest all the commands under a `map` command. This has nicer semantics. 5. Overhaul the docs to account for multiple commands. I've also had to tweak and fix some tests and other bits that I found while I was testing the Helm feature.
hooksie1
reviewed
Jan 5, 2026
hooksie1
reviewed
Jan 5, 2026
hooksie1
reviewed
Jan 5, 2026
hooksie1
approved these changes
Jan 5, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
When migrating a Helm chart to Chainguard it's a bit of a chore to figure out:
This change adds subcommands that streamline the process.
This involves quite a lot of changes to the existing mapper:
mapcommand. This has nicer semantics.I've also had to tweak and fix some tests and other bits that I found while I was testing the Helm feature.