Reusable Helm chart version bump guard for Woodpecker and local policy hooks.
  • Go 97.1%
  • Shell 2%
  • Dockerfile 0.9%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Renovate Bot 4abe43fa0a
All checks were successful
ci/woodpecker/pr/test Pipeline was successful
ci/woodpecker/push/test Pipeline was successful
Create gated release tag / release (push) Successful in 50s
ci/woodpecker/tag/release Pipeline was successful
chore(deps): update weekly dependencies
2026-11-13 09:38:51 +00:00
.forgejo/workflows ci: gate releases and enable persistent caching 2026-08-11 03:01:04 +02:00
.woodpecker chore(deps): update weekly dependencies 2026-11-13 09:38:51 +00:00
cmd/chart-version-guard chore: migrate project to isityael 2026-10-28 12:23:37 +01:00
hack ci: gate releases and enable persistent caching 2026-08-11 03:01:04 +02:00
internal chore: migrate project to isityael 2026-10-28 12:23:37 +01:00
.dockerignore feat: add Helm chart version guard 2026-05-31 14:11:34 +02:00
.gitignore feat: add Helm chart version guard 2026-05-31 14:11:34 +02:00
.pre-commit-hooks.yaml feat: add Helm chart version guard 2026-05-31 14:11:34 +02:00
Dockerfile chore(deps): update weekly dependencies 2026-11-13 09:38:51 +00:00
go.mod ci: enforce complete Go dependency updates 2026-11-13 08:56:58 +01:00
go.sum ci: enforce complete Go dependency updates 2026-11-13 08:56:58 +01:00
README.md ci: publish versioned chart guard images to Forgejo 2026-10-28 12:28:46 +01:00
renovate.json ci: enforce complete Go dependency updates 2026-11-13 08:56:58 +01:00
VERSION ci: gate releases and enable persistent caching 2026-08-11 03:01:04 +02:00

chart-version-guard

chart-version-guard enforces the GitOps rule that Helm chart behavior changes must bump the chart version.

It watches chart-local templates/, values.yaml, values.yml, values-*.yaml, and values-*.yml files. If any of those files change, the same chart's top-level Chart.yaml version must change between the base and head refs.

Usage

Check a local branch:

chart-version-guard check --base origin/main --head HEAD --repo .

Check from Woodpecker:

chart-version-guard check --ci woodpecker --repo .

Patch-bump missing chart versions locally:

chart-version-guard bump --base origin/main --head HEAD --repo . --write

Patch-bump missing chart versions from Woodpecker:

chart-version-guard bump --ci woodpecker --repo . --write

Skip chart roots that the repository does not release, such as upstream copies in a fork (repeatable; path.Match globs, and a trailing /** matches the whole subtree):

chart-version-guard check --ci woodpecker --repo . --ignore 'charts/**'

Rules

  • Chart roots are discovered by Chart.yaml.
  • Vendored dependency charts under a chart's charts/ directory are ignored.
  • Charts matching an --ignore pattern are skipped, and their files are not attributed to a parent chart.
  • Dependency version changes inside Chart.yaml do not satisfy or require a chart version bump.
  • New charts pass when their new Chart.yaml has a top-level version.
  • Deleted charts pass.
  • bump --write only handles strict x.y.z versions.

CI Image

Woodpecker publishes git.m0sh1.cc/isityael/chart-version-guard:<release-tag> from this repository's .woodpecker/release.yaml pipeline. Only gated v*-ym.* release tags are published; consumers pin that version tag. The pipeline uses the shared forgejo_public_package_username and forgejo_public_package_token secrets for the public Forgejo registry.

Repository

Forgejo is the source of truth:

  • https://git.m0sh1.cc/isityael/chart-version-guard

GitHub is maintained as a public push mirror:

  • https://github.com/isityael/chart-version-guard