v0.25.0

Changelog v0.25.0

Know before update

• In version v0.25.0, support for the module's operation with CRI Containerd V2 has been added.
  After upgrading CRI from Containerd v1 to Containerd v2, it is necessary to recreate the images that were created using virtualization module version v0.24.0 and earlier.

Features

• [core] In version v0.25.0, support for the module's operation with CRI Containerd V2 has been added. #1395
  In version v0.25.0, support for the module's operation with CRI Containerd V2 has been added.
  After upgrading CRI from Containerd v1 to Containerd v2, it is necessary to recreate the images that were created using virtualization module version v0.24.0 and earlier.
• [observability] New Prometheus metrics have been added to track the phase of resources such as VirtualMachineSnapshot, VirtualDiskSnapshot, VirtualImage, and ClusterVirtualImage. #1356
• [vm] MAC address management for additional network interfaces has been added using the VirtualMachineMACAddress and VirtualMachineMACAddressLease resources. #1350
• [vm] Added the ability to attach additional network interfaces to a virtual machine for networks provided by the SDN module. For this, the SDN module must be enabled in the cluster. #1253
• [vmclass] An annotation has been added to set the default VirtualMachineClass.
  To designate a VirtualMachineClass as the default, you need to add the annotation
  virtualmachineclass.virtualization.deckhouse.io/is-default-class=true to it.
  This allows creating VMs with an empty spec.virtualMachineClassName field, which will be automatically filled with the default class. #1305

Fixes

• [module] Added validation to ensure that virtual machine subnets do not overlap with system subnets (podSubnetCIDR and serviceSubnetCIDR). #1324
• [vi] To create a virtual image on a PersistentVolumeClaim, the storage must support the RWX and Block modes; otherwise, a warning will be displayed. #1289
• [vm] Fixed an issue where changing the operating system type caused the machine to enter a reboot loop. #1358
• [vm] Fixed an issue where a virtual machine would hang in the Starting phase when project quotas were insufficient. A quota shortage message will now be displayed in the virtual machine's status. To allow the machine to continue starting, the project quotas need to be increased. #1314

For more information, see the changelog and minor version release changes.

v0.24.0

Changelog v0.24.0

Features

• [api] Remove setting of VolumeSnapshotClass. Set field deprecated in CRDS's. #1274
• [core] bump kubevirt to tag v1.3.1-v12n.8. Set mac address for non default pod network and improve reason when live-migration failed #1287
• [vd] Add Exporting phase and new conditions to VirtualDisk status #1256
• [vm] Add additional network interfaces for VirtualMachines. #1253

Fixes

• [core] fix CVE-2025-22868 #1322
• [module] Fix helm template to be compatible with CustomCertificate https mode. #1297
• [observability] fix alerts D8InternalVirtualizationVirtHandlerTargetAbsent and D8InternalVirtualizationVirtHandlerTargetDown, by removing them and adding virtualization virt metrics state #1291
• [vd] Fail with error on insufficient PVC size #1295
• [vd] Set ImageNotReady/ClusterImageNotReady condition when VI/CVI is missing. #1286
• [vd] Improve virtual disk protection logic during deletion #1285
• [vm] Fix an issue where multiple networks of type "Main" could be specified in a virtual machine's spec. #1299
• [vm] Add react on create virtual machine event for WorkloadUpdater controller #1293
• [vm] Add validation to ensure that names in spec.blockDeviceRefs do not exceed the maximum allowed lengths. #1276

Chore

• [api] Update the IsStorageClassDeprecated method to accept a StorageClass pointer instead of a string. #1264
• [docs] Examples of using the user interface have been added to the documentation #1270

For more information, see the changelog and minor version release changes.

v0.23.1

Changelog v0.23.1

Fixes

• [api] A virtual machine with the AlwaysOn run policy can be restored with the forced mode. #1294

For more information, see the changelog and minor version release changes.

v0.23.0

Changelog v0.23.0

Features

• [core] All containers have been switched to read-only mode, which is part of efforts to enhance security and ensure integrity control of the virtualization components. #1244

• [vmrestore] Added the ability to forcefully restore a virtual machine from a snapshot using the restoreMode parameter. This parameter has two possible values:

  • Safe - a safe recovery option when there are no conflicts with the virtual machine's resources;
  • Forced - a forced recovery option that can be applied to a running virtual machine but may lead to destructive consequences if conflicts arise during the recovery process.

  If the forcibly restored virtual disks are used by another virtual machine or the restored IP address is reserved by another virtual machine, the recovery process will fail, and this will be reported in the VirtualMachineRestore resource status. #1115

Fixes

• [core] Fixed the placement of the virtualization management component on system nodes when they are present in the cluster. If there are no system nodes in the cluster, it will be placed on master nodes. #1260
• [vd] For a virtual disk in Filesystem mode, fixed the ability to dynamically attach (hotplug) to a virtual machine. #1241
• [vd] Fixed the creation of virtual disks using NFS storage with the no_root_squash option. #1210

For more information, see the changelog and minor version release changes.

v0.22.0

Changelog v0.22.0

Features

• [api] The storage classes managed by the local-path-provisioner module are now deprecated for VirtualImage and VirtualDisk creation. #1243

Fixes

• [api] The allowed name lengths for resources have been adjusted and the corresponding validation has been added:
  • ClusterVirtualImage: 48 characters (instead of 36)
  • VirtualImage: 49 characters (instead of 37) #1229
• [module] Now in clusters with High Availability mode, the virtualization components on the master nodes use 3 replicas. #1208
• [module] Fixed the deployment of the virtualization module in HTTP mode (when using Disabled or OnlyInURI options for the https.mode setting), which could lead to blocking the execution of the deckhouse queue. #1207
• [module] Fixed the deployment of the module on nodes with CentOS, Rocky Linux, and Alma Linux with SELinux enabled (Enforced). Now the installation completes without errors. #1203
• [module] Reduced the module size to 50MB (previously 445MB). #1181
• [vm] Removed unnecessary warnings about virtual machines running in privileged mode — such messages are no longer displayed, as this is standard and expected behavior of the system. #1202
• [vmsnapshot] Fixed the hotplugging of existing images when restoring a virtual machine from a snapshot. #1198

For more information, see the changelog and minor version release changes.

v0.21.2

Changelog v0.21.2

Fixes

• [vd] The creation of virtual disks using the storage class of the local-path-provisioner module has been fixed.
  Support for storage classes managed by the local-path-provisioner module will be discontinued starting from version 0.22. #1228

For more information, see the changelog and minor version release changes.

v0.20.2

Changelog v0.20.2

Fixes

• [vd] The creation of virtual disks using the storage class of the local-path-provisioner module has been fixed.
  Support for storage classes managed by the local-path-provisioner module will be discontinued starting from version 0.22. #1228

For more information, see the changelog and minor version release changes.

v0.21.1

Changelog v0.21.1

Fixes

• [vmip] Fix the deletion of old VirtualMachineIPAddress resources that may have had a legacy finalizer blocking deletion. #1220

For more information, see the changelog and minor version release changes.

v0.21.0

Changelog v0.21.0

Features

• [core] Add automatic rebalancing of virtual machines to optimize load distribution among cluster nodes based on CPU usage threshold (80%) and affinity/anti-affinity rules. This functionality is activated only when the descheduler module is enabled. #962
• [module] Add detection of virtualization-capable nodes (with /dev/kvm enabled and support for VMX/SVM processor instructions) to schedule virtual machine deployment only on suitable nodes. #1076
• [vm] Add the ability for dynamic attachment (hotplug) of a virtual disk in Filesystem mode to a virtual machine. #1060

Fixes

• [vd] Fix the update of the .status.observedGeneration field for a virtual disk in the Ready state if the image from which the disk was created no longer exists in the cluster. #1124
• [vmip] Fix a potential hang during the deletion of a VirtualMachineIPAddress resource when deleting a virtual machine. #1185

For more information, see the changelog and minor version release changes.

v0.20.1

Changelog v0.20.1

Fixes

• [api] The allowed name lengths for resources have been adjusted and the corresponding validation has been added:
  • VirtualMachine: 63 characters
  • ClusterVirtualImage: 36 characters
  • VirtualImage: 37 characters
  • VirtualDisk: 60 characters #1177
• [module] Fixed a hang during virtualization version upgrade in an HA cluster with two system nodes. #1173

For more information, see the changelog and minor version release changes.