Versionshinweise zur Flux-Erweiterung (GitOps)

Die Flux-Erweiterung (GitOps) wird kontinuierlich aktualisiert. Dieser Artikel enthält Informationen zu den neuesten Versionen der Erweiterung.

Von Bedeutung

Um die fortgesetzte Kompatibilität sicherzustellen und Fehler zu vermeiden, aktualisieren Sie Ihre Quellen, um Verweise auf veraltete APIs zu entfernen und sicherzustellen, dass Cluster die neueste Version der Erweiterung ausführen.

Die neueste Version der Flux-Erweiterung (GitOps) und die beiden vorherigen Versionen (N-2) werden unterstützt. Im Allgemeinen wird empfohlen, die neueste Version der Erweiterung zu verwenden.

Wenn eine neue Version der microsoft.flux Erweiterung veröffentlicht wird, kann es mehrere Tage dauern, bis die neue Version in allen Regionen verfügbar ist.

Einstellungs- und Entfernungshinweis: Änderungen an der Erweiterung microsoft.flux

Die folgenden Flux-APIs wurden in den Upstream-Flux-Versionen 2.7, 2.8 und 2.9 entfernt:

  • Veraltete APIs in Gruppe source.toolkit.fluxcd.io/v1beta1 und source.toolkit.fluxcd.io/v1beta2
  • Veraltete APIs in Gruppe kustomize.toolkit.fluxcd.io/v1beta1 und kustomize.toolkit.fluxcd.io/v1beta2
  • Veraltete APIs in Gruppe helm.toolkit.fluxcd.io/v2beta1 und helm.toolkit.fluxcd.io/v2beta2
  • Veraltete APIs in Gruppe notification.toolkit.fluxcd.io/v1beta1 und notification.toolkit.fluxcd.io/v1beta2
  • Veraltete APIs in Gruppe image.toolkit.fluxcd.io/v1beta1 und image.toolkit.fluxcd.io/v1beta2

Weitere Informationen finden Sie unter https://github.com/fluxcd/flux2/issues/5572.

Erforderliche Aktion: Um die fortgesetzte Kompatibilität sicherzustellen und Unterbrechungen zu vermeiden, aktualisieren Sie Ihre Quellen so schnell wie möglich, um Verweise auf veraltete APIs zu entfernen. Wenn Ihre Cluster 1.20.4 oder niedriger ausführen, aktualisieren Sie sie zuerst auf eine Zwischenversion (1.21.0 - 1.22.2), und führen Sie dann ein Upgrade auf Version 1.23.0 durch.

Migrieren Sie alle Ihre Ressourcen zu den Flux stable APIs in Ihren Quellen (Git-Repositorys, OCI-Repositorys, Buckets, Blob-Speicher), indem Sie die API-Version in den Manifesten ersetzen:

  • Kustomization bis kustomize.toolkit.fluxcd.io/v1
  • HelmRelease bis helm.toolkit.fluxcd.io/v2
  • Bucket bis source.toolkit.fluxcd.io/v1
  • GitRepository bis source.toolkit.fluxcd.io/v1
  • HelmChart bis source.toolkit.fluxcd.io/v1
  • HelmRepository bis source.toolkit.fluxcd.io/v1
  • OCIRepository bis source.toolkit.fluxcd.io/v1
  • Receiver bis notification.toolkit.fluxcd.io/v1
  • Alert bis notification.toolkit.fluxcd.io/v1beta3
  • Provider bis notification.toolkit.fluxcd.io/v1beta3
  • ImageRepository bis image.toolkit.fluxcd.io/v1
  • ImagePolicy bis image.toolkit.fluxcd.io/v1
  • ImageUpdateAutomation bis image.toolkit.fluxcd.io/v1

Beachten Sie, dass die ImageUpdateAutomation Commit-Vorlage die Felder .Changed.FileChanges, .Changed.Objects und .Changed.Changes anstelle der veralteten Felder .Updated und .Changed.ImageResult verwenden soll.

Sobald die Manifeste in den Quellen aktualisiert werden, wird Flux die neuen API-Versionen abstimmen.

August 2026 – microsoft.flux Version 1.25.0

Flux-Version: Release v2.8.8

  • source-controller: v1.8.5-3
  • kustomize-controller: v1.8.5-2
  • helm-controller: v1.5.5-2
  • notification-controller: v1.8.4-3
  • image-automation-controller: v1.1.4-2
  • image-reflector-controller: v1.1.2-2

Änderungen in dieser Version:

  • Die Flux-Erweiterung wurde auf upstream Flux v2.8.8 aktualisiert. Dieses Update stellt helm-controller von Helm v3 auf Helm v4 um, wodurch sich einige Standardeinstellungen ändern, darunter die Verwendung von serverseitiger Anwendung und kstatus-basierten Integritätsprüfungen. Weitere Informationen finden Sie in den offiziellen Flux v2.8.0-Versionshinweisen unter Helm v4-Unterstützung. Um das Standardverhalten von Helm v3 wiederherzustellen, aktivieren Sie die useHelm3Defaults Einstellung wie im Standardverhalten "Helm v3 wiederherstellen".
  • Dem azure-k8s-flux-Diagramm wurde eine generische Durchleitung für Feature-Gates hinzugefügt, die die optionale Konfiguration von Upstream-Flux-Controller-Feature-Gates ermöglicht.
  • Unterstützung für das Konfigurieren von --override-manager auf helm-controller hinzugefügt.
  • Härtung des Flusserweiterungsdiagramms durch Hinzufügen von Typschutz (quote, int) zu interpolierten Werten in den Controllervorlagen.
  • Es wurden Sicherheitsrisiken in fluxconfig-agent, fluxconfig-controller, , fluent-bit-mdmsource-controller, kustomize-controller, notification-controller, , image-automation-controller, und image-reflector-controllerhelm-controllerdurch Aktualisieren der Go-Pakete und Basisimages behoben.

August 2026 – microsoft.flux Version 1.24.1

Flux-Version: Release v2.7.5

  • source-controller: v1.7.4-23
  • kustomize-controller: v1.7.3-17
  • helm-controller: v1.4.5-16
  • notification-controller: v1.7.5-15
  • image-automation-controller: v1.0.4-16
  • image-reflector-controller: v1.0.4-13

Änderungen in dieser Version:

  • Legen Sie Image v1-APIs als Speicherversion fest.
  • Fügen Sie der fluxconfig-CRD eine Notation hinzu.
  • Es wurden Sicherheitsrisiken in fluxconfig-agent, fluxconfig-controller, , fluent-bit-mdmsource-controller, kustomize-controller, notification-controller, , image-automation-controller, und image-reflector-controllerhelm-controllerdurch Aktualisieren der Go-Pakete und Basisimages behoben.

Juli 2026 – microsoft.flux Version 1.24.0

Flux-Version: Release v2.7.5

  • source-controller: v1.7.4-20
  • kustomize-controller: v1.7.3-15
  • helm-controller: v1.4.5-15
  • notification-controller: v1.7.5-13
  • image-automation-controller: v1.0.4-15
  • image-reflector-controller: v1.0.4-12

Änderungen in dieser Version:

  • Aktivieren Sie das Client-Caching für ORAS Notation in Version 1.7.4 von source-controller.
  • Erweiterung der Erweiterungskonfiguration, um Feldmanager anzugeben, die keine Änderungen an verwalteten Ressourcen mithilfe von override-manager in kustomize-controller vornehmen dürfen.
  • Stellen Sie 2.7-CRDs für das Rollforward von Clustern wieder her, die die Flux-API-Nutzung als veraltet markiert oder entfernt haben.
  • Es wurden Sicherheitsrisiken in fluxconfig-agent, fluxconfig-controller, , fluent-bit-mdmsource-controller, kustomize-controller, notification-controller, , image-automation-controller, und image-reflector-controllerhelm-controllerdurch Aktualisieren der Go-Pakete und Basisimages behoben.

Juli 2026 – microsoft.flux Version 1.23.3

Flux-Version: Release v2.7.5

  • source-controller: v1.7.4-16
  • kustomize-controller: v1.7.3-13
  • helm-controller: v1.4.5-13
  • notification-controller: v1.7.5-11
  • image-automation-controller: v1.0.4-13
  • image-reflector-controller: v1.0.4-10

Änderungen in dieser Version:

  • Es wurden Sicherheitsrisiken in fluxconfig-agent, fluxconfig-controller, , fluent-bit-mdmsource-controller, kustomize-controller, notification-controller, , image-automation-controller, und image-reflector-controllerhelm-controllerdurch Aktualisieren der Go-Pakete und Basisimages behoben.

Juni 2026 – microsoft.flux Version 1.23.1

Flux-Version: Release v2.7.5

  • source-controller: v1.7.4-13
  • kustomize-controller: v1.7.3-12
  • helm-controller: v1.4.5-11
  • notification-controller: v1.7.5-10
  • image-automation-controller: v1.0.4-12
  • image-reflector-controller: v1.0.4-9

Änderungen in dieser Version:

  • Es wurden Sicherheitsrisiken in fluxconfig-agent, fluxconfig-controller, , fluent-bit-mdmsource-controller, kustomize-controller, notification-controller, , image-automation-controller, und image-reflector-controllerhelm-controllerdurch Aktualisieren der Go-Pakete und Basisimages behoben.

Juni 2026 – microsoft.flux Version 1.23.0

Von Bedeutung

Cluster müssen Version 1.21.0 oder höher ausführen, um anschließend auf Version 1.23.0 zu aktualisieren, die die Flux 2.7-API-Version enthält.

Flux-Version: Release v2.7.5

  • source-controller: v1.7.4-10
  • kustomize-controller: v1.7.3-9
  • helm-controller: v1.4.5-8
  • notification-controller: v1.7.5-7
  • image-automation-controller: v1.0.4-9
  • image-reflector-controller: v1.0.4-6

Änderungen in dieser Version:

  • Flux-Erweiterungsupdates auf v2.7.5 mit neuen CRDs und Controllern. Eine Reihe von API-Versionen wurde entfernt. Weitere Informationen finden Sie im API-Entfernungshinweis.
  • Ermöglicht die Konfiguration des Helm-Cache, des Index und des Jitter-Intervall-Prozentsatzes der Flux-Controller.
  • Es wurden Sicherheitsrisiken in fluxconfig-agent, , fluxconfig-controller, fluent-bit-mdmsource-controllerkustomize-controller, notification-controller, und image-automation-controllerimage-reflector-controllerhelm-controller durch Aktualisieren der Go-Pakete und Basisimages behoben.

Mai 2026 – microsoft.flux Version 1.22.2

Flux-Version: Version v2.6.4

  • source-controller: v1.6.4-19
  • kustomize-controller: v1.6.1-20
  • helm-controller: v1.3.2-11
  • notification-controller: v1.6.0-16
  • image-automation-controller: v0.41.2-19
  • image-reflector-controller: v0.35.2-15

Änderungen in dieser Version:

  • Es wurden Sicherheitsrisiken in fluxconfig-agent, , fluxconfig-controller, fluent-bit-mdmsource-controllerkustomize-controller, notification-controller, und image-automation-controllerimage-reflector-controllerhelm-controller durch Aktualisieren der Go-Pakete und Basisimages behoben.

Mai 2026 – microsoft.flux Version 1.22.1

Flux-Version: Version v2.6.4

  • source-controller: v1.6.4-14
  • kustomize-controller: v1.6.1-15
  • helm-controller: v1.3.2-8
  • notification-controller: v1.6.0-13
  • image-automation-controller: v0.41.2-14
  • image-reflector-controller: v0.35.2-12

Änderungen in dieser Version:

  • Es wurden Sicherheitsrisiken in fluxconfig-agent, , fluxconfig-controller, fluent-bit-mdmsource-controllerkustomize-controller, notification-controller, und image-automation-controllerimage-reflector-controllerhelm-controller durch Aktualisieren der Go-Pakete und Basisimages behoben.
  • Flux-Erweiterungs-Pods mit den Pod-Sicherheitsstandards konform gemacht.
  • Es wurden Designverbesserungen für die WaitForReconciliation-Logik in fluxconfig-agent und fluxconfig-controller implementiert, um Fehler zu beheben, bei denen der Provisionierungsstatus im Zustand Failed hängen blieb.
  • Unterstützung für die Cosign-Verifizierung in source-controller hinzugefügt.

April 2026 – microsoft.flux Version 1.21.1

Flux-Version: Version v2.6.4

  • Source-Controller: v1.6.4-13
  • kustomize-controller: v1.6.1-15
  • helm-controller: v1.3.2-8
  • notification-controller: v1.6.0-12
  • image-automation-controller: v0.41.2-14
  • image-reflector-controller: v0.35.2-12

Änderungen in dieser Version:

  • Es wurden Sicherheitsrisiken in fluxconfig-agent, , fluxconfig-controller, fluent-bit-mdmsource-controllerkustomize-controller, notification-controller, und image-automation-controllerimage-reflector-controllerhelm-controller durch Aktualisieren der Go-Pakete und Basisimages behoben.

April 2026 – microsoft.flux Version 1.21.0

Flux-Version: Version v2.6.4

  • Source-Controller: v1.6.4-8
  • kustomize-controller: v1.6.1-11
  • helm-controller: v1.3.2-6
  • notification-controller: v1.6.0-10
  • image-automation-controller: v0.41.2-11
  • image-reflector-controller: v0.35.2-10

Änderungen in dieser Version:

  • Es wurden Sicherheitsrisiken in fluxconfig-agent, , fluxconfig-controller, fluent-bit-mdmsource-controllerkustomize-controller, notification-controller, und image-automation-controllerimage-reflector-controllerhelm-controller durch Aktualisieren der Go-Pakete und Basisimages behoben.
  • Migrierte CRs im Speicher etcd für Flux-CRDs mit veralteten API-Versionen.
  • Optimierte Protokollierung zur Reduzierung des Protokollierungsbedarfs in fluxconfig-agent und fluxconfig-controller.

März 2026 – microsoft.flux Version 1.20.4

Flux-Version: Version v2.6.4

  • Source-Controller: v1.6.4-7
  • kustomize-controller: v1.6.1-10
  • helm-controller: v1.3.2-5
  • notification-controller: v1.6.0-9
  • image-automation-controller: v0.41.2-10
  • image-reflector-controller: v0.35.2-9

Änderungen in dieser Version:

  • Es wurden Sicherheitsrisiken in fluxconfig-agent, , fluxconfig-controller, fluent-bit-mdmsource-controllerkustomize-controller, notification-controller, und image-automation-controllerimage-reflector-controllerhelm-controller durch Aktualisieren der Go-Pakete und Basisimages behoben.
  • Workload-Identitätsunterstützung für den Benachrichtigungscontroller.
  • Stelle sicher, dass die Einstellungen für die Workload-Identität, die Mandant-ID und die Client-ID in den Bereitstellungen von Flux-Controllern korrekt berücksichtigt werden, wenn sie aktualisiert werden.
  • Compliance mit den Sicherheitsvorkehrungen bei der automatischen Bereitstellung von AKS.
  • Unterstützung der Workload-Identität auf Objektebene für Flux-Controller.

Februar 2026 – microsoft.flux Version 1.19.5

Flux-Version: Version v2.6.4

  • Source-Controller: v1.6.4
  • kustomize-controller: v1.6.1
  • helm-controller: v1.3.2
  • notification-controller: v1.6.0
  • image-automation-controller: v0.41.2
  • image-reflector-controller: v0.35.2

Änderungen in dieser Version:

  • Es wurden Sicherheitsrisiken in fluxconfig-agent, fluxconfig-controller, , fluent-bit-mdm, source-controllerund helm-controller durch Aktualisieren der Go-Pakete und Basisimages behoben.