# KubeVirt v1.10.0

2026-11-18 · [元のリリースノート](https://github.com/kubevirt/kubevirt/releases/tag/v1.10.0) · [全体のまとめ](https://ratatosk.io/ja/releases/kubevirt/v1.10.0)

セキュリティ 7 · 破壊的変更 38 · 非推奨 1 · 重大な修正 74 · 機能・改善 39 · 依存関係の更新 7 · その他の変更 31

## アップグレード前の確認事項

### 既知の問題

- **KubeVirt Operator マニフェストのクライアントサイド適用失敗**: `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 トラフィック転送の修正

- 影響対象: pod ネットワークを持ち、`virtctl port-forward` または `virtctl ssh` でアクセスする VMI
- [CVE-2026-13318](https://www.cve.org/CVERecord?id=CVE-2026-13318)

ランチャーポッドの IP を解決できない場合、virt-api はゲストエージェントが報告した未検証のインターフェース IP を使用していたため、到達可能な任意のエンドポイントへトラフィックを転送できる状態でした。ポートフォワードと SSH では、ランチャーポッドの IP にのみ接続するようになりました。また、pod ネットワークを持たない 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 から到達できず、ポートフォワードのトンネルを確立できないことがあります。ポートフォワードでは、利用可能な場合は launcher Pod の IP に接続し、利用できない場合はインターフェースステータスの IP にフォールバックするようになりました。既存のコアバインディングでは観測可能な変化はなく、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.

### 移行 ID の共有をプロキシ有効時に限定

- 影響対象: 移行プロキシが無効な KubeVirt 構成

以前は、移行プロキシが無効でも同期コントローラーポッドに移行 ID が渡されていました。現在は、プロキシが有効な場合にのみ、その ID が渡されます。

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

### メモリダンプ PVC を VM スナップショットおよびエクスポートから除外

- 影響対象: メモリダンプ 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`

以前は、ベースチェックポイントのビットマップがないディスクが1つでもあると、有効なビットマップを持つディスクも含めてバックアップ全体が失敗していました。現在は、そのディスクをフルバックアップし、ほかのディスクは増分差分を維持します。

> - [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 仕様のボリューム名ではなく、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 製モニターのログ出力レベルに反映されていました。書き換え後の C 製モニターは、設定値をログ出力レベルの設定に使用しません。

根拠: “- 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` ステータスのプルモード用エンドポイントリンクの分離

- 影響対象: プルモードのバックアップにおける `VirtualMachineBackup` のステータス

プルモードの `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` フィーチャーゲートの Beta への昇格とデフォルトでの有効化

- 影響対象: `VSOCK` フィーチャーゲートを使用または設定するインストール環境、および VSOCK を使用するワークロード (推定)

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

### KubeVirt による旧 `cpumanager` ノードラベルの使用終了

- 影響対象: virt-handler によって更新されたノードで、旧 `cpumanager` ノードラベルを使用する自動化ルールまたはスケジューリングルール (推定)

Pod では引き続き `kubevirt.io/cpumanager` ラベルが使用されます。

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

### CBT のダーティービットマップのオーバーヘッドを VM のメモリー計算に反映

- 影響対象: CBT が有効な VM

従来のメモリー計算では、CBT のダーティービットマップに必要なメモリーが含まれておらず、必要量を過小評価していました。現在は、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` オブジェクトを照会せず、launcher 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 移行でハッシュ化されたインターフェース名を使用

- 影響対象: 序数付きネットワークまたはタップインターフェース名を持つ VM、および `--upgrade-ordinal-ifaces` を使用する自動化
- 必要な対応: ライブマイグレーション中の対象 VM の変換（手動操作不要）

以前は、移行先に移行元 Pod の序数付きインターフェース名が引き継がれる場合があり、移行前フックはゲートによって制御されていました。`--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.

### ノードフックにおけるプラグインレベルの条件の適用

- 影響対象: プラグインレベルの `Spec.Condition` を設定したノードフック (推定)

条件の扱いがドメインフックと同じになります。

> - [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` をインポートするコード

別のインポート済みパッケージ（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 ユーティリティボリュームを使用するメモリダンプ

- 影響対象: メモリダンプを使用する環境

以前は、ダンプ時に `MemoryDump` ボリュームを VM テンプレートと `vmi.spec.volumes` の両方に追加していました。現在はテンプレートを変更せず、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` は特定の割り当てにバインドされるため、移行先の Pod では同じ割り当てを再度予約できません。

根拠: “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` の実行 (推定)

ボリュームの作成には、削除されたフラグの代わりに `type:blank`、`type:ds`、または `type:pvc` を指定した `--volume-import` を使用します。

> - [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 Service でヘッドレスポート 8443 を使用

- 影響対象: 新しい VMExport を作成する環境

新規エクスポートのリンクでは `:8443` を使用しますが、既存の ClusterIP エクスポートでは引き続き `:443` を使用します。`https://virt-export-*.svc:443` をハードコードしているクライアントは、新規エクスポートで動作しなくなります。`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` を使用する Plugin オブジェクト (推定)

以前の `spec.domainHooks` ではフックポイントを明示する必要がなく、停止フックポイントには `PreVMStop` という名前が付いていました。ランチャーフックではフックポイントの明示が必須となり、`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` エンドポイントを呼び出すクライアント (推定)

以前は、1つの `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 バインディングの拒否

- 影響対象: DRA ネットワークで構成された SR-IOV インターフェース

従来は、DRA ネットワークで SR-IOV バインディングを使用でき、virt-launcher がパススルー用に DRA デバイスメタデータから PCI アドレスを解決していました。今後、これらのインターフェースではバインディングプラグインを使用する必要があります。

根拠: “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

### Stall detector API フィールドの型変更

- 影響対象: `MigrationStallDetection` を有効にして v1.9 からアップグレードするクラスター、および v1.9 の `StallDetectorOptions` をインポートする SDK

4つの 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

Windowsの「ハードウェアを安全に取り外す」メニューなど、ゲストOSのホットプラグ機能によって、ディスク、メモリバルーン、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.

### 複数の vGPU を持つテンプレートを拒否する RamFB ディスプレイ検証

- 影響対象: `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 の conditions とイベントに警告が記録されます。

> - [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 を参照している場合でも、そのオーバーレイが再利用され、増分バックアップが不正になることがありました。この場合、バックアップは Full になります。

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

### OCI エクスポートアーカイブのプッシュ時における Image Index の保持

- 影響対象: KubeVirt OCI エクスポートアーカイブ

エクスポートしたアーカイブを `skopeo copy --multi-arch=all` でプッシュすると、レジストリにプラットフォーム情報が失われた通常のマニフェストが登録されることがありました。また、`oras copy --from-oci-layout vm.oci.tar:latest` では `latest` を解決できない場合がありました。現在は、アーカイブ内で Image Index を blob として保存し、`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 予約数の過大計上を修正

- 影響対象: `supplementalPool` の IO スレッドと `EmulatorThreadCompleteToEvenParity` を組み合わせる専用 CPU の VMI

IO スレッド数が奇数の場合、ホスト CPU を気付かないうちに 1 個余分に予約することがありました。例では、正しい数が 10 個のところ、11 個が要求されていました。予約数は、ゲスト vCPU、IO スレッド、エミュレータースレッドをそれぞれ 1 回ずつ数えるようになりました。

> - [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 バスが空になることがありました。現在は外部で作成されたデバイスが保持されます。一方、`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.

### キャプチャされた ControllerRevisions で Common-instancetypes のバージョンラベルを保持

- 影響対象: 参照される instancetype または preference オブジェクトのうち、`instancetype.kubevirt.io/common-instancetypes-version` ラベルを持つもの

これらのオブジェクトを 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 によるドメイン再起動時のゲストエージェント VMStats キャッシュのリセット

- 影響対象: `VMStatsCollector` フィーチャーゲートとゲストエージェントデータを使用する VMStats の収集

ゲスト OS の再起動後、キャッシュの TTL が切れるまで、VMStats から古いホスト名、OS、ネットワークインターフェースのデータが返されることがありました。libvirt がドメインの再起動を報告すると、次回の VMStats リクエストで新しいゲストエージェントデータを取得します。

> - [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 プールの自動修復が適用される場合があります。

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

### pause 解除の繰り返しや移行時のゲスト時刻同期を修正

- 影響対象: pause と pause 解除を繰り返す、または移行の最終処理を行う VMI

一度限りの `sync.Once` ガードにより、`setGuestTime()` は VMI の存続期間中に一度しか実行されず、その後の pause 解除や移行の最終処理で時刻同期が行われていませんでした。

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

### ユーティリティボリュームとホットプラグボリューム向けの単一アタッチメント Pod

- 影響対象: ユーティリティボリュームとホットプラグボリュームの両方を使用する VM

両方のボリューム種別を使用すると、ホットプラグ用アタッチメント Pod が2つ作成される場合がありました。単一の Pod に、使用するボリュームに応じたマウントとデバイスが含まれます。

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

### `VMBackup` のファイナライザー追加時に発生するステータス消失の修正

- 影響対象: `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 の検出で `--kubelet-root` を使用する `virt-handler`

- 影響対象: デフォルト以外の 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 の応答しないドメインソケット処理 (推定)

複数の応答しないソケットを、ソケットが応答可能な状態と応答しない状態の間で切り替わる場合も含め、1回の処理でクリーンアップできるようになりました。応答しないソケットの追跡を解除しても、別のソケットの期限切れ処理が妨げられなくなりました。

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

### 同名の VM と VMI での時系列再利用を UID ラベルで修正

- 影響対象: `kubevirt_vm_info` または `kubevirt_vmi_info` をスクレイプまたはクエリするインストール環境 (推定)

以前は、同じ名前と namespace でオブジェクトを削除して再作成すると、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 (推定)

3つ以上の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` フィーチャーゲートが有効で、少なくとも1つの Plugin があるクラスター内で、SR-IOV、GPU、または PCI ホストデバイスを使用する VMI

この構成では、該当する VMI は起動に失敗していました。この修正により、生成されるホストデバイスエントリーに `subsystem` モードが追加され、起動できるようになりました。

> - [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` に設定されている場合、独自の `failureStrategy` を持たないノードフックが失敗しても、VM の起動、停止、移行はブロックされなくなりました。どちらのレベルにもストラテジーが設定されていない場合、フックの既定値は `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.

### virt-handler のデバイスプラグイン再起動時の panic を修正

- 影響対象: ホストデバイスを持つノード

デバイスプラグインの再起動時に virt-handler が panic することがありました。ホストデバイスを持つノードでは、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` で停止していました。書き込みを復旧するには、オーバーレイを手動でコミットするか、スナップショットを復元する必要がありました。今後は起動時に、置き換え後の VMI が残ったオーバーレイ上で起動し、その書き込みを実行中にコミットします。これにより起動ブロックが解除され、コミットの検証後にスクラッチボリュームが解放されます。ボリュームまたはスクラッチ状態のチェックに失敗した場合、復旧は引き続き拒否されます。

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

### ホットプラグのマウント解除時に PVC 上のファイルを保持

- 影響対象: ホットプラグ用マウントルート経由でマウントされたホットプラグボリュームを使用する VM ワークロード (推定)

virt-handler がユーティリティボリュームをアンマウントする前に kubelet のクリーンアップが実行されると、そのボリュームの PVC 上のファイルが削除されることがありました。現在は、代わりにメモリーバックのルートをアンマウントするため、マウント済みの 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 を拒否してエクスポートが完了しませんでした。現在はインデックスに基づく一意なボリューム名を使用するため、エクスポートが完了します。

> - [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までバックアップが保留状態のままでした。現在は `SourceLost` で失敗し、プルモードのエクスポートも削除されます。

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

### サブコマンド失敗時も `GetVMStats` が成功した統計情報を保持

- 影響対象: `GetVMStats` を通じて VMStats を収集するセットアップ (推定)

以前は、1つのサブコマンドが失敗すると、virt-handler はほかのサブコマンドが返したデータを破棄していました。現在は、失敗が `VMStats.Errors` マップに記録されます。

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

### 重複 PVC によるエクスポート失敗時のステータス報告

- 影響対象: VM、VMSnapshot、または VMTemplate をソースとし、複数のボリュームで同じ PVC を参照する `VirtualMachineExport`

以前は、重複したボリューム名があると、ステータスが書き込まれる前にエクスポーターポッドが拒否され、エクスポートの phase が空のまま、condition もなく、バックオフが無限に続いていました。現在は、対象の claim 名を示す `DuplicatePVC` の Ready condition とともに `Pending` を報告します。重複参照が修正されるまで、エクスポーターポッドは作成されません。

> - [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 ホールが残ることがありました。現在はそのホールに手を加えないため、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秒を超えると、バックアップ後フックのタイムアウト注釈の設定にかかわらず、内部の 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` がクラッシュし、同期や移行の失敗につながる可能性がありました。デフォルトのデバイスルールは、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 VirtualMachineExports

ダイジェスト処理でバックエンド状態ディレクトリ内の `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

### Centos Stream 10 向け KubeVirt イメージのソケットパス互換性修正

- 影響対象: Centos Stream 10 ベースで `virt-handler` または `vm-killer` イメージを使用するデプロイメント (推定)

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` は必要なドメイン設定を省略していました。現在は、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` フェーズの終了済みソースランチャー 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 の修正

- 影響対象: CDI ディスクインポートに使用する `VirtualMachineExport` マニフェスト

エクスポート CA のローテーション後に exporter Pod を再作成すると、既存のマニフェスト `ConfigMap` に古い CA が残り、それを使用する 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` が誤って発報する問題の修正

- 影響対象: UDF CDROM/ISO を接続し、`GuestFilesystemAlmostOutOfSpace` による監視を行っている 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 アラートは実行中で Ready ではない Pod に対してのみ発報します。

> - [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` 以外のエラーを呼び出し元に返し、呼び出し元がそのエラーを `SyncFailed` イベントに反映するため、virt-handler は終了しません。

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

### virt-handler の ghost レコードおよびマウントレコードのアトミックなディスク書き込み

- 影響対象: virt-handler が ghost レコードまたはマウントレコードをディスクに書き込む構成

レコードの書き込み中に virt-handler が再起動すると、データが失われたり、レコードが破損したりする可能性がありました。

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

### ドメインの早期 undefine の修正

- 影響対象: ホットプラグを使用する VM (推定)

QEMU の起動に時間がかかると、ドメインが早期に undefine され、VM が一時的な状態になってホットプラグが機能しなくなっていました。アップグレード後は、この早期の undefine が修正されています。

> - [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分間のランチャー再接続猶予期間

- 影響対象: 実行中のVMI

virt-handler の再起動によってランチャーソケットへの接続が一時的に失われた場合、実行中のVMIは直ちに Failed とマークされていました。現在は、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 デバイスの公開

- 影響対象: IOMMUFD ベースの GPU パススルーを使用する SMMUv3 搭載 ARM64 システム

SMMUv3 搭載 ARM64 システムでの 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.

### ホットプラグボリュームのデタッチ時のデッドロック修正

- 影響対象: アタッチメント Pod 間で 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 count 低下アラートで `running` ルールを使用

- 影響対象: virt count 低下アラートを利用する環境 (推定)

以前は、これらのアラートで `running` ルールではなく `up` ルールを使用していました。

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

### NFS バックエンドの VM の誤った再起動を修正

- 影響対象: NFS バックエンドのストレージを使用する VM

NFS サーバーのフェイルオーバーなどで NFS が一時的に利用できなくなると、これらの 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` による importer Pod 拒否の修正

- 影響対象: `kubevirt-plugin-sidecar-subpath-policy` を使用しているインストール環境 (推定)

ポリシーの `matchConditions` による評価時に、importer 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` 経由で hugepages を必要とする場合、このボリュームが `/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 コントローラーの期待値タイムアウト後の同期再試行

- 影響対象: Pod、VMI、PVC の期待値が関係する VM/VMI の削除

期待値が未充足の間にコントローラーを起こす Pod イベントが発生しない場合、削除処理はデフォルトで数時間先となる次回の informer 再同期まで待つことがありました。現在は期待値のタイムアウト後に同期を再試行します。タイムアウトはデフォルトで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 を展開できない場合や、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` フィーチャーゲートのベータ昇格
- バックアップ API `backup.kubevirt.io/v1beta1` の導入
- 停止中の VM の増分バックアップ (利用条件: `OfflineIncrementalBackup` フィーチャーゲート（デフォルトで無効、`IncrementalBackup` が必要）)
- External モードの `VirtualMachineSnapshot` での QCOW2 オーバーレイ使用 (利用条件: External モードの利用には、`ExternalVMSnapshot` フィーチャーゲートの有効化が必要（アルファ版）)
- ARM64 ゲスト向け UEFI セキュアブートのアルファ版 (利用条件: `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 鍵交換グループ設定 (利用条件: Alpha 段階でデフォルト無効の `TLSGroupPreferences` フィーチャーゲートの有効化と、希望するグループを指定した `TLSConfiguration.Groups` の設定)
- ラベル付き Route、Ingress、Service からのプロキシモード移行エンドポイント検出 (利用条件: プロキシモードが有効で、クラスター間ネットワークが構成されておらず、適切なエンドポイント検出ラベルが付いた Route、Ingress、または Service があること)
- 最新の成功した VMI 移行における virt-handler のゲスト一時停止時間ゲージ
- `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` では、TLS ハンドシェイクを制御する `--vsock-tls` の設定（デフォルト値は true）。)
- `VMStatsCollector` を介したゲストデバイスペイロードの転送
- `GetVMStats` にゲストのファイルシステム情報を追加 (利用条件: `GetVMStats` リクエストの `GuestGetFsInfo`)
- DRA ネットワーク要求のバインディングサイドカーと移行先への引き継ぎ
- 孤立が疑われる PVC ストレージ用 KubeVirt 記録ルール
- ライブマイグレーションのダウンタイム動的調整 (利用条件: アルファ版 `MigrationDowntimeTuning` フィーチャーゲートと、`MigrationPolicy` の `.spec.experimental.downtimeTuning` によるオプトイン)
- OCI アーティファクトとルート直下のディスクに対応した ImageVolume containerDisk (利用条件: コンテナ以外の OCI アーティファクトでは、互換性のないダイジェスト解決用 init コンテナーをスキップするため、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` フィーチャーゲートの Beta 昇格
- VM 状態 PVC のレイアウトを正規の VM 非依存レイアウトへ移行
- ContainerPath ボリュームのベータ昇格とデフォルト有効化
- `virt-launcher-monitor` を静的リンクの C スーパーバイザーに書き換え、2Mi を予備確保
- ライブマイグレーション時にソースドメインXMLから不足するCBTオーバーレイを作成
- ボリューム切り離し時のCBTオーバーレイ削除
- `VirtualMachineRestore` のパッチアドミッションで有効な JSON Patch 操作を受け入れ
- `virt-launcher-pod-mutator` Webhook に対する virt-operator の GET 繰り返しの停止
- ホットプラグボリュームの個別アタッチ
- virt-operator による重複エンドポイントのメッセージと警告の安定化
- 従来のファームウェア UUID 計算と同期の削除
- Windows クラッシュ時の `hyperv` パニックデバイスの処理変更
- KubeVirt インベントリメトリクスへの VM 識別ラベルの追加
- ACPI 無効時の amd64 ゲスト向け警告の追加
- NFS ディスクイメージを共有する VM のエラー表示を改善
- `VMStatsCollector` が未対応のゲストエージェントコマンドに対してキャッシュ済みの空結果を返す動作
- カスタム seccomp プロファイルファイルの権限を 0600 に変更
- KubeVirt カスタム seccomp プロファイルのアトミック書き込み
- ストレージ自己認定スイートへの PVC 拡張テストの追加
- プラグイン CEL フック評価器の共有セットアップのキャッシュ化
- 旧式 containerdisk の CRC32 チェックサム計算の削除
- `virtctl evacuate-cancel` が VMI のノード名を渡すように変更
- VMI メモリーオーバーヘッド報告の GA 昇格
- `hermetic_launcher` v0.0.15 による s390x コンテナーイメージビルドの修正
- オンラインディスク拡張での `GetBlockInfo` の反復呼び出し回避
- コンテナーイメージビルドでの `rules_img` の採用
- migration オブジェクトに伴う virt-launcher Pod のクリーンアップ
- ネットワーク適合性テストでのカスタムネットワークバインディングプラグインへの対応
- DRA のエンドツーエンドテスト対応
- Grace I/O Virtualization の SMMUv3 アドレス機能の明示的な設定
- DRA GPU およびホストデバイスのフィーチャーゲートのベータ昇格

---

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