jhelm

Table of Contents

• Why jhelm
• Features
• Modules
• Tech Stack
• Quick Start
  • As a library
  • As a CLI
• Documentation
• Building
• License

A native Java implementation of the Helm package manager for Kubernetes. Render templates, manage charts, and deploy releases from the JVM — as an embeddable library, a Spring Boot starter, a REST API, or a standalone CLI — without shelling out to the Go-based Helm binary.

Why jhelm

• Helm-faithful rendering — jhelm renders chart templates byte-for-byte identically to helm template across a continuously-run suite of 346 real-world charts (Bitnami, Grafana, GitLab, Kubernetes-monitoring, and more). Parity is enforced in CI on every change.

• Pure JVM, no native binary — no helm executable, no exec, no platform-specific distribution. Just a Maven dependency.

• Designed to be embedded — a clean programmatic API (TemplateAction, InstallAction, …), Spring Boot auto-configuration, and a REST module, in addition to the CLI.

• Go template engine on Maven Central — the template/Sprig engine is the standalone gotmpl4j library, reusable on its own.

Features

• Go template engine — the full Go text/template language with Helm’s Sprig function set and Helm-specific functions (include, tpl, required, lookup, toYaml, …), matched against Helm’s own conformance tests.

• Chart lifecycle — install, upgrade, rollback, uninstall, list, status, history, test.

• Repository & registry management — add/remove repos, search, pull, push over both classic HTTP repositories and OCI registries.

• Dependency management — list, update, and build chart dependencies (Chart.yaml dependencies, charts/ vendoring, conditions/tags).

• Packaging & provenance — package charts to .tgz, sign and verify with PGP provenance files.

• Spring Boot integration — auto-configured beans, @ConfigurationProperties, and a programmatic action API.

• REST API — a Spring MVC module exposing chart and template operations over HTTP, with OpenAPI/Swagger documentation.

• JSON Schema validation — validates chart values against values.schema.json (Draft-07).

• Async Kubernetes operations — Java 21 virtual threads via AsyncKubeService.

Modules

Module	Description
jhelm-core	Chart model, loader, repository manager, rendering engine, and action API. The main entry point for library users.
jhelm-gotemplate-helm	Helm-specific template functions (include, tpl, required, toYaml, lookup, …) layered on top of gotmpl4j.
jhelm-kube	Kubernetes client integration — apply/delete resources, ConfigMap-based release storage, async operations.
jhelm-rest	Spring MVC REST API over jhelm operations, with OpenAPI documentation.
jhelm-plugin	Maven plugin for packaging charts as part of a build.
jhelm-cli	Standalone CLI (Spring Boot + Picocli) — 22 Helm-compatible commands.

The Go template + Sprig engine lives in the separate gotmpl4j project (on Maven Central) and is consumed as a dependency.

Tech Stack

Java	21
Spring Boot	4.0.7
Kubernetes Client	26.0.0
Template engine	gotmpl4j 0.3.0
CLI framework	Picocli 4.7.7

Quick Start

As a library

Add jhelm-core to your pom.xml:

    org.alexmond
    jhelm-core
    0.1.0

For Kubernetes operations (install/upgrade/rollback against a cluster), also add:

    org.alexmond
    jhelm-kube
    0.1.0

Render a chart programmatically (Spring Boot auto-configures the action beans):

@Autowired
TemplateAction templateAction;

// Render with default values
String manifest = templateAction.render(
        "/path/to/chart", "my-release", "default");

// Render with value overrides
String manifest = templateAction.render(
        "/path/to/chart", "my-release", "default",
        Map.of("replicaCount", 3, "image", Map.of("tag", "1.2.3")));

See the Spring Boot Starter guide for the full action API and configuration properties.

As a CLI

./mvnw clean install -DskipTests
java -jar jhelm-cli/target/jhelm-0.1.0.jar template my-release ./my-chart

The CLI mirrors the Helm command surface:

jhelm template my-release ./my-chart        # render manifests locally
jhelm install my-release ./my-chart -n prod # install into a cluster
jhelm upgrade my-release ./my-chart         # upgrade an existing release
jhelm repo add bitnami https://charts.bitnami.com/bitnami
jhelm pull bitnami/nginx --untar

Documentation

Full documentation — getting started, architecture, CLI reference, configuration, the REST API, and the Helm function catalogue — is published at https://www.alexmond.org/jhelm/current/index.html.

Building

./mvnw clean install          # build + run tests
./mvnw test -pl jhelm-core    # test a single module

Helm-parity tests (rendering jhelm against helm template over the chart suite) require a local helm binary on the PATH.

License

Apache License 2.0