Flux （GitOps） 扩展发行说明

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

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

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

弃用和移除通知：对 microsoft.flux 扩展程序的更改

在 microsoft.flux 扩展的 1.23.0 版本中，Flux 项目已弃用的若干上游 Flux API 已被移除。 这些更改符合 Flux 社区简化和现代化 API 图面的努力。

已删除以下 Flux API：

• 已弃用的 API 在组 source.toolkit.fluxcd.io/v1beta1 和 source.toolkit.fluxcd.io/v1beta2 中
• 已弃用的 API 在组 kustomize.toolkit.fluxcd.io/v1beta1 和 kustomize.toolkit.fluxcd.io/v1beta2 中
• 已弃用的 API 在组 helm.toolkit.fluxcd.io/v2beta1 和 helm.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.23.0，这会引入 Flux 2.7 API 版本。 如果群集运行的是 1.20.4 或更高版本，请先将其升级到临时版本（1.21.0 - 1.22.2），然后升级到版本 1.23.0。

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

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

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

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

2026 年 6 月 - microsoft.flux 版本 1.23.0

Flux 版本： 发布 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

此版本中的更改包括：

• 使用新的 CRD 和控制器将 Flux 扩展更新到 v2.7.5。 已删除许多 API 版本。 有关详细信息，请参阅 API 删除通知。
• 允许配置 Flux 控制器的 Helm 缓存、索引和抖动间隔百分比。
• 通过更新 Go 包和基本映像来解决fluxconfig-agent, fluxconfig-controller, fluent-bit-mdm, source-controllerkustomize-controller, notification-controller, image-automation-controller, image-reflector-controller和helm-controller中的安全漏洞。

2026 年 5 月 - microsoft.flux 版本 1.22.2

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

此版本中的更改包括：

• 通过更新 Go 包和基本映像来解决fluxconfig-agent, fluxconfig-controller, fluent-bit-mdm, source-controllerkustomize-controller, notification-controller, image-automation-controller, image-reflector-controller和helm-controller中的安全漏洞。

2026 年 5 月 - microsoft.flux 版本 1.22.1

Flux 版本：版本 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
• 图像自动化控制器：v0.41.2-14
• image-reflector-controller：v0.35.2-12

此版本中的更改包括：

• 通过更新 Go 包和基本映像来解决fluxconfig-agent, fluxconfig-controller, fluent-bit-mdm, source-controllerkustomize-controller, notification-controller, image-automation-controller, image-reflector-controller和helm-controller中的安全漏洞。
• 使 Flux 扩展 Pod 符合 Pod 安全标准要求。
• 在 WaitForReconciliation 和 fluxconfig-agent 中对 fluxconfig-controller 逻辑实施了设计改进，以解决预配状态会卡在 Failed 状态的问题。
• 在 source-controller 中添加了对 cosign 验证的支持。

2026 年 4 月 - microsoft.flux 版本 1.21.1

Flux 版本：版本 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
• 图像自动化控制器：v0.41.2-14
• image-reflector-controller：v0.35.2-12

此版本中的更改包括：

• 通过更新 Go 包和基本映像来解决fluxconfig-agent, fluxconfig-controller, fluent-bit-mdm, source-controllerkustomize-controller, notification-controller, image-automation-controller, image-reflector-controller和helm-controller中的安全漏洞。

2026 年 4 月 - microsoft.flux 版本 1.21.0

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-controller和helm-controller中的安全漏洞。
• Flux CRD 中已弃用 API 版本的 CR 已迁移至 etcd 存储。
• 优化日志减少fluxconfig-agent和fluxconfig-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-controller和helm-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。

相关内容

• 详细了解 Flux （GitOps） 扩展。
• 通过 本教程开始使用 Flux （GitOps） 扩展。