Kong Helm Charts

This is the official Helm Charts repository for installing Kong on Kubernetes.

Setup

$ helm repo add kong https://charts.konghq.com
$ helm repo update

# Helm 2
$ helm install kong/kong

# Helm 3
$ helm install kong/kong --generate-name --set ingressController.installCRDs=false

Documentation

The documentation for Kong's Helm Chart is available at here.

Seeking help

If you run into an issue, bug or have a question, please reach out to the Kong community via Kong Nation or open Github issues in this repository.

Releasing and forking

This repo uses chart releaser to automatically update a GitHub pages branch containing a Helm repo. When you bump the version field in Chart.yaml in one of the charts under charts/ and merge to main, GitHub Actions will trigger a release job to generate a GitHub release and add the new release to the Helm repo:

1. Make a new branch and add a release commit. This commit updates the Chart.yaml chart version, finalizes that version's changelog, and optionally adds upgrade instructions.
2. Open a PR to main and merge once approved.
3. Wait for CI to release the new version. Investigate errors if the release job fails.

Forks of this repo can use this release functionality without (much) additional configuration. Enabling GitHub pages for the gh-pages branch will make a Helm repo with your fork's changes available on your GitHub Pages URL. You can then use this with:

helm repo add kong-fork https://myuser.github.io/charts/