NAME
Langertha::Holmgang::Sim::Linux::Helm - helm on the admin host of a simulated cluster — releases, values, revisions, rendering
VERSION
version 0.001
SYNOPSIS
# from the Linux simulator: helm on a device with kubernetes.helm
my ( $out, $ok ) = Langertha::Holmgang::Sim::Linux::Helm::helm( $dev, \@argv, $ctx );
DESCRIPTION
Helm 3 (v3.15) against the cluster under kubernetes of a Linux device (cai-platform docs/entwurf-evals.md §3.3.1). The state is under kubernetes.helm:
helm:
repos: { example: https://charts.example.com }
charts:
example/shop-api:
versions:
"1.4.0":
app_version: 1.4.2
values: { replicaCount: 2, image: { tag: "" } } # the chart's defaults
resources: # templates (state shape)
- kind: deployments
name: "{{ .Release.Name }}"
if: enabled # only when the value is true
obj: { replicas: "{{ .Values.replicaCount }}", … }
releases:
shop: # namespace
shop-api:
chart: example/shop-api
version: 1.4.0
revision: 4
status: deployed # deployed | failed | pending-upgrade | …
values: { … } # values set by the user (helm get values)
updated: "2026-10-23 14:02:11"
description: Upgrade complete
history: [ { revision, version, values, status, updated, description }, … ]
manifest: [ deployments/shop-api, … ] # what the release owns
Templates: a text that is exactly {{ EXPRESSION }} becomes the value itself (number, list …); otherwise it is substituted. Expressions: .Values.a.b, .Release.Name, .Release.Namespace, .Chart.Version, .Chart.AppVersion, plus | default EXPRESSION|"text". A hash with _if: path in a list counts only when the value is true.
Values like Helm 3: upgrade without --reuse-values puts only the newly passed values (-f, --set) on top of the chart's defaults — the old ones are dropped; without new values the old ones stay. --reuse-values puts the new ones on top of the old. Without --version, upgrade takes the newest chart version of the repo. helm list shows only deployed and failed (-a all). A release in pending-* refuses upgrade ("another operation … is in progress"); rollback and deleting the secret of the pending revision (sh.helm.release.v1.NAME.vN) resolve it as for real. --wait/--atomic check the readiness of the rendered deployments.
Commands: list|ls, status, history|hist, get values|manifest, upgrade [--install], install, rollback, uninstall, repo list|update, search repo, show values|chart, version. Anything else (template, lint, pull …) is a gap of the simulation; plugins (diff) are not installed.
Pure functions on the state, neutral.
drop_revision
drop_revision( $k, $ns, $release, $revision );
The secret sh.helm.release.v1.NAME.vN was deleted: the revision disappears; if it was the newest, the previous one becomes current again.
release_secrets
my %s = release_secrets( $k, $ns ); # name -> Secret (type helm.sh/release.v1)
helm
my ( $out, $ok ) = helm( $dev, \@argv, $ctx );
SUPPORT
Issues
Please report bugs and feature requests at https://github.com/Getty/langertha-holmgang/issues.
IRC
Join #langertha on irc.perl.org or message Getty directly.
CONTRIBUTING
Contributions are welcome! Please fork the repository and submit a pull request.
AUTHOR
Torsten Raudssus <torsten@raudssus.de>
COPYRIGHT AND LICENSE
This software is copyright (c) 2026 by Torsten Raudssus <torsten@raudssus.de> https://raudssus.de/.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.