# Flux v2.7.5

2025-11-27 · [元のリリースノート](https://github.com/fluxcd/flux2/releases/tag/v2.7.5) · [全体のまとめ](https://ratatosk.io/ja/releases/flux/v2.7.5)

破壊的変更 4 · 重大な修正 2 · 機能・改善 4

## アップグレード前の確認事項

### 既知の問題

- **source-controllerのOCI署名検証におけるCosign v3の非対応**: このリリースノートでは、Flux v2.8でCosign v3のサポートが追加されるまで、FluxのOCIアーティファクトとHelmチャートの署名にCosign v2.6を使用することを推奨しています。
  > :warning: Note that signature verification for OCI artifacts in source-controller is not compatible with Cosign v3.
  > Flux users are advised to use [Cosign v2.6](https://fluxcd.io/flux/flux-gh-action/#push-and-sign-kubernetes-manifests-to-container-registries) for signing Flux OCI artifacts and Helm charts, until support for Cosign v3 is added in Flux v2.8.

### アップグレードガイド

- **非推奨のベータ API を段階的に廃止するための Flux v2.7 以降へのアップグレード手順**
  > ℹ️ Please follow the [Upgrade Procedure for Flux v2.7+](https://github.com/fluxcd/flux2/discussions/5572) for a smooth upgrade from Flux v2.6 to the latest version.

  - Flux v2.6 から最新バージョンへのアップグレードガイド
  - Flux CLI を使ったクラスターの手動移行
  - Flux Operator を使ったクラスター自動移行ガイド
  - Flux v2.9での`image.toolkit.fluxcd.io/v1beta2` APIと`notification.toolkit.fluxcd.io/v1beta2` APIの削除: 両APIは2024年に非推奨となり、2026年第2四半期にライフサイクルを終了します。
  - Flux CLI のアップグレード手順
  - Flux リソースの v2.6 安定版 API への移行: リポジトリ全体で `flux migrate -v 2.6 -f .` を実行して移行し、その後、変更をコミットしてプッシュします。
  - Flux カスタムリソースを最新の API バージョンへ移行するためのガイド
  - イメージ更新自動化の定義の移行: リリースノートでは、`flux migrate -v 2.8 -f .` を使って定義を最新の安定版に移行し、その変更をコミットしてプッシュすることを推奨しています。
  - Flux v2.6 安定版 API への移行手順

## 破壊的変更 (4)

### Fluxによる非推奨ベータAPIバージョン5種の削除

- 影響対象: `source.toolkit.fluxcd.io/v1beta1`、`kustomize.toolkit.fluxcd.io/v1beta1`、`helm.toolkit.fluxcd.io/v2beta1`、`image.toolkit.fluxcd.io/v1beta1`、または `notification.toolkit.fluxcd.io/v1beta1` を使用するマニフェスト、保存済みリソース、またはクライアント (推定)

これらのAPIバージョンは2023年に非推奨となりました。直前のリリースでFluxが引き続き提供または受け入れていたかどうかは、リリースノートに記載されていません。

> In Flux v2.7, the following deprecated API versions have been removed:
> - `source.toolkit.fluxcd.io/v1beta1`
> - `kustomize.toolkit.fluxcd.io/v1beta1`
> - `helm.toolkit.fluxcd.io/v2beta1`
> - `image.toolkit.fluxcd.io/v1beta1`
> - `notification.toolkit.fluxcd.io/v1beta1`
> > The beta1 API were deprecated in 2023 and have reached their end-of-life.

https://github.com/fluxcd/flux2/discussions/5572

### Flux v2.10 での Alert `spec.summary` の削除

- 影響対象: `spec.summary` を使用する Alert リソース (推定)

代替として、`notification.toolkit.fluxcd.io/v1` の `spec.eventMetadata.summary` が挙げられています。

> - Alert `spec.summary` (replaced by `spec.eventMetadata.summary` in `notification.toolkit.fluxcd.io/v1`)

https://github.com/fluxcd/flux2/discussions/5572

### Provider の `spec.proxy` の削除

- 影響対象: `spec.proxy` を使用する Provider リソースを含む Flux の構成 (推定)

> - Provider `spec.proxy` (replaced by `spec.proxySecretRef` in `notification.toolkit.fluxcd.io/v1`)

https://github.com/fluxcd/flux2/discussions/5572

### Provider の `spec.interval` の削除

- 影響対象: `spec.interval` を指定する Provider リソース (推定)
- 必要な対応: Flux CLI v2.9.0 以降の使用、Git リソースの Flux v2.6 安定版 API への移行と reconcile、Kubernetes etcd 内の Flux カスタムリソースの移行、続いて Flux コンポーネントを v2.9 にアップグレード

このフィールドは使用されていなかったとリリースノートに記載されています。

> - Provider `spec.interval` (unused)

https://github.com/fluxcd/flux2/discussions/5572

## 重大な修正 (2)

### HelmRelease 履歴の切り詰めを修正

- 影響対象: `RetryOnFailure` 戦略を使用する HelmRelease

このリリース以前は、HelmRelease の履歴が途中で切り詰められていました。

> - Fix HelmRelease history truncation when using the `RetryOnFailure` strategy.

### HelmRelease のリトライ履歴の切り詰めを修正

- 影響対象: `RetryOnFailure` 戦略を使用する HelmRelease リソース

リトライ処理が有効な場合、`.status.history` が増え続けて etcd の容量を使い切る可能性がありました。リトライ中は、履歴をバージョンの降順で並べた最新5件のスナップショットに切り詰めるようになりました。

> - helm-controller [v1.4.5](https://github.com/fluxcd/helm-controller/blob/v1.4.5/CHANGELOG.md)
> Fixes:
> - Fix HelmRelease history truncation when using the `RetryOnFailure` strategy.
> Fixes:
> - Fix history truncation logic for RetryOnFailure
>   [#1360](https://github.com/fluxcd/helm-controller/pull/1360)

## 機能・改善 (4)

- Flux CLI の Helm-controller 依存関係とマニフェストを `v1.4.5` に更新
- 新しい `source-watcher` コンポーネント (利用条件: `--components-extra=source-watcher` フラグ)
- Flux Operator による FluxInstance の Flux 2.9 へのアップグレード (利用条件: `spec.distribution.version` の `2.9.x` への設定（`source-watcher` の有効化は任意）)
- `source-watcher` コンポーネントの任意有効化 (利用条件: Flux 2.9、および `FluxInstance` の `components` リストへの `source-watcher` の追加)

---

整理した内容は AI が作成するため誤っている可能性があり、無保証で提供されます。
