Notas de lançamento da extensão Flux (GitOps)

A extensão Flux (GitOps) é atualizada de forma contínua. Este artigo fornece informações sobre as versões mais recentes da extensão.

A versão mais recente da extensão Flux (GitOps) e as duas versões anteriores (N-2) são suportadas. Geralmente, recomendamos que você use a versão mais recente da extensão.

Quando uma nova versão da microsoft.flux extensão é lançada, pode demorar vários dias até a nova versão estar disponível em todas as regiões.

Aviso de descontinuação e remoção: Próximas alterações da extensão microsoft.flux

Várias APIs upstream do Flux que foram retiradas pelo projeto Flux serão removidas nas próximas versões da microsoft.flux extensão. Essas mudanças se alinham com os esforços da comunidade Flux para simplificar e modernizar a superfície da API.

As seguintes APIs do Flux estão sendo preteridas e serão removidas:

• APIs obsoletas no grupo source.toolkit.fluxcd.io/v1beta1 e source.toolkit.fluxcd.io/v1beta2
• APIs obsoletas no grupo kustomize.toolkit.fluxcd.io/v1beta1 e kustomize.toolkit.fluxcd.io/v1beta2
• APIs obsoletas no grupo helm.toolkit.fluxcd.io/v2beta1 e helm.toolkit.fluxcd.io/v2beta2
• APIs preteridas no grupo notification.toolkit.fluxcd.io/v1beta1
• APIs preteridas no grupo image.toolkit.fluxcd.io/v1beta1

Para obter mais informações, veja https://github.com/fluxcd/flux2/issues/5572.

Ação obrigatória: Para garantir a compatibilidade contínua e evitar interrupções, atualize as suas fontes para remover referências a APIs obsoletas o mais rapidamente possível. Use as versões de API suportadas para todos os recursos afetados. Certifique-se de que todos os clusters são atualizados para usar microsoft.flux a versão 1.21.0, para que possam atualizar para a próxima versão que introduz a versão da API Flux 2.7.

Migre todos os seus recursos para as APIs estáveis do Flux em seus códigos-fonte (repositórios Git, repositórios OCI, buckets, armazenamento de blobs) substituindo a versão da API nos manifestos:

• 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

Observe que o ImageUpdateAutomation modelo de confirmação deve usar os campos .Changed.FileChanges, .Changed.Objects e .Changed.Changes em vez dos campos preteridos .Updated e .Changed.ImageResult.

Assim que os manifestos forem atualizados nas fontes, o Flux reconciliará as novas versões da API.

Abril 2026 - microsoft.flux versão 1.21.1

Versão Flux: Release v2.6.4

• Source-Controller: v1.6.4-13
• kustomize-controller: v1.6.1-15
• Comando do Helm: v1.3.2-8
• controlador-notificações: v1.6.0-12
• Controlador-automação-de imagem: v0.41.2-14
• Controlador refletor de imagem: V0.35.2-12

As alterações nesta versão incluem:

• Resolveu vulnerabilidades de segurança em fluxconfig-agent, fluxconfig-controller, fluent-bit-mdm, source-controllerkustomize-controller, notification-controller, image-automation-controller, , e image-reflector-controllerhelm-controller atualizando os pacotes Go e as imagens base.

Abril de 2026 - microsoft.flux versão 1.21.0

Versão Flux: Release v2.6.4

• Controlador de Origem: v1.6.4-8
• kustomize-controller: v1.6.1-11
• helm-controller: v1.3.2-6
• controlador-notificações: v1.6.0-10
• controlador-de-automaçao-de-imagem: v0.41.2-11
• Controlador de refletor de imagem: v0.35.2-10

As alterações nesta versão incluem:

• Resolveu vulnerabilidades de segurança em fluxconfig-agent, fluxconfig-controller, fluent-bit-mdm, source-controllerkustomize-controller, notification-controller, image-automation-controller, , e image-reflector-controllerhelm-controller atualizando os pacotes Go e as imagens base.
• CRs migrados no armazenamento etcd para CRDs do Flux que usam versões descontinuadas da API.
• Otimizou o registo para reduzir a pegada de registo em fluxconfig-agent e fluxconfig-controller.

Março de 2026 - microsoft.flux versão 1.20.4

Versão Flux: Release v2.6.4

• controlador-fonte: v1.6.4-7
• kustomize-controller: v1.6.1-10
• Helm-Controller: v1.3.2-5
• controlador-notificações: v1.6.0-9
• Controlador de automação de imagem: v0.41.2-10
• Controlador-refletor de imagem: v0.35.2-9

As alterações nesta versão incluem:

• Resolveu vulnerabilidades de segurança em fluxconfig-agent, fluxconfig-controller, fluent-bit-mdm, source-controllerkustomize-controller, notification-controller, image-automation-controller, , e image-reflector-controllerhelm-controller atualizando os pacotes Go e as imagens base.
• Suporte à identidade de carga de trabalho para o controlador de notificações.
• Garantir que as definições de ID de identidade de carga de trabalho, ID do tenant e ID do cliente estejam corretamente refletidas nas implementações do controlador Flux quando atualizadas.
• Conformidade com as salvaguardas de implementação automática para o AKS.
• Suporte à identidade de carga de trabalho ao nível do objeto para controladores Flux.

Fevereiro de 2026 - microsoft.flux versão 1.19.5

Versão Flux: Release v2.6.4

• Controlador de Origem: v1.6.4
• Kustomize-controller: v1.6.1
• Helm-Controller: v1.3.2
• Controlador-Notificação: v1.6.0
• Imagem-Automação-Controlador: V0.41.2
• imagem-refletor-controlador: v0.35.2

As alterações nesta versão incluem:

• Corrigiu vulnerabilidades de segurança em fluxconfig-agent, fluxconfig-controller, fluent-bit-mdm, source-controller, e helm-controller atualizando os pacotes Go e as imagens base.

Conteúdo relacionado

• Saiba mais sobre a extensão Flux (GitOps).
• Comece a usar a extensão Flux (GitOps) usando o nosso tutorial.