isityael/chart-version-guard
Watch
1
1
Fork
You've already forked chart-version-guard
 0
Code Issues 1 Pull requests Projects Releases Packages Wiki Activity Actions
Reusable Helm chart version bump guard for Woodpecker and local policy hooks.
56 commits 1 branch 1 tag 95 KiB
  • Go 96.1%
  • Shell 2.4%
  • Dockerfile 1.5%
Find a file
Exact
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Yael Meya 886a857c9f
All checks were successful
ci/woodpecker/push/test Pipeline was successful
Details
ci/woodpecker/tag/release Pipeline was successful
Details
ci: gate releases and enable persistent caching
2026-08-11 03:01:04 +02:00
.forgejo/workflows ci: gate releases and enable persistent caching 2026-08-11 03:01:04 +02:00
.woodpecker ci: gate releases and enable persistent caching 2026-08-11 03:01:04 +02:00
cmd/chart-version-guard feat: add Helm chart version guard 2026-05-31 14:11:34 +02:00
hack ci: gate releases and enable persistent caching 2026-08-11 03:01:04 +02:00
internal feat: support ci-aware chart bumps 2026-06-01 10:45:02 +02: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 dhi.io/golang:1.26.5-debian13-dev docker digest to 4f8306e 2026-08-07 09:30:39 +00:00
go.mod chore(deps): update module go.yaml.in/yaml/v3 to v3.0.5 2026-07-26 19:30:47 +00:00
go.sum chore(deps): update module go.yaml.in/yaml/v3 to v3.0.5 2026-07-26 19:30:47 +00:00
README.md Update GHCR namespace references 2026-06-30 23:39:07 +02:00
renovate.json Add renovate.json 2026-05-31 15:20:39 +00:00
VERSION ci: gate releases and enable persistent caching 2026-08-11 03:01:04 +02:00

README.md

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

Rules

  • Chart roots are discovered by Chart.yaml.
  • Vendored dependency charts under a chart's charts/ directory are ignored.
  • 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 ghcr.io/isityael/chart-version-guard from this repository's .woodpecker/release.yaml pipeline.

Repository

Forgejo is the source of truth:

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

GitHub is maintained as a public push mirror:

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