Simple Helm Plugin - SHelm

Package your application's Helm Chart and all of its dependencies with "external" configuration files added.
Enables customizing Chart.yaml during the build.
You can manage application Chart and dependent Charts from the SBT

Helm has long-standing issue about addition of external files into Helm Charts.

This plugin "kind of" addresses this issue. It allows users to add any additional files to the Helm Chart. The plugin doesn't impose security issues raised in the aforementioned ticket. The additional files are accessible only during build time and packaged into Chart.

With shelm it is also possible to add Helm repositories and publish Charts to configured repositories.

Usage

Requirements

Helm 3 binary is required.

Example

Refer to tests for complete examples

Add shelm plugin to project:
project/plugins.sbt

addSbtPlugin("com.kiemlicz" % "shelm" % "0.6.0")

Check releases page for latest available version

1. Create Chart from the local directory.

build.sbt

lazy val root = (project in file("."))
  .enablePlugins(HelmPlugin)
  .settings(
    version := "0.1",
    scalaVersion := "2.13.3",
    Helm / chartSettings := Seq(
      ChartSettings(
        chartLocation = ChartLocation.Local(ChartName("includes-chart"), file("includes-chart")),
      )
    ),
    Helm / chartMappings := { s =>
      ChartMappings(
        s,
        destination = target.value,
        chartUpdate = _.copy(version = "1.2.3+meta.data"),
        includeFiles = Seq(
          file("config") -> "config",
          file("secrets") -> "secrets",
          file("config2/single.conf") -> "config/single.conf",
        ),
        yamlsToMerge = Seq(
          file("values.yaml") -> "values.yaml"
        )
      )
    }
  )

sbt> helm:packagesBin creates: projectRoot/target/chart_name-1.2.3+meta.data.tgz, which contains config, config2 and secrets dirs. Additionally, the values.yaml from Chart's directory will be merged with values.yaml present in project root.

2. Create Chart which is in the already added Helm repository (re-pack).

build.sbt

lazy val root = (project in file("."))
  .enablePlugins(HelmPlugin)
  .settings(
    version := "0.1",
    scalaVersion := "2.13.3",
    target in Helm := target.value / "nestTarget",
    Helm / shouldUpdateRepositories := true,
    Helm / chartSettings := Seq(
      ChartSettings(
        chartLocation = ChartLocation.AddedRepository(ChartName("redis"), ChartRepositoryName("stable"), Some("10.5.7")),
      )
    ),
    Helm / chartMappings := { s =>
      ChartMappings(
        s,
        destination = target.value / "someExtraDir",
        chartUpdate = c => c.copy(version = s"${c.version}+extraMetaData"),
        includeFiles = Seq(
          file("extraConfig") -> "extraConfig"
        ),
        Seq.empty,
        valueOverrides = _ => Seq(
          Json.fromFields(
            Iterable(
              "nameOverride" -> Json.fromString("testNameRedis"),
            )
          )
        ),
        fatalLint = false
      )
    }
  )

sbt> helm:packagesBin creates: projectRoot/target/someExtraDir/redis-10.5.7+extraMetaData.tgz, the downloaded and unpacked Chart can be found: projectRoot/target/nestTarget/redis. The re-packed Redis Chart will contain extraConfig and nameOverride key set in values.yaml

It is also possible to use direct URI for Chart: ChartLocation.Remote(URI.create("https://github.com/kiemlicz/ambassador/raw/gh-pages/salt-2.1.2.tgz"))
or not helm repo add'ed repository: ChartLocation.RemoteRepository("thename", URI.create("https://kiemlicz.github.io/ambassador/"), ChartRepositorySettings.NoAuth, Some("2.1.3"))

3. Publish Chart

Additionally to Helm / chartSettings and Helm / chartMappings, specify the repository.

build.sbt

credentials += Credentials("Artifactory Realm", "repository.example.com", "user", "pass"),
Helm / publishTo := Some(Resolver.url("Artifactory Realm", url("https://repository.example.com/artifactory/helm/experiments/"))(Patterns("[chartMajor].[chartMinor].[chartPatch]/[artifact]-[chartVersion].[ext]"))),

Available extra Ivy attributes (for use in Patterns):

• chartName Chart's name (Chart.yaml's name field)
• chartVersion full version of the Chart
• chartMajor Chart's SemVer2 Major
• chartMinor Chart's SemVer2 Minor
• chartPatch Chart's SemVer2 Patch
• [chartMetadata] Chart's metadata appended during execution of packagesBin task

Development notes

Releasing SHelm

Release is performed from dedicated Github action

The SHelm is versioned using SemVer2 with GitVersioning

The release procedure description can be found here
Git tag is published after the successful release.

Artifacts are hosted on Maven Central

Consult following README regarding the versioning.