# KubeVirt v1.7.0

2025-11-27 · [元のリリースノート](https://github.com/kubevirt/kubevirt/releases/tag/v1.7.0) · [全体のまとめ](https://ratatosk.io/ja/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 を終了したように見せかけ、攻撃者が制御するノード上で再作成させる可能性がありました。

> - [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 クライアント証明書のコモンネーム検査の強制

- 影響対象: クライアント証明書で認証される集約 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)

許可されたコモンネームの一覧にないコモンネームを持つ、信頼済み CA 発行の証明書を使うと、アグリゲーターになりすまして RBAC を回避できる可能性がありました。悪用には、有効なフロントエンドプロキシ証明書と `virt-api` へのネットワークアクセスも必要です。現在は、一覧にないコモンネームを持つ証明書は拒否されます。一方、Kubernetes からコモンネームが提供されない場合は、認証局による検証に合格した証明書であれば許可されます。

> - [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 のファイルシステムを制御し、UID 107 の `qemu` としてホストファイルシステムにアクセスでき、非特権ユーザー名前空間を作成できる場合、`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` Pod のファイルシステム内のファイルを指すシンボリックリンクを作成できる場合、ゲスト 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)

### 分散型ライブマイグレーションの上限による移行先 Pod 作成の制御

- 影響対象: ノード単位またはクラスタ単位の移行上限が適用される分散型ライブマイグレーション (推定)

この修正前は、分散型ライブマイグレーションに移行上限が正確に適用されていませんでした。テストでは、いずれかの上限に達している場合の保留中の移行を対象とし、移行先 Pod が作成されないことを確認します。

> - [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 の正常終了要求ごとにイベントを1件送信

- 影響対象: 正常終了中の 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 のクリーンアップ用ファイナライザーの追加

- 影響対象: VirtualMachinePool を使用する環境

VMとPVCの状態を保持するようにプールを設定している場合、Podを手動で削除したときやVMpoolのレプリカ数を減らしたときに、調整処理が実行される前に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 またはワーキングセットを差し引いた値として定義するようになりました。使用量が要求量を上回る場合、値は負になることがあります。以前は、現在利用可能なメモリー量として説明されていました。

> - [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 でホスト側クライアントを使用

- 影響対象: `--local-ssh` を指定した実行を含む、virtctl の SSH または SCP の使用 (推定)

このリリース以前は、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 の退避状態の連動

- 影響対象: Descheduler の `eviction-in-progress` アノテーションを VMI の退避に使用する構成

マイグレーションの試行に失敗すると、退避が再試行されるにもかかわらずアノテーションが削除され、退避が完了したと誤って示すことがありました。現在は、VMI が退避対象としてマークされているかどうかをアノテーションに反映します。マイグレーション中は、移行元の Pod にのみアノテーションが追加されます。キャンセルされないまま停止したマイグレーションがあると、退避が完了またはキャンセルされるまで、同時退避数の上限に達した 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 finalizer をドメイン修飾名に変更

- 影響対象: KubeVirt の foreground-delete finalizer を使用する VirtualMachineInstance (推定)
- 削除予定: 今後のリリース

ドメイン修飾されていない従来の finalizer は、finalizer 名をドメイン修飾する必要があるという Kubernetes の警告を引き起こすことがありました。コントローラーは現在、`kubevirt.io/foregroundDeleteVirtualMachine` を使用し、VMI の処理完了時または削除時に、従来の finalizer と新しい finalizer のどちらも削除します。従来の名前に一致するよう設定された自動化は、エラーが発生しなくても一致しなくなる可能性があります。

> - [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 名全体で選択するとランチャーポッドを見つけられないことがありました。また、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 所有ホットプラグ Pod の退避保護

- 影響対象: ライブマイグレーション可能な、virt-launcher 所有のホットプラグ Pod を持つ VMI

以前は、ライブマイグレーション中にホットプラグ Pod が終了させられ、移行完了前に不整合や失敗を招く可能性がありました。退避 Webhook により、移行中の Pod の早期退避が防止されます。

根拠: “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` リソースとスナップショットのステータスを読み取るクライアント (推定)
- 削除予定: 不明

オンラインスナップショットでは、ステータスに既存の値が `indications` に含まれ、対応するメッセージ付きのエントリーが `sourceIndications` に含まれます。この更新では、オフラインスナップショットのどちらのフィールドにも値は設定されません。

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

## 重大な修正 (31)

### 削除対象としてマークされたアタッチメント Pod を除外するホットプラグボリューム状態更新

- 影響対象: ホットプラグボリュームの状態更新を行う構成 (推定)

> - [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.

### `MergeCABundle`の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.

### 復元された単独 PVC の VM 所有権の修正

- 影響対象: 復元ポリシー `VM` で、DataVolume に所有されていない PVC を含む VMSnapshot の復元

以前は、DataVolume に所有されていない通常の PVC を復元すると、VM の owner reference が設定されず、VM の削除後も孤立したままになることがありました。復元ポリシー `VM` の場合、復元された PVC に VM の owner reference が設定され、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.beta.kubernetes.io/evict` を伝播していましたが、Descheduler はこのアノテーションを無視していました。現在は代わりに `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 に Pod がない場合も、そのマイグレーション状態は失敗かつ完了としてマークされ、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 プロセス (推定)

シグナルがブロックされている間に複数のシグナルが届くと、通知されるのは1つだけの場合があります。そのため、モニターがシグナルごとに `Wait4` を1回だけ呼び出すと、終了したプロセスを見逃し、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` の両方を追加するようになりました。これにより、Istio v1.25 以降では新しい注釈が正常に機能し、従来の注釈は v1.24.4 との互換性のために引き続き使用されます。

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

### 分散型マイグレーションのキャンセルとクリーンアップの修正

- 影響対象: 分散型ライブマイグレーション

移行中にどちらかの移行リソースを削除しても、移行が適切にキャンセルされず、ファイナライザーを手動で削除しなければならない移行リソースが残ることがありました。現在はキャンセルが伝播し、移行元は実行中の状態に戻り、両方の移行リソースがクリーンアップされます。この変更では移行先 VM はクリーンアップされません。

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

### Default VirtAPI クライアントのレート制限引き上げ

- 影響対象: 個々の webhook クライアントにデフォルトのレート制限を使用する KubeVirt 環境

このリリース以前は、`DefaultVirtAPI` クライアントのデフォルト値は QPS 5、バースト 10 で、authorizer-client のデフォルト値を下回っていました。大量退避イベント時には、認可済みリクエストによって webhook クライアントが飽和し、リクエストが処理されないことがありました。デフォルト値は 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 インストール環境 (推定)

informer による enqueue で移行の優先度が 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 のシャットダウン猶予期間処理の修正

- 影響対象: `spec.TerminationGracePeriodSeconds` を設定した VMI

ACPI シグナルに応答しない VM では、`virtctl stop vm --force --grace-period=0` のように強制停止時の猶予期間を更新しても、`virt-handler` にキャッシュされた猶予期間が古いために無視され、シャットダウンが停止したように見えることがありました。修正後は、応答しない VM も含め、更新後の VMI の猶予期間がシャットダウンに反映されます。

> - [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

### postcopy 移行での `ParallelMigrationThreads` のスキップ

- 影響対象: postcopy ライブマイグレーション

アップグレード中に `virt-handler` と `virt-launcher` のバージョンが異なると、postcopy 移行で `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 の導入
- VMPool の障害 VM 自動修復 (利用条件: VMPool での `spec.autohealing` の設定（自動修復はオプトイン）)
- VMPool の `unmanaged`／`opportunistic` スケールイン戦略の追加
- VMPool のスケールイン時の状態保持設定
- 変更された ImageVolume の container-disk イメージに対するライブマイグレーション
- マイグレーションの優先度カテゴリの一般化 (利用条件: `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 の設定における必須および優先アーキテクチャ値
- ラベルセレクターに基づく VM の Changed Block Tracking (利用条件: `changedBlockTrackingLabelSelectors` に一致する namespace または VM のラベルセレクター、および CBT の変更を反映するための VM の再起動)
- VNC を使わない KubeVirt のスクリーンショット
- DataVolume の Upload ソース向け libdv ビルダーオプション
- `kubevirt_vm_labels` ゲージによる VM ラベルの公開
- `VirtualMachineRestore` における PVC 所有者の設定
- 不健全な状態や遷移中の VM に対するアラートの追加
- VNC 接続での進行中セッションの維持 (利用条件: `virtctl vnc` の `--preserve-session` フラグ、または VNC エンドポイントの `preserveSession` クエリパラメーター)
- virt-handler の Node Labeller コントローラー制御用フラグ (利用条件: 既定値が `true` の `enable-node-labeller` フラグ。`false` に設定するとコントローラーを無効化)
- ゲスト CPU キューの記録ルールとアラート
- 一時停止中の VM ドメインでのゲストエージェントスナップショットに対応
- ゲストエージェントのCPU負荷メトリクスの報告
- バンドル版 common-instancetypes を v1.4.0 に更新、新しいプリファレンスを追加
- VM ファームウェアのシリアル検証の削除
- VMI でインスタンスタイプと競合しないメモリフィールドを設定可能に
- アーキテクチャ固有の `s390x` クラスター構成
- `VirtualMachineInstanceMigration` のステータスに同期アドレスを追加 (利用条件: 分散型ライブマイグレーションのフィーチャーゲートが有効であること)
- GPU と `HostDevices` の Kubernetes DRA 経由のサポート (利用条件: 対応するアルファ機能ゲートの有効化: 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` フィーチャーゲートの Beta 昇格
- ImageVolume フィーチャーゲートのベータ昇格
- `VideoConfig` の Alpha から Beta への昇格
- v1.6.0 の性能・スケーラビリティベンチマークをドキュメントとグラフに追加
- `PanicDevices` フィーチャーゲートのベータ昇格
- VM ディスクのブロック I/O における discard 粒度の設定
- `virt-handler` のデフォルトレート制限の引き上げ
- VM の移行中にメモリーオーバーコミットを再計算
- ビルドツールの Bazel v6.5.0 および `rules_oci` への更新
- ホットプラグテストにおけるインターフェース状態の正規化による `IP` と `IPs` の消去
- VMPool のユニットテストでフェイククライアントを使用
- Migration リソースに基づく PVC 作成要件
- 長い名前のVMIのボリューム更新移行ラベルでUIDを使用
- virt-launcher のメモリ差分を監視メトリクスに追加
- VM のファームウェアシリアル番号のデフォルト値を UUID に変更
- 分散型マイグレーション失敗後のソース VM/VMI 削除を可能に
- 一時停止中の VM に対するスナップショットの安全性警告の誤表示修正
- virt-launcher エージェントポーラーによる VM 一時停止中のゲストエージェントコマンドのスキップ
- `libvmi` 内の CPU とメモリーのセッター名を統一
- `NodeRestriction` フィーチャーゲートのベータ段階への移行

---

整理した内容は AI が作成するため誤っている可能性があり、無保証で提供されます。
