Flux (GitOps) 拡張機能のリリース ノート

Flux (GitOps) 拡張機能は、継続的に更新されます。 この記事では、拡張機能の最新リリースに関する情報を提供します。

Important

互換性を維持し、中断を回避するには、 非推奨の API への参照を削除するように ソースを更新し、クラスターで最新バージョンの拡張機能が実行されていることを確認します。

Flux (GitOps) 拡張機能の最新バージョンと、以前の 2 つのバージョン (N-2) がサポートされています。 一般的に、拡張機能の最新バージョンを使用することをお勧めします。

microsoft.flux拡張機能の新しいバージョンがリリースされると、新しいバージョンがすべてのリージョンで使用できるようになるまでに数日かかることがあります。

非推奨と削除に関する通知: microsoft.flux 拡張機能に対する今後の変更

Flux プロジェクトによって廃止されたいくつかのアップストリーム Flux API は、 microsoft.flux 拡張機能の今後のリリースで削除される予定です。 これらの変更は、API サーフェスを合理化および最新化するための Flux コミュニティの取り組みに沿うものです。

次の 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 にあります。
  • グループ notification.toolkit.fluxcd.io/v1beta1 内の非推奨の API
  • グループ image.toolkit.fluxcd.io/v1beta1 内の非推奨の API

詳細については、https://github.com/fluxcd/flux2/issues/5572を参照してください。

必要なアクション: 互換性を維持し、中断を回避するには、非推奨の API への参照をできるだけ早く削除するようにソースを更新します。 影響を受けるすべてのリソースに対して、サポートされている API バージョンを使用してください。 Flux 2.7 API バージョン microsoft.flux 導入される今後のリリースにアップグレードできるように、すべてのクラスターがバージョン 1.21.0 を使用するようにアップグレードされていることを確認します。

マニフェストの API バージョンを置き換えて、ソース (Git リポジトリ、OCI リポジトリ、バケット、BLOB ストレージ) 内のすべてのリソースを Flux 安定 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、および.Changed.ImageResultフィールドを使用する必要があることに注意してください。

ソースでマニフェストが更新されると、Flux によって新しい API バージョンが調整されます。

2026 年 4 月 - microsoft.flux バージョン 1.21.1

Important

クラスターで自動拡張機能をアップグレードしていない場合は、できるだけ早く手動でこのバージョンにアップグレードすることを強くお勧めします。 Flux 2.7 API バージョンを含む今後の拡張機能リリースにアップグレードするには、クラスターでバージョン 1.21.0 以降が実行されている必要があります。

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

このバージョンでの変更点は次のとおりです。

  • Go パッケージと基本イメージを更新することで、 fluxconfig-agentfluxconfig-controllerfluent-bit-mdmsource-controllerkustomize-controllernotification-controllerimage-automation-controllerimage-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-agentfluxconfig-controllerfluent-bit-mdmsource-controllerkustomize-controllernotification-controllerimage-automation-controllerimage-reflector-controller 、および helm-controller のセキュリティの脆弱性に対処しました。
  • 非推奨の API バージョンを持つ Flux CRD について、etcd ストレージ内の CR を移行。
  • fluxconfig-agentfluxconfig-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
  • notification-controller: v1.6.0-9
  • image-automation-controller: v0.41.2-10
  • image-reflector-controller: v0.35.2-9

このバージョンでの変更点は次のとおりです。

  • Go パッケージと基本イメージを更新することで、 fluxconfig-agentfluxconfig-controllerfluent-bit-mdmsource-controllerkustomize-controllernotification-controllerimage-automation-controllerimage-reflector-controller 、および helm-controller のセキュリティの脆弱性に対処しました。
  • 通知コントローラーのワークロード ID のサポート。
  • 更新時に、ワークロード ID テナント ID とクライアント ID の設定が Flux コントローラーのデプロイに正しく反映されていることを確認します。
  • AKS 自動のデプロイ セーフガードへの遵守状況。
  • Flux コントローラーに対するオブジェクト レベルのワークロード ID のサポート。

2026 年 2 月 - microsoft.flux バージョン 1.19.5

Flux バージョン: リリース v2.6.4

  • source-controller: v1.6.4
  • kustomize-controller: バージョン1.6.1
  • helm-controller: v1.3.2
  • ノーティフィケーションコントローラー: v1.6.0
  • image-automation-controller: v0.41.2
  • image-reflector-controller: v0.35.2

このバージョンでの変更点は次のとおりです。

  • Go パッケージと基本イメージを更新することで、 fluxconfig-agentfluxconfig-controllerfluent-bit-mdmsource-controller、および helm-controller のセキュリティの脆弱性に対処しました。