# Flux v2.7.5

2025-11-27 · [릴리스 노트 원문](https://github.com/fluxcd/flux2/releases/tag/v2.7.5) · [전체 정리](https://ratatosk.io/ko/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` 및 `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` 제거

- 영향 대상: Provider 리소스에서 `spec.proxy`를 사용하는 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로 마이그레이션한 뒤 리컨실, 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를 통한 Flux 2.9 업그레이드 (사용 조건: `spec.distribution.version`을 `2.9.x`로 설정; `source-watcher` 활성화는 선택 사항)
- 선택적 `source-watcher` 컴포넌트 활성화 (사용 조건: Flux 2.9 및 `FluxInstance`의 `components` 목록에 `source-watcher` 포함)

---

정리 내용은 AI가 작성하므로 틀릴 수 있으며, 보증 없이 제공합니다.
