CtrlK
BlogDocsLog inGet started
Tessl Logo

dirien/pulumi-skills

Pulumi infrastructure-as-code and Flux CD GitOps skills for Claude Code with ESC, OIDC, and cloud provider best practices.

97

Quality

97%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Risky

Do not use without reviewing

Overview
Quality
Evals
Security
Files

helmreleases.mdflux-cli/references/

HelmRelease Commands

HelmReleases tell Flux how to install and manage Helm charts.


flux create helmrelease

flux create helmrelease <name> [flags]

Flags

FlagDefaultDescription
--chartHelm chart name or path (required unless --chart-ref is set)
--sourceChart source: <kind>/<name>.<namespace>. Kind: HelmRepository, GitRepository, Bucket
--chart-refReference to a HelmChart or OCIRepository: <kind>/<name>.<namespace>
--chart-versionChart version (semver range accepted; ignored for Git sources)
--chart-intervalInterval to check for new chart versions
--release-nameCustom Helm release name (defaults to HelmRelease name)
--target-namespaceNamespace to install the chart into
--storage-namespaceNamespace for storing Helm release metadata
--create-target-namespacefalseCreate target namespace if it doesn't exist
--valuesLocal path to values.yaml file(s) (repeatable)
--values-fromK8s object reference for values: Secret/<name> or ConfigMap/<name> (repeatable)
--depends-onDependencies: <name> or <namespace>/<name> (repeatable)
--crdsCRD upgrade policy: Skip, Create, CreateReplace
--service-accountService account for impersonation
--kubeconfig-secret-refSecret with kubeconfig for remote cluster
--reconcile-strategyChartVersionStrategy: Revision or ChartVersion
--interval1mReconciliation interval
--exportOutput YAML instead of applying
--labelLabels as key=value (repeatable)

Examples

# From a HelmRepository
flux create helmrelease nginx \
  --source=HelmRepository/bitnami \
  --chart=nginx \
  --chart-version=">=15.0.0" \
  --values=./nginx-values.yaml

# From a GitRepository (chart in repo)
flux create helmrelease my-app \
  --source=GitRepository/my-app \
  --chart=./charts/my-app

# From a Bucket
flux create helmrelease my-app \
  --source=Bucket/my-bucket \
  --chart=./charts/my-app

# With values from a Secret
flux create helmrelease my-app \
  --source=HelmRepository/my-charts \
  --chart=my-app \
  --values-from=Secret/my-app-values

# Multiple values files
flux create helmrelease my-app \
  --source=HelmRepository/my-charts \
  --chart=my-app \
  --values=./base-values.yaml \
  --values=./prod-values.yaml

# Custom release name and target namespace
flux create helmrelease my-app \
  --source=HelmRepository/my-charts \
  --chart=my-app \
  --release-name=my-custom-release \
  --target-namespace=apps \
  --create-target-namespace

# With dependencies
flux create helmrelease my-app \
  --source=HelmRepository/my-charts \
  --chart=my-app \
  --depends-on=cert-manager \
  --depends-on=kube-system/external-dns

# CRD handling
flux create helmrelease cert-manager \
  --source=HelmRepository/jetstack \
  --chart=cert-manager \
  --crds=CreateReplace

# Cross-namespace source reference
flux create helmrelease my-app \
  --source=HelmRepository/shared-charts.shared-ns \
  --chart=my-app

# From an OCIRepository
flux create helmrelease my-app \
  --chart-ref=OCIRepository/my-oci-source

# Export YAML
flux create helmrelease my-app \
  --source=HelmRepository/my-charts \
  --chart=my-app \
  --export > helmrelease.yaml

flux debug helmrelease

Debug a failing HelmRelease — shows detailed status, last attempted values, and error messages.

flux debug helmrelease <name> [-n <namespace>]

Managing HelmReleases

# List
flux get helmreleases [-A] [-w] [--no-header]

# Filter
flux get helmreleases --status-selector ready=false
flux get helmreleases -l app=frontend

# Force reconciliation
flux reconcile helmrelease <name>

# Suspend/resume
flux suspend helmrelease <name>
flux suspend helmrelease --all
flux resume helmrelease <name>

# Export
flux export helmrelease <name>
flux export helmrelease --all > all-hr.yaml

# Delete
flux delete helmrelease <name>

flux-cli

references

artifacts-and-images.md

bootstrap.md

helmreleases.md

kustomizations.md

sources.md

SKILL.md

AGENTS.md

CLAUDE.md

README.md

tile.json