NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Go modules, #2827 by repository stars
Latest stable
v1.7.1
Last release 26 days ago
26 Oct 2026
Ships fairly regularly
a new release about every 2 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
6 years old
919 releases · first in 2020
Drag across the ruler to compare, or tap a release to open it.
CHANGELOG
Release date: 2023-04-13
This prerelease comes with a bug fix for a nil pointer deref that could occur when drift detection was enabled.
In addition, it updates Helm to v3.11.3, which includes two fixes for Go
routine leaks.
Fixes:
CHANGELOG
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Release date: 2023-04-03
This prerelease comes with a bug fix in HelmRelease related to the
.spec.chart.metadata field which wasn't truly optional, leading to empty value
assignment even when it wasn't set.
Fixes:
CHANGELOG
Release date: 2023-03-31
This prerelease comes with a number of new features and improvements, and solves a long-standing issue with the patching of the HelmRelease status.
The HelmRelease now supports the definition of a set of labels and annotations
using .spec.chart.metadata.labels and .spec.chart.metadata.annotations,
which will be applied to the HelmChart created by the controller.
The controller can now be configured with --watch-label-selector, after
which only HelmRelease objects with this label will be reconciled by the
controller.
This allows for horizontal scaling, where the controller can be deployed multiple times with a unique label selector which is used as the sharding key.
Note that if you want to ensure a HelmChart gets created for a specific
source-controller instance, you have to provide the labels for this controller
in .spec.chart.metadata.labels of the HelmRelease.
In addition, the source referenced (i.e. HelmRepository) in the HelmChart must be available to this same controller instance.
The HelmRelease now supports opting out of the persistent Kubernetes client
introduced in v0.31.0 by defining .spec.persistentClient: false (default
true).
This can be useful when a HelmRelease is used to manage a Helm chart that itself manages Custom Resource Definitions outside the Helm chart's CRD lifecycle (like OPA Gatekeeper), as the persistent client will not observe the creation of these resources.
Disabling this increases memory consumption, and should only be used when necessary.
The controller will now verify the Digest of the Artifact as advertised by
the HelmChart, introduced in source-controller v0.35.0.
Due to this, the controller will now require source-controller v0.35.0 or
higher (and ships with v1.0.0-rc.1 by default, which includes v1 of the
Artifact API).
Improvements:
controllers to internal/controllers
#653PersistentClient flag to allow control over Kubernetes client behavior
#659Fixes:
CHANGELOG
Release date: 2023-03-20
This prerelease extends the drift detection feature introduced in v0.31.0
with support for disabling the correction of drift using the CorrectDrift
feature gate.
When disabled while DetectDrift is enabled (using --feature-gates=DetectDrift=true,CorrectDrift=false),
the controller will only emit events and log messages when drift is detected,
but will not attempt to correct it. This allows to transition to drift
detection and correction in a controlled manner.
In addition, the controller dependencies have been updated to their latest versions.
Fixes:
Improvements:
CHANGELOG
Release date: 2023-03-10
This prerelease extends the OOM watch feature introduced in v0.31.0 with
support for automatic detection of cgroup v1 paths, and flags to configure
alternative paths using --oom-watch-max-memory-path and
--oom-watch-current-memory-path.
Fixes:
Nothing published for this version
CHANGELOG
Release date: 2023-03-08
This prerelease comes with a number of new features and improvements after a long period of non-substantial changes.
The controller now supports experimental drift detection, which can be enabled
by configuring the Deployment with --feature-gates=DetectDrift=true. This
feature is still in its early stages, and lacks certain UX features. Diff
output is currently available in the controller logs when the --log-level=debug
flag is set.
The feature itself makes use of the same approach as kustomize-controller to detect drift using a dry-run Server Side Apply of the rendered manifests of a release. When drift is detected, the controller will emit an event and trigger a Helm upgrade.
When a specific object from a release causes spurious upgrades, it can be
excluded by annotating or labeling the object with
helm.toolkit.fluxcd.io/driftDetection: disabled. Refer to the drift detection
documentation
for more information.
When a SIGTERM signal is received by the controller, it will now propagate
this to any running Helm action, which will mark the release as failed. This
should prevent the controller from getting stuck in a pending state when
receiving a SIGTERM signal.
The controller can now be configured to detect when it is nearing an OOM kill.
This is enabled by configuring the Deployment with
--feature-gates=OOMWatch=true.
When enabled, the controller will monitor its memory usage as reported by
cgroups, and when it is nearing OOM, attempt to gracefully shutdown. Releases
that are currently being upgraded will be cancelled (resulting in a failed
release as opposed to a pending deadlock), and no new releases will be
started.
This is best combined with a thoughtful configuration of remediation strategies
on the HelmRelease resources, to ensure that the controller can recover from
the failed release.
To control the threshold at which the controller will attempt to shut down, use
the --oom-watch-memory-threshold (default 95) and --oom-watch-interval
(default 500ms) flags.
In a future release, we will add support for unlocking releases that are in a pending state as a different approach to handling OOM situations. But this is waiting for architectural changes to happen first.
We have made a number of improvements to the Kubernetes client used by the controller for Helm actions, which should reduce the memory usage of the controller and the number of API requests it makes when creating or replacing Custom Resource Definitions.
klog is now configured to log using the same logger as the rest of the
controller (providing a consistent log format).
In addition, the controller is now built with Go 1.20, and the dependencies have been updated.
Improvements:
logger.SetLogger to also configure klog
#633Nothing published for this version
CHANGELOG
Release date: 2023-02-17
This prerelease adds support for parsing the
RFC-0005
revision format produced by source-controller >=v0.35.0.
In addition, the controller dependencies have been updated to their latest
versions, including a security patch of Helm to v3.11.1.
Improvements:
Nothing published for this version
CHANGELOG
Release date: 2023-02-01
This prerelease comes with an update of Kubernetes dependencies to v1.26, Helm to v3.11.0, and a general update of other dependencies to their latest versions.
Starting with this release, Custom Resource Definitions installed by the
controller as part of a Create or CreateReplace
policy
are now labeled with helm.toolkit.fluxcd.io/name and
helm.toolkit.fluxcd.io/namespace to allow tracking the HelmRelease origin
of the resource. Note that these labels are only added to new and/or changed
resources, existing resources will not be updated.
Improvements:
CHANGELOG
Release date: 2022-12-22
This prerelease sets the default value for the --graceful-shutdown-timeout to
match the default value we set in the Deployment for
terminationGracePeriodSeconds which is 600s. This should fix handling graceful
shutdown correctly.
Fixes:
graceful-shutdown-timeout with terminationGracePeriodSeconds
#584CHANGELOG
Release date: 2022-12-20
This prerelease disables the caching of Secret and ConfigMap resources to
improve memory usage. To opt-out from this behaviour, start the controller
with: --feature-gates=CacheSecretsAndConfigMaps=true.
In addition, a new flag --graceful-shutdown-timeout has been added to
control the duration of the graceful shutdown period. The default value is
-1 (disabled), to help prevent releases from being stuck due to the
controller being terminated before the Helm action has completed.
Helm has been updated to v3.10.3, which includes security fixes.
Fixes:
DisableOpenApiValidation during upgrade
#564Improvements:
CHANGELOG
Release date: 2022-11-22
This prerelease comes with re-added support for h in the HelmRelease
spec.timeout field, so that users can use hours to set reconciliation
timeouts.
Improvements:
CHANGELOG
Release date: 2022-10-21
This prerelease comes with support for Cosign verification of Helm OCI charts.
The signatures verification can be configured by setting HelmRelease.spec.chart.spec.verify with
provider as cosign and a secretRef to a secret containing the public key.
Cosign keyless verification is also supported, please see the
HelmChart API documentation
for more details.
In addition, the controller dependencies have been updated to Kubernetes v1.25.3 and Helm v3.10.1.
Improvements:
CHANGELOG
Release date: 2022-09-29
This prerelease comes with strict validation rules for API fields which define a
(time) duration. Effectively, this means values without a time unit (e.g. ms,
s, m, h) will now be rejected by the API server. To stimulate sane
configurations, the units ns, us and µs can no longer be configured, nor
can h be set for fields defining a timeout value.
In addition, the controller dependencies have been updated to Kubernetes controller-runtime v0.13.
:warning: Breaking changes:
.spec.interval new validation pattern is "^([0-9]+(\\.[0-9]+)?(ms|s|m|h))+$".spec.timeout new validation pattern is "^([0-9]+(\\.[0-9]+)?(ms|s|m))+$"Improvements:
Nothing published for this version
CHANGELOG
Release date: 2022-09-12
This prerelease comes with improvements to fuzzing. In addition, the controller dependencies have been updated to Kubernetes controller-runtime v0.12.
:warning: Breaking change: The controller logs have been aligned with the Kubernetes structured logging. For more details on the new logging structure please see: fluxcd/flux2#3051.
Improvements:
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
CHANGELOG
Release date: 2022-08-29
This prerelease comes with updates to the controller dependencies including Kubernetes v1.25.0, Helm v3.9.4 and Kustomize v4.5.7.
Improvements:
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
CHANGELOG
Release date: 2022-08-19
This prerelease comes with panic recovery, to protect the controller from crashing when reconciliations lead to a crash.
The API now enforces validation to Spec.ValuesFrom subfields:
TargetPath and ValuesKey.
The new image contains updates to patch alpine CVEs.
Improvements:
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
CHANGELOG
Release date: 2022-07-13
This prerelease updates dependencies to patch upstream CVEs.
Improvements:
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
CHANGELOG
Release date: 2022-06-07
This prerelease fixes a regression bug introduced in #480
which would cause the impersonation config to pick the incorrect
TargetNamespace for the account name if it was set.
In addition, Kubernetes dependencies have been updated to v0.24.1, and
github.com/containerd/containerd was updated to v1.6.6 to mitigate
CVE-2022-31030.
Fixes:
Improvements:
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.