From 885783dcc1e29ad32a89416bd9cc1a567b129ed7 Mon Sep 17 00:00:00 2001 From: Vladislav Panfilov Date: Wed, 4 Mar 2026 16:36:06 +0400 Subject: [PATCH] docs: fixes Signed-off-by: Vladislav Panfilov --- docs/RELEASE_NOTES.ru.md | 2 +- docs/USER_GUIDE.md | 6 ++++-- docs/USER_GUIDE.ru.md | 6 ++++-- openapi/config-values.yaml | 2 +- openapi/doc-ru-config-values.yaml | 2 +- 5 files changed, 11 insertions(+), 7 deletions(-) diff --git a/docs/RELEASE_NOTES.ru.md b/docs/RELEASE_NOTES.ru.md index db3d9ea3bd..57c3277ec3 100644 --- a/docs/RELEASE_NOTES.ru.md +++ b/docs/RELEASE_NOTES.ru.md @@ -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` с обзором состояния платформы виртуализации. diff --git a/docs/USER_GUIDE.md b/docs/USER_GUIDE.md index 8d7781e1d9..17edb3043c 100644 --- a/docs/USER_GUIDE.md +++ b/docs/USER_GUIDE.md @@ -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. diff --git a/docs/USER_GUIDE.ru.md b/docs/USER_GUIDE.ru.md index 8825ca6773..013238a760 100644 --- a/docs/USER_GUIDE.ru.md +++ b/docs/USER_GUIDE.ru.md @@ -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-устройств требуются соответствующие модули ядра на узле. diff --git a/openapi/config-values.yaml b/openapi/config-values.yaml index 0c44901dda..b34e7ec2c2 100644 --- a/openapi/config-values.yaml +++ b/openapi/config-values.yaml @@ -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: | diff --git a/openapi/doc-ru-config-values.yaml b/openapi/doc-ru-config-values.yaml index b9a7ae227f..442193611c 100644 --- a/openapi/doc-ru-config-values.yaml +++ b/openapi/doc-ru-config-values.yaml @@ -100,7 +100,7 @@ properties: description: | Расписание для запуска процедуры очистки хранилища. Очистка удалит неактуальные образы, созданные для ресурсов `ClusterVirtualImage`, `VirtualImage`, `VirtualDisk`, которых уже нет в кластере. - Расписание по умолчанию не задано. Периодическая очистка включится, если задать расписание. + По умолчанию периодическая очистка включена и выполняется ежедневно в 02:00. virtualImages: type: object description: |