kustomize-helmgenerator

A simple exec plugin for Kustomize written in go to declaratively define helm template outputs as a Kustomize generator.

HelmGenerator is purposely not written as a Kustomize go plugin to prevent integration difficulties with various versions of Kustomize.

Examples

The HelmGenerator API is heavily inspired by the Helm portion of the argocd-cm api here. An example of a feature rich generator is below:

apiVersion: wolfs.io/v1beta1
kind: HelmGenerator
metadata:
  name: helmGenerator

# Charge release name
releaseName: dog

# Path to a chart directory or .tgz of a chart (only local chart paths supported right now)
chartPath: testdata/mocha/

# Namespace to deploy chart to
namespace: coco

# Ordered helm value imports (values will be overrided in order)
valueFiles:
  - testdata/values-base.yaml
  - testdata/values-prod.yaml

# Generic map of values (will overwrite valuesFiles above)
values: |
  image:
    repository: donkers

Installation

Download HelmGenerator either from source or from the Github release page.

Like any Kustomize plugin, an XDG_CONFIG_HOME environment variable must be set before installing. See here for more info.

From Source

# Clone the repo
git clone https://github.com/joshrwolf/kustomize-helmgenerator.git
cd kustomize-helmgenerator

# Build the plugin (tested with go 1.14) and move it to the appropriate $XDG_CONFIG_HOME
make install

From Release

Executables are provided for amd64 on darwin, linux, and windows. Download it by specifying your appropriate arch, platform, and version:

VERSION=0.1.0 PLATFORM=linux ARCH=amd64 curl -Lo HelmGenerator https://github.com/joshrwolf/kustomize-helmgenerator/releases/download/v${VERSION}/HelmGenerator_${VERSION}_${PLATFORM}_${ARCH}
mkdir -p ${XDG_CONFIG_HOME}/kustomize/plugin/wolfs.io/v1beta1/helmgenerator
chmod +x HelmGenerator
mv HelmGenerator ${XDG_CONFIG_HOME}/kustomize/plugin/wolfs.io/v1beta1/helmgenerator/

Future Releases will be available from this repo once they have processed through the PartyBus artifact pipeline