Update module github.com/fluxcd/flux2/v2 to v2.1.2 - autoclosed
This MR contains the following updates:
Package | Type | Update | Change |
---|---|---|---|
github.com/fluxcd/flux2/v2 | require | minor |
v2.0.1 -> v2.1.2
|
Release Notes
fluxcd/flux2 (github.com/fluxcd/flux2/v2)
v2.1.2
Highlights
Flux v2.1.2
is a patch release which comes with various fixes. Users are encouraged to upgrade for the best experience.
Fixes
- Ensures faster recovery of
Kustomization
andHelmRelease
resources when the source-controller has restarted and is working on restoring the storage. - Prevent source-controller from failing to reconcile
OCIRepositories
when artifacts contain symlinks. - Addresses issue with helm-controller miss-labeling Custom Resource Definitions.
- Detect immutable field errors in Google Cloud resources managed by Flux
Kustomizations
. - Better error reporting for
flux bootstrap
when the owner doesn't match the identity associated with the given token. - Allow
flux pull artifact
to fetch OCI artifacts produced by other tools.
Components changelog
CLI Changelog
- MR #4324 - @somtochiama - bootstrap: Fix error msg when the Git token doesn't match the repo owner
- MR #4323 - @stefanprodan - e2e: Update Go dependencies
- MR #4313 - @fluxcdbot - Update toolkit components
- MR #4296 - @Skarlso - fix: only wait for changeset if the result is not empty
- MR #4285 - @matheuscscp - Add badge for SLSA Level 3
- MR #4284 - @errordeveloper - Make
flux pull
work for OCI artifacts produced by other tools
v2.1.1
Highlights
Flux v2.1.1
is a patch release which comes with various fixes. Users are encouraged to upgrade for the best experience.
Fixes
- Use auto lookup strategy for Buckets to widen support for S3-compatible object storage services (
source-controller
). - Fix Secret type check for HelmRepositories TLS certs referred in
.spec.secretRef
(source-controller
). - Fix the branch name reporting when the push branch is the same as the checkout branch (
image-automation-controller
). - Restore Helm logs inclusion in failure events (
helm-controller
). - Fix the impersonation of the default service account when diffing HelmReleases (
helm-controller
). - Check source for
nil
artifact before loading Helm charts (helm-controller
). - Update the description of Kubernetes specific flag to distinguish them from Flux bootstrap flags (
flux
CLI).
Components changelog
CLI Changelog
- MR #4255 - @hiddeco - tests/azure: update controller dependencies
- MR #4251 - @fluxcdbot - Update toolkit components
- MR #4246 - @dependabot[bot] - build(deps): bump the ci group with 4 updates
- MR #4238 - @makkes - Upgrade github.com/fluxcd/pkg/{git,git/gogit}
- MR #4233 - @sonbui00 - chore: remove support armv6h for aur package
- MR #4228 - @sonbui00 - Improve AUR package templates
- MR #4227 - @dependabot[bot] - build(deps): bump the ci group with 3 updates
- MR #4226 - @somtochiama - Update description of kubeconfig specific flag
- MR #4222 - @dependabot[bot] - build(deps): bump github.com/cyphar/filepath-securejoin from 0.2.3 to 0.2.4 in /tests/integration
- MR #4221 - @dependabot[bot] - build(deps): bump github.com/cyphar/filepath-securejoin from 0.2.3 to 0.2.4 in /tests/azure
- MR #4215 - @dependabot[bot] - build(deps): bump the ci group with 4 updates
- MR #4213 - @dependabot[bot] - build(deps): bump github.com/docker/distribution from 2.8.1+incompatible to 2.8.2+incompatible in /tests/integration
- MR #4212 - @dependabot[bot] - build(deps): bump github.com/docker/docker from 23.0.1+incompatible to 23.0.3+incompatible in /tests/integration
- MR #4198 - @makkes - Add 2.1.x backport label
- MR #4197 - @stefanprodan - Fix links to fluxcd.io
- MR #4195 - @dependabot[bot] - build(deps): bump the ci group with 2 updates
v2.1.0
Highlights
Flux v2.1.0 is a feature release. Users are encouraged to upgrade for the best experience.
The Flux APIs were extended with new opt-in features in a backwards-compatible manner.
The Flux Git capabilities have been improved with support for Git push options, Git refspec, Gerrit, HTTP/S and SOCKS5 proxies.
The Flux alerting capabilities have been extended with Datadog support.
The Flux controllers come with performance improvements when reconciling Helm repositories with large indexes (80% memory reduction), and when reconciling Flux Kustomizations with thousands of resources (x4 faster server-side apply). The load distribution has been improved when reconciling Flux objects in parallel to reduce CPU and memory spikes.
Deprecations
Flux v2.1.0 comes with support for Kubernetes TLS Secrets when referring to secrets containing TLS certs, and deprecates the usage of caFile
, keyFile
and certFile
keys.
For more details about the TLS changes please see the Kubernetes TLS Secrets section.
Flux v2.1.0 comes with major improvements to the Prometheus monitoring stack. Starting with this version, Flux is leveraging the kube-state-metrics
CRD exporter to report metrics containing rich information about Flux reconciliation status e.g. Git revision, Helm chart version, OCI artifacts digests, etc. The gotk_reconcile_condition
metrics was deprecated in favor of the gotk_resource_info
.
For more details about the new monitoring stack please see the Flux Prometheus metrics documentation and the flux2-monitoring-example repository.
API changes
GitRepository v1
The GitRepository API was extended with the following fields:
-
.spec.proxySecretRef.name
is an optional field used to specify the name of a Kubernetes Secret that contains the HTTP/S or SOCKS5 proxy settings. -
.spec.verify.mode
now support one of the following valuesHEAD
,Tag
,TagAndHEAD
.
Kustomization v1
The Kustomization API was extended with two apply policies IfNotPresent
and Ignore
.
Changing the apply behaviour for specific Kubernetes resources, can be done using the following annotations:
Annotation | Default | Values | Role |
---|---|---|---|
kustomize.toolkit.fluxcd.io/ssa |
Override |
- Override - Merge - IfNotPresent - Ignore
|
Apply policy |
kustomize.toolkit.fluxcd.io/force |
Disabled |
- Enabled - Disabled
|
Recreate policy |
kustomize.toolkit.fluxcd.io/prune |
Enabled |
- Enabled - Disabled
|
Delete policy |
The IfNotPresent
policy instructs the controller to only apply the Kubernetes resources if they are not present on the cluster.
This policy can be used for Kubernetes Secrets
and ValidatingWebhookConfigurations
managed by cert-manager,
where Flux creates the resources with fields that are later on mutated by other controllers.
ImageUpdateAutomation v1beta1
The ImageUpdateAutomation was extended with the following fields:
-
.spec.git.push.refspec
is an optional field used to specify a Git refspec used when pushing commits upstream. -
.spec.git.push.options
is an optional field used to specify the Git push options to be sent to the Git server when pushing commits upstream.
Kubernetes TLS Secrets
All the Flux APIs that accept TLS data have been modified to adopt Secrets of type
kubernetes.io/tls
. This includes:
-
HelmRepository: The field
.spec.secretRef
has been deprecated in favor of a new field.spec.certSecretRef
. -
OCIRepository: Support for the
caFile
,keyFile
andcertFile
keys in the Secret specified in.spec.certSecretRef
have been deprecated in favor ofca.crt
,tls.key
andtls.crt
. -
ImageRepository: Support for the
caFile
,keyFile
andcertFile
keys in the Secret specified in.spec.certSecretRef
have been deprecated in favor ofca.crt
,tls.key
andtls.crt
. -
GitRepository: CA certificate can now be provided in the Secret specified in
.spec.secretRef
using theca.crt
key, which takes precedence over thecaFile
key.
Upgrade procedure
Upgrade Flux from v2.0.x
to v2.1.0
either by rerunning bootstrap or by using the Flux GitHub Action.
To upgrade Flux from v0.x
to v2.1.0
please follow the Flux GA upgrade procedure.
Kubernetes compatibility
This release is compatible with the following Kubernetes versions:
Kubernetes version | Minimum required |
---|---|
v1.25 |
>= 1.25.0 |
v1.26 |
>= 1.26.0 |
v1.27 |
>= 1.27.1 |
v1.28 |
>= 1.28.0 |
Note that Flux may work on older versions of Kubernetes e.g. 1.21, but we don't recommend running end-of-life versions in production nor do we offer support for these versions.
New Documentation
- Flux installation
- Flux bootstrap
- Flux configuration
- Flux Prometheus metrics
- Flux custom Prometheus metrics
- Flux logs
- Flux events
Components changelog
- source-controller v1.1.0
- kustomize-controller v1.1.0
- notification-controller v1.1.0
- helm-controller v0.36.0
- image-reflector-controller v0.30.0
- image-automation-controller v0.36.0
CLI Changelog
- MR #4189 - @hiddeco - Update dependencies
- MR #4186 - @fluxcdbot - Update toolkit components
- MR #4183 - @somtochiama - Fix autocompletion for helm chart
- MR #4182 - @hiddeco - manifestgen/install: use clean default HTTP client
- MR #4181 - @hiddeco - cmd/events: handle error value
- MR #4180 - @stefanprodan - Fix controller version info
- MR #4177 - @stefanprodan - Set min value for the
--ssh-rsa-bits
flag - MR #4176 - @hiddeco - ci: disable fail-fast for ARM end-to-end
- MR #4175 - @hiddeco - build: update securejoin dependency
- MR #4169 - @darkowlzz - Add monitoring configuration deprecation notice
- MR #4167 - @dependabot[bot] - build(deps): bump the ci group with 2 updates
- MR #4166 - @stefanprodan - e2e: Add Kubernetes v1.28.0 to conformance tests
- MR #4151 - @hiddeco - ci: enable security-and-quality CodeQL query
- MR #4147 - @aryan9600 - Adopt Kubernetes style TLS Secrets and add relevant flags
- MR #4142 - @dependabot[bot] - build(deps): bump the ci group with 2 updates
- MR #4140 - @somtochiama - Disable azure e2e test
- MR #4134 - @sestegra - monitoring: add OCIRepository in cluster dashboard and new source panels in control-plane dashboard
- MR #4131 - @mraerino - Fix selection of kustomization resource from multi doc yaml
- MR #4126 - @stefanprodan - Set Kubernetes min version to 1.25
- MR #4077 - @dependabot[bot] - build(deps): bump the ci group with 2 updates
- MR #4068 - @stefanprodan - Update dependencies
- MR #4065 - @hiddeco - action: support
openssl
andsha256sum
- MR #4062 - @souleb - diff: Take into account the server-side inventory for local Flux Kustomizations
- MR #4061 - @hiddeco - action: re-allow configuration of non-default token
- MR #4057 - @fluxcdbot - Update toolkit components
- MR #4052 - @stefanprodan - docs: Link to the Flux GitHub Action documentation
- MR #4051 - @hiddeco - action: use
$RUNNER_TOOL_CACHE
, support MacOS and Windows, validate checksum - MR #4046 - @stefanprodan - ci: backport: set write permissions
- MR #4043 - @stefanprodan - ci: release: extract the image tag from GITHUB_REF
- MR #4041 - @hiddeco - ci: release: disable interpretation backslash esc
Configuration
-
If you want to rebase/retry this MR, check this box
This MR has been generated by Renovate Bot.