Flux Cheatsheet

Flux CheatsheetKapitel 06 von 12

Flux HelmRelease

Stand Flux 2.10 · Edition 2026.11 · Release-Daten geprüft am 30. Oktober 2026

Chart-Referenz

chart.spec + sourceRef (HelmRepository, GitRepository, Bucket) erzeugt eine HelmChart. Seit 2.10 legt chart.kind: OCIRepository mit spec.url eine OCIRepository im Namespace der HelmRelease an, Version und Values stehen dann in einem Objekt. chartRef nutzt eine vorhandene OCIRepository, HelmChart oder ExternalArtifact. SemVer-Ranges (6.x, >=0.2.0 <1.0.0) wählen die höchste passende Version.

apiVersion: helm.toolkit.fluxcd.io/v2
kind: HelmRelease
metadata: {name: podinfo, namespace: apps}
spec:
  interval: 30m
  chart:
    kind: OCIRepository        # seit 2.10
    spec:
      url: oci://ghcr.io/stefanprodan/charts/podinfo
      ref: {semver: ">=6.0.0 <7.0.0"}
  install: {remediation: {retries: 3}}
  upgrade: {remediation: {retries: 3, strategy: rollback}}
  driftDetection: {mode: enabled}
  valuesFrom: [{kind: Secret, name: podinfo-values}]
  values:
    replicaCount: 2

Remediation & Drift

remediation.retries (Install, Upgrade): automatische Wiederholung fehlgeschlagener Releases; strategy: rollback oder uninstall. driftDetection.mode: enabled erkennt und korrigiert manuelle Änderungen am Release-Inventar (warn meldet nur). test.enable führt Helm-Tests nach Install/Upgrade aus.

Helm 4 (seit 2.8)

helm-controller arbeitet mit dem Helm-4-SDK (v2.10: 4.3.1). Neue Releases laufen per Server-Side Apply (install.serverSideApply, Default true), bestehende bleiben auf Client-Side Apply, bis upgrade.serverSideApply: enabled (Default auto) sie umstellt. Health-Checks laufen für alle Releases über kstatus (waitStrategy.name: poller). Seit 2.9 laufen Hooks durch die Post-Renderer (postRenderStrategy: combined). Je Release zurück per waitStrategy: {name: legacy} bzw. postRenderStrategy: nohooks, global per Feature-Gate UseHelm3Defaults.