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.