Plugin: updater-helm

Updates chart metadata in a Helm Chart.yaml file. It helps keep Helm chart packages aligned with the application version being released.

Installation

Binary

semrel plugin install @semrel/updater-helm

semrel plugin install downloads the binary to .semrel/plugins/ and updates .semrel.lock. Commit .semrel.lock to pin the version for your team.

Docker

Pre-built, signed multi-platform images (linux/amd64, linux/arm64) are published on every release:

docker pull ghcr.io/semrels/updater-helm:latest

Verify the image signature with cosign:

cosign verify ghcr.io/semrels/updater-helm:latest \
  --certificate-identity-regexp 'https://github.com/SemRels/updater-helm/.github/workflows/release.yml.*' \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com

Configuration

version: 1
plugins:
  - uses: @semrel/updater-helm
    phase: pre-tag
    args:
      file: Chart.yaml

Environment Variables

Name	Required	Default	Description
`SEMREL_PLUGIN_FILE`	no	`Chart.yaml`	Helm chart file to update.
`SEMREL_PLUGIN_UPDATE_APP_VERSION`	no	`false`	When `true`, also update the `appVersion` field.
`SEMREL_PLUGIN_APP_VERSION_ONLY`	no	`false`	When `true`, update only `appVersion` and leave chart `version` unchanged.
`SEMREL_PLUGIN_APP_VERSION`	no	release version	Explicit override for `appVersion`.
`SEMREL_PLUGIN_APP_VERSION_PREFIX`	no	`""`	Optional prefix prepended to `appVersion` (e.g. `"v"`).

Release Context Variables

SEMREL_NEXT_VERSION
SEMREL_CURRENT_VERSION
SEMREL_TAG_NAME
SEMREL_DRY_RUN

Behavior

For a 1.4.0 release, the updater can change version: 1.3.2 and related chart metadata in Chart.yaml.

Source

SemRels/updater-helm