Note sulla versione dell'estensione Flux (GitOps)

L'estensione Flux (GitOps) viene aggiornata regolarmente. Questo articolo fornisce informazioni sulle versioni più recenti dell'estensione.

Sono supportate la versione più recente dell'estensione Flux (GitOps) e le due versioni precedenti (N-2). In genere è consigliabile usare la versione più recente dell'estensione.

Quando viene rilasciata una nuova versione dell'estensione microsoft.flux , la disponibilità della nuova versione in tutte le aree può richiedere diversi giorni.

Avviso di deprecazione e rimozione: Modifiche all'estensione microsoft.flux

Le API Flux seguenti sono state rimosse nelle versioni upstream Flux 2,7, 2.8 e 2.9:

• API deprecate in gruppo source.toolkit.fluxcd.io/v1beta1 e source.toolkit.fluxcd.io/v1beta2
• API deprecate in gruppo kustomize.toolkit.fluxcd.io/v1beta1 e kustomize.toolkit.fluxcd.io/v1beta2
• API deprecate in gruppo helm.toolkit.fluxcd.io/v2beta1 e helm.toolkit.fluxcd.io/v2beta2
• API deprecate in gruppo notification.toolkit.fluxcd.io/v1beta1 e notification.toolkit.fluxcd.io/v1beta2
• API deprecate in gruppo image.toolkit.fluxcd.io/v1beta1 e image.toolkit.fluxcd.io/v1beta2

Per altre informazioni, vedere https://github.com/fluxcd/flux2/issues/5572.

Azione richiesta: Per garantire la compatibilità continua ed evitare interruzioni, aggiornare le origini per rimuovere i riferimenti alle API deprecate il prima possibile. Se i cluster eseguono la versione 1.20.4 o precedente, aggiornateli prima a una versione intermedia (1.21.0 - 1.22.2) e quindi alla versione 1.23.0.

Eseguire la migrazione di tutte le risorse alle API stabili Flux nelle origini (repository Git, repository OCI, bucket, archiviazione BLOB) sostituendo la versione dell'API nei manifesti:

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

Si noti che il ImageUpdateAutomation modello di commit deve usare i campi .Changed.FileChanges, .Changed.Objects e .Changed.Changes anziché i campi .Updated e .Changed.ImageResult deprecati.

Dopo aver aggiornato i manifesti nelle origini, Flux riconcilia le nuove versioni dell'API.

Agosto 2026 - microsoft.flux versione 1.25.0

Versione Flux: Rilascio v2.8.8

• source-controller: v1.8.5-3
• kustomize-controller: v1.8.5-2
• helm-controller: v1.5.5-2
• notification-controller: v1.8.4-3
• image-automation-controller: v1.1.4-2
• image-reflector-controller: v1.1.2-2

Le modifiche apportate a questa versione includono:

• Aggiornata l'estensione Flux alla versione upstream di Flux v2.8.8. Questo aggiornamento porta helm-controller da Helm v3 a Helm v4, modificando alcuni comportamenti predefiniti, tra cui l'uso di server-side apply e dei controlli di integrità basati su kstatus. Per altre informazioni, vedere Supporto di Helm v4 nelle note sulla versione upstream Flux v2.8.0. Per ripristinare il comportamento predefinito helm v3, abilitare l'impostazione come descritto in Ripristinare il useHelm3Defaultscomportamento predefinito helm v3.
• È stato aggiunto al chart azure-k8s-flux un pass-through generico per i controlli di funzionalità, che consente la configurazione di consenso esplicito dei controlli di funzionalità dei controller Flux upstream.
• Aggiunto il supporto per la configurazione di --override-manager su helm-controller.
• È stata rafforzata la sicurezza del chart dell'estensione Flux aggiungendo controlli di tipo (quote, int) ai valori interpolati nei modelli dei controller.
• Sono stati risolti i problemi di sicurezza in fluxconfig-agent, fluxconfig-controllerfluent-bit-mdmsource-controllerkustomize-controllernotification-controllerimage-automation-controller, image-reflector-controller, e helm-controller aggiornando i pacchetti Go e le immagini di base.

Agosto 2026 - microsoft.flux versione 1.24.1

Versione Flux: Release v2.7.5

• source-controller: v1.7.4-23
• kustomize-controller: v1.7.3-17
• helm-controller: v1.4.5-16
• notification-controller: v1.7.5-15
• image-automation-controller: v1.0.4-16
• image-reflector-controller: v1.0.4-13

Le modifiche apportate a questa versione includono:

• Impostare le API image v1 come versione di archiviazione.
• Aggiungi la notazione al CRD fluxconfig.
• Sono stati risolti i problemi di sicurezza in fluxconfig-agent, fluxconfig-controllerfluent-bit-mdmsource-controllerkustomize-controllernotification-controllerimage-automation-controller, image-reflector-controller, e helm-controller aggiornando i pacchetti Go e le immagini di base.

Luglio 2026 - microsoft.flux versione 1.24.0

Versione Flux: Release v2.7.5

• source-controller: v1.7.4-20
• kustomize-controller: v1.7.3-15
• helm-controller: v1.4.5-15
• notification-controller: v1.7.5-13
• image-automation-controller: v1.0.4-15
• image-reflector-controller: v1.0.4-12

Le modifiche apportate a questa versione includono:

• Abilitare la memorizzazione nella cache del client di notazione ORAS nella source-controller versione 1.7.4.
• Miglioramento della configurazione dell'estensione per specificare i field manager a cui non è consentito apportare modifiche alle risorse gestite tramite override-manager in kustomize-controller.
• Ripristinati i CRD 2.7 per consentire l'aggiornamento dei cluster che usano API Flux deprecate o rimosse.
• Sono stati risolti i problemi di sicurezza in fluxconfig-agent, fluxconfig-controllerfluent-bit-mdmsource-controllerkustomize-controllernotification-controllerimage-automation-controller, image-reflector-controller, e helm-controller aggiornando i pacchetti Go e le immagini di base.

Luglio 2026 - microsoft.flux versione 1.23.3

Versione Flux: Release v2.7.5

• source-controller: v1.7.4-16
• kustomize-controller: v1.7.3-13
• helm-controller: v1.4.5-13
• notification-controller: v1.7.5-11
• image-automation-controller: v1.0.4-13
• image-reflector-controller: v1.0.4-10

Le modifiche apportate a questa versione includono:

• Sono stati risolti i problemi di sicurezza in fluxconfig-agent, fluxconfig-controllerfluent-bit-mdmsource-controllerkustomize-controllernotification-controllerimage-automation-controller, image-reflector-controller, e helm-controller aggiornando i pacchetti Go e le immagini di base.

Giugno 2026 - microsoft.flux versione 1.23.1

Versione Flux: Release v2.7.5

• source-controller: v1.7.4-13
• kustomize-controller: v1.7.3-12
• helm-controller: v1.4.5-11
• notification-controller: v1.7.5-10
• image-automation-controller: v1.0.4-12
• image-reflector-controller: v1.0.4-9

Le modifiche apportate a questa versione includono:

• Sono stati risolti i problemi di sicurezza in fluxconfig-agent, fluxconfig-controllerfluent-bit-mdmsource-controllerkustomize-controllernotification-controllerimage-automation-controller, image-reflector-controller, e helm-controller aggiornando i pacchetti Go e le immagini di base.

Giugno 2026 - microsoft.flux versione 1.23.0

Versione Flux: Release 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

Le modifiche apportate a questa versione includono:

• L'estensione Flux si aggiorna alla versione 2.7.5 con nuovi CRD e controller. Sono state rimosse diverse versioni dell'API. Per altre informazioni, vedere l'avviso di rimozione dell'API.
• Consente di configurare la cache Helm, l'indice e la percentuale di intervallo di instabilità dei controller Flux.
• Sono stati risolti i problemi di sicurezza in fluxconfig-agent, fluxconfig-controllerfluent-bit-mdmsource-controllerkustomize-controllernotification-controller, image-automation-controllere image-reflector-controllerhelm-controller aggiornando i pacchetti Go e le immagini di base.

Maggio 2026 - microsoft.flux versione 1.22.2

Versione Flux: versione 2.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

Le modifiche apportate a questa versione includono:

• Sono stati risolti i problemi di sicurezza in fluxconfig-agent, fluxconfig-controllerfluent-bit-mdmsource-controllerkustomize-controllernotification-controller, image-automation-controllere image-reflector-controllerhelm-controller aggiornando i pacchetti Go e le immagini di base.

Maggio 2026 - microsoft.flux versione 1.22.1

Versione Flux: versione 2.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
• image-automation-controller: v0.41.2-14
• image-reflector-controller: v0.35.2-12

Le modifiche apportate a questa versione includono:

• Sono stati risolti i problemi di sicurezza in fluxconfig-agent, fluxconfig-controllerfluent-bit-mdmsource-controllerkustomize-controllernotification-controller, image-automation-controllere image-reflector-controllerhelm-controller aggiornando i pacchetti Go e le immagini di base.
• Ha reso i pod di estensione Flux conformi agli standard di sicurezza dei pod.
• Sono state implementate migliorie alla progettazione per la logica WaitForReconciliation in fluxconfig-agent e fluxconfig-controller per risolvere i bug per cui lo stato di provisioning rimaneva bloccato nello stato Failed.
• Aggiunto il supporto per la verifica di cosign in source-controller.

Aprile 2026 - microsoft.flux versione 1.21.1

Versione Flux: versione 2.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

Le modifiche apportate a questa versione includono:

• Sono stati risolti i problemi di sicurezza in fluxconfig-agent, fluxconfig-controllerfluent-bit-mdmsource-controllerkustomize-controllernotification-controller, image-automation-controllere image-reflector-controllerhelm-controller aggiornando i pacchetti Go e le immagini di base.

Aprile 2026 - microsoft.flux versione 1.21.0

Versione Flux: versione 2.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

Le modifiche apportate a questa versione includono:

• Sono stati risolti i problemi di sicurezza in fluxconfig-agent, fluxconfig-controllerfluent-bit-mdmsource-controllerkustomize-controllernotification-controller, image-automation-controllere image-reflector-controllerhelm-controller aggiornando i pacchetti Go e le immagini di base.
• CR migrati nell'archiviazione etcd per i CRD Flux con versioni API deprecate.
• Registrazione ottimizzata per ridurre l'impatto della registrazione in fluxconfig-agent e fluxconfig-controller.

Marzo 2026 - microsoft.flux versione 1.20.4

Versione Flux: versione 2.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

Le modifiche apportate a questa versione includono:

• Sono stati risolti i problemi di sicurezza in fluxconfig-agent, fluxconfig-controllerfluent-bit-mdmsource-controllerkustomize-controllernotification-controller, image-automation-controllere image-reflector-controllerhelm-controller aggiornando i pacchetti Go e le immagini di base.
• Supporto dell'identità del carico di lavoro per il controller di notifica.
• Assicurarsi che le impostazioni dell'ID tenant e dell'ID client dell'identità del carico di lavoro siano riflesse correttamente nelle distribuzioni del controller Flux quando queste vengono aggiornate.
• Conformità alle protezioni di distribuzione per AKS automatico.
• Supporto delle identità del carico di lavoro a livello di oggetto per i controller Flux.

Febbraio 2026 - microsoft.flux versione 1.19.5

Versione Flux: versione 2.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

Le modifiche apportate a questa versione includono:

• Sono stati risolti i problemi di sicurezza in fluxconfig-agent, fluxconfig-controllerfluent-bit-mdm, source-controller, e helm-controller aggiornando i pacchetti Go e le immagini di base.

Contenuti correlati

• Altre informazioni sull'estensione Flux (GitOps).
• Inizia con l'estensione Flux (GitOps) usando il nostro tutorial.