# Karmada v1.17.6

> Orchestration & Management · 2026-08-31

워크로드 배치 친화도와 저장 데이터 암호화 기능을 더하고, 컨트롤러의 성능과 정확성을 개선한 유지보수 릴리스입니다. 의존성, 이미지, Helm 지원을 갱신하고 일부 기본값을 바꾸는 한편 더 이상 쓰지 않는 인터페이스를 정리했습니다.

## 영향 확인
- **[breaking]** `WorkloadAffinity`의 중복 `GroupByLabelKey` 설정 제한
  - `WorkloadAffinity`와 `GroupByLabelKey`를 설정한 경우에 적용됩니다.
  - `WorkloadAffinity`에서 `affinity`와 `antiAffinity`에 같은 `GroupByLabelKey`를 설정할 수 없도록 제한했습니다.
- **[breaking]** `--etcd-init-image` 플래그 제거
  - `--etcd-init-image`를 사용하는 경우에 적용됩니다.
  - `karmadactl`의 `init` 명령에서 더 이상 사용하지 않는 `--etcd-init-image` 플래그를 제거했습니다.
- **[breaking]** 기본 구성 요소 이미지 버전 갱신
  - `kube-apiserver`, `kube-controller-manager` 또는 `ETCD`에 의존하는 경우에 적용됩니다.
  - 기본 `kube-apiserver` 및 `kube-controller-manager` 이미지를 v1.34.1에서 v1.35.2로, 기본 `ETCD` 이미지를 3.6.0-0에서 3.6.6-0으로 갱신했습니다.
- **[breaking]** `ControllerPriorityQueue` 베타 승격 및 기본 활성화
  - `ControllerPriorityQueue`를 활성화한 경우에 적용됩니다.
  - `ControllerPriorityQueue`를 베타 단계로 올리고 기본값으로 활성화했습니다.

## 미리 준비
- **[deprecated]** 클러스터 임대 관련 플래그 사용 중단 예고
  - `--cluster-lease-duration` 또는 `--cluster-lease-renew-interval-fraction`을 사용하는 경우에 적용됩니다.
  - v1.17.0부터 · 제거 시점 미정
  - `karmada-controller-manager`의 `--cluster-lease-duration` 및 `--cluster-lease-renew-interval-fraction` 플래그를 더 이상 사용하지 않는 항목으로 지정했으며, 향후 릴리스에서 제거할 예정입니다.
- **[deprecated]** `Etcd.Local.InitImage` 사용 중단 예고
  - v1.17.0부터 · 제거 시점 미정
  - `karmadactl`의 `Karmada Init Configuration`에서 `Etcd.Local.InitImage` 사용을 중단했으며, 향후 버전에서 제거할 예정입니다.
- **[deprecated]** `--cluster-lease-duration` 사용 중단 예고
  - `--cluster-lease-duration`을 사용하는 경우에 적용됩니다.
  - 제거 시점 미정
  - `--cluster-lease-duration` 및 `--cluster-lease-renew-interval-fraction` 플래그를 더 이상 사용하지 않는 항목으로 지정했으며, 향후 릴리스에서 제거할 예정입니다.
- **[deprecated]** `--cluster-lease-renew-interval-fraction` 사용 중단 예고
  - `--cluster-lease-renew-interval-fraction`을 사용하는 경우에 적용됩니다.
  - 제거 시점 미정
  - `--cluster-lease-duration` 및 `--cluster-lease-renew-interval-fraction` 플래그를 더 이상 사용하지 않는 항목으로 지정했으며, 향후 릴리스에서 제거할 예정입니다.
- **[deprecated]** `Etcd.Local.InitImage` 사용 중단 예고
  - `Etcd.Local.InitImage`를 설정한 경우에 적용됩니다.
  - 제거 시점 미정
  - `Karmada Init Configuration`의 `Etcd.Local.InitImage`를 더 이상 사용하지 않는 항목으로 지정했으며, 향후 버전에서 제거할 예정입니다.

## 그 밖에 기록된 변경
- 83 (defect_corrected 41, value_changed 21, added 19, default_changed 1, constraint_changed 1)

[분석 자세히 보기](https://ratatosk.io/ko/releases/karmada/v1.17.6)

[원본 릴리스 노트](https://github.com/karmada-io/karmada/releases/tag/v1.17.6)