helm-charts

Helm charts I maintain for my home cluster.

Publishing

• Chart API version: v2
• Chart path: charts/<chart>
• Release/index automation: GitHub Actions (.github/workflows/release.yml)
• Chart repository branch: gh-pages
• Chart artifacts (*.tgz) and index.yaml are generated by CI (not committed to main)

Repo Layout

• charts/<chart>/ contains a chart definition
• scripts/ contains local/CI helpers

CI Testing

PR workflow (.github/workflows/pr.yml) runs:

• Layer 1 (static): helm lint + rendered manifest schema validation via kubeconform
• Layer 2 (integration): ct lint + ct install in a disposable kind cluster

Recommended branch policy: require pull requests for main and require the pr workflow to pass before merge.

Local Lint

./scripts/lint.sh

Using The Chart Repository

After the release workflow has published index.yaml to gh-pages:

helm repo add mgarratt-home https://mgarratt.uk/helm-charts
helm repo update
helm search repo mgarratt-home

One-time repository setup: enable GitHub Pages with source branch gh-pages and folder / (root).

Adding A Chart

1. Copy charts/_template/ to charts/<chart>/.
2. Edit charts/<chart>/Chart.yaml.
3. Edit charts/<chart>/values.yaml and charts/<chart>/templates/*.