Forge
Plugins

Helm

Plugin for Helm chart packaging and publishing

@bjb-forge/nx-helm-project

Installation

pnpm exec forge add @bjb-forge/nx-helm-project

Plugin Options

{
  "plugin": "@bjb-forge/nx-helm-project/nx-plugin",
  "options": {}
}
OptionTypeDescription
release.targetNamestringThe name of the release target
release.registryUrlstringThe Helm registry URL
release.registryUsernamestringThe Helm registry username
release.registryPasswordstringThe Helm registry password

Configuration

Helm charts read additional configuration from forge/-prefixed annotations in Chart.yaml. These keys are flat (not nested under a forge map) because Helm requires Chart.yaml's annotations to be a map<string, string>.

apiVersion: v2
name: my-chart
version: 0.1.0

annotations:
  forge/release: 'false'
  forge/registryNamespace: juliusbaer/my-claim/charts

Annotations

AnnotationDescription
forge/releaseSet to 'false' to disable publishing this chart via nx release. Defaults to enabled.
forge/registryNamespaceThe namespace under the Codeak Helm registry this chart is pushed to, in the form juliusbaer/<your-claim>/charts.

Inferred Targets

nx-release-publish

Packages and publishes the Helm chart to a registry.

Condition: All projects containing a Chart.yaml

Generators

chart-project

Create a Chart.yaml

nx g @bjb-forge/nx-helm-project:chart-project [options]
OptionTypeRequiredDefaultDescription
directorystringYes-A directory where the chart is placed.
namestringYes-Chart Name

On this page