helm-chart-version-tools/README.md

1.3 KiB

helm-chart-version-tools

Find and compare Helm chart version drift across directory trees.

Problem

Umbrella or multi-environment Helm layouts often duplicate Chart.yaml under path variants (for example charts/monitoring/alpha/ vs charts/monitoring/beta/). Versions can drift silently. These scripts scan a tree and report mismatches.

Requirements

  • Python 3.10+
  • No third-party packages

Scripts

Script Purpose
check-helm-chart-versions.py Report version drift within one directory tree
compare-helm-chart-versions.py Compare versions between two directory trees

Charts are grouped by parent path; the leaf directory name is treated as the variant label. Use --min-depth if your layout is deeper than the default.

Usage

./check-helm-chart-versions.py /path/to/tree
./compare-helm-chart-versions.py /path/to/tree-a /path/to/tree-b alpha beta

Run --help on either script for examples and options. Exit code is 1 when differences are found, 0 when versions match.

Limits

  • Reads dependencies[].version or appVersion from Chart.yaml only.
  • Does not validate semver or contact chart repositories.
  • Path grouping is structural, not Helm-release aware.

License

MIT — see LICENSE.