Freigeben über


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 Unterbrechungen 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.

Hinweis zu veralteten Elementen und Entfernung: Bevorstehende Änderungen an der microsoft.flux-Erweiterung

Mehrere Upstream-Flux-APIs, die vom Flux-Projekt eingestellt wurden, werden in bevorstehenden Versionen der microsoft.flux-Erweiterung entfernt. Diese Änderungen gehen mit den Bemühungen der Flux-Community einher, die API-Oberfläche zu optimieren und zu modernisieren.

Die folgenden Flux-APIs sind veraltet und werden 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
  • Veraltete APIs in Gruppe „image.toolkit.fluxcd.io/v1beta1

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. Verwenden Sie die unterstützten API-Versionen für alle betroffenen Ressourcen. Stellen Sie sicher, dass alle Cluster auf Version 1.21.0 aktualisiert werden microsoft.flux, damit sie auf die kommende Version aktualisieren können, die die Flux-API 2.7 einführt.

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/v1beta2
  • ImagePolicy bis image.toolkit.fluxcd.io/v1beta2
  • ImageUpdateAutomation bis image.toolkit.fluxcd.io/v1beta2

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.

April 2026 – microsoft.flux Version 1.21.0

Von Bedeutung

Wenn Sie keine automatischen Erweiterungen auf Ihrem Cluster aktualisiert haben, empfehlen wir dringend, ein manuelles Upgrade auf diese Version so schnell wie möglich durchzuführen. Cluster müssen Version 1.21.0 ausführen, um anschließend ein Upgrade auf eine bevorstehende Erweiterungsversion durchzuführen, die die Flux 2.7-API-Version enthält.

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.
  • Stellen Sie sicher, dass die Mandanten-ID- und Client-ID-Einstellungen der Workload-Identität in den Flux-Controller-Bereitstellungen korrekt wiedergegeben sind, wenn sie aktualisiert werden.
  • Einhaltung der Sicherheitsvorkehrungen für die automatische AKS-Bereitstellung.
  • 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.