deckhouse · prismagod · Mar 4, 2026
@@ -11,7 +11,7 @@ weight: 70
 ### Новые возможности
 
 - [vm] Добавлена поддержка подключения USB-устройств к виртуальным машинам через `.spec.usbDevices`.
-- [usb] Добавлены ресурсы [NodeUSBDevice](/modules/virtualization/cr.html#nodeusbdevice) и `USBDevice`, позволяющие управлять USB-устройствами в кластере:
+- [usb] Добавлены ресурсы [NodeUSBDevice](/modules/virtualization/cr.html#nodeusbdevice) и [USBDevice](/modules/virtualization/cr.html#usbdevice), позволяющие управлять USB-устройствами в кластере:
   - [NodeUSBDevice](/modules/virtualization/cr.html#nodeusbdevice) (cluster-scoped) — представляет USB-устройство, обнаруженное на конкретном узле. Позволяет назначить USB-устройство для использования в конкретном неймспейсе.
   - [USBDevice](/modules/virtualization/cr.html#usbdevice) (namespace-scoped) — представляет USB-устройство, доступное для подключения к виртуальным машинам в заданном неймспейсе.
 - [observability] Добавлен дашборд `Virtualization / Overview` с обзором состояния платформы виртуализации.

@@ -3759,7 +3759,7 @@ The USB device is automatically forwarded to the node where the virtual machine
 {{< /alert >}}
 
 {{< alert level="warning" >}}
-If a virtual machine with an attached USB device is migrated to another node, the USB device is automatically detached for the entire duration of the migration.
+If a virtual machine with an attached USB device is migrated to another node, the USB device is automatically detached for the entire duration of the migration. After a successful migration, the device is forwarded to the new node again and reattached to the VM. If the migration fails, the device is reattached on the original node.
 {{< /alert >}}
 
 ### Viewing USB Device Details
@@ -3818,7 +3818,9 @@ Both `USBDevice` and `NodeUSBDevice` resources update their status conditions to
 USB device passthrough has several operational requirements and limitations that must be considered before use:
 
 - The DRA driver must be installed on nodes where USB devices are to be discovered.
-- USB devices are forwarded to the VM node over the network using USBIP. The VM does not need to run on the same node where the device is physically connected.
+- USB devices are forwarded to the VM node over the network using USBIP. The VM does not need to run on the same node where the device is physically connected. When connecting over the network, the following limitations on the number of devices and hub selection apply:
+  - Node can attach at most 16 USB devices: up to 8 on the USB 2.0 hub and up to 8 on the USB 3.0 hub.
+  - Hub is determined by the device speed and cannot be changed. A device that operates at USB 2.0 speed cannot be attached to the USB 3.0 hub, and vice versa.
 - USB devices support hot-plug — they can be attached to and detached from a running VM without stopping it.
 - USB device passthrough requires proper kernel modules on the node.
 

@@ -3795,7 +3795,7 @@ USB-устройство автоматически пробрасывается
 {{< /alert >}}
 
 {{< alert level="warning" >}}
-Если виртуальная машина с подключённым USB-устройством мигрирует на другой узел, USB-устройство автоматически отключается на всё время миграции.
+Если виртуальная машина с подключённым USB-устройством мигрирует на другой узел, USB-устройство автоматически отсоединяется на всё время миграции. После успешного завершения миграции устройство снова пробрасывается на новый узел и подключается к ВМ. Если миграция не удалась, устройство подключается обратно на старый узел.
 {{< /alert >}}
 
 ### Просмотр информации об USB-устройстве
@@ -3854,7 +3854,9 @@ Status:
 При использовании проброса USB-устройств необходимо учитывать следующие требования и ограничения:
 
 - Драйвер DRA должен быть установлен на узлах, где требуется обнаружение USB-устройств.
-- USB-устройства пробрасываются на узел ВМ по сети с использованием USBIP. Виртуальная машина не обязана работать на том же узле, где физически подключено устройство.
+- USB-устройства пробрасываются на узел ВМ по сети с использованием USBIP. Виртуальная машина не обязана работать на том же узле, где физически подключено устройство. При подключении по сети действуют следующие ограничения по количеству устройств и выбору концентратора:
+  - Узел может подключить не более 16 USB-устройств: до 8 на концентратор USB 2.0 и до 8 на концентратор USB 3.0.
+  - Концентратор определяется скоростью устройства и не может быть выбран вручную. Устройство, работающее на USB 2.0, не может быть подключено к концентратору USB 3.0, и наоборот.
 - USB-устройства поддерживают hot-plug — их можно подключать и отключать от работающей ВМ без её остановки.
 - Для проброса USB-устройств требуются соответствующие модули ядра на узле.
 

@@ -191,7 +191,7 @@ properties:
             description: |
               Schedule to run garbage collection procedure that remove stale images for `ClusterVirtualImage`, `VirtualImage`, `VirtualDisk` resources deleted from the cluster.
 
-              Default schedule is not defined. Specify schedule to enable garbage collection.
+              By default, periodic garbage collection is enabled and runs daily at 02:00.
   audit:
     type: object
     description: |

@@ -100,7 +100,7 @@ properties:
             description: |
               Расписание для запуска процедуры очистки хранилища. Очистка удалит неактуальные образы, созданные для ресурсов `ClusterVirtualImage`, `VirtualImage`, `VirtualDisk`, которых уже нет в кластере.
 
-              Расписание по умолчанию не задано. Периодическая очистка включится, если задать расписание.
+              По умолчанию периодическая очистка включена и выполняется ежедневно в 02:00.
   virtualImages:
     type: object
     description: |