Notas de la versión de la extensión Flux (GitOps)

La extensión Flux (GitOps) se actualiza de forma continua. En este artículo se proporciona información sobre las versiones más recientes de la extensión.

Importante

Para garantizar la compatibilidad continua y evitar interrupciones, actualice los orígenes para quitar las referencias a las API en desuso y asegúrese de que los clústeres ejecutan la versión más reciente de la extensión.

Se admite la versión más reciente de la extensión Flux (GitOps) y las dos versiones anteriores (N-2). Por lo general, se recomienda usar la versión más reciente de la extensión.

Cuando se publica una nueva versión de la microsoft.flux extensión, la nueva versión puede tardar varios días en estar disponible en todas las regiones.

Aviso de obsolescencia y eliminación: Próximos cambios en la extensión microsoft.flux

Varias API de Flux de nivel superior que han sido retiradas por el proyecto Flux se eliminarán en las próximas versiones de la extensión microsoft.flux. Estos cambios se alinean con los esfuerzos de la comunidad de Flux para simplificar y modernizar la superficie de API.

Las siguientes API de Flux están en desuso y se quitarán:

  • APIs en desuso en los grupos source.toolkit.fluxcd.io/v1beta1 y source.toolkit.fluxcd.io/v1beta2
  • APIs en desuso en los grupos kustomize.toolkit.fluxcd.io/v1beta1 y kustomize.toolkit.fluxcd.io/v1beta2
  • APIs en desuso en los grupos helm.toolkit.fluxcd.io/v2beta1 y helm.toolkit.fluxcd.io/v2beta2
  • API en desuso en el grupo notification.toolkit.fluxcd.io/v1beta1
  • API en desuso en el grupo image.toolkit.fluxcd.io/v1beta1

Para obtener más información, consulte https://github.com/fluxcd/flux2/issues/5572.

Acción necesaria: Para garantizar la compatibilidad continua y evitar interrupciones, actualice los orígenes para quitar las referencias a las API en desuso lo antes posible. Use las versiones de API admitidas para todos los recursos afectados. Asegúrese de que todos los clústeres se actualicen para usar microsoft.flux la versión 1.21.0 para que puedan actualizar a la próxima versión que presenta la versión de la API flux 2.7.

Migre todos los recursos a las API estables de Flux en los orígenes (repositorios de Git, repositorios de OCI, cubos, almacenamiento de blobs) reemplazando la versión de API en los manifiestos.

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

Tenga en cuenta que la ImageUpdateAutomation plantilla de confirmación debe usar los campos .Changed.FileChanges, .Changed.Objects y .Changed.Changes, en lugar de los campos .Updated y .Changed.ImageResult en desuso.

Una vez actualizados los manifiestos en los orígenes, Flux reconciliará las nuevas versiones de API.

Abril de 2026: microsoft.flux versión 1.21.1

Importante

Si no tiene extensiones automáticas actualizadas en el clúster, se recomienda encarecidamente actualizar manualmente a esta versión lo antes posible. Los clústeres deben ejecutar la versión 1.21.0 o posterior para actualizar posteriormente a una próxima versión de extensión que incluirá la versión de la API flux 2.7.

Versión de Flux: Lanzamiento 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

Los cambios en esta versión incluyen:

  • Se han solucionado las vulnerabilidades de seguridad en fluxconfig-agent, , fluxconfig-controllerfluent-bit-mdm,source-controllerkustomize-controllernotification-controller , , image-automation-controllery image-reflector-controllerhelm-controller actualizando los paquetes de Go e imágenes base.

Abril de 2026: microsoft.flux versión 1.21.0

Versión de Flux: Lanzamiento 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

Los cambios en esta versión incluyen:

  • Se han solucionado las vulnerabilidades de seguridad en fluxconfig-agent, , fluxconfig-controllerfluent-bit-mdm,source-controllerkustomize-controllernotification-controller , , image-automation-controllery image-reflector-controllerhelm-controller actualizando los paquetes de Go e imágenes base.
  • CR migradas almacenadas en etcd para solicitudes de cambio de Flux que tienen versiones de API en desuso.
  • Registro optimizado para reducir la huella de registro en fluxconfig-agent y fluxconfig-controller.

Marzo de 2026: microsoft.flux versión 1.20.4

Versión de Flux: Lanzamiento 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

Los cambios en esta versión incluyen:

  • Se han solucionado las vulnerabilidades de seguridad en fluxconfig-agent, , fluxconfig-controllerfluent-bit-mdm,source-controllerkustomize-controllernotification-controller , , image-automation-controllery image-reflector-controllerhelm-controller actualizando los paquetes de Go e imágenes base.
  • Compatibilidad con identidades de cargas de trabajo para el controlador de notificaciones.
  • Asegúrese de que los valores para los identificadores del inquilino y el cliente de la identidad de carga de trabajo se reflejen correctamente en las implementaciones del controlador de Flux cuando se actualicen.
  • Cumplimiento de las salvaguardias de implementación para AKS de forma automática.
  • Compatibilidad de identidades de carga de trabajo a nivel de objeto para controladores Flux.

Febrero de 2026: microsoft.flux versión 1.19.5

Versión de Flux: Lanzamiento v2.6.4

  • source-controller: v1.6.4
  • kustomize-controller: v1.6.1
  • helm-controller: v1.3.2
  • controlador de notificaciones: v1.6.0
  • image-automation-controller: v0.41.2
  • image-reflector-controller: v0.35.2

Los cambios en esta versión incluyen:

  • Se han solucionado las vulnerabilidades de seguridad en fluxconfig-agent, fluxconfig-controller, fluent-bit-mdm, source-controllery helm-controller actualizando los paquetes de Go e imágenes base.