m0sh1/chart-version-guard
1
0
Fork 0
Code Issues 1 Pull requests Projects Releases Packages Wiki Activity Actions
Reusable Helm chart version bump guard for Woodpecker and local policy hooks.
10 commits 1 branch 0 tags 52 KiB
  • Go 98.4%
  • Dockerfile 1.6%
Find a file
Exact
Yael Meya a5263c4c59
All checks were successful
ci/woodpecker/push/test Pipeline was successful
Details
ci/woodpecker/push/release Pipeline was successful
Details
feat: support ci-aware chart bumps
2026-06-01 10:45:02 +02:00
.woodpecker chore(deps): update dhi.io/golang:1.26.3-debian13-dev docker digest to fda9463 2026-05-31 15:30:01 +00:00
cmd/chart-version-guard feat: add Helm chart version guard 2026-05-31 14:11:34 +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.3-debian13-dev docker digest to fda9463 2026-05-31 15:30:01 +00:00
go.mod feat: add Helm chart version guard 2026-05-31 14:11:34 +02:00
go.sum feat: add Helm chart version guard 2026-05-31 14:11:34 +02:00
README.md feat: support ci-aware chart bumps 2026-06-01 10:45:02 +02:00
renovate.json Add renovate.json 2026-05-31 15:20:39 +00: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/yaelmoshi/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/yaelmoshi/chart-version-guard