Skip to content

Releases

grex ships versioned binaries, container images, and a Helm chart from each git tag. Release notes (changelogs) are generated by GoReleaser from conventional commits and published on GitHub.

What Where
Changelog (this site) Changelog
GitHub Releases github.com/dennisme/grex/releases
Container images ghcr.io/dennisme/grex
Helm chart (Pages) dennisme.github.io/grex/charts
Helm chart (OCI) oci://ghcr.io/dennisme/charts/grex
Source tags github.com/dennisme/grex/tags
How maintainers cut a release Developer: Releasing

Install a release

Pin a SemVer (no leading v for Helm / image tags that match chart appVersion). Example for 0.1.0 (git tag v0.1.0):

helm repo add grex https://dennisme.github.io/grex/charts/
helm repo update
helm upgrade --install grex grex/grex --version 0.1.0 \
  --namespace grex --create-namespace

helm upgrade --install grex oci://ghcr.io/dennisme/charts/grex --version 0.1.0 \
  --namespace grex --create-namespace

docker pull ghcr.io/dennisme/grex:0.1.0
# also tagged: v0.1.0, latest (on the newest release)

Download archives from the GitHub Release for your OS/arch, verify checksums.txt, extract, and run:

./grex -config /path/to/config.yaml

Full operator install paths (Compose, from source, TLS, etc.): Admin: Install. Kubernetes details: Deploy with Helm.

What each release includes

Artifact Published by Notes
Cross-compiled binaries + checksums GoReleaser → GitHub Release linux / darwin / windows × amd64 / arm64
Multi-arch container image GoReleaser → GHCR Tags: VERSION, vVERSION, major/minor aliases, latest
Helm chart .tgz helm-release workflow (cr) → its own GitHub Release (helm-grex-VERSION) Version comes from an explicit --version override at package time, not from Chart.yaml
Helm chart OCI GoReleaser workflow → GHCR oci://ghcr.io/dennisme/charts/grex
Helm chart on Pages helm-release workflow pushes index.yaml to gh-pages; docs workflow mirrors it into /charts/ Repo index only; the .tgz itself downloads from the chart's GitHub Release asset
Release notes body GoReleaser changelog Grouped by commit type; PR links from (#N) squash subjects

Versioning

  • Git tags: vMAJOR.MINOR.PATCH (via svu / just release-tag)
  • Helm version / appVersion and default image tag: MAJOR.MINOR.PATCH (no v), set via an explicit --version/--app-version override at package time in CI. deploy/charts/grex/Chart.yaml itself stays a fixed 0.0.0 placeholder and is never edited as part of a release.
  • Breaking changes: conventional BREAKING CHANGE / type!: → major bump

See the Changelog for notes per tag, or the GitHub Releases feed for assets and the same notes at the source.