Skip to main content
Version: 4.0.0

Tutorial: Build a Postrenderer Plugin

Build a plugin that adds custom labels to all Kubernetes resources.

Subprocess Runtime​

Let's start by building a Postrenderer Plugin with the Subprocess runtime.

Prerequisites​

  1. Install the latest Helm 4 release: v4.0.0
  2. In your terminal session, alias helm to the release you downloaded. helm version --short should now show the correct Helm version in this terminal session.
  3. Install mikefarah/yq: https://github.com/mikefarah/yq/#install

1. Create Plugin Directory​

You can create this anywhere on your filesystem. For example:

mkdir -p $HOME/code/helm/plugins/label-injector
cd $HOME/code/helm/plugins/label-injector

2. Create plugin manifest​

plugin.yaml
apiVersion: v1
type: postrenderer/v1
name: label-injector
version: 0.1.0
runtime: subprocess
runtimeConfig:
  platformCommand:
    - command: ${HELM_PLUGIN_DIR}/inject-labels.sh

3. Create Script​

inject-labels.sh
#!/usr/bin/env sh
# set -e
cat <&0 | yq '.metadata.labels.postrendered-by = "helm-label-injector-plugin"'

Make it executable:

chmod +x inject-labels.sh

4. Install in Dev Mode and Test​

Installing a plugin from your filesystem installs in local dev mode, which does not check the provenance:

% helm plugin install $HOME/code/helm/plugins/label-injector
Installing plugin from local directory (development mode)
Installed plugin: label-injector

As we saw in the CLI Plugin and Getter Plugin tutorials, local dev mode installation creates a symlink from your plugin source directory to the plugins directory. You now have three plugins installed:

% ls -lah $(helm env HELM_PLUGINS)
total 0
drwxr-xr-x@ 5 r6by  staff   160B Nov 10 04:04 .
drwxr-xr-x@ 3 r6by  staff    96B Jan 21  2025 ..
lrwxr-xr-x  1 r6by  staff    41B Nov 10 04:04 demo-getter -> /Users/r6by/code/helm/plugins/demo-getter
lrwxr-xr-x  1 r6by  staff    44B Nov 10 03:02 label-injector -> /Users/r6by/code/helm/plugins/label-injector
lrwxr-xr-x  1 r6by  staff    41B Nov 10 02:18 system-info -> /Users/r6by/code/helm/plugins/system-info

You can now see your installed Postrenderer plugin details along with the installed CLI and Getter plugins, using helm plugin list:

% helm plugin list
NAME          	VERSION	TYPE           	APIVERSION	PROVENANCE	SOURCE
demo-getter   	0.1.0  	getter/v1      	v1        	local dev 	unknown
label-injector	0.1.0  	postrenderer/v1	v1        	local dev 	unknown
system-info   	0.1.0  	cli/v1         	v1        	local dev 	unknown

Let's try it out:

% helm create ../mychart
% helm template ../mychart --post-renderer label-injector

You should see labels like this in the output:

metadata:
  labels:
    postrendered-by: helm-label-injector-plugin

What you built: A Postrenderer plugin using the Subprocess runtime!

Let's do this one in Wasm runtime now too…

Wasm Runtime​

Prerequisites​

warning

To-do: add this section