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 imminenti all'estensione microsoft.flux

Diverse API Flux upstream ritirate dal progetto Flux verranno rimosse nelle prossime versioni dell'estensione microsoft.flux . Queste modifiche sono allineate agli sforzi della community di Flux per semplificare e modernizzare la superficie dell'API.

Le API Flux seguenti sono deprecate e verranno rimosse:

• 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 nel gruppo notification.toolkit.fluxcd.io/v1beta1
• API deprecate nel gruppo image.toolkit.fluxcd.io/v1beta1

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. Usare le versioni api supportate per tutte le risorse interessate. Assicurarsi che tutti i cluster vengano aggiornati per usare microsoft.flux la versione 1.21.0 in modo che possano eseguire l'aggiornamento alla versione futura che introduce la versione dell'API Flux 2.7.

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

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.

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.