# KubeVirt v1.10.0

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

보안 7 · 호환성 변경 38 · 폐기 예정 1 · 중요 수정 74 · 기능·개선 39 · 의존성 갱신 7 · 기타 31

## 업그레이드 전 확인

### 알려진 문제

- **KubeVirt 오퍼레이터 매니페스트에 대한 클라이언트 측 apply 실패**: `kubevirts.kubevirt.io` CRD가 256 KiB 어노테이션 제한을 초과합니다. 릴리스 노트에서는 대안으로 `kubectl apply --server-side`와 `kubectl create`를 안내합니다.
  > > [!IMPORTANT]
  > > Installing the `kubevirt-operator.yaml` with client-side `kubectl apply -f kubevirt-operator.yaml` fails because the kubevirts.kubevirt.io CRD now exceeds the 256 KiB annotation limit. Use `kubectl apply --server-side` (or `kubectl create`) for `kubevirt-operator.yaml` instead. See #19980.

## 보안 (7)

### [medium] virt-api 포트 포워딩 및 SSH 트래픽 리디렉션 수정

- 영향 대상: 팟 네트워크가 있는 VMI에 `virtctl port-forward` 또는 `virtctl ssh`로 접근하는 경우
- [CVE-2026-13318](https://www.cve.org/CVERecord?id=CVE-2026-13318)

런처 Pod IP를 확인할 수 없으면 virt-api는 게스트 에이전트가 보고한 검증되지 않은 인터페이스 IP를 사용해 임의의 연결 가능한 엔드포인트로 트래픽을 리디렉션할 수 있었습니다. 이제 포트 포워딩과 SSH는 런처 Pod IP로만 연결을 시도하며, 팟 네트워크가 없는 VMI는 websocket 업그레이드나 연결 시도 전에 거부됩니다.

> - [PR #18753][orelmisan] Fix SSRF vulnerability (CVE-2026-13318) in virt-api port-forward that allowed a malicious QEMU guest agent to redirect virtctl port-forward and ssh traffic to arbitrary network endpoints. virt-api now dials only the launcher pod IP and never the guest-agent-reported interface IP.

### [medium] virt-api 포트 포워딩 프로토콜 검사로 SSRF 차단

- 영향 대상: virt-api 포트 포워딩 및 SSH 트래픽 (추정)
- [CVE-2026-13318](https://www.cve.org/CVERecord?id=CVE-2026-13318), [GHSA-cgm6-wvp9-4g5h](https://github.com/advisories/GHSA-cgm6-wvp9-4g5h)

악성 QEMU 게스트 에이전트는 포워딩된 프로토콜이 검증 없이 `net.Dial`에 전달되는 점을 악용해 `virtctl` 포트 포워딩 및 SSH 트래픽을 임의의 네트워크 엔드포인트로 리디렉션할 수 있었습니다. 이제 `tcp` 및 `udp` 이외의 포워딩 프로토콜에는 `BadRequest` 오류가 반환됩니다.

> - [PR #18753][orelmisan] Fix SSRF vulnerability (CVE-2026-13318) in virt-api port-forward that allowed a malicious QEMU guest agent to redirect virtctl port-forward and ssh traffic to arbitrary network endpoints. virt-api now dials only the launcher pod IP and never the guest-agent-reported interface IP.

### [medium] virt-api 포트 포워딩 대상 선택 수정

- 영향 대상: Pod 네트워크에 연결된 VMI
- [CVE-2026-13318](https://www.cve.org/CVERecord?id=CVE-2026-13318), [GHSA-cgm6-wvp9-4g5h](https://github.com/advisories/GHSA-cgm6-wvp9-4g5h)

virt-launcher Pod가 멀티홈 구성이거나 바인딩으로 인해 Pod 측 링크에 주소가 남지 않으면, 보고된 인터페이스 IP에 virt-api가 연결할 수 없어 포트 포워딩 터널을 설정하지 못할 수 있습니다. 이제 포트 포워딩은 사용 가능한 경우 런처 Pod IP로 연결하고, 그렇지 않으면 인터페이스 상태 IP로 폴백합니다. 기존 core 바인딩에서는 관찰 가능한 변화가 없으며, Pod 네트워크가 없는 VMI는 이전 동작을 유지합니다.

> - [PR #19019][lllamnyp] virt-api: the port-forward subresource (used by `virtctl port-forward` and `virtctl ssh`) now dials the virt-launcher pod IP for VMIs connected to the pod network, instead of the first IP reported in the VMI interface status. The virt-api cluster role gains the `watch` verb on pods.

### 프록시 활성화 구성으로 제한된 마이그레이션 아이덴티티 공유

- 영향 대상: 마이그레이션 프록시를 비활성화한 KubeVirt 구성

이전에는 마이그레이션 프록시가 비활성화된 경우에도 동기화 컨트롤러 Pod가 마이그레이션 아이덴티티를 받았습니다. 이제는 프록시가 활성화된 경우에만 해당 아이덴티티를 받습니다.

> - [PR #19490][awels] Only add virt-handler migration identity to synchronization controller if proxy is enabled.

### [보안 여부 불분명] VM 어드미션의 `ContainerPath` 제한 경로 차단

- 영향 대상: VM/VMI `ContainerPath` 볼륨

`/run/kubevirt*` 또는 `/run/libvirt*`와 일치하는 경로를 사용하는 요청은 어드미션 단계에서 거부됩니다. 이 제한은 기존 `/var/run` 제한과 동일합니다.

> - [PR #19251][mhenriks] Check ContainerPathVolume feature gate at admission time.  Reject /run/kubevirt* and /run/libvirt* paths.

### [보안 여부 불분명] GPU 정보 메트릭에 VMI 이름 레이블 추가

- 영향 대상: `kubevirt_vmi_gpu_info`를 스크레이핑하거나 쿼리하는 설치 환경 (추정)

이 릴리스 전에는 `kubevirt_vmi_gpu_info`에 VMI 이름 레이블이 포함되지 않았습니다.

> - [PR #18902][machadovilaca] Add name label to kubevirt_vmi_gpu_info

### 익스포트 서버 토큰 타이밍 사이드 채널 수정

- 영향 대상: 익스포트 서버 토큰 검사를 사용하는 환경

토큰 검사는 상수 시간 비교를 사용하지 않아 타이밍 사이드 채널이 발생했습니다. 이제 상수 시간 비교를 사용합니다.

> - [PR #18200][naruto-lgtm] Fixed a timing side channel in the export server token check by switching to a constant-time comparison.

## 호환성 변경 (38)

### VM 스냅샷 및 내보내기에서 메모리 덤프 PVC 제외

- 영향 대상: 메모리 덤프 PVC가 연결된 VM 스냅샷 또는 내보내기 (추정)

스냅샷이나 내보내기를 복원해도 이 변경 전부터 덤프 PVC는 복원되지 않았습니다.

근거: “Snapshots and exports no longer include the dump PVC (restore never restored it anyway).” https://github.com/kubevirt/kubevirt/pull/19550

> - [PR #19550][Acedus] Memory dumps are attached as utility volumes and require the UtilityVolumes feature gate, which is promoted to Beta and enabled by default. VM snapshots and exports no longer include the memory dump PVC.

### `VirtualMachineBackup` 유형 보고를 볼륨별 상태로 전환

- 영향 대상: 기준 체크포인트 비트맵이 없는 디스크가 포함된 체크포인트 기반 `VirtualMachineBackup`

이전에는 디스크 하나에 기준 체크포인트 비트맵이 없으면 유효한 비트맵이 있는 디스크까지 포함해 백업 전체가 실패했습니다. 이제 해당 디스크는 전체 백업되고, 나머지 디스크는 증분 델타를 유지합니다.

> - [PR #19056][Acedus] VirtualMachineBackup no longer fails when a disk has lost the base checkpoint's bitmap; that disk is backed up in full and type is now reported per volume in `status.includedVolumes[].type`, replacing the removed `status.type`.

### `VirtualMachineBackup`에서 볼륨별 백업 유형 보고

- 영향 대상: `VirtualMachineBackup` 상태를 읽는 클라이언트 또는 자동화 (추정)

이전에는 체크포인트 기반 백업에서 디스크가 기준 체크포인트의 비트맵을 잃으면 전체 백업이 실패했습니다. 이제 해당 디스크는 전체 백업으로 처리됩니다.

> - [PR #19056][Acedus] VirtualMachineBackup no longer fails when a disk has lost the base checkpoint's bitmap; that disk is backed up in full and type is now reported per volume in `status.includedVolumes[].type`, replacing the removed `status.type`.

### `io.kubevirt.disk.name` 어노테이션에 VM 볼륨 이름 사용

- 영향 대상: 디스크 레이어가 포함된 내보낸 OCI 아티팩트 (추정)

이전에는 어노테이션에 VM spec의 볼륨 이름이 아니라 PVC에서 유래한 정제된 마운트 디렉터리 이름이 들어가 VM 볼륨을 식별하지 못했습니다. 예를 들어 `fedora-vm-rootdisk`를 기반으로 하는 `rootdisk` 볼륨은 이제 `rootdisk`로 표시됩니다.

근거: “The volume name is passed to the exporter pod and the layer is annotated with it. A volume `rootdisk` backed by claim `fedora-vm-rootdisk` is annotated `rootdisk`.” https://github.com/kubevirt/kubevirt/pull/19066

> - [PR #19066][0xFelix] The io.kubevirt.disk.name annotation of exported OCI artifacts now carries the volume name from the VM instead of the PersistentVolumeClaim name

### 사용자 정의 HostDisk 볼륨을 CBT 대상에서 제외

- 영향 대상: 사용자 정의 HostDisk 볼륨을 사용하는 CBT

누락된 `DiskOrCreate` 이미지가 별도 알림 없이 다시 생성되면, 해당 CBT 오버레이가 더 이상 존재하지 않는 디스크를 계속 나타낼 수 있었습니다. 이제 HostDisk 볼륨은 CBT 메모리 오버헤드에 포함되지 않습니다.

근거: “Only PVC and DataVolume volumes are eligible for CBT. User-defined HostDisk volumes are no longer tracked, and no longer count towards CBT's memory overhead.” https://github.com/kubevirt/kubevirt/pull/19410

> - [PR #19410][Acedus] HostDisk volumes are no longer eligible for changed block tracking.

### `virt-launcher-monitor`의 `VIRT_LAUNCHER_LOG_VERBOSITY` 설정 미적용

- 영향 대상: `virt-launcher-monitor`에 `VIRT_LAUNCHER_LOG_VERBOSITY`를 설정하는 구성 (추정)

이전에는 유효한 정수 값을 설정하면 Go 모니터의 로그 verbosity가 지정됐습니다. 새로 작성된 C 모니터는 설정된 값을 verbosity 지정에 사용하지 않습니다.

근거: “- no `VIRT_LAUNCHER_LOG_VERBOSITY` in the monitor” https://github.com/kubevirt/kubevirt/pull/19240

> - [PR #19240][vladikr] virt-launcher-monitor is rewritten in C to reduce memory footprint to about 2Mi

### 영구 예약 LUN의 기본 SCSI 버스 설정과 비 SCSI 버스 거부

- 영향 대상: 영구 예약이 활성화된 LUN 디스크

근거: “Default bus to SCSI when reservation is true and bus is unset, and reject with a validation error when reservation is true with an explicitly non-SCSI bus.” https://github.com/kubevirt/kubevirt/pull/18267

> - [PR #18267][akalenyu] Default LUN bus to SCSI when persistent reservation is enabled

### 명시적 정책이 필요한 소프트웨어 에뮬레이션

- 영향 대상: 소프트웨어 에뮬레이션을 사용하거나 VM에 에뮬레이션 정책을 사용하는 KubeVirt 클러스터

이전에는 소프트웨어 에뮬레이션을 클러스터 전체의 켜기 또는 끄기 설정으로 제어했습니다. 이제는 에뮬레이션 정책에서 선택한 경우에만 사용됩니다. KubeVirt CR에서 `spec.configuration.emulationPolicy: Software`를 설정하면 기존 동작이 유지됩니다.

근거: “Action Required: Add `spec.configuration.emulationPolicy: Software` to kubevirt CR to keep existing behaviour if using Software Emulation” https://github.com/kubevirt/kubevirt/pull/19244

> - [PR #19244][jschintag] Add configuration option for cluster wide and per VM emulation (Alpha Stage).

### virt-launcher-monitor의 Istio 프록시 종료 기능 제거

- 영향 대상: Istio 사이드카를 사용하는 KubeVirt 구성
- 필요 조치: Istio 1.27 이상 또는 네이티브 사이드카 모드

레거시 Istio 인젝션에서는 Envoy가 일반 컨테이너로 실행되어 메인 컨테이너가 종료된 뒤에도 Pod가 계속 실행될 수 있었습니다. 종료 과정에서 virt-launcher-monitor는 더 이상 프록시를 종료하지 않습니다.

> - [PR #19239][akalenyu] Istio sidecar proxy termination is no longer handled by virt-launcher-monitor; Istio >= 1.27 is required with kubevirt (alternatively, use native sidecar mode)

### `VirtualMachineBackup` 상태의 pull 모드 엔드포인트 링크 분리

- 영향 대상: pull 모드 백업의 `VirtualMachineBackup` 상태

pull 모드 `VirtualMachineExport`에 내부 링크와 외부 링크가 모두 있을 때, 백업 상태에는 이전에 한 세트만 노출되어 다른 세트가 누락됐습니다. 기존 `EndpointCert`, `DataEndpoint`, `MapEndpoint` 필드는 제거됐으며, 새 링크 항목마다 자체 CA 인증서와 볼륨별 데이터 URL 및 맵 URL이 포함됩니다.

근거: “The existing fields (`EndpointCert`, `DataEndpoint`, `MapEndpoint`) are removed. Consumers of pull-mode backups should use `status.links.internal` and/or `status.links.external` instead.” https://github.com/kubevirt/kubevirt/pull/18537

> - [PR #18537][davmarro] Add structured `links` field to `VirtualMachineBackup` status exposing both internal and external export endpoints for pull-mode backups. The existing endpoint fields are removed.

### 베타 단계로 승격되고 기본 활성화된 `VSOCK` 기능 게이트

- 영향 대상: `VSOCK` 기능 게이트를 사용하거나 설정하는 설치 환경 및 VSOCK을 사용하는 워크로드 (추정)

> - [PR #19155][0xFelix] The VSOCK feature gate graduated to Beta and is now enabled by default.

### KubeVirt의 레거시 `cpumanager` 노드 레이블 사용 중단

- 영향 대상: virt-handler가 업데이트한 노드에서 레거시 `cpumanager` 노드 레이블을 사용하는 자동화 또는 스케줄링 규칙 (추정)

`kubevirt.io/cpumanager` 레이블은 Pod에서 계속 사용됩니다.

> - [PR #19100][xpivarc] Label "cpumanager" is no longer used

### VM 메모리 계산에 CBT dirty bitmap 오버헤드 포함

- 영향 대상: CBT가 활성화된 VM

기존에는 메모리 계산에서 CBT dirty bitmap에 필요한 메모리를 제외해 필요량을 실제보다 적게 산정했습니다. 이제 계산에는 포함된 각 디스크의 오버헤드가 반영되며, CBT 대상 볼륨과 활성 백업 추적기, 동적 증가에 대비한 버퍼도 고려합니다.

> - [PR #18416][Acedus] VMs with CBT now correctly factor in the required memory overhead for each of their included disks.

### 사용자 정의 seccomp 프로파일 설치에 게이트 미적용

- 영향 대상: `KubevirtSeccompProfile` 게이트를 사용하거나 KubeVirt의 사용자 정의 seccomp 프로파일에 의존하는 클러스터

이전 릴리스에서는 `KubevirtSeccompProfile`을 명시적으로 활성화한 경우에만 KubeVirt가 프로파일을 설치했습니다. 이제는 게이트가 비활성화되어 있어도 프로파일을 설치합니다.

근거: “**Before:** The `KubevirtSeccompProfile` feature gate is at Beta. The custom seccomp profile is only installed when the feature gate is explicitly enabled, and operator tests verify configuration statically (file presence, pod annotation). **After:** The `KubevirtSeccompProfile` feature gate graduates to GA. The custom seccomp profile is always installed, the feature gate check is removed, and three hardening improvements are included:” https://github.com/kubevirt/kubevirt/pull/18888

> - [PR #18888][dankenigsberg] Graduate the KubevirtSeccompProfile feature gate to GA. The custom seccomp profile is now always installed. Tighten profile file permissions to 0600, and write it atomically.

### Network Resources Injector를 통한 네트워크 리소스 주입 상시 활성화

- 영향 대상: `NetworkAttachmentDefinition` 기반 인터페이스에 네트워크 리소스 주입을 사용하는 설치 환경

`ExternalNetResourceInjection` 기능 게이트는 v1.9부터 기본적으로 활성화되어 있었지만, 이를 비활성화한 설치 환경도 더 이상 옵트아웃할 수 없습니다. `virt-controller`는 더 이상 `NetworkAttachmentDefinition` 오브젝트를 조회하거나 런처 Pod에 네트워크 리소스 요청을 주입하지 않으며, `ClusterRole`도 `k8s.cni.cncf.io network-attachment-definitions`에 대한 get 권한을 더 이상 부여하지 않습니다.

근거: “The `ExternalNetResourceInjection` FG has been Beta since v1.8.0 and enabled by default since v1.9. It disables virt-controller's query of `NetworkAttachmentDefinition` objects and the deployment of NAD RBAC rules by virt-operator. This PR graduates it to GA, making this behavior always on. virt-controller no longer queries `NetworkAttachmentDefinition` objects, injects network resource requests into the launcher pod, or holds the `k8s.cni.cncf.io network-attachment-definitions` get permission.” https://github.com/kubevirt/kubevirt/pull/18497

> - [PR #18497][orelmisan] ExternalNetResourceInjection graduated to GA. virt-controller no longer queries NetworkAttachmentDefinition objects or injects network resource requests into the launcher pod. The k8s.cni.cncf.io network-attachment-definitions get rule is

### VM 마이그레이션에서 해시된 인터페이스 이름 사용

- 영향 대상: ordinal 네트워크 또는 tap 인터페이스 이름을 사용하는 VM, `--upgrade-ordinal-ifaces`를 사용하는 자동화
- 필요 조치: 라이브 마이그레이션 중 해당 VM 자동 변환, 수동 개입 불필요

이전에는 마이그레이션 대상이 소스 Pod의 ordinal 인터페이스 이름을 그대로 유지할 수 있었고, 사전 마이그레이션 훅은 게이트로 제어됐습니다. 이제 `--upgrade-ordinal-ifaces` 플래그를 사용할 수 없습니다.

근거: “Migration targets will no longer preserve ordinal pod interface names from the source pod - the hashed scheme is always used. The pre-migration hook that converts ordinal tap names to hashed equivalents now runs unconditionally” https://github.com/kubevirt/kubevirt/pull/18317

> - [PR #18317][orelmisan] Graduate the PodSecondaryInterfaceNamingUpgrade feature gate to GA. The pre-migration hook that converts ordinal network interface names to hashed equivalents now runs unconditionally.

### VMI 메모리 요청의 QEMU 오버헤드 추정치 증가

- 영향 대상: KVM 또는 MSHV 하이퍼바이저 백엔드를 사용하는 VMI pod

QEMU 프로세스 오버헤드 추정치가 30Mi에서 50Mi로 늘어나 VMI pod 메모리 요청이 각각 20Mi씩 증가합니다.

> - [PR #18388][dasionov] Bumped QEMU process memory overhead from 30Mi to 50Mi, increasing VMI pod memory requests by 20Mi to reflect actual QEMU RSS requirements with current QEMU versions.

### Node 훅의 플러그인 수준 조건 반영

- 영향 대상: 플러그인 수준에서 `Spec.Condition`을 설정한 Node 훅 (추정)

이를 통해 Node 훅의 조건 처리 방식이 도메인 훅과 일치합니다.

> - [PR #18414][iholder101] Fix CallNodeHooks to evaluate plugin-level Spec.Condition, ensuring consistent behavior between domain hooks and node hooks.

### `kubevirt.io/client-go/log`의 전역 `-v` 등록 제거

- 영향 대상: `kubevirt.io/client-go/log` 패키지를 임포트하는 코드

`kubevirt.io/client-go/log` 패키지를 임포트할 때 glog나 klog 같은 다른 패키지가 이미 `flag.CommandLine`에 `-v`를 등록한 상태면 패닉이 발생했습니다. 이제 이 플래그는 패키지 전용 `FlagSet`에 보관되므로 `flag.CommandLine.Lookup("v")`로는 더 이상 찾을 수 없습니다. 대신 `log.VerbosityFlag()`로 가져올 수 있습니다.

근거: “The `-v` flag is registered on a package-private `FlagSet` instead of the global `flag.CommandLine`. A new `VerbosityFlag()` function is exported so that consumers can bridge it into pflag without going through `flag.CommandLine`. All 8 internal call sites are updated. Importing `kubevirt.io/client-go/log` no longer registers any flags on the global `flag.CommandLine`, eliminating the conflict entirely regardless of `init()` ordering.” https://github.com/kubevirt/kubevirt/pull/18294

> - [PR #18294][guzalv] client-go/log: The `-v` verbosity flag is no longer registered on `flag.CommandLine` during `init()`. External consumers that used `flag.CommandLine.Lookup("v")` to obtain the verbosity flag must switch to `log.VerbosityFlag()`. This eliminates panics when importing `kubevirt.io/client-go` alongside packages that also register a `-v` flag (e.g. glog, klog).

### 메모리 덤프에서 VMI 유틸리티 볼륨 사용

- 영향 대상: 메모리 덤프를 사용하는 설정

이전에는 덤프를 수행하면 VM 템플릿과 `vmi.spec.volumes` 모두에 `MemoryDump` 볼륨이 추가됐습니다. 이제 템플릿은 변경하지 않고 PVC를 VMI에 연결합니다. 덤프가 진행되는 동안 VMI가 중지되거나 재시작되면 새 VMI에서 계속 진행하는 대신 덤프가 실패합니다. 업그레이드 중 이미 진행 중이던 덤프는 완료된 뒤 분리됩니다.

근거: “A memory dump request attaches its PVC to the VMI as a utility volume of type `MemoryDump`, nothing is written to the VM template. A dump still in progress when its VMI stops or restarts fails instead of dumping the new VMI. Dumps that were in progress on it during the upgrade finish, then it's detached.” https://github.com/kubevirt/kubevirt/pull/19550

> - [PR #19550][Acedus] Memory dumps are attached as utility volumes and require the UtilityVolumes feature gate, which is promoted to Beta and enabled by default. VM snapshots and exports no longer include the memory dump PVC.

### mdev 기반 vGPU 라이브 마이그레이션용 `VGPULiveMigration`을 `MDevVGPULiveMigration`으로 이름 변경

- 영향 대상: mdev 기반 vGPU 라이브 마이그레이션의 Alpha 기능 게이트를 활성화한 설정

근거: “Mdev-based vGPU live migration uses `MDevVGPULiveMigration`.” https://github.com/kubevirt/kubevirt/pull/19546

> - [PR #19546][dasionov] Renamed the alpha feature gate for mdev-based vGPU live migration from VGPULiveMigration to MDevVGPULiveMigration.

### 런처 훅 조건에서 `domainSpec` 제거

- 영향 대상: `domainSpec`을 참조하는 런처 훅 `condition` 표현식 (추정)

이전에는 훅 조건에서 VMI와 `domainSpec`을 모두 참조할 수 있었습니다. 조건부 도메인 변경에는 여전히 CEL의 `has()` 연산자를 사용할 수 있습니다.

근거: “In addition, Launcher hook `condition` expressions could also reference `domainSpec` in addition to the VMI, which both complicated the code and was wrong because on certain situations the domain did not exist yet, it is not relevant for most hook points and it's a low-level libvirt-coupled variable which we don't want to commit to.” https://github.com/kubevirt/kubevirt/pull/19403

> - [PR #19403][iholder101] Add PreBoot and PreMigrationSource sidecar launcher hook points for plugins.

### 준비 단계 라이브 마이그레이션 중단 시 마이그레이션 취소

- 영향 대상: 라이브 마이그레이션

도메인 준비 중이나 `PreMigrationSource` 훅 실행 중에 중단을 요청하면, 이전에는 `AbortFailed`를 보고하고 마이그레이션을 계속 진행했습니다. 이제는 마이그레이션을 취소하고 `AbortSucceeded`를 보고합니다. 핸드오프 이후 libvirt의 마이그레이션 작업을 확인할 수 있기 전까지의 짧은 시간 동안에는 중단 요청이 여전히 `AbortFailed`를 보고하며, virt-handler가 재시도합니다.

근거: “Also, there's a small behavior change for all migrations (with or without plugins): an abort that arrives while the migration is being prepared (domain preparation or `PreMigrationSource` hooks) now cancels it and reports `AbortSucceeded`, where it previously reported `AbortFailed` and the migration continued. A short window remains between the hand-off and libvirt's migration job becoming observable; an abort landing there still reports `AbortFailed`, and virt-handler retries.” https://github.com/kubevirt/kubevirt/pull/19403

> - [PR #19403][iholder101] Add PreBoot and PreMigrationSource sidecar launcher hook points for plugins.

### `ContainerPathVolume` 비활성화 시 새 `ContainerPath` 사용에 대한 VM/VMI 어드미션 거부

- 영향 대상: `ContainerPathVolume` 기능 게이트가 비활성화된 상태에서 `ContainerPath`를 사용하는 VM/VMI 워크로드

이 변경 전에는 새 사용에 대해 VM/VMI 어드미션에서 기능 게이트를 확인하지 않았습니다. 다만 게이트를 비활성화하기 전에 어드미션된 VMI에 대해서는 컨트롤러 측 검사가 유지되었습니다. 이미 `ContainerPath`를 사용하는 오브젝트의 업데이트는 계속 허용됩니다.

근거: “Rejects new ContainerPath usage at VM/VMI admission when the feature gate is disabled, while allowing updates to objects already using it.” https://github.com/kubevirt/kubevirt/pull/19251

> - [PR #19251][mhenriks] Check ContainerPathVolume feature gate at admission time.  Reject /run/kubevirt* and /run/libvirt* paths.

### DRA `ResourceClaim`을 사용하는 VMI의 마이그레이션 불가 표시

- 영향 대상: `NetworkDevicesWithDRA`가 활성화된 상태에서 `ResourceClaim`을 기반으로 하는 DRA 네트워크를 사용하는 VMI

`ResourceClaim`은 특정 할당에 바인딩되므로 마이그레이션 대상 파드가 해당 할당을 다시 예약할 수 없습니다.

근거: “VerifyVMIMigratable now rejects the former. The check is guarded by the NetworkDevicesWithDRA feature gate, threaded in from virt-handler, so behavior is unchanged when the gate is disabled.” https://github.com/kubevirt/kubevirt/pull/19468

> - [PR #19468][orelmisan] VMI whose DRA network is backed by a ResourceClaim (rather than a ResourceClaimTemplate) are now reported as non-migratable.

### KubeVirt 인프라 컨테이너의 읽기 전용 루트 파일시스템 적용

- 영향 대상: virt-handler와 virt-launcher init 컨테이너를 제외한 KubeVirt 인프라 컨테이너
- 필요 조치: 쓰기 가능한 `/tmp` 볼륨 불필요, 마운트된 Secret 경로에서 인증서 직접 로드

이번 릴리스 전에는 포함된 컨테이너에 `readOnlyRootFilesystem: true` 설정이 없었고, virt-api는 사용하지 않는 임시 인증서 디렉터리를 만들었습니다. 이제 인증서는 마운트된 Secret 경로에서 직접 로드하며, 쓰기 가능한 `/tmp` 볼륨은 추가되지 않습니다.

근거: “KubeVirt containers (`virt-operator`, `virt-api`, `virt-controller`, `virt-exportproxy`, and `virt-synchronization-controller`) run without `readOnlyRootFilesystem: true`, triggering compliance scan findings.” https://github.com/kubevirt/kubevirt/pull/18853

> - [PR #18853][davmarro] Enable readOnlyRootFilesystem for all KubeVirt infrastructure containers

### 지원 중단 예정이었던 `virtctl create vm` 볼륨 플래그 제거

- 영향 대상: `--volume-blank`, `--volume-datasource` 또는 `--volume-clone-pvc`를 사용하는 `virtctl create vm` 호출 (추정)

볼륨 생성에는 제거된 플래그 대신 `--volume-import`와 `type:blank`, `type:ds` 또는 `type:pvc`를 사용합니다.

> - [PR #19362][NoamBerkoLaor] Removed deprecated virtctl create vm flags --volume-blank, --volume-datasource, and --volume-clone-pvc. Use --volume-import with type:blank, type:ds, or type:pvc instead.

### 새 virt-export 서비스의 헤드리스 포트 8443

- 영향 대상: 새 VMExport를 생성하는 환경

새 export의 링크는 `:8443`을 사용하지만, 기존 ClusterIP export는 계속 `:443`을 사용합니다. `https://virt-export-*.svc:443`을 하드코딩한 클라이언트는 새 export에서 작동하지 않습니다. `status.links`를 따르는 클라이언트는 계속 작동합니다.

근거: “New exports are not ClusterIP on `:443`. Clients that hardcode `https://virt-export-*.svc:443` will break for those. Clients that follow `status.links` should be fine. Leftover ClusterIP exports stay on `:443`.” https://github.com/kubevirt/kubevirt/pull/18606

> - [PR #18606][OOsemka] Make new virt-export Services headless on port 8443 so virt-exportproxy can reach exporters across isolated networks. Existing ClusterIP/443 export Services are left in place. Internal VMExport links include the Service dial port (:8443 or :443).

### 플러그인 훅의 `spec.launcherHooks` 전환

- 영향 대상: `spec.domainHooks` 또는 `PreVMStop`을 사용하는 플러그인 오브젝트 (추정)

이전에는 `spec.domainHooks`에 훅 포인트를 명시할 필요가 없었고, stop 훅 포인트의 이름은 `PreVMStop`이었습니다. 이제 launcher 훅에는 훅 포인트를 명시해야 하며, `OnVMStop`을 사용합니다.

> - [PR #19160][iholder101] Plugin's spec.domainHooks is renamed to spec.launcherHooks. Launcher hooks now require explicit hook points. PreVMStop is renamed to OnVMStop.

### virt-handler `/v1/vmstats`의 GET에서 POST로 전환

- 영향 대상: virt-handler의 `/v1/vmstats` 엔드포인트를 호출하는 클라이언트 (추정)

이전에는 하나의 `VMStatsRequest`가 노드의 모든 VMI에 적용됐고, 통계 범주는 쿼리 매개변수로 선택했습니다. 이제 요청 본문에 JSON을 사용해 VMI마다 통계 범주를 지정합니다.

근거: “virt-handler GetVMStats accepts a per-VMI VMStatsRequest body, allowing the caller to filter which VMIs to collect from and specify the stats categories it needs on a per-VMI basis, rather than one set applied to every VMI on the node, so it can collect different data for different VMIs in a single call.” https://github.com/kubevirt/kubevirt/pull/18938

> - [PR #18938][machadovilaca] Accept a per-VMI VMStatsRequest body in virt-handler GetVMStats

### GPU 메모리 복사 레코딩 룰 이름을 `vmi:kubevirt_vmi_gpu_mem_copy_utilization_ratio:sum`으로 변경

- 영향 대상: `vmi:kubevirt_vmi_gpu_mem_copy_util:sum`을 사용하는 모니터링 쿼리와 대시보드 (추정)

이전 레코딩 룰 이름은 `vmi:kubevirt_vmi_gpu_mem_copy_util:sum`이었습니다.

근거: “-| vmi:kubevirt_vmi_gpu_mem_copy_util:sum | Recording rule | Gauge | Memory utilization (ratio, 0-1) of the GPU passed through to a virtual machine instance. |” https://github.com/kubevirt/kubevirt/pull/19144

> - [PR #19144][machadovilaca] Add GPU utilization time and active engine time recording rules

### client-go KubeVirt 서브리소스 클라이언트 헬퍼 제거

- 영향 대상: `GetKubevirtSubresourceClient` 또는 `GetKubevirtSubresourceClientFromFlags`를 호출하는 client-go 애플리케이션 또는 도구 (추정)

이 함수들은 KubeVirt 서브리소스 클라이언트를 생성해 반환하는 방법을 제공했습니다.

> - [PR #18874][xpivarc] client-go: GetKubevirtSubresourceClient is removed

### DRA 네트워크에서 SR-IOV 바인딩 거부

- 영향 대상: SR-IOV 인터페이스로 구성된 DRA 네트워크

이전에는 DRA 네트워크에서 SR-IOV 바인딩을 사용할 수 있었고, virt-launcher가 패스스루에 필요한 PCI 주소를 DRA 장치 메타데이터에서 확인했습니다. 이제 이러한 인터페이스에는 바인딩 플러그인을 사용해야 합니다.

근거: “It is no longer possible to use SR-IOV binding with DRA networks - the network admitter rejects them and only allows interfaces using binding plugins.” https://github.com/kubevirt/kubevirt/pull/18451

> - [PR #18451][orelmisan] SR-IOV interfaces are no longer supported with DRA networks.

### `LibvirtHooksServerAndClient` GA 승격 및 상시 활성화

- 영향 대상: `LibvirtHooksServerAndClient`를 설정하거나 라이브 마이그레이션에 해당 도메인 변경 훅을 사용하는 환경

이전에는 도메인 변경 훅 메커니즘이 베타 기능이어서 명시적으로 활성화해야 했습니다. 이 훅은 마이그레이션 중 TAP 장치 이름을 조정합니다.

근거: “Graduate the `LibvirtHooksServerAndClient` feature gate (VEP-141) to GA.” https://github.com/kubevirt/kubevirt/pull/18687

> - [PR #18687][Barakmor1] Graduate LibvirtHooksServerAndClient feature gate to GA

### 스톨 디텍터 API 필드 타입 변경

- 영향 대상: `MigrationStallDetection`을 활성화한 상태로 v1.9에서 업그레이드하는 클러스터와 v1.9 `StallDetectorOptions`를 가져오는 SDK

네 개의 factor 필드 타입이 `*string`에서 `*resource.Quantity`로 변경되고, `StallProgressTimeout`과 `SwitchoverTimeout` 타입이 `*uint64`에서 `*int64`로 변경됩니다. 이 변경으로 `MigrationStallDetection`을 활성화한 클러스터의 업그레이드가 실패할 수 있으며, v1.9 타입을 가져오는 SDK에서 컴파일 오류가 발생할 수 있습니다.

근거: “**Backward compatibility note:** These changes are NOT strictly backward compatible. At the API level, these changes break API SDK since anyone importing kubevirt.io/api/core/v1 from v1.9 and using StallDetectorOptions would see compile-time breakage when upgrading (e.g. *string -> *resource.Quantity). But at the serialization/upgrade level for API they ARE compatible. On the wire, MigrationOptions changes are breaking and thus this will break cluster upgrades if someone has the FG enabled when upgrading 1.9->1.10.” https://github.com/kubevirt/kubevirt/pull/18303

> - [PR #18303][Aseeef] BREAKING CHANGE: Modifies internal on-the-wire API fields for the stall detector feature; MigrationStallDetection FG must be disabled for cluster upgrades to succeed.

### 비-NIC 장치용 PCI 루트 포트의 핫플러그 비활성화

- 영향 대상: 비-NIC 장치가 연결된 PCI 루트 포트를 사용하는 VM

게스트 OS의 핫플러그 기능을 사용하면 Windows의 “하드웨어 안전하게 제거” 메뉴처럼 디스크, 메모리 벌룬, RNG, 워치독을 비롯한 중요 장치를 꺼낼 수 있었습니다. NIC 포트와 향후 핫플러그를 위해 예약된 빈 포트는 계속 사용할 수 있습니다.

> - [PR #17605][dasionov] Bug fix: Prevent guest OS from ejecting critical PCI devices (disks, memory balloon, RNG, watchdog) via hotplug mechanisms like the Windows "Safely Remove Hardware" tray menu. PCI root ports hosting non-NIC devices are now marked as non-hotpluggable, while NIC ports and empty ports reserved for future hotplug remain available.

### Slirp 네트워크 바인딩 플러그인 사이드카 이미지 제거

- 영향 대상: slirp 네트워크 바인딩 플러그인 사이드카 이미지를 참조하거나 사용하는 설정

> - [PR #18613][orelmisan] Removed the slirp network binding plugin sidecar image. The plugin had no known consumers.

### RamFB 디스플레이 검증에서 vGPU가 여러 개인 템플릿 거부

- 영향 대상: `ramFB`가 있고 `enabled`가 설정되지 않은 vGPU를 포함하는 `VirtualMachine` 및 `VirtualMachineInstanceReplicaSet` 템플릿

이전에는 이러한 vGPU가 둘 이상 포함된 템플릿이 생성 시 허용된 뒤, 나중에 VMI를 생성할 때 실패할 수 있었습니다.

> - [PR #18542][thc1006] RamFB display validation now treats a vGPU whose ramFB is present with its enabled field unset as an enabled display, matching the API default. A VirtualMachine or VirtualMachineInstanceReplicaSet template with more than one such vGPU is now rejected at creation instead of being accepted and failing later when its VMI is created.

## 폐기 예정 (1)

### 레거시 게스트 에이전트 SSH 키 설정 지원 중단 예정

- 영향 대상: 레거시 게스트 에이전트의 `guest-file-write` 흐름으로 `~/.ssh/authorized_keys`에 SSH 키를 설정하는 VM
- 제거 시점: 미상

이전에는 이 흐름이 지원 중단 경고 없이 SSH 키를 `~/.ssh/authorized_keys`에 직접 기록했습니다. 이번 릴리스에서는 이 흐름을 사용하면 VMI 조건과 이벤트에 경고가 표시됩니다.

> - [PR #13881][akrejcir] Deprecated old method to set SSH key in a VM.

## 중요 수정 (74)

### SMMUv3 IOMMU `ssidsize` 처리 수정

- 영향 대상: 게스트 정의 플러그인 훅이 실행되는 Grace IOVirtualization VMI

게스트 정의 플러그인 훅이 이제 해당 VMI의 SSID 크기와 IOMMU 드라이버 속성을 보존합니다.

> - [PR #19862][kubevirt-bot] Bump libvirtxml to v1.12007.0 and fix the smmuv3 IOMMU ssidsize attribute, so Grace IOVirtualization VMIs get their SSID size and keep their IOMMU driver attributes when guest definition plugin hooks run.

### CBT 오버레이의 볼륨별 PVC 구분

- 영향 대상: CBT 증분 백업을 사용하는 설정

이전에는 볼륨이 다른 PVC를 가리키면 해당 볼륨의 오버레이를 재사용해 잘못된 증분 백업이 생성될 수 있었습니다. 이제 이런 경우에는 증분 백업 대신 전체 백업이 생성됩니다.

> - [PR #19688][kubevirt-bot] CBT overlays are now keyed by volume and PVC name. Pointing a volume at a different PVC triggers a Full backup instead of an incorrect incremental.

### 레지스트리 푸시 시 Image Index를 보존하는 OCI 내보내기 아카이브

- 영향 대상: KubeVirt OCI 내보내기 아카이브

내보낸 아카이브를 `skopeo copy --multi-arch=all`로 푸시하면 레지스트리에 플랫폼 정보가 사라진 일반 매니페스트가 저장될 수 있었고, `oras copy --from-oci-layout vm.oci.tar:latest`는 `latest`를 확인하지 못해 실패할 수도 있었습니다. 이제 아카이브는 Image Index를 블롭으로 저장하고 `index.json`에서 `ref.name: latest`로 이를 참조하므로, 레지스트리에 푸시하면 Image Index가 생성됩니다.

> - [PR #19485][0xFelix] Exported OCI archives now contain the Image Index as a blob referenced from index.json with ref.name "latest", so pushing them creates an Image Index in the registry

### [드러나지 않던 결함] 전용 CPU VM의 호스트 CPU 예약 과다 계산 수정

- 영향 대상: 전용 CPU VMI에서 `supplementalPool` IO 스레드와 `EmulatorThreadCompleteToEvenParity`를 함께 사용하는 경우

IO 스레드 수가 홀수이면 호스트 CPU를 하나 더 예약하면서도 이를 알리지 않을 수 있었습니다. 예시에서는 올바른 값인 10이 아니라 11을 요청했습니다. 이제 예약 계산 시 게스트 vCPU, IO 스레드, 에뮬레이터 스레드를 각각 한 번씩 셉니다.

> - [PR #19228][Sreeja1725] Alpha: Add CPUsWithDRA to provision dedicated VMI CPUs via a DRA CPU driver instead of kubelet's CPU manager.

### virt-handler의 외부 관리 mediated device 보존

- 영향 대상: 외부에서 생성한 mediated device를 사용하는 설정. DRA가 소유한 `vfio-ap` 디바이스와 GPU 오퍼레이터가 제공하는 디바이스 포함

`mediatedDeviceTypes`가 비어 있을 때 virt-handler의 주기적 스윕이 알 수 없는 mediated device를 삭제해, VMI가 Ready 상태를 유지하는 동안 게스트의 AP 버스가 비어 있을 수 있었습니다. 이제 virt-handler는 외부에서 생성된 디바이스를 보존합니다. 다만 `mediatedDeviceTypes`를 비우면 KubeVirt가 생성한 유형은 계속 제거됩니다.

> - [PR #19099][HarshithaMS005] virt-handler no longer deletes mediated devices it did not create, so DRA-owned vfio-ap devices are not torn out from under running VMs

### [드러나지 않던 결함] 증분 풀 모드 백업 맵에 이전에 건너뛴 변경 블록 포함

- 영향 대상: 단편화된 디스크의 증분 풀 모드 백업

블록 할당 범위와 더티 비트맵 범위의 끝 오프셋이 서로 다르면 병합 과정에서 그 사이의 변경된 익스텐트가 건너뛰어질 수 있었습니다. 이 경우 오류를 보고하지 않은 채 백업이 불완전해졌습니다. 이제 맵 생성 루프가 출력한 오프셋부터 다시 진행하므로, 이전에 건너뛴 범위를 요청해 백업에 포함합니다.

> - [PR #19315][Acedus] Fix: incremental pull-mode backups no longer silently leave out changed blocks from the backup map on fragmented disks.

### 캡처된 ControllerRevision에서 Common-instancetypes 버전 레이블 보존

- 영향 대상: `instancetype.kubevirt.io/common-instancetypes-version` 레이블이 있는 참조 대상 instancetype 또는 preference 오브젝트

이 오브젝트 중 하나를 `ControllerRevision`에 캡처할 때 레이블이 누락됐습니다. 이제 캡처된 리비전에는 업그레이드 중에도 레이블이 유지됩니다.

> - [PR #19006][lyarwood] Propagate the `instancetype.kubevirt.io/common-instancetypes-version` label from referenced instancetype and preference objects to their captured `ControllerRevision` metadata labels.

### 도메인 재부팅 시 virt-launcher의 guest-agent VMStats 캐시 초기화

- 영향 대상: `VMStatsCollector` 기능 게이트와 guest-agent 데이터를 사용하는 VMStats 수집

게스트 OS를 재부팅한 뒤에는 캐시 TTL이 만료될 때까지 VMStats에서 오래된 호스트 이름, OS 또는 네트워크 인터페이스 데이터를 반환할 수 있었습니다. libvirt가 도메인 재부팅을 보고하면 다음 VMStats 요청에서 최신 guest-agent 데이터를 가져옵니다.

> - [PR #19169][0xFelix] VMStats guest agent data is refreshed after a guest OS reboot instead of being served from cache until its TTL expires

### VM과 VMI에 잘못된 컨테이너 디스크 이미지 오류 표시

- 영향 대상: `containerDisk.image`를 사용하도록 구성된 VM

`containerDisk.image`에 잘못된 이미지 참조가 지정되어 virt-launcher init 컨테이너가 `InvalidImageName` 상태가 되면, 이전에는 VM이 `Starting` 상태에 머물고 VMI에는 오류가 표시되지 않았습니다. 이제 VMI에는 사유 `InvalidImageName`이 보고되고 VM에는 `ErrImagePull`이 표시됩니다. 이 상태에서는 VM 풀 autoheal이 적용될 수도 있습니다.

> - [PR #18872][ameya-keskar] Report InvalidImageName container disk errors on the VMI and surface ErrImagePull on the VM instead of leaving the VM stuck in Starting. Pool autoheal for VM's may apply, on the error condition, where it did not before.

### 반복 재개 및 마이그레이션 시 게스트 시계 동기화 수정

- 영향 대상: 일시 중지와 재개를 반복하거나 마이그레이션 완료 처리를 거치는 VMI

일회성 `sync.Once` 가드 때문에 `setGuestTime()`은 VMI 수명 동안 한 번만 실행되어, 이후 일시 중지 해제나 마이그레이션 완료 처리 시 시간 동기화가 이루어지지 않았습니다.

> - [PR #19089][jean-edouard] Guest clock now properly syncs after multiple pause/unpause

### 유틸리티 및 핫플러그 볼륨용 단일 연결 파드

- 영향 대상: 유틸리티 볼륨과 핫플러그 볼륨을 모두 사용하는 VM

두 볼륨 유형을 함께 사용하면 핫플러그 연결 파드가 두 개 생성될 수 있습니다. 단일 파드에는 사용하는 볼륨에 필요한 마운트와 디바이스가 포함됩니다.

> - [PR #18843][awels] BugFix: Prevent duplicate attachment pods when both utility volumes and hotplug volumes are used in a single VM

### finalizer 추가 시 `VMBackup` 상태 유실 수정

- 영향 대상: 컨트롤러가 finalizer를 추가하는 `VMBackup` 리소스 (추정)

> - [PR #18843][awels] BugFix: Prevent duplicate attachment pods when both utility volumes and hotplug volumes are used in a single VM

### [드러나지 않던 결함] 마이그레이션 실패 상태 경쟁 조건 수정

- 영향 대상: 소스 소유권 이전 중인 마이그레이션

`SourceNode`가 `TargetNode`보다 먼저 설정되면, 마이그레이션이 정상인데도 실패로 표시되는 경쟁 상태가 발생할 수 있었습니다. 이제 소유권 이전 로직은 알 수 없는 호스트로 인한 실패 경로를 따르기 전에 도메인 마이그레이션 완료 컨디션을 기다립니다.

> - [PR #18604][awels] BugFix: Fixed race condition where target node and source fields were racing which could cause a migration failed.

### CPU Manager 감지 시 `virt-handler`의 `--kubelet-root` 반영

- 영향 대상: 기본값이 아닌 kubelet 루트 디렉터리를 사용하는 클러스터(k3s, k0s, MicroK8s 포함)

이전에는 CPU Manager가 활성화되어 있는지 확인할 때 `virt-handler`가 `--kubelet-root`를 무시하고 기본 경로에서 `cpu_manager_state`를 찾았습니다. 그 결과 노드 레이블이 잘못 지정되었습니다.

> - [PR #16346][ram2valar] Fixed a bug where virt-handler ignored the --kubelet-root flag when detecting whether CPU Manager is enabled, causing incorrect node labeling on clusters with a non-default kubelet root directory (e.g. k3s, k0s, MicroK8s).```

### 의심되는 고아 스토리지 레코딩 룰의 메트릭 참조 수정

- 영향 대상: `pvc:kubevirt_suspected_orphaned_storage_bytes:info` 레코딩 룰을 사용하는 설치 환경

이 룰은 존재하지 않는 `kube_pod_spec_volumes_persistentvolumeclaims`를 참조해 해당 입력이 결과에 반영되지 않았습니다. 의심되는 고아 스토리지의 바이트 수를 계산할 때 이제 `kube_pod_spec_volumes_persistentvolumeclaims_info`를 사용합니다.

> - [PR #18986][Ronilerr] Changing recording rule expression

### virt-handler의 무응답 소켓 처리 수정

- 영향 대상: virt-handler의 무응답 도메인 소켓 처리 (추정)

이제 여러 무응답 소켓을 한 번에 정리할 수 있으며, 소켓이 응답 상태와 무응답 상태 사이를 오가는 경우에도 가능합니다. 무응답 소켓 하나의 추적을 해제해도 다른 소켓의 만료가 더는 차단되지 않습니다.

> - [PR #18970][xpivarc] Bug fix: unresponsive sockets are not correctly accounted

### UID 레이블로 같은 이름의 VM 및 VMI 타임 시리즈 재사용 문제 수정

- 영향 대상: `kubevirt_vm_info` 또는 `kubevirt_vmi_info`를 스크레이프하거나 쿼리하는 설치 환경 (추정)

이전에는 같은 이름과 네임스페이스를 가진 오브젝트를 삭제한 뒤 다시 만들면 Prometheus 타임 시리즈를 재사용했습니다. 이제 `uid` 레이블로 다시 생성된 오브젝트가 별도의 시리즈로 구분됩니다. VM UID는 중지와 시작 사이에 유지되지만, VMI UID는 시작할 때마다 바뀝니다.

> - [PR #18854][sradco] Add uid label (Kubernetes object UID) to kubevirt_vm_info and kubevirt_vmi_info

### `RunStrategyRerunOnFailure`를 사용하는 VM의 중지 상태 수정

- 영향 대상: `RunStrategyRerunOnFailure`를 사용하는 VM

이 VM을 PVC가 바인딩되지 않은 상태에서 수동으로 중지하면, 컨트롤러가 VMI를 생성하지 않았는데도 `WaitingForVolumeBinding`으로 표시될 수 있었습니다. 이제 PVC 상태와 관계없이 `Stopped`로 표시됩니다.

> - [PR #18787][davmarro] Fixed a bug where a VM with RunStrategyRerunOnFailure incorrectly showed WaitingForVolumeBinding status after being manually stopped when its PVC was unbound.

### 호스트 NUMA 거리 정보를 게스트 NUMA 셀에 전달

- 영향 대상: 호스트 NUMA 거리 데이터가 제공되는 NUMA 노드가 여러 개인 호스트의 VM (추정)

NUMA 노드가 세 개 이상인 VM에서는 이전에 원격 노드들이 모두 같은 거리에 있는 것으로 표시되어 스케줄링 결정에 제약이 있었습니다. 이제 게스트 OS에서 호스트 NUMA 거리 행렬을 확인할 수 있으며, 호스트 노드 ID는 순차적인 게스트 ID에 매핑됩니다.

> - [PR #18829][omastama-spec] Added NUMA node distance passthrough from host topology to guest VMs, enabling performance-sensitive applications to make optimal scheduling decisions on multi-NUMA systems.

### VM 경고 평가 범위를 클러스터/노드로 복원

- 영향 대상: `OrphanedVirtualMachineInstances` 또는 `VirtLauncherPodsStuckFailed` 경고 규칙

이전에는 `virt-handler`가 준비된 상태에서도 `OrphanedVirtualMachineInstances`가 VM 네임스페이스마다 한 번씩 발생할 수 있었고, `VirtLauncherPodsStuckFailed`의 200개 launcher 임계값은 단일 네임스페이스 안에서 적용됐습니다. 이제 네임스페이스 레이블은 virt-launcher 시계열에서 가져오는 대신 KubeVirt 설치 네임스페이스를 나타냅니다.

> - [PR #18822][sradco] Fix OrphanedVirtualMachineInstances false positives and VirtLauncherPodsStuckFailed per-namespace threshold by restoring cluster-scoped evaluation with a static install-namespace label

### [드러나지 않던 결함] 사이드카 훅의 XML 왕복 변환 중 QEMU 명령줄 인수 보존

- 영향 대상: XML 왕복 변환을 거쳐 QEMU `qemu:commandline` 인수를 전달하는 사이드카 훅 (추정)

이 왕복 변환 과정에서 인수가 아무런 표시 없이 누락될 수 있었습니다.

> - [PR #18460][dasionov] Fix sidecar hooks silently dropping QEMU command-line arguments (qemu:commandline) during XML round-trip

### 선호 패닉 장치 생성 문제 수정

- 영향 대상: `PreferredPanicDeviceModel`이 설정된 `VirtualMachinePreference`를 사용하는 VM

이전에는 VMI에 패닉 장치가 없으면 선호 설정이 별도 알림 없이 무시되어, 있어야 할 장치가 생성되지 않았습니다. 이제 KubeVirt는 이 경우 선호 모델을 사용하는 패닉 장치를 생성합니다.

> - [PR #18314][lyarwood] Bug fix: PreferredPanicDeviceModel now creates a panic device when none exist on the VMI, instead of silently ignoring the preference.

### SR-IOV, GPU 및 PCI 호스트 디바이스 VM 시작 실패 수정

- 영향 대상: `Plugins` 기능 게이트가 활성화되어 있고 Plugin이 하나 이상 있는 클러스터에서 SR-IOV, GPU 또는 PCI 호스트 디바이스를 사용하는 VMI

이전에는 해당 설정에서 이런 VMI가 시작되지 않았습니다. 이제 생성되는 호스트 디바이스 항목에 `subsystem` 모드가 추가되어 VMI를 시작할 수 있습니다.

> - [PR #19771][kubevirt-bot] Fix VMIs with SR-IOV, GPU or PCI host devices failing to start when the Plugins feature gate is enabled and any Plugin exists in the cluster.

### 노드 훅에 적용되는 Plugin 수준 `failureStrategy`

- 영향 대상: 자체 `failureStrategy`를 지정하지 않은 노드 훅이 있는 Plugin

Plugin의 `spec.failureStrategy: Ignore`가 설정되어 있으면, 자체 전략이 없는 노드 훅이 실패해도 VM 시작, 중지 또는 마이그레이션을 더는 차단하지 않습니다. Plugin 수준과 훅 수준 모두 전략을 설정하지 않으면 훅은 기본값으로 `Fail`을 사용하며, 훅 수준 전략이 우선 적용됩니다.

> - [PR #19863][kubevirt-bot] Node hooks now fall back to the Plugin-level failureStrategy when they do not set their own, like launcher hooks. Plugins with spec.failureStrategy: Ignore no longer block VM start, stop or migration when one of their node hooks without its own failureStrategy fails.

### device plugin 재시작 시 virt-handler 패닉 수정

- 영향 대상: 호스트 디바이스가 있는 노드

device plugin을 재시작하면 virt-handler에서 패닉이 발생할 수 있었습니다. 호스트 디바이스가 있는 노드에서는 kubelet을 재시작할 때마다 패닉이 발생했습니다.

> - [PR #19743][kubevirt-bot] Fixed a virt-handler panic when a device plugin is restarted, which on nodes with host devices happened on every kubelet restart.

### virt-handler 업그레이드 시 라이브 마이그레이션 대상 지정 수정

- 영향 대상: 롤링 업그레이드 중 라이브 마이그레이션 (추정)

업데이트된 virt-handler 노드에서 시작한 마이그레이션이 아직 업데이트되지 않은 노드로 스케줄링되어 멈출 수 있었습니다. 이 수정으로 대상은 원하는 virt-handler 이미지를 실행 중인 노드로 제한됩니다.

> - [PR #19732][stu-gott] Live migrations are no longer scheduled from a node running an updated virt-handler onto a node that has not yet been updated, preventing migrations from getting stuck during a rolling upgrade.

### virt-handler gRPC 연결 누수 수정

- 영향 대상: virt-handler 클라이언트 초기화 (추정)

`NewClient` 초기화 중 `newClientWithInfoClient`가 실패하면 gRPC 연결이 열린 채 남을 수 있었습니다. 이제 해당 경로에서 연결을 닫으며, 오류는 계속 반환합니다.

> - [PR #19492][caxu-rh] Fixed a bug that caused a gRPC connection to leak when virt-handler client initialization fails

### External 스냅샷 충돌 후 VM 시작 시 오버레이 복구

- 영향 대상: External 스냅샷을 사용하는 VM

External 스냅샷 중 `virt-launcher`가 충돌해 VM 디스크가 오버레이에 남으면, 이전에는 시작이 `ManualRecoveryRequired`로 중단됐습니다. 쓰기를 복구하려면 오버레이를 수동으로 커밋하거나 스냅샷을 복원해야 했습니다. 이제 VM 시작 시 교체된 VMI가 남아 있는 오버레이로 부팅하고, 오버레이의 쓰기를 실시간으로 커밋합니다. 이로써 시작 차단이 해제되며, 커밋이 검증된 뒤 스크래치 볼륨이 해제됩니다. 볼륨 또는 스크래치 상태 검사에 실패하면 복구는 여전히 거부됩니다.

> - [PR #19574][noamasu] Guest writes are recovered when a VM starts after a virt-launcher crash during an External mode snapshot.

### 핫플러그 마운트 teardown 시 PVC 파일 보존

- 영향 대상: 핫플러그 마운트 루트를 통해 마운트된 핫플러그 볼륨을 사용하는 VM 워크로드 (추정)

kubelet 정리가 virt-handler의 유틸리티 볼륨 마운트 해제보다 먼저 실행되면 해당 볼륨의 PVC에 있는 파일이 삭제될 수 있었습니다. 이제 teardown 시 메모리 기반 루트를 마운트 해제해 마운트된 PVC의 파일을 보존합니다.

> - [PR #19520][noamasu] Use a memory-backed emptyDir for the hotplug mount root to support mount propagation.

### 비활성화 및 디스크 핫 언플러그 시 고아 CBT 오버레이 정리

- 영향 대상: CBT를 사용하며 백엔드 PVC를 유지하거나 핫 언플러그된 디스크를 사용하는 환경

특정 상황에서 디스크를 핫 언플러그하거나 CBT를 비활성화하면 고아 오버레이가 남을 수 있었습니다. 이제 이러한 오버레이를 제거합니다. CBT를 다시 활성화한 뒤 수행하는 다음 백업은 체크포인트 재정의에 실패하는 대신 전체 백업으로 폴백합니다.

> - [PR #19435][awels] Cleanup CBT overlays when disabling CBT

### VirtualMachineExport 볼륨 이름 충돌 수정

- 영향 대상: 클레임 이름이 점만 다르거나 고정된 익스포터 Pod 볼륨 이름과 충돌하는 클레임을 가진 VM의 VirtualMachineExport

클레임 이름을 정제하는 과정에서 `my.disk`와 `my-disk`처럼 점만 다른 이름이 중복된 볼륨 이름을 만들었습니다. 그 결과 API 서버가 익스포터 Pod를 거부해 내보내기가 완료되지 않았습니다. 이제 Pod는 인덱스 기반의 고유한 볼륨 이름을 사용하므로 내보내기가 완료됩니다.

> - [PR #19064][0xFelix] Fixed a bug where a VirtualMachineExport of a VM with two claims whose names differ only in dots would never complete

### `InjectNotify` 오류 반환 전 리스너 닫기

- 영향 대상: Unix 소켓과 함께 `InjectNotify`를 사용하는 경우

소켓 경로가 유효하지 않거나 파일 소유권 설정에 실패하면, `InjectNotify`는 오류를 반환하면서 리스너를 열린 상태로 남길 수 있었습니다.

> - [PR #19534][caxu-rh] Fixed a bug where a Unix socket listener may be left open if an error occurs while setting file ownership on the socket

### VMI 삭제 시 백업의 신속한 실패

- 영향 대상: VMI 백업

백업 도중 VMI가 상태 변경 없이 삭제되면, 이전에는 백업이 TTL이 만료될 때까지 pending 상태로 남아 있었습니다. 이제 백업은 `SourceLost`로 실패하고 pull-mode export는 제거됩니다.

> - [PR #19484][Acedus] Backups whose VMI is deleted mid-backup now fail immediately, and pull-mode backups remove their export.

### 하위 명령 실패에도 성공한 통계 보존

- 영향 대상: `GetVMStats`를 통해 VMStats를 수집하는 설정 (추정)

이전에는 하위 명령 하나가 실패하면 virt-handler가 다른 하위 명령에서 반환된 데이터를 버렸습니다. 이제 실패는 `VMStats.Errors` 맵에 기록됩니다.

> - [PR #19192][machadovilaca] Keep partial VMStats when a sub-command fails

### 중복 PVC 내보내기 실패 시 상태 보고

- 영향 대상: VM, VMSnapshot 또는 VMTemplate를 소스로 하는 `VirtualMachineExport` 중 여러 볼륨에서 동일한 PVC를 참조하는 항목

이전에는 볼륨 이름이 중복되면 상태를 기록하기 전에 exporter 파드가 거부되어, export의 phase가 비어 있고 조건도 없으며 backoff가 끝없이 이어졌습니다. 이제 클레임 이름을 명시한 `DuplicatePVC` Ready 조건과 함께 `Pending` 상태를 보고하며, 중복 참조가 수정될 때까지 exporter 파드를 생성하지 않습니다.

> - [PR #19057][0xFelix] Fixed a bug where a VirtualMachineExport of a source referencing the same PVC from more than one volume would never complete

### SeaBIOS의 PCI 홀 설정 반영

- 영향 대상: SeaBIOS를 사용하고 `kubevirt.io/disablePCIHole64` 어노테이션이 있는 VM

이전에는 SeaBIOS가 QEMU 설정을 무시하고 자체적으로 64비트 PCI 홀을 설정했으므로, 메모리가 4Gi를 초과하는 게스트에도 PCI 홀이 남아 있을 수 있었습니다. 이제 SeaBIOS는 해당 홀을 그대로 두므로, Windows Server 2003 같은 레거시 게스트를 4Gi 이상의 메모리로 실행할 수 있습니다.

> - [PR #18941][0xFelix] The kubevirt.io/disablePCIHole64 annotation now also stops SeaBIOS from programming a 64-bit PCI hole, allowing legacy guests like Windows Server 2003 to run with 4Gi of memory or more.

### Velero 백업 후 동결 해제 타임아웃을 60초로 연장

- 영향 대상: 백업 후 동결 해제 훅이 있는 Velero 백업

이전에는 Windows 게스트의 동결 해제에 20초 넘게 걸리면, post-hook 타임아웃 어노테이션 값과 관계없이 내부 gRPC 타임아웃으로 동결 해제가 실패할 수 있었습니다. 이제 동결 해제는 최대 60초 동안 실행될 수 있으며, 생성되는 백업 후 훅은 `post.hook.backup.velero.io/timeout`을 `60s`로 설정합니다.

> - [PR #19166][alromeros] Bugfix: Increase timeout for velero post-backup hook

### 온라인 파일 기반 디스크 확장에 PVC 용량 사용

- 영향 대상: PVC 기반 파일 디스크를 온라인 확장 중인 VM (추정)

파일시스템 볼륨에서 I/O가 진행되는 동안 여유 공간이 변하면 `BlockResize`가 반복해서 시도될 수 있었습니다.

> - [PR #19120][akalenyu] BugFix: blockresize spam when doing I/O for filesystem volumes

### 온라인 `BlockResize`의 게스트 디스크 축소 방지

- 영향 대상: 온라인 디스크 리사이징을 사용하는 VM (추정)

새로 관측한 용량이 추적 중인 크기보다 작거나 같으면, KubeVirt는 게스트 디스크를 축소하는 대신 리사이즈를 건너뜁니다.

> - [PR #19120][akalenyu] BugFix: blockresize spam when doing I/O for filesystem volumes

### cgroup 재생성 후에도 유지되는 `/dev/urandom` 접근 권한

- 영향 대상: virtio-rng 디바이스가 없는 VMI

블록 볼륨 핫플러그 또는 라이브 마이그레이션 중 cgroup 허용 목록을 다시 만들 때 `/dev/urandom` 접근 권한이 사라질 수 있었습니다. s390x에서는 이로 인해 `virtqemud`가 충돌하고 sync 또는 마이그레이션이 실패할 수 있었습니다. 이제 기본 디바이스 규칙은 VMI 설정이나 아키텍처에 관계없이 cgroups v1과 v2에서 cgroup을 다시 만들 때마다 `/dev/urandom` 접근을 허용합니다.

> - [PR #19131][vishnubijukumar] Fixed a bug where hotplugging a block volume or triggering a live migration on s390x crashed virtqemud due to /dev/urandom being removed from the cgroup device allow list. /dev/urandom (char 1:9) is now unconditionally included in the default cgroup device rules, consistent with the OCI runtime specification. This also fixes a latent bug on x86_64 where /dev/urandom was incorrectly revoked but masked by the RDRAND hardware entropy fallback.

### OCI 내보내기에서 디스크가 아닌 백엔드 디렉터리 건너뛰기

- 영향 대상: 영구 TPM 또는 EFI 백엔드 스토리지를 사용하는 VM의 OCI VirtualMachineExport

다이제스트 처리 단계에서 백엔드 상태 디렉터리의 `disk.img`를 열려고 했기 때문에 내보내기가 `Pending` 상태에 머물렀고, 디스크나 매니페스트를 제공하지 못했습니다. 이제 해당 디렉터리를 건너뛰고 내보내기 콘텐츠를 제공합니다.

> - [PR #19085][0xFelix] Fixed a bug where an OCI VirtualMachineExport of a VM with a persistent TPM or EFI never became ready

### KubeVirt 이미지의 Centos Stream 10 소켓 경로 호환성 수정

- 영향 대상: `virt-handler` 또는 `vm-killer` 이미지를 사용하는 Centos Stream 10 기반 배포 (추정)

Centos Stream 10은 소켓을 `/run/`에 생성하지만 KubeVirt는 소켓이 `/var/run/`에 있다고 가정합니다. 이로 인해 `vm-killer`가 dbus 소켓을 찾지 못하고 `virt-handler`가 multipathd 소켓을 마운트하지 못했습니다. 이제 이미지에 `/var/run -> ../run` 심볼릭 링크가 포함되어 `/var/run/`이 `/run/`을 가리킵니다.

> - [PR #18951][dsanatar] image changes for Centos Stream 10 compatibility, notably adds /var/run -> ../run symlink to virt-handler image layer due to how CS10 creates sockets in /run/ but kubevirt expects them to exist in /var/run/

### Vera Rubin GPU 패스스루 구성 수정

- 영향 대상: `GraceIOVirtualization`을 사용하는 상태에서 NVIDIA Vera Rubin GPU(`10de:3041`)를 패스스루하는 VM

이전에는 `virt-handler`가 해당 GPU를 Grace GPU로 인식하지 못해 `virt-launcher`가 필요한 도메인 구성을 건너뛰었습니다. 이제 `virt-launcher`는 해당 GPU에 2 TiB `pcihole64` 어퍼처와 `arm-smmuv3` IOMMU 모델을 구성합니다.

> - [PR #19070][lyarwood] Vera Rubin GPU (10de:3041) is now recognised as a Grace GPU, enabling GraceIOVirtualization for VMs with a passthrough Vera Rubin GPU.

### 종료된 런처 pod UID를 VMI 활성 pod 상태에서 제외

- 영향 대상: 핫플러그 볼륨 조정을 수행하는 VMI

라이브 마이그레이션이 성공한 뒤에도 `Succeeded` 또는 `Failed` phase인 종료된 소스 런처 pod가 대상 UID와 함께 `VMI.status.activePods`에 남아 있을 수 있었습니다. 이로 인해 `findVirtlauncherUID()`가 빈 UID를 반환하고 핫플러그 조정이 `SyncFailed`와 함께 반복될 수 있었습니다. 이제 종료된 pod는 제외되어 실행 중인 대상 UID만 남으므로 핫플러그 조정을 진행할 수 있습니다.

> - [PR #18287][dasionov] Ensure terminated launcher pods are pruned from VMI status.activePods after live migration

### Prometheus EndpointSlice 디스커버리 권한 수정

- 영향 대상: KubeVirt 네임스페이스에서 EndpointSlice를 통한 Prometheus 타깃 디스커버리

Prometheus CR에서 `serviceDiscoveryRole`을 `EndpointSlice`로 설정하면 Prometheus가 타깃 디스커버리를 위해 해당 EndpointSlice를 목록 조회할 수 있습니다.

> - [PR #19041][machadovilaca] Allow Prometheus to list EndpointSlices in the KubeVirt namespace

### 오프라인 PVC 확장 시 실제 사전 할당 상태 확인

- 영향 대상: 씬 프로비저닝된 PVC/DataVolume 기반 디스크 (추정)

오프라인 PVC 확장 중에는 가상 크기와 할당 크기만을 근거로 가득 찬 씬 프로비저닝 디스크를 사전 할당된 것으로 잘못 판단할 수 있었습니다. 그 결과 확장된 공간이 불필요하게 사전 할당될 수 있었습니다.

> - [PR #18827][germanovm] Fix PVC expansion preallocating new space on full thin provisioned disks

### 내보내기 매니페스트 `ConfigMap`의 오래된 CA 수정

- 영향 대상: `VirtualMachineExport` 매니페스트를 사용하는 CDI 디스크 가져오기

내보내기 CA를 교체하고 exporter Pod를 다시 만든 뒤에도 기존 매니페스트 `ConfigMap`에 이전 CA가 남아 있을 수 있었습니다. 이 `ConfigMap`을 사용하는 CDI 가져오기는 TLS 검증에 실패할 수 있었습니다. 이제 컨트롤러가 기존 `ConfigMap`을 새 CA로 업데이트합니다.

> - [PR #18965][lukashes] Fixed VirtualMachineExport manifests retaining stale CA certificates when exporter Pods are recreated after CA rotation, which could cause CDI disk imports to fail TLS verification

### 탈중앙화 라이브 마이그레이션 중 소스 고스트 레코드 누수 수정

- 영향 대상: 나중에 같은 이름의 VMI가 같은 노드에 스케줄링될 수 있는 탈중앙화 라이브 마이그레이션

부하가 높은 소스 노드에서는 정리 과정에서 잠깐 나타나는 `Shutoff+Migrated` 상태를 놓칠 수 있었습니다. 그 결과 고스트 레코드가 남아 나중에 같은 이름의 VMI가 등록하고 시작하는 것을 막고, 마이그레이션이 시간 초과될 수도 있었습니다. 소스가 종료 상태가 되면 virt-handler는 이제 `sync()`를 계속 실행해 소스 고스트 레코드를 삭제합니다. 이에 따라 새 UID를 가진 같은 이름의 수신 VMI가 해당 노드에 등록하고 시작할 수 있습니다.

> - [PR #18988][davmarro] Fixed a source-side ghost record leak on decentralized live migration that could prevent a subsequent same-name VirtualMachineInstance from starting on the same node.

### Windows UDF 미디어에서 `GuestFilesystemAlmostOutOfSpace` 경보가 잘못 발생하는 문제 수정

- 영향 대상: `GuestFilesystemAlmostOutOfSpace`로 모니터링되는 UDF CDROM/ISO를 연결한 Windows VM

QEMU Guest Agent는 연결된 광학 미디어의 여유 공간을 0바이트로 보고합니다. 파일 시스템 유형 제외 조건이 대소문자를 구분해 대문자 `UDF`를 제외하지 못하면서 경보가 발생했습니다. 이제 제외 조건이 대소문자를 구분하지 않으므로 UDF CDROM/ISO 미디어에서는 경보가 더 이상 발생하지 않습니다.

> - [PR #18994][avlitman] Fix GuestFilesystemAlmostOutOfSpace firing on Windows VMs when a UDF CDROM/ISO is attached.

### Down 알림과 동시에 발생하지 않도록 수정된 NoReady 알림

- 영향 대상: KubeVirt VirtController, VirtHandler 또는 API의 NoReady 및 Down 모니터링 알림 (추정)

이전에는 Down 알림과 NoReady 알림이 동시에 발생할 수 있었습니다. 이제 NoReady 알림은 실행 중이지만 준비 상태가 아닌 파드에 대해서만 발생합니다.

> - [PR #18942][Ronilerr] Fix no ready alerts

### PCI 패스스루 시작 실패 수정

- 영향 대상: `CONFIG_VFIO_DEVICE_CDEV`를 지원하지 않는 호스트에서 PCI 호스트 디바이스 패스스루를 사용하는 VM

`IOMMUFD` 기능 게이트를 꺼도 해당 VM이 시작되지 않았습니다. IOMMUFD를 지원하지 않는 커널에서는 존재하지 않는 cdev 디바이스를 건너뛰고 `/dev/vfio/<group>`을 사용해 패스스루를 수행합니다. IOMMUFD를 지원하는 커널에서는 기존 cdev 동작을 유지합니다.

> - [PR #18905][fossedihelm] Fix PCI passthrough regression on kernels without CONFIG_VFIO_DEVICE_CDEV support. VMs with GPU/PCI host devices now correctly fall back to legacy VFIO group interface when IOMMUFD cdev is unavailable.

### hugepages 사용 VMI의 메모리 오버커밋 우회

- 영향 대상: hugepages를 사용하도록 구성된 VMI

이전에는 이러한 VMI에 메모리 오버커밋을 적용하면 정렬되지 않은 메모리 값이 생성됐습니다. 이제 오버커밋을 적용하지 않은 메모리 값을 사용합니다.

> - [PR #18880][jean-edouard] Memory overcommit is now ignored for VMIs with hugepages

### VFIO 디바이스 소유권 오류 처리 수정

- 영향 대상: VFIO 디바이스 소유권 준비를 사용하는 설정

VFIO 디바이스 소유권을 준비하는 동안 런처 마운트 루트를 확인하지 못하면 nil 포인터 역참조로 virt-handler가 종료되고 해당 노드에서 VM 조정이 중단될 수 있었습니다. 이제 `os.ErrNotExist` 이외의 오류는 호출자에게 반환되며, 호출자는 이를 virt-handler를 종료하는 대신 `SyncFailed` 이벤트로 전달합니다.

> - [PR #18867][cwedgwood] Fix a virt-handler crash that could occur when preparing VFIO device ownership fails.

### virt-handler 고스트 및 마운트 레코드의 원자적 디스크 기록

- 영향 대상: virt-handler가 고스트 또는 마운트 레코드를 디스크에 기록하는 설정

virt-handler가 레코드를 기록하는 도중 재시작하면 구현에서 데이터가 유실되거나 손상된 레코드가 생성될 수 있었습니다.

> - [PR #18716][xpivarc] Bug fix: Ensuring that records (ghost records, mount records) are written atomically to disk

### QEMU 시작 지연 중 발생하던 도메인 조기 정의 해제 문제 수정

- 영향 대상: 핫플러그를 사용하는 VM (추정)

QEMU 시작이 지연되면 도메인을 너무 일찍 정의 해제해 VM이 transient 상태로 남고 핫플러그가 작동하지 않았습니다. 업그레이드 후에는 이 조기 정의 해제 문제가 해결됩니다.

> - [PR #18545][amasolov] Fix premature domain undefine during slow QEMU startup that left VMs transient and broke hotplug

### CBT 백엔드 PVC 요청량 1Gi 증가

- 영향 대상: CBT가 활성화되어 있고 백엔드 영구 상태 PVC가 필요한 VM

이전에는 해당 PVC가 10Mi만 요청했으며, 이는 대부분의 CBT 사용 사례에 충분하지 않았습니다.

> - [PR #18470][Acedus] Backend storage PVC size is increased by 1Gi for VMs with CBT enabled.

### 잠금된 도메인에서 도메인 통계 수집 대기 제거

- 영향 대상: 라이브 마이그레이션 중 도메인 통계 수집

라이브 마이그레이션 중 `GetDomainStats()`는 마이그레이션이 보유한 libvirt 작업 잠금 때문에 최대 30초까지 대기할 수 있었습니다. 이로 인해 시간 초과와 오류 로그가 발생하고, virt-launcher 상태를 모니터링하는 업그레이드 흐름이 방해받을 수 있었습니다. 이제 잠금된 도메인은 건너뛰고 캐시된 값을 제공하며, 그 밖의 경우에는 통계 수집이 계속됩니다. 다만 마이그레이션 중 건너뛴 도메인에서는 약 3.25초마다 `empty DomainStats` 오류 로그가 계속 발생할 수 있습니다.

> - [PR #18362][iholder101] Bug fix: During live migration, domain stats collection no longer blocks on the libvirt job lock for up to 30 seconds. The NOWAIT flag is used to skip locked domains instead of waiting, avoiding lock contention and disruptive error logs.

### vmexport 프록시 파일 디스크립터 누수 수정

- 영향 대상: vmexport 프록시를 사용하는 환경 (추정)

이 수정 전에는 vmexport 프록시에서 파일 디스크립터가 누수됐습니다.

> - [PR #18400][awels] BugFix: file descriptor leak in vmexport proxy

### `client-go` `AsyncSubresourceHelper` 누수 수정

- 영향 대상: `AsConn()`을 사용하는 `AsyncSubresourceHelper` `StreamInterface` 사용자

`Stream()` 대신 `AsConn()`을 사용하면 고루틴과 연결 리소스가 누수됐습니다. 이제 `AsConn()` 경로에서는 이런 누수가 발생하지 않습니다.

> - [PR #18410][vikin91] Fix a goroutine (and connection resource) leak in client-go's AsyncSubresourceHelper when its StreamInterface is consumed via AsConn() instead of Stream() (affects VSOCK, PortForward TCP/UDP, and similar consumers).

### 실행 중인 VMI에 3분간 launcher 재연결 유예 기간 적용

- 영향 대상: 실행 중인 VMI

virt-handler가 재시작되어 launcher 소켓 연결이 일시적으로 끊기면, 실행 중인 VMI는 이전에는 즉시 Failed로 표시됐습니다. 이제 VMI는 Failed로 전환되기 전에 3분간의 재연결 유예 기간 동안 유지됩니다.

> - [PR #18453][iholder101] Bug fix: Running VMIs are no longer immediately marked as Failed when virt-handler restarts and temporarily loses the launcher socket connection. A 3-minute grace period (matching the existing Scheduled VMI behavior) now allows the launcher client to reconnect before transitioning the VMI to Failed.

### 잘못 구성된 네트워크 인터페이스 바인딩 어드미션 거부

- 영향 대상: 바인딩이 없거나 둘 이상 설정된 네트워크 인터페이스가 있는 VM 또는 VMI

이전에는 이러한 인터페이스가 어드미션 단계에서 거부되지 않아 런타임에 조용히 실패했습니다.

> - [PR #18374][orelmisan] Fixed missing validation for network interface bindings: interfaces with no binding or multiple bindings are now rejected at admission instead of failing silently at runtime.

### virt-launcher 컨테이너에 노출되는 VFIO cdev 장치

- 영향 대상: SMMUv3가 있는 ARM64 시스템에서 IOMMUFD 기반 GPU 패스스루를 사용하는 경우

ARM64 시스템에서 SMMUv3를 사용할 때 IOMMUFD 기반 GPU 패스스루가 작동하도록 수정했습니다.

> - [PR #18300][lyarwood] Bug fix: Expose VFIO cdev devices (/dev/vfio/devices/vfioN) to virt-launcher containers, fixing IOMMUFD-based GPU passthrough on ARM64 systems with SMMUv3.

### 핫플러그 어태치먼트 pod의 VMI 오너 확인 폴백

- 영향 대상: 핫플러그 어태치먼트 pod

virt-launcher pod가 삭제된 뒤 어태치먼트 pod 이벤트가 처리되면 오너 확인에 실패해 VMI에 알림이 전달되지 않을 수 있었습니다. 이제 오너 레퍼런스 체인으로 VMI를 확인할 수 없는 경우 어태치먼트 pod의 오너 이름 및 UID 어노테이션을 폴백으로 사용합니다.

> - [PR #18222][lukashes] Fixed VMI owner resolution when an attachment pod is deleted while the virt-launcher pod is gone

### 핫플러그 볼륨 분리 데드락 수정

- 영향 대상: 핫플러그 볼륨 분리

이미 제거된 핫플러그 볼륨을 분리할 때 데드락이 발생할 수 있었습니다.

> - [PR #18044][maxwmsft] BugFix: hotplug volume detach deadlock for already removed volumes.

### 핫플러그 볼륨 분리 교착 상태 수정

- 영향 대상: 어태치먼트 파드 간에 RWO PVC를 교체하는 VMI

이러한 교체 과정에서 핫플러그 볼륨을 분리할 때 교착 상태가 발생할 수 있었습니다.

> - [PR #18045][maxwmsft] BugFix: hotplug volume detach deadlock when VMIs exchange RWO PVCs between attachment pods.

### 메모리 잠금이 필요한 VM의 세션 모드 memlock 계산 수정

- 영향 대상: VFIO, 실시간, SEV 또는 명시적 memlock 설정을 위해 메모리 잠금이 필요하고 세션 모드로 실행되는 VM

이러한 VM에서는 libvirt의 memlock 계산이 실패할 수 있었습니다. 이제 memlock `prlimit`이 무제한으로 설정되어 계산이 성공합니다.

> - [PR #17857][lyarwood] Set unlimited memlock prlimit for VMs requiring memory locking (VFIO, realtime, SEV, explicit memlock), ensuring libvirt's memlock calculation always succeeds in session mode.

### 마이그레이션 불가능한 VM의 NAD 변경 시 재시작 필요

- 영향 대상: 마이그레이션할 수 없는 VM의 NAD 참조

NAD 참조가 변경되면 VMI spec에 동기화되고 `MigrationRequired` 컨디션이 발생했습니다. VM은 마이그레이션할 수 없었기 때문에 컨디션이 계속 유지됐고 변경 사항은 적용되지 않았습니다. 이제 변경된 참조를 VMI spec에 반영하지 않습니다.

> - [PR #18194][frenzyfriday] Require restart for NAD swap for non-migratable VMs

### virt 수 부족 알림에서 `running` 규칙 사용

- 영향 대상: virt 수 부족 알림을 사용하는 설정 (추정)

이전에는 이 알림에서 `running` 규칙 대신 `up` 규칙을 사용했습니다.

> - [PR #18380][Ronilerr] Low virt count alerts are using running rule intead of up rule

### NFS 스토리지를 사용하는 VM의 잘못된 재시작 수정

- 영향 대상: NFS 스토리지를 사용하는 VM

NFS 서버 페일오버와 같이 NFS를 일시적으로 사용할 수 없는 동안 해당 VM이 잘못 재시작될 수 있었습니다. 이제 이러한 일시적인 사용 불가로 인해 VM이 잘못 재시작되지 않습니다.

> - [PR #17752][iholder101] Bug fix: VMs with NFS-backed storage are no longer incorrectly restarted during temporary NFS unavailability (e.g., NFS server failover).

### 백엔드 스토리지의 VM 복원 처리 수정

- 영향 대상: 스냅샷을 지원하지 않는 `VMStateStorageClass`를 사용하는 VM

`VMStateStorageClass`가 스냅샷을 지원하지 않으면 백엔드 PVC를 스냅샷에 포함할 수 없어 복원 문제가 발생했습니다. 이제 복원 과정에서 스냅샷 내용에 없는 백엔드 볼륨은 리컨실리에이션을 건너뛰고 기존 백엔드 PVC를 재사용합니다.

> - [PR #17286][alromeros] Bugfix: Fix VM restore when backend storage is not snapshottable

### `kubevirt-plugin-sidecar-subpath-policy`의 임포터 Pod 거부 수정

- 영향 대상: `kubevirt-plugin-sidecar-subpath-policy`를 사용하는 설치 환경 (추정)

정책의 `matchConditions`가 임포터 Pod를 평가할 때 해당 Pod가 거부될 수 있었습니다. 이제 정책은 CEL 평가 전에 `objectSelector`로 virt-launcher Pod를 선택합니다.

> - [PR #18392][akalenyu] BugFix: Importer pod rejected by ValidatingAdmissionPolicy 'kubevirt-plugin-sidecar-subpath-policy'

### `hugetblfs-dir` EmptyDir의 hugepage 백킹 수정

- 영향 대상: `hugetblfs-dir` EmptyDir를 사용하는 VM (추정)

QEMU가 `-mem-path`를 통해 hugepage를 요청할 때, 이 볼륨이 `/dev/hugepages`의 상위 hugetlbfs 마운트를 가려 할당을 막았습니다. 이제 EmptyDir가 명시적으로 hugepage를 백킹하므로 이 문제가 해결됩니다.

> - [PR #18272][laxmi-333] Bug fix: Fixed hugetblfs-dir EmptyDir volume masking the parent hugetlbfs mount at /dev/hugepages, which prevented QEMU from allocating hugepages via -mem-path. The EmptyDir is now explicitly hugepage-backed.

### VMI 컨트롤러의 expectations 타임아웃 후 동기화 재시도

- 영향 대상: 파드, VMI 또는 PVC expectations가 관련된 VM/VMI 삭제

expectations가 충족되지 않은 상태에서 파드 이벤트가 컨트롤러를 깨우지 않으면, 삭제 처리가 기본적으로 몇 시간 뒤에 진행되는 다음 informer 리싱크까지 기다릴 수 있었습니다. 이제 expectations 타임아웃이 지나면 재시도합니다. 기본 타임아웃은 5분입니다.

> - [PR #18206][lukashes] Fixed a delay in VM/VMI deletion that could happen when the VMI controller missed a pod event.

### `ClusterConfig` CRD 삭제 핸들러의 tombstone 패닉 수정

- 영향 대상: `ClusterConfig` CRD를 사용하는 설치 환경

CRD 삭제 이벤트를 놓친 뒤 informer가 CRD 대신 `cache.DeletedFinalStateUnknown` tombstone을 전달해 핸들러에서 패닉이 발생할 수 있었습니다. 이제 핸들러는 tombstone에서 CRD를 추출합니다. tombstone을 풀 수 없거나 tombstone 안에 CRD가 없으면 오류를 로그에 남기고 반환합니다.

> - [PR #17880][Shreesha001] Fix panic in ClusterConfig CRD delete handler when the informer delivers a tombstone object instead of the deleted CRD.

## 기능·개선 (39)

- `IncrementalBackup` 기능 게이트 베타 승격
- Backup API `backup.kubevirt.io/v1beta1` 도입
- 중지된 VM의 증분 백업 (사용 조건: 기본적으로 비활성화되어 있으며 `IncrementalBackup`이 필요한 `OfflineIncrementalBackup` 기능 게이트)
- External 모드 `VirtualMachineSnapshot` 스냅샷의 QCOW2 오버레이 사용 (사용 조건: External 모드 사용을 위한 `ExternalVMSnapshot` 기능 게이트(Alpha) 활성화)
- ARM64 게스트용 UEFI Secure Boot 알파 지원 (사용 조건: `ARM64SecureBoot`와 `FirmwareAutoSelection` 기능 게이트 모두, 그리고 적합한 QEMU, libvirt, edk2 펌웨어가 포함된 CentOS Stream 10 virt-launcher 이미지)
- 전용 VMI CPU용 알파 DRA 할당 (사용 조건: `CPUsWithDRA` 기능 게이트 활성화)
- 준비된 네트워크 인터페이스의 VMI `pod-status` 보고 (사용 조건: `NetworkDevicesWithDRA` 기능 게이트 활성화)
- 선언형 VM 상태 PVC 선택 및 생성 (사용 조건: `DeclarativeVMState` 기능 게이트)
- virtio-scsi 컨트롤러의 다중 I/O 스레드 (사용 조건: `SCSIMultiIOThread` 기능 게이트 활성화 및 VMI에 `IOThreadsPolicy` 할당)
- virtio-blk `auto` IOThread 정책에 풀 할당 추가 (사용 조건: `MultiIOThreadAutoPolicy` 설정 토글과 `SCSIMultiIOThread` 기능 게이트를 함께 활성화)
- `kubevirt_vmi_info` 메트릭에 패닉 디바이스 레이블 추가
- 사이드카 플러그인용 `PreBoot` 런처 훅
- libvirt 마이그레이션 파라미터용 사이드카 `PreMigrationSource` 훅
- `pkg/render`에 클러스터 없이 VM을 Pod로 렌더링하는 기능 추가
- virt Pod 엔드포인트의 TLS 키 교환 그룹 설정 (사용 조건: `TLSGroupPreferences` 기능 게이트 활성화 및 원하는 그룹으로 `TLSConfiguration.Groups` 설정 필요. 해당 기능 게이트는 알파 단계이며 기본적으로 비활성화.)
- 라벨이 지정된 Route, Ingress, Service에서 프록시 모드 마이그레이션 엔드포인트 디스커버리 (사용 조건: 프록시 모드 활성화, 클러스터 간 네트워크 미구성, 적절한 엔드포인트 디스커버리 라벨이 지정된 Route, Ingress 또는 Service)
- virt-handler가 노출하는 최신 성공 VMI 마이그레이션 다운타임 게이지
- `Virt*Down` 알림에 컨테이너 대기 사유 추가
- VM 게스트 메모리를 커널 메모리 병합에서 제외 (사용 조건: 커널 메모리 병합에서 제외하려면 VMI의 `kubevirt.io/mergeable-memory` 어노테이션을 `false`로 설정)
- GPU 사용률 및 그래픽 엔진 활성 시간 레코딩 룰 추가
- 분산형 라이브 마이그레이션을 위한 TCP 프록시 지원 (사용 조건: `DecentralizedLiveMigration` 기능 게이트)
- DCGM 메트릭용 VMI GPU 레코딩 룰
- VM 디스크에 `directsync` 캐시 모드 추가 (사용 조건: VM 디스크에 `cache=directsync`를 설정하세요.)
- `virtctl port-forward`, `virtctl ssh`, `virtctl scp`용 VSOCK 전송 (사용 조건: VSOCK 전송을 사용하려면 `--vsock`을 설정합니다. `virtctl port-forward`에서는 `--vsock-tls`가 TLS 핸드셰이크를 제어하며 기본값은 true입니다.)
- `VMStatsCollector`를 통한 게스트 디바이스 페이로드 전달
- `GetVMStats`에 게스트 파일 시스템 정보 추가 (사용 조건: `GetVMStats` 요청의 `GuestGetFsInfo`)
- DRA 네트워크 클레임을 바인딩 사이드카와 마이그레이션 대상에 전달
- 고아 상태로 의심되는 PVC 스토리지용 KubeVirt 레코딩 룰
- 동적 라이브 마이그레이션 다운타임 조정 (사용 조건: 알파 `MigrationDowntimeTuning` 기능 게이트 및 `MigrationPolicy`의 `.spec.experimental.downtimeTuning`을 통한 명시적 활성화)
- ImageVolume containerDisk의 OCI 아티팩트 및 이미지 루트 디스크 지원 (사용 조건: 컨테이너가 아닌 OCI 아티팩트에서 호환되지 않는 다이제스트 해석 초기화 컨테이너를 건너뛰기 위한 VMI 어노테이션 설정: `kubevirt.io/image-volume-skip-digest-resolution: "true"`)
- KubeVirt 알림에 네임스페이스 라벨 추가
- 네트워크 바인딩 플러그인 사이드카 등록 이름 추론 (사용 조건: `NETWORK_BINDING_PLUGIN_NAME` 환경 변수)
- KubeVirt의 `kubevirt_vmi_guest_os_panic_total` 메트릭 제공
- `virtctl addvolume`에서 디스크 이름과 소스 볼륨 이름 분리 (사용 조건: `virtctl addvolume`의 `--disk-name`)
- 스냅샷 기반 `inferFromVolume` 지원 (사용 조건: 스냅샷 기반 DataVolume, DataVolumeTemplate 또는 DataSource에 설정된 `inferFromVolume`)
- KubeVirt에 리더 virt-controller 레코딩 룰과 알림 추가
- 기본 제공 KubeVirt 역할에 VM 메모리 덤프 제거 권한 추가
- 라이브 마이그레이션 스트림의 선택적 zstd 압축 (사용 조건: `AdvancedLiveMigration` 기능 게이트)
- `virt-handler`의 로컬 네임스페이스 모드 VSOCK 다이얼링 (사용 조건: `ns_mode`를 `local`로 설정)

## 의존성 갱신 (7)

### KubeVirt 빌드 툴체인을 Go 1.26.10으로 업그레이드

- [GO-2026-6599](https://osv.dev/vulnerability/GO-2026-6599), [GO-2026-6600](https://osv.dev/vulnerability/GO-2026-6600), [GO-2026-6603](https://osv.dev/vulnerability/GO-2026-6603), [GO-2026-6604](https://osv.dev/vulnerability/GO-2026-6604), [GO-2026-6605](https://osv.dev/vulnerability/GO-2026-6605), [GO-2026-6607](https://osv.dev/vulnerability/GO-2026-6607), [GO-2026-6608](https://osv.dev/vulnerability/GO-2026-6608), [GO-2026-6609](https://osv.dev/vulnerability/GO-2026-6609), [GO-2026-6610](https://osv.dev/vulnerability/GO-2026-6610), [GO-2026-6611](https://osv.dev/vulnerability/GO-2026-6611), [GO-2026-6612](https://osv.dev/vulnerability/GO-2026-6612), [GO-2026-6613](https://osv.dev/vulnerability/GO-2026-6613), [GO-2026-6617](https://osv.dev/vulnerability/GO-2026-6617), [GO-2026-6809](https://osv.dev/vulnerability/GO-2026-6809)

이전 Go 1.26.6 툴체인은 공개된 권고 14건의 영향을 받았지만, Go 1.26.10은 해당 권고의 영향을 받지 않습니다.

> - [PR #19590][lyarwood] Build KubeVirt with go 1.26.10

그 외 6건 · 보안 언급 없음

- `- [PR #19521][kubevirt-bot] Updated common-instancetypes bundles to v1.8.0`
- `- [PR #19388][0xFelix] Updated virt-template to v0.3.0`
- `- [PR #19048][michalskrivanek] Libvirt updated to 12.5.0-4.el10`
- `- [PR #18908][kubevirt-bot] Updated virt-template to v0.2.3`
- `- [PR #18315][alancaldelas] Kubernetes dependencies have been updated to v0.36.4 (Kubernetes 1.36)`
- `- [PR #18761][lentzi90] Build KubeVirt with go 1.26.6`

## 기타 (31)

- `NetworkDevicesWithDRA` 기능 게이트 베타 단계로 승격
- VM 상태 PVC 레이아웃을 VM별 구분이 없는 표준 레이아웃으로 마이그레이션
- ContainerPath 볼륨 베타 승격 및 기본 활성화
- 2Mi 메모리 예약을 적용한 정적 링크 C 슈퍼바이저로 `virt-launcher-monitor` 재작성
- 라이브 마이그레이션에서 소스 도메인 XML로 누락된 CBT 오버레이 생성
- 볼륨 분리 시 CBT 오버레이 정리
- `VirtualMachineRestore` 패치 어드미션에서 유효한 JSON Patch 연산 허용
- virt-operator의 `virt-launcher-pod-mutator` 웹훅 반복 GET 방지
- 핫플러그 볼륨의 독립적 연결
- virt-operator의 중복 엔드포인트 메시지와 Warning 이벤트 안정화
- 레거시 펌웨어 UUID 계산 및 동기화 제거
- `hyperv` 패닉 디바이스의 Windows 크래시 처리 변경
- KubeVirt 인벤토리 메트릭에 VM 아이덴티티 라벨 추가
- ACPI를 비활성화한 amd64 게스트에 경고 추가
- NFS 디스크 이미지를 공유하는 VM의 오류 메시지 개선
- 지원되지 않는 게스트 에이전트 명령에 캐시된 빈 결과를 반환하는 `VMStatsCollector`
- 사용자 지정 seccomp 프로파일 파일의 권한을 `0600`으로 변경
- KubeVirt 사용자 지정 seccomp 프로파일의 원자적 쓰기
- 스토리지 자체 인증 테스트 스위트에 PVC 확장 테스트 추가
- 플러그인 CEL 훅 평가기의 캐시된 공통 설정
- 레거시 containerdisk CRC32 체크섬 계산 제거
- VMI 노드 이름을 전달하는 `virtctl evacuate-cancel`
- VMI 메모리 오버헤드 보고 기능의 GA 승격
- `hermetic_launcher` v0.0.15를 사용한 s390x 컨테이너 이미지 빌드 수정
- 온라인 디스크 확장에서 `GetBlockInfo` 반복 호출 방지
- 컨테이너 이미지 빌드에 `rules_img` 사용
- 마이그레이션 오브젝트와 연계된 virt-launcher Pod 정리
- 네트워크 컨포먼스 테스트에서 사용자 지정 네트워크 바인딩 플러그인 지원
- DRA 엔드투엔드 테스트 지원
- Grace I/O Virtualization의 SMMUv3 주소 capability 명시
- DRA GPU 및 호스트 디바이스 기능 게이트의 베타 단계 전환

---

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