/helm-charts

Contains helm-charts for Unleash

Primary LanguageSmartyApache License 2.0Apache-2.0

Unleash Kubernetes Helm Chart

License Release

Usage

Helm must be installed to use the charts. Please refer to Helm's documentation to get started.

Once Helm is set up properly, add the repository as follows:

helm repo add unleash https://docs.getunleash.io/helm-charts

You can then run helm search repo unleash to see the charts.

Versions

  • 1.x includes Unleash v3.x
  • 2.x includes Unleash v4.x

Kubernetes support strategy

We'll build this repository on all k8s versions that have not reached End of Life according to the Kubernetes support period.

Contributing

The source code of all unleash Helm charts can be found on Github: https://github.com/unleash/helm-charts/

We'd love to have you contribute! Please refer to our contribution guidelines for details.

License

Apache 2.0 License.

Helm charts build status

Release

Releasing the charts

To release new versions of the charts, you must update the chart version in the Chart.yaml file and then merge these modifications into the main branch. Following this, the workflow will detect these changes and automatically release a new version of the modified Helm chart.

Helm repository

This repository employs a process that converts it into a Helm repository, specifically using the Helm Chart Releaser Action version 1.5.0. It leverages GitHub Pages for hosting the artifacts. Furthermore, the Unleash documentation on Helm charts utilizes a CNAME to direct to the GitHub Pages.

The specific workflow is outlined in the file located at .github/workflows/release.yml. This workflow activates whenever there's an update to the chart version, which consequently prompts an update to the repository with the new chart version.

Testing the helm chart locally

To test the helm chart locally, first you should set up a local k8s environment. An easy way to do this is to set up kind, you can see instructions for setting it up here.

Once you have your local k8s environment set up, you can run the following command to install the helm chart locally:

helm install --debug --generate-name . # this will install the chart using the local files provided you are in the folder that contains the chart
# To see the output of the helm chart without running it locally, you can run the following command:
helm install --debug --dry-run --generate-name .