# KubeVirt v1.6.3

2025-11-11 · [릴리스 노트 원문](https://github.com/kubevirt/kubevirt/releases/tag/v1.6.3) · [전체 정리](https://ratatosk.io/ko/releases/kubevirt/v1.6.3)

호환성 변경 2 · 중요 수정 6 · 기능·개선 1

## 호환성 변경 (2)

### 마이그레이션 시 `memoryOvercommit` 재계산 변경 되돌림

- 영향 대상: `memoryOvercommit`이 10 미만인 배포 환경
- 필요 조치: 업그레이드 전에 `memoryOvercommit`을 10 이상으로 높이기

> - [PR #15894][jean-edouard] REVERT: Memory overcommit is now recalculated on migration.

### 스케줄링 가능 노드 수 기준 `virt-api` 복제본 스케일링

- 영향 대상: `kubevirt.io/schedulable=true` 레이블이 지정된 노드 수와 전체 노드 수가 다른 KubeVirt 환경 (추정)

이전에는 복제본 수를 계산할 때 이 레이블로 노드를 필터링하지 않았습니다. 따라서 일부 노드에 이 레이블이 없으면 계산되는 `virt-api` 복제본 수가 달라질 수 있습니다.

> - [PR #15824][kubevirt-bot] Replicas of `virt-api` are now scaled depending on the number of nodes within the environment with the `kubevirt.io/schedulable=true` label.

## 중요 수정 (6)

### 핫플러그 가능한 DataVolume의 잘못된 `RestartRequired` 조건 수정

- 영향 대상: 핫플러그 가능한 DataVolume이 있는 VirtualMachine 리소스

핫플러그 가능한 DataVolume을 추가해도 더는 `RestartRequired` 조건이 설정되지 않습니다. 핫플러그할 수 없는 볼륨을 변경하면 계속 해당 조건이 설정됩니다.

> - [PR #15890][mhenriks] Fix RestartRequired handling for hotplug volumes

### 만료된 인증서가 `MergeCABundle`에서 유효한 인증서를 밀어내지 않도록 수정

- 영향 대상: `MergeCABundle`에서 처리하는 CA 번들 (추정)

번들에 만료된 인증서가 포함되어 있고 전체 항목이 50개 이하인 경우, 필터링 전에 번들을 잘라내면 유효한 인증서가 더 적게 남을 수 있었습니다. 이제 만료된 인증서를 먼저 필터링한 다음, 남은 유효한 인증서를 최대 50개로 제한합니다.

> - [PR #15842][kubevirt-bot] fix: prioritize expired cert removal over 50-cert limit in MergeCABundle

### 복원된 네이키드 PVC의 소유권 수정

- 영향 대상: VM 복원 정책을 사용하는 VMSnapshot 복원의 네이키드 PVC

원본 VM이 소유하던 네이키드 PVC를 복원할 때 VM 오너 레퍼런스가 누락될 수 있었습니다. 이제 원본 VM이 소유하던 PVC에만 해당 레퍼런스를 설정하고, 다른 대상이 소유한 PVC는 변경하지 않습니다.

> - [PR #15805][awels] BugFix: Restoring naked PVCs from a VMSnapshot are now properly owned by the VM if the restore policy is set to VM

### 마이그레이션 대상 Pod 조회 최적화

- 영향 대상: 수천 건의 마이그레이션을 처리하는 클러스터

마이그레이션이 수천 건에 이르면 진행 중인 마이그레이션이 실패할 수 있었습니다. 조회를 최적화해 이 조건에서 발생하는 실패를 방지합니다.

> - [PR #15903][kubevirt-bot] Bug fix: Thousands of migrations should not cause failures of active migrations

### 업그레이드 중 마이그레이션 nil 포인터 오류 수정

- 영향 대상: KubeVirt 마이그레이션

`virt-handler`가 마이그레이션 컨트롤러보다 먼저 업데이트되면, 마이그레이션에서 `AllowWorkloadDisruption` 값이 누락되어 nil 포인터 오류가 발생할 수 있었습니다. 이제 해당 값이 nil이면 대신 `AllowPostCopy`를 사용합니다.

> - [PR #15944][kubevirt-bot] Fix possible nil pointer caused by migration during kv upgrade

### CX-series 핫플러그 CPU 과할당 수정

- 영향 대상: CPU manager와 노드 huge pages가 필요한 `common-instancetypes` 번들의 CX-series 인스턴스 유형

KubeVirt의 기본 핫플러그 동작으로 노드에서 사용할 수 있는 CPU 수보다 많은 CPU가 제공되면 CX-series VM이 실패할 수 있었습니다. 업데이트된 번들은 `spec.cpu.maxSockets`를 게스트 CPU 수로 설정해, 핫플러그 CPU가 노드 용량을 초과하지 않도록 합니다.

> - [PR #15925][kubevirt-bot] Updated common-instancetypes bundles to v1.4.1

## 기능·개선 (1)

- VNC 세션 보존 옵션 (사용 조건: `virtctl vnc --preserve-session` 플래그 또는 `preserveSession` 쿼리 옵션)

---

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