Flux(GitOps) 확장 릴리스 정보

Flux(GitOps) 확장은 지속적으로 업데이트됩니다. 이 문서에서는 확장의 최신 릴리스에 대한 정보를 제공합니다.

중요합니다

지속적인 호환성을 보장하고 중단을 방지하려면 원본을 업데이트하여 사용되지 않는 API에 대한 참조를 제거하고 클러스터가 최신 버전의 확장을 실행하고 있는지 확인합니다.

최신 버전의 Flux(GitOps) 확장 과 두 개의 이전 버전(N-2)이 지원됩니다. 일반적으로 최신 버전의 확장을 사용하는 것이 좋습니다.

확장의 microsoft.flux 새 버전이 릴리스되면 모든 지역에서 새 버전을 사용할 수 있게 되는 데 며칠이 걸릴 수 있습니다.

사용 중단 및 제거 알림: 확장에 대한 예정된 변경 내용 microsoft.flux

Flux 프로젝트에서 사용 중지된 몇 가지 업스트림 Flux API는 향후 확장 릴리스 microsoft.flux 에서 제거될 예정입니다. 이러한 변화는 API 표면을 간소화하고 현대화하려는 Flux 커뮤니티의 노력에 부합합니다.

다음 Flux API는 더 이상 사용되지 않으며 제거됩니다.

  • 그룹 source.toolkit.fluxcd.io/v1beta1source.toolkit.fluxcd.io/v1beta2에서 더 이상 사용되지 않는 API
  • 그룹 kustomize.toolkit.fluxcd.io/v1beta1kustomize.toolkit.fluxcd.io/v1beta2에서 더 이상 사용되지 않는 API
  • 그룹 helm.toolkit.fluxcd.io/v2beta1helm.toolkit.fluxcd.io/v2beta2에서 더 이상 사용되지 않는 API
  • 그룹에서 사용되지 않는 API notification.toolkit.fluxcd.io/v1beta1
  • 그룹에서 사용되지 않는 API image.toolkit.fluxcd.io/v1beta1

자세한 내용은 https://github.com/fluxcd/flux2/issues/5572를 참조하세요.

필요한 작업: 지속적인 호환성을 보장하고 중단을 방지하려면 가능한 한 빨리 사용되지 않는 API에 대한 참조를 제거하도록 원본을 업데이트합니다. 영향을 받는 모든 리소스에 대해 지원되는 API 버전을 사용합니다. Flux 2.7 API 버전을 도입하는 예정된 릴리스로 업그레이드할 수 있도록 모든 클러스터가 버전 1.21.0을 사용하도록 microsoft.flux 업그레이드되었는지 확인합니다.

매니페스트의 API 버전을 대체하여 모든 리소스를 원본의 Flux 안정적인 API(Git 리포지토리, OCI 리포지토리, 버킷, Blob Storage)로 마이그레이션합니다.

  • 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 필드를 사용해야 합니다.

원본에서 매니페스트가 업데이트되면 Flux는 새 API 버전을 조정합니다.

2026년 4월 - microsoft.flux 버전 1.21.1

중요합니다

클러스터에서 자동 확장을 업그레이드하지 않은 경우 가능한 한 빨리 수동으로 이 버전으로 업그레이드하는 것이 좋습니다. 이후 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

이 버전의 변경 내용은 다음과 같습니다.

  • ,, fluxconfig-agent,fluxconfig-controllerfluent-bit-mdmsource-controllerkustomize-controllernotification-controllerimage-automation-controller및 Go 패키지 및 image-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

이 버전의 변경 내용은 다음과 같습니다.

  • ,, fluxconfig-agent,fluxconfig-controllerfluent-bit-mdmsource-controllerkustomize-controllernotification-controllerimage-automation-controller및 Go 패키지 및 image-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

이 버전의 변경 내용은 다음과 같습니다.

  • ,, fluxconfig-agent,fluxconfig-controllerfluent-bit-mdmsource-controllerkustomize-controllernotification-controllerimage-automation-controller및 Go 패키지 및 image-reflector-controller 기본 이미지를 업데이트하여 보안 취약성helm-controller을 해결했습니다.
  • 알림 컨트롤러에 대한 워크로드 ID 지원.
  • 업데이트할 때 Flux 컨트롤러 배포에 워크로드 ID 테넌트 ID 및 클라이언트 ID 설정이 올바르게 반영되는지 확인합니다.
  • AKS 자동 배포에 대한 배포 안전장치 준수 사항.
  • Flux 컨트롤러에 대한 개체 수준 워크로드 ID 지원.

2026년 2월 - microsoft.flux 버전 1.19.5

Flux 버전: 릴리스 v2.6.4

  • source-controller: v1.6.4
  • kustomize-컨트롤러: 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

이 버전의 변경 내용은 다음과 같습니다.

  • Go 패키지 및 fluxconfig-agent, fluxconfig-controller, fluent-bit-mdm, source-controller 기본 이미지를 업데이트하여 helm-controller 보안 취약성을 해결했습니다.