Helm

Install and manage Helm releases as part of a Bicep deployment.

Community Maintained

Version	0.0.1
Artifact	br:ghcr.io/anthony-c-martin/bicep-ext-helm:0.0.1
Source	github.com/anthony-c-martin/bicep-ext-helm
Publisher	anthony-c-martin
Licence	MIT
Category	Containers

Installation

Register the extension in bicepconfig.json:

{
  "experimentalFeaturesEnabled": {
    "localDeploy": true,
    "ociEnabled": true
  },
  "implicitExtensions": [],
  "extensions": {
    "helm": "br:ghcr.io/anthony-c-martin/bicep-ext-helm:0.0.1"
  }
}

Then reference it from your Bicep file:

extension helm

Configuration

Configuration is supplied using extension helm with { ... }.

Property	Type	Attributes	Description
kubeConfig	string	Required	The Kubernetes configuration file content, either base64-encoded or as raw YAML.

Connecting to a cluster

The extension needs the contents of a kubeconfig file identifying the cluster to deploy into, either as raw YAML or base64-encoded:

extension helm with {
  kubeConfig: loadTextContent('~/.kube/config')
}

Reading the file at deployment time keeps the cluster credentials out of your template:

main.bicep

@secure()
param kubeConfig string

extension helm with {
  kubeConfig: kubeConfig
}

main.bicepparam

using 'main.bicep'

param kubeConfig = readEnvironmentVariable('KUBECONFIG_CONTENT')

Example

targetScope = 'local'

@secure()
param kubeConfig string

extension helm with {
  kubeConfig: kubeConfig
}

resource ingress 'Release' = {
  name: 'ingress-nginx'
  namespace: 'ingress'
  chart: 'ingress-nginx'
  repository: 'https://kubernetes.github.io/ingress-nginx'
  values: {
    controller: {
      replicaCount: 2
    }
  }
}

Notes

• A Release maps to a Helm release. Updating the resource performs an upgrade, and removing it uninstalls the release.
• Chart values are supplied as a Bicep object, so they can be composed from parameters and expressions like any other Bicep value.

Samples

1 example Bicep file is available under Samples.

Resource types

This extension exposes 1 resource type, documented under Reference.

Reference generated from ghcr.io/anthony-c-martin/bicep-ext-helm:0.0.1 on 2026-08-23.