NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Go modules, #3112 by repository stars
Latest stable
v1.10.1
Last release 19 days ago
03 Nov 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
1 version withdrawn
withdrawn after publishing
7 years old
516 releases · first in 2020
Drag across the ruler to compare, or tap a release to open it.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →
CHANGELOG
Release date: 2022-03-28
This prerelease improves on the experimental managed transport overall stability. Changes of note:
Fixes:
Nothing published for this version
CHANGELOG
Release date: 2022-03-25
This prerelease fixes a regression bug introduced in v0.22.0, which would
cause a GitRepository to end up in a Stalled state if an include did not
have an Artifact available.
Fixes:
Nothing published for this version
Nothing published for this version
CHANGELOG
Release date: 2022-03-23
This prerelease ensures (Kubernetes) Event annotations are prefixed with the
FQDN of the Source API Group. For example, revision is now
source.toolkit.fluxcd.io/revision.
This to facilitate improvements to the notification-controller, where annotations prefixed with the FQDN of the Group of the Involved Object will be transformed into "fields".
Fixes:
Nothing published for this version
Nothing published for this version
CHANGELOG
Release date: 2022-03-23
This prerelease fixes a regression in which .sourceignore rules for a
GitRepository would not be matched correctly.
Fixes:
Nothing published for this version
Nothing published for this version
CHANGELOG
Release date: 2022-03-17
This prerelease comes with new reconcilers which make use of fluxcd/pkg
utilities for common runtime operations, and graduates the API to v1beta2.
:warning: It is required to update the source-controller Custom Resource Definitions on your cluster and/or in Git.
Bucket resources do now take the provided etag for object storage items
into account during the calculation of the revision. As a result, items will
no longer be downloaded on every reconcile if none of them have changed.HelmChart resources do now advertise the observed chart name
(.status.observedChartName) and Source (reference) Artifact revision
(.status.observedSourceArtifactRevision) in the Status. The information is
used to more efficiently react to source revision and/or chart changes.The new specifications for the v1beta2 API
have been written in a new format with the aim to be more valuable to a user.
Featuring separate sections with examples, and information on how to write
and work with them.
The size (in bytes) of a tarball Artifact is now advertised in the Size
(.size) field of the Artifact. This can be utilized by users to e.g. quickly
see if .sourceignore rules have an effect, or be displayed in a UI.
Bucket resourcesThe .spec.provider of a Bucket resource can now be set to azure to
instruct the controller to use the
Azure Blob Storage SDK
while fetching objects. This allows for authenticating using Service
Principals, Managed Identities and Shared Keys.
For more information, see the Bucket spec about the Azure provider.
Source API resources will now advertise more explicit Condition types (more
about the types in "API changes"), provide Reconciling and Stalled
Conditions where applicable for
better integration with kstatus,
and record the Observed Generation on the Condition.
For a detailed overview per Source type, refer to the spec:
The Kubernetes Events the controller emits have been reworked to provide a proper reason, and more informative messages. Users making use of the notification-controller will notice this as well, as this same information is used to compose notifications.
libgit2 Git implementationThe libgit2 Git implementation supports a new experimental transport to
improve reliability, adding timeout enforcement for Git network operations.
Opt-in by setting the environment variable EXPERIMENTAL_GIT_TRANSPORT to
true in the controller's Deployment. This will result in the low-level
transport being handled by the controller, instead of libgit2. It may result
in an increased number of timeout messages in the logs, however it will remove
the ability of Git operations to make the controllers hang indefinitely.
The Helm dependency has been updated to v3.8.1, with a patch applied from
https://github.com/helm/helm/pull/10568. Using this patch, the HTTP transports
are now managed by the controller, to prevent the clogging of thousands of open
TCP connections on some instances.
libgit2 Git implementation to v1.3.xThe libgit2 Git implementation has been updated to v1.3.x, allowing us to
provide better error signals for authentication, certificate and transport
failures. Effectively, this means that instead of a unable to clone: User
error string, a descriptive one is now given.
In addition, NO_PROXY settings are now properly taken into account.
rsa-ssh2-256/512The dependency on golang.org/x/crypto has been updated to
v0.0.0-20220315160706-3147a52a75dd, as preparation of support for
rsa-ssh2-256/512. This should theoretically work out of the box for
known_hosts entries and go-git Git provider credentials, but has not been
widely tested.
The source.toolkit.fluxcd.io/v1beta2 API is backwards compatible with v1beta1.
Reconciling and Stalled Condition types for better
integration with kstatus.ArtifactOutdated: indicates the current Artifact of the Source is outdated.SourceVerified: indicates the integrity of the Source has been verified.FetchFailed: indicates a transient or persistent fetch failure of the
upstream Source.BuildFailed: indicates a transient or persistent build failure of a
Source's Artifact.StorageOperationFailed: indicates a transient or persistent failure
related to storage.IncludeUnavailable: indicates an include is not available. For example,
because it does not exist, or does not have an Artifact..status.artifact.size) in the
Artifact object.ObservedChartName (.status.observedChartName) and
ObservedSourceArtifactRevision (.status.observedSourceArtifactRevision)
fields in the HelmChart Status.azure provider implementation for Bucket.Updating the manifests in Git to v1beta2 can be done at any time after the
source-controller upgrade.
v1beta2 API and rewrite reconcilers
#586Nothing 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
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-02-07
This prerelease changes the default timeout of GitRepositories and Buckets from 20s to 60s.
When using the libgit2 Git implementation, increasing the timeout helps avoid
Error waiting on socket intermittent SSH cloning failures.
Improvements:
CHANGELOG
Release date: 2022-01-27
This prerelease comes with a bug fix to ensure the libgit2 Git implementation
respects hostnames with and without port while matching against known_hosts.
Fixes:
Nothing published for this version
CHANGELOG
Release date: 2022-01-26
This prerelease comes with changes to the base image used to build and run the controller, replacing Debian Unstable (Sid) with Alpine 3.15. The controller is now statically built and includes libgit2 along with its main dependencies.
The controller container images are signed with Cosign and GitHub OIDC, and a Software Bill of Materials in SPDX format has been published on the release page.
Starting with this version, the controller deployment conforms to the Kubernetes restricted pod security standard:
Breaking changes:
Improvements:
Fixes:
CHANGELOG
Release date: 2022-01-07
This prerelease comes with an update for github.com/containerd/containerd to v1.5.9
to please static security analysers and fix any warnings for CVE-2021-43816.
Improvements:
CHANGELOG
Release date: 2022-01-05
This prerelease comes with an update to the Kubernetes and controller-runtime dependencies
to align them with the Kubernetes 1.23 release, including an update of Helm to v3.7.2.
In addition, the controller is now built with Go 1.17, and
github.com/containerd/containerd was updated to v1.5.8 to please
static security analysers and fix any warnings for GHSA-5j5w-g665-5m35.
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: 2021-12-09
This prerelease ensures the API resources are not prematurely marked as Ready
by tools like kstatus, while the controller has not observed a newly created
resource yet, by defaulting the ObservedGeneration in the status of the
resource to -1.
In addition, it changes the faulty URL column for Bucket resources to
Endpoint, and updates github.com/opencontainers/runc to v1.0.3 to please
static security analysers and fix any warnings for CVE-2021-43784.
Improvements:
Fixes:
Nothing published for this version
Nothing published for this version
Nothing published for this version
CHANGELOG
Release date: 2021-12-03
This prerelease changes the length of the SHA hex added to the SemVer metadata
of a HelmChart, when ReconcileStrategy is set to Revision, to a short SHA
hex of the first 12 characters. This is to prevent situations in which the
SemVer would exceed the length limit of 63 characters when utilized in a Helm
chart as a label value.
Concrete example: 1.2.3+a4303ff0f6fb560ea032f9981c6bd7c7f146d083.1 becomes
1.2.3+a4303ff0f6fb.1
:warning: There have been additional user reports about charts complaining
about a + character in the label:
metadata.labels: Invalid value: "1.2.3+a4303ff0f6fb560ea032f9981c6bd7c7f146d083.1": a valid label must be an empty string or consist of alphanumeric characters, '-', '_' or '.', and must start and end with an alphanumeric character (e.g. 'MyValue', or 'my_value', or '12345', regex used for validation is '(([A-Za-z0-9][-A-Za-z0-9_.]*)?[A-Za-z0-9])?')
Given the Helm chart best practices mention to replace this character with a
_,
we encourage you to patch this in your (upstream) chart.
Pseudo example using template functions:
{{- replace "+" "_" .Chart.Version | trunc 63 }}
Fixes:
Nothing published for this version
CHANGELOG
Release date: 2021-11-23
For this prerelease we focused on improving the logic around Helm resources, with as goal to be more efficient, and increase code and testing quality.
It contains breaking behavioral changes to HelmRepository and
HelmChart resources:
Helm repository index files and/or charts must not exceed the new declared runtime default limits to avoid out-of-memory crashes, overwriting the default configuration is possible.
| Type | Default max size (in MiB) | Option flag to overwrite |
|---|---|---|
| Helm repository index | 50MiB | --helm-index-max-size=<bytes> |
| Helm chart | 10MiB | --helm-chart-max-size=<bytes> |
| Singe file from Helm chart | 5MiB | --helm-chart-file-max-size=<bytes> |
Using ValuesFiles in a HelmChart will now append a .<Generation> to the SemVer
metadata of the packaged chart and the revision of the Artifact. For example,
v1.2.3+.5 for a HelmChart resource with generation 5. This ensures consumers
of the chart are able to notice changes to the merged values without the underlying
chart source (revision) changing.
While an optional ACL field has been added to the API resources, there is no implementation at time of release.
Improvements:
v7.0.15
#498Fixes:
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.