# KubeVirt v1.7.0

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

보안 5 (high 1) · 호환성 변경 20 · 폐기 예정 1 · 중요 수정 31 · 기능·개선 33 · 의존성 갱신 7 · 기타 22

## 보안 (5)

### [high] HostDisk 소유권 취약점 수정

- 영향 대상: `HostDisk` `DiskOrCreate` 설정에서 기존 디스크 파일을 사용하는 경우
- [CVE-2025-64324](https://www.cve.org/CVERecord?id=CVE-2025-64324), [GHSA-46xp-26xh-hpqh](https://github.com/kubevirt/kubevirt/security/advisories/GHSA-46xp-26xh-hpqh)

이전에는 KubeVirt가 기존 호스트 파일의 소유권을 `107:107`로 변경할 수 있어 VM이 해당 파일을 읽고 수정할 수 있었습니다. 이제 기존 HostDisk 파일의 소유권과 권한을 변경하지 않습니다.

> - [PR #15037][jean-edouard] HostDisk: KubeVirt no longer performs chown/chmod to compensate for storage that doesn't support fsGroup

보안 공지:

> Arbitrary Host File Read and Write

https://github.com/kubevirt/kubevirt/security/advisories/GHSA-46xp-26xh-hpqh

### [medium] NodeRestriction의 다른 노드 업데이트 차단

- 영향 대상: KubeVirt의 `NodeRestriction` 검증 어드미션 정책이 평가하는 노드 업데이트 (추정)
- [CVE-2025-64436](https://www.cve.org/CVERecord?id=CVE-2025-64436), [GHSA-7xgm-5prm-v5gc](https://github.com/kubevirt/kubevirt/security/advisories/GHSA-7xgm-5prm-v5gc)

보안 권고문에 따르면, 과도한 권한이 있는 `virt-handler` 계정을 침해한 공격자는 VMI가 종료된 것처럼 보이게 하고 공격자가 제어하는 노드에서 VMI를 다시 생성되게 할 수 있습니다.

> - [PR #16076][kubevirt-bot] NodeRestriction: Source of node update is now verified

보안 공지:

> Excessive Role Permissions Could Enable Unauthorized VMI Migrations Between Nodes

https://github.com/kubevirt/kubevirt/security/advisories/GHSA-7xgm-5prm-v5gc

### [medium] 집계 API 클라이언트 인증서의 Common Name 검사 적용

- 영향 대상: 클라이언트 인증서로 인증하는 집계 API 요청
- [CVE-2025-64432](https://www.cve.org/CVERecord?id=CVE-2025-64432), [GHSA-38jw-g2qx-4286](https://github.com/kubevirt/kubevirt/security/advisories/GHSA-38jw-g2qx-4286)

Kubernetes에서 허용하는 목록에 없는 Common Name을 가진, 신뢰할 수 있는 CA가 서명한 인증서를 사용하면 aggregator를 사칭해 RBAC를 우회할 수 있었습니다. 이를 악용하려면 유효한 프런트엔드 프록시 인증서와 `virt-api`에 대한 네트워크 접근도 필요합니다. 이제 허용 목록에 없는 Common Name을 가진 인증서는 거부됩니다. 다만 Kubernetes가 Common Name을 제공하지 않으면, 인증 기관의 검증을 통과한 모든 인증서가 허용됩니다.

> - [PR #15314][xpivarc] Common Names are now enforce for aggregated API

보안 공지:

> Authentication Bypass in Kubernetes Aggregation Layer

https://github.com/kubevirt/kubevirt/security/advisories/GHSA-38jw-g2qx-4286

### [medium] virt-handler 호스트 파일 소유권 변경 결함 수정

- 영향 대상: 릴리스 노트에 언급 없음
- [CVE-2025-64437](https://www.cve.org/CVERecord?id=CVE-2025-64437), [GHSA-2r4r-5x78-mvqf](https://github.com/kubevirt/kubevirt/security/advisories/GHSA-2r4r-5x78-mvqf), [GHSA-9m94-w2vq-hcf9](https://github.com/advisories/GHSA-9m94-w2vq-hcf9)

공격자가 `virt-launcher` Pod의 파일시스템을 제어하고, `qemu`(UID 107)로 호스트 파일시스템에 접근할 수 있으며, 비특권 사용자 네임스페이스를 생성할 수 있으면, `virt-handler`가 `launcher-sock`을 Pod의 루트 마운트로 잘못 판단해 임의의 호스트 파일 소유자를 UID 107로 변경할 수 있었습니다. 공격자는 이후 해당 파일을 수정할 수 있었습니다. 입증된 익스플로잇은 VMI 생성 또는 업데이트 작업과의 경쟁 조건을 노립니다.

보안 공지:

> It is possible to trick the `virt-handler` component into changing the ownership of arbitrary files on the host node to the unprivileged user with UID `107` due to mishandling of symlinks when determining the root mount of a `virt-launcher` pod.
> In the current implementation, the `virt-handler` does not verify whether the `launcher-sock` is a symlink or a regular file. This oversight can be exploited, for example, to change the ownership of arbitrary files on the host node to the unprivileged user with UID `107` (the same user used by `virt-launcher`) thus, compromising the CIA (Confidentiality, Integrity and Availability) of data on the host.
> To successfully exploit this vulnerability, an attacker should be in control of the file system of the `virt-launcher` pod.
> It is assumed that an attacker has access to a `virt-launcher` pod's file system (for example, [obtained using another vulnerability](https://github.com/kubevirt/kubevirt/security/advisories/GHSA-9m94-w2vq-hcf9)) and also has access to the host file system with the privileges of the `qemu` user (`UID=107`). It is also assumed that they can create unprivileged user namespaces:
> Upon successful exploitation, `virt-launcher` connects to the attacker controlled socket, misinterprets the root mount and changes the permissions of the host's `/etc/passwd` file:
> The attacker controlling an unprivileged user can now update the contents of the file.
> This oversight can be exploited, for example, to change the ownership of arbitrary files on the host node to the unprivileged user with UID `107` (the same user used by `virt-launcher`) thus, compromising the CIA (Confidentiality, Integrity and Availability) of data on the host.

https://github.com/kubevirt/kubevirt/security/advisories/GHSA-2r4r-5x78-mvqf

보안 공지:

> Isolation Detection Flaw Allows Arbitrary File Permission Changes

https://github.com/kubevirt/kubevirt/security/advisories/GHSA-2r4r-5x78-mvqf

### [medium] PVC 디스크 심볼릭 링크를 통한 파일 노출 수정

- 영향 대상: 릴리스 노트에 언급 없음
- [CVE-2025-64433](https://www.cve.org/CVERecord?id=CVE-2025-64433), [GHSA-qw6q-3pgr-5cwq](https://github.com/kubevirt/kubevirt/security/advisories/GHSA-qw6q-3pgr-5cwq)

누군가 PVC의 콘텐츠를 충분히 제어해 `virt-launcher` 파드 파일 시스템의 파일을 가리키는 심볼릭 링크를 만들 수 있으면, 게스트 VM이 해당 파일 시스템과 마운트된 PVC에서 임의의 파일을 읽을 수 있었습니다. 이로 인해 컨테이너와 VM의 경계를 넘어 스토리지 데이터가 노출될 수 있었습니다.

보안 공지:

> Mounting a user-controlled PVC disk within a VM allows an attacker to read any file present in the `virt-launcher` pod. This is due to erroneous handling of symlinks defined within a PVC.
> A vulnerability was discovered that allows a VM to read arbitrary files from the `virt-launcher` pod's file system. This issue stems from improper symlink handling when mounting PVC disks into a VM. Specifically, if a malicious user has full or partial control over the contents of a PVC, they can create a symbolic link that points to a file within the `virt-launcher` pod's file system. Since `libvirt` can treat regular files as block devices, any file on the pod's file system that is symlinked in this way can be mounted into the VM and subsequently read.
> Although a security mechanism exists where VMs are executed as an unprivileged user with UID `107` inside the `virt-launcher` container, limiting the scope of accessible resources, this restriction is bypassed due to a second vulnerability (TODO: put link here). The latter causes the ownership of any file intended for mounting to be changed to the unprivileged user with UID `107` prior to mounting. As a result, an attacker can gain access to and read arbitrary files located within the `virt-launcher` pod's file system or on a mounted PVC from within the guest VM.
> The two PVCs will be mounted as volumes in "filesystem" mode:
> This vulnerability breaches the container-to-VM isolation boundary, compromising the confidentiality of storage data.

https://github.com/kubevirt/kubevirt/security/advisories/GHSA-qw6q-3pgr-5cwq

보안 공지:

> Arbitrary Container File Read

https://github.com/kubevirt/kubevirt/security/advisories/GHSA-qw6q-3pgr-5cwq

## 호환성 변경 (20)

### 분산형 라이브 마이그레이션 제한에 따른 대상 파드 생성 제어

- 영향 대상: 노드별 또는 클러스터 마이그레이션 제한의 적용을 받는 분산형 라이브 마이그레이션 (추정)

이 수정 전에는 분산형 라이브 마이그레이션에 마이그레이션 제한이 정확히 적용되지 않았습니다. 테스트에서는 두 제한 중 하나라도 사용 중일 때 대기 중인 마이그레이션을 다루며, 대상 파드가 생성되지 않아야 한다고 확인합니다.

> - [PR #16011][kubevirt-bot] BugFix: The migration limit was not accurately being used with decentralized live migrations

### `VirtualMachinePool` 업데이트의 기본 전략이 된 선제 재시작

- 영향 대상: `VirtualMachinePool` 리소스 (추정)

기존에는 풀에 업데이트 전략 API가 없었고, 기본적인 인플레이스 업데이트 동작만 제공했습니다. `opportunistic` 전략을 명시적으로 설정하면 VM이 업데이트되고, VMI는 재시작 시 자연스럽게 변경됩니다. `unmanaged` 전략은 VM을 자동으로 업데이트하지 않습니다. `proactive`를 선택하면 선택 정책을 설정하지 않은 경우 `Random`이 기본값으로 사용됩니다.

근거: “"description": "SelectionPolicy defines the priority in which VM instances are selected for proactive update Defaults to \"Random\" base policy when no SelectionPolicy is configured"” https://github.com/kubevirt/kubevirt/pull/15123

> - [PR #15123][Sreeja1725] VMpool: Add UpdateStrategy support with Proactive, Opportunistic modes and Selection policies

### VMI 정상 종료 요청당 이벤트 하나만 전송

- 영향 대상: 정상 종료 중인 VMI

이전에는 재시도할 때마다 `VMIGracefulShutdown` 이벤트가 반복해서 발생했습니다. `TerminationGracePeriodSeconds` 값이 크면 이벤트 레코더의 버스트 한도인 25회를 초과해 후속 이벤트가 누락될 수 있었으며, 최종 종료 이벤트도 누락될 수 있었습니다. 이제 최초 요청에서만 해당 이벤트를 발생시키며, 재시도는 virt-handler 로그에 계속 기록됩니다.

> - [PR #15759][lyarwood] Only a single `Signaled Graceful Shutdown` event is now sent to avoid spamming the event recorder during long graceful shutdown attempts

### VMpool 정리 파이널라이저 추가

- 영향 대상: VirtualMachinePools를 사용하는 구성

VM과 PVC 상태를 보존하도록 VMpool을 설정한 상태에서 Pod를 수동으로 삭제하거나 VMpool의 replica 수를 줄이면, 리컨실리에이션이 실행되기 전에 VM이 삭제되어 PVC가 보존되지 않을 위험이 있었습니다. 파이널라이저를 사용하면 컨트롤러가 먼저 정리 작업을 수행해 VM이 삭제되기 전에 PVC를 보존하는 데 도움이 됩니다.

근거: “Example usecase - When a pod is deleted manually or vmpool replica count is scaled down, and the vmpool is configured to preserve the state of the VM and PVC, it might be possible that the vm might have deleted by the time vmpool reconcile is triggered. Adding a finalizer will help in preserving the pvc before deleting the VM.” https://github.com/kubevirt/kubevirt/pull/15406

> - [PR #15406][Sreeja1725] Add VMpool finalizer to ensure proper cleanup

### VM 컨테이너 메모리 메트릭 명칭을 요청 메모리 여유분으로 변경

- 영향 대상: 두 VM 컨테이너 메모리 메트릭 중 하나를 사용하는 Prometheus 쿼리 또는 규칙 (추정)

메트릭 설명이 이제 값을 요청된 메모리에서 RSS 또는 working set을 뺀 값으로 정의합니다. 사용량이 요청량을 초과하면 값이 음수가 될 수 있습니다. 이전 설명에서는 현재 사용 가능한 메모리라고 했습니다.

> - [PR #15504][sradco] Update metric kubevirt_vm_container_free_memory_bytes_based_on_rss and kubevirt_vm_container_free_memory_bytes_based_on_working_set_bytes names to kubevirt_vm_container_memory_request_margin_based_on_rss_bytes and kubevirt_vm_container_memory_request_margin_based_on_working_set_bytes so they will be clearer

### `ppc64le` 아키텍처 설정 처리 코드 제거

- 영향 대상: `ppc64le` 아키텍처로 구성된 설치 환경

프로젝트는 이전부터 `ppc64le`을 지원하거나 유지 관리하지 않았지만, 관련 설정 및 처리 코드는 남아 있었습니다. 이번 릴리스에서는 해당 처리 코드를 제거하고 스키마 필드는 지원 중단 예정으로 표시된 상태로 둡니다.

근거: “This PR **removes the `ppc64le` architecture configuration completely** and also removes associated code references and handling logic related to the `ppc64le` architecture.” https://github.com/kubevirt/kubevirt/pull/14976

> - [PR #14976][dasionov] remove ppc64le architecture configuration support

### 익스포트 서버의 `lost+found` 제외

- 영향 대상: 마운트된 내용에 `lost+found`가 있으며 익스포트 서버가 내보내는 데이터 볼륨 (추정)

익스포트 서버에 KubeVirt 또는 CDI가 만들지 않은 파일을 처리할 권한이 없으면 `lost+found`에서 권한 문제가 발생할 수 있었습니다. 이제 익스포트에서 해당 디렉터리를 제외하며, 익스포트 서버는 디렉터리 권한 검사에서도 이를 제외합니다.

근거: “In some environments the export server might lack permissions to handle files that aren't created by Kubevirt or CDI, such as the lost+found directory.” https://github.com/kubevirt/kubevirt/pull/15509

> - [PR #15509][alromeros] Bugfix: Exclude lost+found from export server

### virtctl SSH 및 SCP에서 호스트 클라이언트 사용

- 영향 대상: virtctl SSH 또는 SCP 사용, `--local-ssh`를 사용하는 호출 포함 (추정)

이전 릴리스까지 virtctl에는 네이티브 SSH 및 SCP 클라이언트와 지원 중단 예정인 `--local-ssh` 플래그가 포함되어 있었습니다.

> - [PR #15478][0xFelix] virtctl: The --local-ssh flag and native ssh and scp clients are removed from virtctl. From now on the local ssh and scp clients on a host are always wrapped by virtctl ssh and scp.

### 마이그레이션 메모리 전송 메트릭 이름 변경

- 영향 대상: 마이그레이션 메모리 전송 메트릭을 사용하는 모니터링 및 자동화 (추정)

메모리 전송을 보고하는 메트릭이 이전에는 `kubevirt_vmi_migration_disk_transfer_rate_bytes`라는 이름으로 노출됐지만, 이제 `kubevirt_vmi_migration_memory_transfer_rate_bytes`라는 이름으로 노출됩니다.

근거: “Before this PR: The metric name is wrong and should be renamed to `kubevirt_vmi_migration_memory_transfer_rate_bytes`” https://github.com/kubevirt/kubevirt/pull/13500

> - [PR #13500][brandboat] Fix incorrect metric name kubevirt_vmi_migration_disk_transfer_rate_bytes to kubevirt_vmi_migration_memory_transfer_rate_bytes

### Descheduler의 `eviction-in-progress` 어노테이션과 VMI eviction 상태 연동

- 영향 대상: VMI eviction에 Descheduler의 `eviction-in-progress` 어노테이션을 사용하는 환경

마이그레이션 시도가 실패하면 eviction을 다시 시도할 예정인데도 어노테이션이 제거되어, 완료된 것처럼 잘못 표시될 수 있었습니다. 이제 어노테이션은 VMI가 eviction 대상으로 표시되었는지를 반영하며, 마이그레이션이 진행 중일 때는 소스 Pod에만 추가됩니다. 취소되지 않은 채 멈춘 마이그레이션은 eviction이 완료되거나 취소될 때까지 동시 eviction 제한이 설정된 Descheduler를 멈춰 세울 수 있습니다.

근거: “Note: If migrations are stuck and evictions are never canceled (KubeVirt currently has no such mechanism), and the descheduler is configured with a limit on concurrent evictions, the descheduler may stall until some evictions complete or are manually canceled.” https://github.com/kubevirt/kubevirt/pull/15423

> - [PR #15423][tiraboschi] Derive eviction-in-progress annotation from VMI eviction status

### virtctl 레거시 점 기반 대상 파싱 제거

- 영향 대상: `type/name.namespace` 구문을 사용하는 virtctl `portforward`, `ssh` 또는 `scp` 대상

이전에는 마지막 점 뒤의 부분을 네임스페이스로 처리했지만, 이제 점이 포함된 대상은 지원되는 구문으로 네임스페이스를 지정하지 않는 한 네임스페이스가 없는 리소스 이름으로 파싱됩니다. 이전 구문을 사용하면 호스트 키 검증을 다시 요청할 수 있으며, `known_hosts`를 수동으로 업데이트해야 할 수도 있습니다.

> - [PR #15475][0xFelix] virtctl (portfoward|ssh|scp): Drop support for legacy dot syntax. In case the old dot syntax was used virtctl could ask for verification of the host key again. In some cases the known_hosts file might need to be updated manually.

### VMI foreground-delete 파이널라이저의 도메인 한정 이름 사용

- 영향 대상: KubeVirt foreground-delete 파이널라이저를 사용하는 VirtualMachineInstance (추정)
- 제거 시점: 향후 릴리스

기존 파이널라이저 이름에는 도메인 정보가 없어, 파이널라이저 이름에 도메인 정보를 포함해야 한다는 Kubernetes 경고가 발생할 수 있었습니다. 이제 컨트롤러는 `kubevirt.io/foregroundDeleteVirtualMachine`을 사용하며, VMI가 완료되거나 삭제되면 이전 이름이나 새 이름의 파이널라이저를 제거합니다. 이전 이름을 기준으로 일치 여부를 확인하는 자동화는 오류 없이 더 이상 일치하지 않을 수 있습니다.

> - [PR #15096][lyarwood] The `foregroundDeleteVirtualMachine` has been deprecated and replaced with the domain-qualified `kubevirt.io/foregroundDeleteVirtualMachine`.

### virt-operator 스케줄링을 컨트롤 플레인 노드로 제한

- 영향 대상: virt-operator를 스케줄링할 수 있는 비컨트롤 플레인 노드가 있는 KubeVirt 설치 환경 (추정)

이전에는 virt-operator를 비컨트롤 플레인 노드에 스케줄링할 수 있었습니다. 여러 복제본을 한 노드에 배치하지 않는 것은 여전히 선호 사항이므로, 복제본 수가 컨트롤 플레인 노드 수보다 많으면 복제본이 같은 컨트롤 플레인 노드를 공유할 수 있습니다.

근거: “Avoiding multiple replicas on the same node is still only a preference, so multiple replicas will end up on the same node if there are more replicas than control-plane nodes.” https://github.com/kubevirt/kubevirt/pull/15157

> - [PR #15157][jean-edouard] virt-operator won't schedule on worker nodes

### KubeVirt 동기화 상태 필드가 `synchronizationAddresses`로 전환

- 영향 대상: `DecentralizedLiveMigration`이 활성화된 클러스터, 특히 마이그레이션 네트워크가 있거나 KubeVirt CR의 동기화 주소 상태를 읽는 통합 기능이 있는 클러스터

분산형 라이브 마이그레이션이 활성화되고 마이그레이션 네트워크가 구성된 경우, 오퍼레이터는 이전에는 마이그레이션 네트워크 IP를 알리지 못해 단수 상태 필드에 파드 네트워크 IP를 대신 보고했습니다. 이제 상태에는 구성된 포트가 포함된 주소가 담깁니다. 사용할 수 있는 주소가 여러 개면 첫 번째 주소도 `synchronizationAddress`에 보고합니다.

근거: “The synchronization addresses one can use to connect to the synchronization controller, includes the port, if multiple addresses are available, the first one is reported in the synchronizationAddress field.” https://github.com/kubevirt/kubevirt/pull/15022

> - [PR #15022][awels] The synchronization controller migration network IP address is advertised by the KubeVirt CR

### `virtctl expose` Service 셀렉터 수정

- 영향 대상: `virtctl expose`로 노출한 VMI
- 필요 조치: `virtctl` v1.7 이상의 `virtctl expose`와 호환되지 않는 이전 버전 KubeVirt

이전에는 VMI 이름 전체를 기준으로 선택하면 호스트네임이 설정된 경우 런처 Pod를 찾지 못할 수 있었고, VMI 이름이 길면 런처 레이블이 잘릴 수 있었습니다. 이제 Service는 `vmi.kubevirt.io/id`를 기준으로 선택합니다.

> - [PR #15783][orelmisan] Specify correct label selection when creating a service via virtctl expose. The expose command on virtctl v1.7 and above will not work with older KubeVirt versions.

### `instancetype.kubevirt.io/v1alpha{1,2}` API 지원 제거

- 영향 대상: `instancetype.kubevirt.io/v1alpha{1,2}`를 사용하는 instancetype 또는 preference 리소스, 매니페스트 또는 클라이언트 (추정)

이 API 버전과 CRD는 v1.0.0부터 지원 중단 예정이었지만, 그동안 계속 지원됐습니다.

> - [PR #15400][lyarwood] The deprecated `instancetype.kubevirt.io/v1alpha{1,2}` API and CRDs have been removed

### `memoryOvercommit` 최소값을 10으로 상향

- 영향 대상: `memoryOvercommit`을 10 미만으로 설정한 배포
- 필요 조치: 업그레이드 전에 `memoryOvercommit`을 10 이상으로 상향

근거: “Important: deployments that set a memoryOvercommit value below 10 need to bump to 10+ before upgrading.” https://github.com/kubevirt/kubevirt/pull/15681

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

### 스냅샷 진행 중인 VM의 재개 요청 거부

- 영향 대상: `vm.Status.SnapshotInProgress`가 설정된 VM

이전에는 스냅샷이 진행 중인 VM도 재개할 수 있었지만, 이제 재개 요청은 HTTP 409 Conflict를 반환합니다.

근거: “Make sure unpause will be rejected if `vm.Status.SnapshotInProgress` is not nil.” https://github.com/kubevirt/kubevirt/pull/15001

> - [PR #15001][noamasu] bugfix: Enable vmsnapshot for paused VMs

### 라이브 마이그레이션 중 virt-launcher 소유 핫플러그 파드의 eviction 보호

- 영향 대상: virt-launcher가 소유한 핫플러그 파드가 있고 라이브 마이그레이션이 가능한 VMI

이전에는 라이브 마이그레이션이 진행되는 동안 핫플러그 파드가 종료되어 마이그레이션이 완료되기 전에 불일치나 실패가 발생할 수 있었습니다. 이제 eviction 웹훅이 마이그레이션 중 파드가 너무 일찍 eviction되지 않도록 보호합니다.

근거: “This PR extends the same protection to hotplug pods owned by the virt-launcher, ensuring they are not prematurely terminated during an ongoing live migration. This prevents potential inconsistencies or failures caused by the hotplug pod shutting down before the migration completes.” https://github.com/kubevirt/kubevirt/pull/15093

> - [PR #15093][Acedus] bugfix: volume hotplug pod is no longer evicted when associated VM can live migrate.

### `virt-operator`의 `*_SHASUM` 이미지 선택 제거

- 영향 대상: `*_SHASUM` 환경 변수로 이미지를 선택하는 `virt-operator` 설정
- 필요 조치: 이전에 `*_SHASUM`으로 지정하던 이미지 선택을 남은 `*_IMAGE` 변수에서 태그, 다이제스트 또는 둘 다로 설정

이전에는 `*_SHASUM` 변수가 이미지 체크섬을 선택했지만, 이제는 이미지 버전을 선택하지 않습니다. 남은 `*_IMAGE` 변수는 태그, 다이제스트 또는 둘 다로 이미지를 선택합니다.

> - [PR #15061][lyarwood] Support for all `*_SHASUM` environment variables has been removed from the `virt-operator` component. Users should instead use the remaining `*_IMAGE` environment variables to request a specific image version using a tag, digest or both.

## 폐기 예정 (1)

### `indications` 필드 지원 중단 예정 및 `sourceIndications`로 대체

- 영향 대상: `VirtualMachineSnapshot` 리소스와 스냅샷 status를 읽는 클라이언트 (추정)
- 제거 시점: 미상

온라인 스냅샷의 status에는 기존 indication 값이 `indications`에 포함되고, 이에 대응하는 메시지가 담긴 항목이 `sourceIndications`에 포함됩니다. 이번 업데이트에서는 오프라인 스냅샷의 두 필드 모두 값이 설정되지 않습니다.

> - [PR #16033][noamasu] VMSnapshot: add SourceIndications status field to list snapshot indications with descriptions for clearer meaning.

## 중요 수정 (31)

### 삭제 대상으로 표시된 어태치먼트 파드는 핫플러그 볼륨 상태 업데이트에서 제외

- 영향 대상: 핫플러그 볼륨 상태 업데이트를 수행하는 설정 (추정)

> - [PR #16199][kubevirt-bot] Don't use attachment pods marked for deletion for hotplug volume status updates.

### 실행 중인 VM에서 CD-ROM 분리 시 `RestartRequired` 설정

- 영향 대상: CD-ROM 디스크가 있는 실행 중인 VM

> - [PR #16129][kubevirt-bot] Add RestartRequired when detaching CD-ROMs from a running VM

### VM 디스크 물리 블록 크기 감지 수정

- 영향 대상: 블록 디바이스에서 물리 블록 크기를 감지하는 VM 디스크 (추정)

이전에는 `BLKBSZGET`이 실제 물리 블록 크기를 반영하지 않는 값을 보고할 수 있었습니다. 이제 물리 크기 감지에는 `BLKPBSZGET`을, 논리 크기 감지에는 `BLKSSZGET`을 사용합니다.

> - [PR #15698][Acedus] It is now possible to configure discard_granularity for VM disks.

### CA 번들 인증서 필터링 수정

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

이전에는 만료된 인증서를 제거하기 전에 `MergeCABundle`이 번들을 인증서 50개로 잘랐습니다. 그 결과 새 유효 인증서가 제외되고 만료된 인증서는 남을 수 있었습니다. 이제 만료된 인증서를 먼저 제거한 뒤, 남은 유효 인증서를 최대 50개로 제한합니다.

> - [PR #15706][ksimon1] fix: prioritize expired cert removal over 50-cert limit in MergeCABundle

### `NetworkAttachmentDefinitions` 및 `ServiceAccounts`에 대한 Object Graph 지원 범위 확대

- 영향 대상: `NetworkAttachmentDefinitions` 또는 `ServiceAccounts`를 종속성으로 사용하는 Object Graph 구성 (추정)

`ServiceAccounts`가 의도치 않게 Object Graph에서 누락되었고, `NetworkAttachmentDefinitions`도 포함되지 않았습니다.

> - [PR #15615][alromeros] Object Graph: Include NADs and ServiceAccounts

### virt-operator의 virt-api 복제본 수 산정 기준을 스케줄링 가능한 노드로 변경

- 영향 대상: 모든 노드에 `kubevirt.io/schedulable=true` 라벨이 지정되어 있지 않은 클러스터 (추정)

KubeVirt가 모든 노드에 배포되지 않은 대규모 환경에서는 이전 계산 방식으로 복제본이 필요 이상으로 많이 생성될 수 있었습니다.

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

### 복원된 naked PVC의 VM 소유권 수정

- 영향 대상: 복원 정책 `VM`을 사용하며 naked PVC가 포함된 VMSnapshot 복원

이전에는 DataVolume이 소유하지 않는 일반 PVC를 복원할 때 VM 소유자 참조가 설정되지 않아, VM을 삭제한 뒤에도 PVC가 고아 상태로 남을 수 있었습니다. 복원 정책 `VM`을 사용하면 이제 복원된 PVC에 VM 소유권이 설정되어 VM과 함께 제거됩니다.

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

### 복원된 볼륨의 소유권을 VM에 할당

- 영향 대상: VM 복원

복원 전에 VM이 없었고 볼륨을 복원한 뒤 VM을 생성하면, 이전에는 볼륨에 VM 소유권이 설정되지 않았습니다. 이제 이 순서로 복원하면 볼륨의 소유권이 VM에 할당됩니다.

> - [PR #15344][SkalaNetworks] Added VolumeOwnershipPolicy to decide how volumes are owned once they are restored.

### Descheduler 옵트아웃 어노테이션 전파 수정

- 영향 대상: `descheduler.beta.kubernetes.io/evict` 또는 virt-launcher Pod로 전파되는 기타 Descheduler 옵트아웃 어노테이션을 사용하는 VM 템플릿이나 VMI

KubeVirt는 이전에 Descheduler가 무시하는 `descheduler.beta.kubernetes.io/evict`를 전파했습니다. 이제는 대신 `descheduler.alpha.kubernetes.io/prefer-no-eviction`을 전파하며, `descheduler.alpha.kubernetes.io/evict`도 계속 동기화합니다.

> - [PR #15365][tiraboschi] Aligning descheduler opt-out annotation name

### `KubeVirt.spec.imagetag`를 사용한 설치 정상화

- 영향 대상: `KubeVirt.spec.imagetag`로 설정한 설치

이번 릴리스 전에는 `KubeVirt.spec.imagetag`를 사용하는 설치가 작동하지 않았습니다.

> - [PR #16198][kubevirt-bot] Bug fix: KubeVirt.spec.imagetag installation is working again

### 노드 압박 시 3분 이내 KSM 활성화

- 영향 대상: 노드 압박을 겪는 KSM 처리 대상 노드 (추정)

KSM 핸들러는 3분 간격으로 처리 대상 노드를 확인하고 처리합니다.

> - [PR #16150][kubevirt-bot] fix: KSM is enabled in case of node pressure within 3 minutes

### 탈중앙화 라이브 마이그레이션 실패 전파 수정

- 영향 대상: 탈중앙화 라이브 마이그레이션을 수행하는 환경

탈중앙화 라이브 마이그레이션 중 실패 상태가 제대로 전파되지 않던 문제를 수정했습니다. 소스 VMI에 장애가 발생하면 해당 마이그레이션 상태를 실패 및 완료로 표시합니다. 스케줄된 대상 VMI에 파드가 없으면 해당 마이그레이션 상태도 실패 및 완료로 표시하고, VMI를 `WaitingForSync` 상태로 설정합니다.

> - [PR #16089][kubevirt-bot] A decentralized live migration failure is properly propagates between source and target

### 이전 컨트롤러 설정을 사용하는 virt-handler 마이그레이션 패닉 수정

- 영향 대상: 마이그레이션 컨트롤러보다 virt-handler를 먼저 업데이트하는 업그레이드

이전 컨트롤러의 설정을 사용하는 마이그레이션에서는 `AllowWorkloadDisruption`이 생략된 경우 nil 포인터 예외가 발생할 수 있었습니다. 이제 virt-handler는 `AllowWorkloadDisruption`이 nil이면 `AllowPostCopy`를 사용하므로, 패닉 없이 마이그레이션을 진행할 수 있습니다.

> - [PR #15008][fossedihelm] Fix possible nil pointer caused by migration during kv upgrade

### 대규모 부하에서 진행 중인 마이그레이션을 위한 마이그레이션 컨트롤러 수정

- 영향 대상: 수천 건의 마이그레이션을 처리하는 배포 환경

마이그레이션이 수천 건에 이르면 진행 중인 마이그레이션이 실패할 수 있었습니다. 이번 릴리스에서는 마이그레이션 컨트롤러를 변경해 이러한 부하로 인한 실패가 더는 발생하지 않을 것으로 기대됩니다.

> - [PR #15867][xpivarc] Bug fix: Thousands of migrations should not cause failures of active migrations

### 핫플러그 볼륨의 `RestartRequired` 처리 수정

- 영향 대상: 핫플러그 볼륨을 사용하는 설정

LiveUpdate가 기본 롤아웃 전략이 된 뒤 회귀 문제가 나타났습니다. 순서가 바뀌면 `DeepEqual()` 비교가 실패할 수 있었습니다. 이제 이런 경우에도 `RestartRequired`를 올바르게 처리합니다.

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

### virt-launcher 프로세스 회수 문제 수정

- 영향 대상: virt-launcher-monitor가 모니터링하는 virt-launcher 프로세스 (추정)

시그널이 차단된 동안 여러 시그널이 도착하면 그중 하나만 전달될 수 있습니다. 모니터가 시그널마다 `Wait4`를 한 번만 호출하면 종료된 프로세스를 놓쳐 virt-launcher가 무기한 실행 상태로 남을 수 있었습니다. 소스와 대상 Pod가 모두 계속 실행 중인, 마이그레이션이 성공한 뒤에 이 문제가 관찰되었습니다. 이제 모니터는 시그널을 받을 때마다 가능한 한 많은 프로세스를 회수하도록 시도해 누락된 정리를 해결합니다.

> - [PR #15676][xpivarc] Bug fix, virt-launcher is properly reaped

### KubeVirt Istio 가상 인터페이스 어노테이션 호환성 수정

- 영향 대상: Istio 가상 인터페이스 어노테이션을 사용하는 KubeVirt Pod

기존 `traffic.sidecar.istio.io/kubevirtInterfaces` 어노테이션은 Istio v1.25 이상에서 동작하지 않았습니다. 이제 KubeVirt는 기존 어노테이션과 `istio.io/reroute-virtual-interfaces`를 모두 추가합니다. 새 어노테이션은 해당 버전에서 정상 동작을 제공하고, 기존 어노테이션은 v1.24.4와의 호환성을 위해 유지됩니다.

> - [PR #15661][nirdothan] Support Istio versions 1.25 and above.

### 분산형 마이그레이션 취소 및 정리 문제 수정

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

마이그레이션 도중 두 마이그레이션 리소스 중 하나를 삭제해도 마이그레이션이 제대로 취소되지 않았고, finalizer를 수동으로 제거해야 하는 마이그레이션 리소스가 남을 수 있었습니다. 이제 취소가 전파되고 소스 VM은 실행 상태로 돌아가며 두 마이그레이션 리소스가 모두 정리됩니다. 이 변경으로 대상 VM은 정리되지 않습니다.

> - [PR #15605][awels] BugFix: Able to cancel in flight decentralized live migrations properly

### 기본 VirtAPI 클라이언트 레이트 리밋 상향

- 영향 대상: 개별 웹훅 클라이언트에 기본 레이트 리밋을 사용하는 KubeVirt 구성

이번 릴리스 전에는 `DefaultVirtAPI` 클라이언트의 기본값이 QPS 5, 버스트 10으로, authorizer 클라이언트의 기본값보다 낮았습니다. 대량 eviction 이벤트가 발생하면 인가된 요청이 웹훅 클라이언트를 포화시켜 처리되지 않을 수 있었습니다. 이제 기본값은 QPS 200, 버스트 400입니다.

> - [PR #15422][lyarwood] The `DefaultVirtWebhookClient{QPS,Burst}` values are aligned with `DefaultVirtWebhookClient{QPS,Burst}` to help avoid saturating the webhook client with requests it is unable to serve during mass eviction events

### 분산형 L3 라이브 마이그레이션에서 IP를 직접 전달

- 영향 대상: L3 네트워크에서 분산형 라이브 마이그레이션을 사용하는 경우

이전에는 KubeVirt가 IP에 해당하는 DNS 이름을 조회했습니다. 조회 결과인 FQDN의 DNS 레코드를 반대편에서 찾을 수 없으면 문제가 발생했습니다.

> - [PR #15630][awels] Allow decentralized live migration on L3 networks

### 마이그레이션 컨트롤러의 대기 작업보다 진행 중인 마이그레이션 우선 처리

- 영향 대상: 마이그레이션 컨트롤러를 실행하는 KubeVirt 설치 환경 (추정)

인포머가 작업을 큐에 넣을 때 마이그레이션 우선순위가 0으로 올라가면 진행 중인 마이그레이션이 처리되지 못할 수 있었습니다. 이제 컨트롤러는 대기 중인 작업의 우선순위를 -100으로 유지하고, 진행 중인 마이그레이션 작업에는 0보다 높은 우선순위를 부여합니다.

> - [PR #15513][jean-edouard] Fixed priority escalation bug in migration controller

### REST 라이프사이클 핸들러의 런처 클라이언트 종료

- 영향 대상: virt-handler REST 라이프사이클 핸들러를 사용하는 설정 (추정)

핸들러가 `cmdclient.LauncherClient` 클라이언트를 생성한 뒤 닫지 않아 누수가 발생했습니다.

> - [PR #15557][fossedihelm] Fix: grpc client in handler rest requests are properly closed

### VMI 종료 grace period 처리 수정

- 영향 대상: `spec.TerminationGracePeriodSeconds`를 설정한 VMI

ACPI 신호에도 응답하지 않는 VM에서는 `virtctl stop vm --force --grace-period=0`과 같은 강제 종료 grace period 업데이트가 무시될 수 있었습니다. virt-handler에 캐시된 grace period가 오래된 값이어서 종료가 멈춘 것처럼 보였습니다. 이제 응답하지 않는 VM을 포함해 종료 시 업데이트된 VMI grace period를 적용합니다.

> - [PR #15170][dasionov] bugfix: ensure grace period metadata cache is synced in virt-launcher

### 오류가 바뀌지 않을 때 `VMSnapshotContent` 반복 업데이트 수정

- 영향 대상: KubeVirt VM 스냅샷 처리

`volumesnapshot`을 삭제한 뒤 `VMSnapshotContent`가 같은 오류와 새 타임스탬프로 반복 업데이트될 수 있었으며, 이로 인해 ETCD 데이터가 불어나고 성능이 저하될 가능성이 있었습니다. 이제 오류 메시지가 바뀌지 않으면 업데이트하지 않지만, 메시지가 바뀌면 계속 업데이트합니다.

> - [PR #15397][ShellyKa13] bugfix: prevent VMSnapshotContent repeated update with the same error message

### 라이브 볼륨 업데이트 후 스냅샷 복원 실패 수정

- 영향 대상: `DataVolumeTemplates`가 변경되는 라이브 볼륨 업데이트 후의 VM 스냅샷

스토리지 볼륨 마이그레이션과 같은 라이브 볼륨 업데이트 후에는 VM 리비전에 오래된 `DataVolumeTemplates`가 남아 이를 기반으로 한 스냅샷에서 복원할 때 실패할 수 있었습니다. 이제 스냅샷 소스를 구성할 때 오버라이드된 볼륨 및 디스크와 함께 VM의 최신 `DataVolumeTemplates`를 사용하므로 해당 스냅샷에서 복원할 수 있습니다.

> - [PR #15305][Acedus] bugfix: snapshot and restore now works correctly for VMs after a storage volume migration

### 시크릿 이름에 점이 포함된 `VMExport` 내보내기 실패 수정

- 영향 대상: VM 내보내기

시크릿 이름에 마침표가 포함된 경우 `VMExport` 내보내기가 실패할 수 있었습니다.

> - [PR #15182][akalenyu] BugFix: export fails when VMExport has dots in secret

### virt-handler의 포스트카피 마이그레이션에서 `ParallelMigrationThreads` 건너뛰기

- 영향 대상: 포스트카피 라이브 마이그레이션

업그레이드 중 virt-handler와 virt-launcher의 버전이 서로 다르면 포스트카피 마이그레이션이 `Postcopy is not yet compatible with multifd` 오류와 함께 실패할 수 있었습니다.

> - [PR #15016][fossedihelm] Fix postcopy multifd compatibility during upgrade

### `VMExport` Service 이름의 점을 하이픈으로 대체

- 영향 대상: 이름에 점이 포함된 `VMExport` 리소스

이전에는 유효한 Service 이름을 만들 수 없어 해당 내보내기가 무기한 실패할 수 있었습니다. 이제 이름의 점을 하이픈으로 바꾸어 DNS1035 레이블 규칙에 맞는 Service 이름을 생성합니다.

> - [PR #15099][akalenyu] BugFix: export fails when VMExport has dots in name

### 이미지 업로드 PVC에 StorageProfile 라벨 추가

- 영향 대상: `virtctl image-upload`로 생성한 PVC

CDI의 `WebhookPvcRendering`이 활성화되어 있으면 CDI가 연결된 `StorageProfile`을 적용할 수 있습니다. 여기에는 더 작은 크기를 지원하지 않는 프로비저너를 위해 설정된 PVC 최소 지원 크기도 포함됩니다.

> - [PR #15067][alromeros] Bugfix: Label upload PVCs to support CDI WebhookPvcRendering

### 완료된 마이그레이션의 동기화 컨트롤러 연결 정리 수정

- 영향 대상: 분산형 라이브 마이그레이션을 사용하는 클러스터 (추정)

완료된 마이그레이션을 처리할 때 동기화 컨트롤러가 연결을 설정하려고 시도해 트래픽이 불필요하게 늘고 다른 문제가 발생할 수 있었습니다. 이제는 해당 연결을 정리합니다.

> - [PR #14882][awels] Decentralized live migration is available to allow migration across namespaces and clusters

### `passt` VM 마이그레이션 중 TCP 연결 유지

- 영향 대상: `passt` 네트워크 바인딩을 사용하는 VM

이전에는 이러한 VM의 TCP 연결이 마이그레이션 중 끊겼습니다. `PasstIPStackMigrationEnabled`를 활성화하고 대상 virt-launcher pod에 소스와 같은 IP를 할당하면 연결이 유지됩니다. 마이그레이션은 계속 진행되지만, 복구 과정에서 오류가 발생하거나 IP가 유지되지 않으면 연결이 끊깁니다.

> - [PR #14875][nirdothan] Support seamless TCP migration with passt (alpha)

## 기능·개선 (33)

- libvirt 업그레이드 후 알려진 호스트 CPU 모델의 마이그레이션 지원
- VMI 대피 취소 명령 및 서브리소스
- `pool.kubevirt.io/v1beta1` VirtualMachinePool API 도입
- 실패하는 VM을 위한 VMPool 자동 복구 (사용 조건: VMPool에 `spec.autohealing` 구성; 자동 복구는 옵트인 방식)
- VMPool에 unmanaged 및 opportunistic 스케일 인 전략 추가
- VMPool 스케일 인 상태 보존 설정
- 변경된 ImageVolume 컨테이너 디스크 이미지의 라이브 마이그레이션
- 마이그레이션 우선순위 범주 일반화 (사용 조건: `MigrationPriorityQueue` 기능 게이트)
- 알파 단계 Intel TDX VM 지원 (사용 조건: `WorkloadEncryptionTDX` 기능 게이트)
- 실험적 AMD SEV-SNP 게스트 지원 (사용 조건: `WorkloadEncryptionSEV` 기능 게이트)
- VMI 퇴거 요청 컨디션 추가
- 사용자 지정 VM 템플릿 어노테이션과 레이블을 virt-launcher Pod에 동기화 (사용 조건: `virt-controller`에서 `additional-launcher-annotations-sync` 및/또는 `additional-launcher-labels-sync` 키를 설정해야 합니다. 두 플래그의 기본값은 빈 목록입니다.)
- 인스턴스 타입 API의 `ioThreads` 지원
- VirtualMachine preferences의 필수 및 선호 아키텍처 값
- 레이블 셀렉터 기반 VM 변경 블록 추적 (사용 조건: `changedBlockTrackingLabelSelectors`에 일치하는 네임스페이스 또는 VM 레이블 셀렉터 설정, CBT 변경 사항 적용을 위한 VM 재시작)
- VNC 없이 제공하는 KubeVirt 스크린샷
- DataVolume Upload 소스용 libdv 빌더 옵션
- VM 레이블을 노출하는 `kubevirt_vm_labels` 게이지
- `VirtualMachineRestore`에서 PVC 소유권 구성
- 비정상 및 전환 중인 VM 상태 알림 추가
- VNC 연결에서 진행 중인 세션 유지 (사용 조건: `virtctl vnc`의 `--preserve-session` 플래그 또는 VNC 엔드포인트의 `preserveSession` 쿼리 매개변수)
- Node Labeller 컨트롤러를 제어하는 virt-handler 플래그 (사용 조건: `enable-node-labeller` 플래그(기본값 `true`); 컨트롤러 비활성화 시 `false`로 설정)
- 게스트 CPU 큐 기록 규칙 및 알림
- 게스트 에이전트 스냅샷에서 일시 중지된 VM 도메인 지원
- 게스트 에이전트 CPU 부하 메트릭 보고
- 번들 common-instancetypes v1.4.0 업데이트 및 새 프리퍼런스 추가
- VM 펌웨어 시리얼 검증 제거
- 인스턴스 타입과 충돌하지 않는 메모리 필드 설정 허용
- `s390x` 아키텍처별 클러스터 설정
- `VirtualMachineInstanceMigration` 상태에 동기화 주소 추가 (사용 조건: 분산형 라이브 마이그레이션 기능 게이트를 켜야 합니다.)
- Kubernetes DRA를 통한 GPU 및 `HostDevices` 지원 (사용 조건: 해당 알파 기능 게이트를 활성화해야 합니다. GPU에는 `GPUsWithDRAGate`, HostDevices에는 `HostDevicesWithDRAGate`를 사용합니다.)
- 네임스페이스와 클러스터 간 분산형 라이브 마이그레이션 지원 (사용 조건: `DecentralizedLiveMigration` 기능 게이트)
- KubeVirt 인프라 구성 요소의 추가 CA 신뢰

## 의존성 갱신 (7)

그 외 7건 · 보안 언급 없음

- `- [PR #16026][fossedihelm] support v0.32.5 code generator`
- `- [PR #15718][Vicente-Cheng] Bump k8s v1.33`
- `- [PR #15936][kubevirt-bot] Updated common-instancetypes bundles to v1.5.1`
- `- [PR #15784][brianmcarey] Build KubeVirt with go v1.24.7`
- `- [PR #15531][Yu-Jack] bump prometheus operator to 0.80.1`
- `- [PR #15098][dominikholler] Update dependecy golang.org/x/oauth2 to v0.27.0`
- `- [PR #15100][dominikholler] Update dependecy golang.org/x/net to v0.38.0`

## 기타 (22)

- virt-handler용 전용 마이그레이션 mTLS 인증서
- `KubevirtSeccompProfile` 기능 게이트 베타 승격
- `SecureExecution` 기능 게이트 베타 승격
- `ImageVolume` 기능 게이트의 베타 승격
- 알파에서 베타로 승격된 `VideoConfig`
- 문서와 그래프에 v1.6.0 성능 및 확장성 벤치마크 추가
- `PanicDevices` 기능 게이트의 베타 승격
- VM 디스크 블록 I/O의 discard granularity 설정
- `virt-handler` 기본 rate limit 상향
- VM 마이그레이션 중 메모리 오버커밋 재계산
- 빌드 도구를 Bazel v6.5.0 및 `rules_oci`로 업데이트
- 핫플러그 테스트의 인터페이스 상태 정규화에서 `IP`와 `IPs` 비우기
- VMPool 단위 테스트에서 페이크 클라이언트 사용
- 마이그레이션 리소스에 따른 마이그레이션 PVC 생성 기대 사항
- 이름이 긴 VMI의 볼륨 마이그레이션 라벨에 VMI UID 사용
- 모니터링 메트릭에 virt-launcher 메모리 델타 추가
- VM 펌웨어 시리얼 기본값을 UUID로 설정
- 분산형 마이그레이션 실패 후 소스 VM/VMI 제거 가능
- 일시 중지된 VM의 스냅샷 안전성 경고 수정
- VM 일시 중지 중 virt-launcher 에이전트 폴러의 게스트 에이전트 명령 건너뛰기
- `libvmi`의 CPU·메모리 setter 이름 일관화
- 베타 단계로 진입하는 `NodeRestriction` 기능 게이트

---

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