helm

Overview

Test, build, and release Helm charts. This pipeline:

• Lints the chart configuration with helm lint
• Renders a chart README with helm-docs
• Publishes the Helm chart to a ChartMuseum-compatible repository (GitLab Package Registry by default)

Usage

Include the pipeline:

include:
  - project: brettops/pipelines/helm
    file: include.yml

Specify HELM_CHART_PATH if necessary. This pipeline publishes to the GitLab Package Registry for the current project by default, using a CI job token.

Using charts

See the GitLab documentation on installing Helm charts.

Currently, only project-level repositories are supported by GitLab, not group-level.

Variables

HELM_CHART_PATH

The path of the chart to publish. Defaults to ..

HELM_CHART_VERSION

The chart version to publish. The version field in the Chart.yaml file is always overridden by this pipeline. Defaults to $CI_COMMIT_TAG.

HELM_REPOSITORY_USERNAME

The username used to push to a ChartMuseum repository. Defaults to gitlab-ci-token.

HELM_REPOSITORY_PASSWORD

The password used to push to a ChartMuseum repository. Defaults to $CI_JOB_TOKEN.

HELM_REPOSITORY_URL

The URL of the ChartMuseum repository to push to. Defaults to $CI_API_V4_URL/projects/$CI_PROJECT_ID/packages/helm/production.