Flux (GitOps) 扩展发行说明

Flux (GitOps) 扩展会持续更新。 本文提供有关扩展的最新版本的信息。

Important

若要确保持续兼容性并避免中断,请更新源以 删除对已弃用 API 的引用 ,并确保群集正在运行最新版本的扩展。

支持 Flux (GitOps) 扩展的最新版本 和两个以前的版本 (N-2)。 我们通常建议使用最新版本的扩展。

发布新版本的 microsoft.flux 扩展后,新版本可能需要几天才能在所有区域中可用。

弃用和删除通知:即将对扩展的 microsoft.flux 更改

即将发布的扩展版本中将删除 Flux 项目已停用的 microsoft.flux 多个上游 Flux API。 这些更改符合 Flux 社区简化和现代化 API 图面的努力。

以下 Flux API 即将弃用,将被删除:

  • 已弃用的 API 在组 source.toolkit.fluxcd.io/v1beta1source.toolkit.fluxcd.io/v1beta2
  • 已弃用的 API 在组 kustomize.toolkit.fluxcd.io/v1beta1kustomize.toolkit.fluxcd.io/v1beta2
  • 已弃用的 API 在组 helm.toolkit.fluxcd.io/v2beta1helm.toolkit.fluxcd.io/v2beta2
  • 该组中的已弃用 API notification.toolkit.fluxcd.io/v1beta1
  • 该组中的已弃用 API image.toolkit.fluxcd.io/v1beta1

有关详细信息,请参阅 https://github.com/fluxcd/flux2/issues/5572

所需操作: 为了确保持续兼容性并避免中断,请更新源以尽快删除对已弃用 API 的引用。 对所有受影响的资源使用支持的 API 版本。 确保所有群集都升级为使用 microsoft.flux 版本 1.21.0,以便它们能够升级到即将推出的引入 Flux 2.7 API 版本的版本。

将您所有的资源迁移到源中的 Flux 稳定 API 中(Git 存储库、OCI 存储库、存储桶、Blob 存储),具体做法是替换清单中的 API 版本:

  • Kustomizationkustomize.toolkit.fluxcd.io/v1
  • HelmReleasehelm.toolkit.fluxcd.io/v2
  • Bucketsource.toolkit.fluxcd.io/v1
  • GitRepositorysource.toolkit.fluxcd.io/v1
  • HelmChartsource.toolkit.fluxcd.io/v1
  • HelmRepositorysource.toolkit.fluxcd.io/v1
  • OCIRepositorysource.toolkit.fluxcd.io/v1
  • Receivernotification.toolkit.fluxcd.io/v1
  • Alertnotification.toolkit.fluxcd.io/v1beta3
  • Providernotification.toolkit.fluxcd.io/v1beta3
  • ImageRepositoryimage.toolkit.fluxcd.io/v1beta2
  • ImagePolicyimage.toolkit.fluxcd.io/v1beta2
  • ImageUpdateAutomationimage.toolkit.fluxcd.io/v1beta2

请注意,ImageUpdateAutomation 提交模板应使用字段 .Changed.FileChanges.Changed.Objects,而不是已弃用的 .Changed.Changes.Updated 字段。

在源中更新清单后,Flux 将协调新的 API 版本。

2026 年 4 月 - microsoft.flux 版本 1.21.0

Important

如果没有在群集上升级自动扩展,强烈建议尽快手动升级到此版本。 群集必须运行版本 1.21.0,才能随后升级到即将推出的扩展版本,其中包含 Flux 2.7 API 版本。

Flux 版本:版本 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

此版本中的更改包括:

  • 通过更新 Go 包和基本映像来解决fluxconfig-agent, fluxconfig-controller, fluent-bit-mdm, source-controllerkustomize-controller, notification-controller, image-automation-controller, image-reflector-controllerhelm-controller中的安全漏洞。
  • Flux CRD 中已弃用 API 版本的 CR 已迁移至 etcd 存储。
  • 优化日志减少fluxconfig-agentfluxconfig-controller的日志占用。

2026 年 3 月 - microsoft.flux 版本 1.20.4

Flux 版本:版本 v2.6.4

  • source-controller:v1.6.4-7
  • kustomize-controller: v1.6.1-10
  • helm-controller:v1.3.2-5
  • 通知控制器:v1.6.0-9
  • image-automation-controller:v0.41.2-10
  • image-reflector-controller:v0.35.2-9

此版本中的更改包括:

  • 通过更新 Go 包和基本映像来解决fluxconfig-agent, fluxconfig-controller, fluent-bit-mdm, source-controllerkustomize-controller, notification-controller, image-automation-controller, image-reflector-controllerhelm-controller中的安全漏洞。
  • 通知控制器的工作负载身份支持。
  • 确保工作负载身份的租户 ID 和客户端 ID 设置在更新时能在 Flux 控制器部署中得到正确反映。
  • 自动符合 AKS 部署保护机制。
  • Flux 控制器的对象级工作负荷标识支持。

2026 年 2 月 - microsoft.flux 版本 1.19.5

Flux 版本:版本 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

此版本中的更改包括:

  • 通过更新 Go 包和基础映像,解决了安全漏洞fluxconfig-agentfluxconfig-controllerfluent-bit-mdmsource-controllerhelm-controller