upd

Signed-off-by: Pavel Tishkov <[email protected]>

Author: fl64

docs/USER_GUIDE.md

@@ -617,8 +617,8 @@ VolumeBindingMode property:
 
 AccessMode:
 
-- `ReadWriteOnce (RWO)` - only one instance of the virtual machine is granted access to the disk.
 - `ReadWriteMany (RWX)` - multiple disk access. Live migration of virtual machines with such disks is possible.
+- `ReadWriteOnce (RWO)` - only one instance of the virtual machine is granted access to the disk. Live migration of virtual machines with such disks is possible only in the DVP commercial editions. Live migration is only available if all disks are connected statically via (`.spec.blockDeviceRefs`). Disks connected dynamically via `VirtualMachineBlockDeviceAttachments` must be reconnected statically by specifying them in `.spec.blockDeviceRefs`.
 
 When creating a disk, the controller will independently determine the most optimal parameters supported by the storage.
 
@@ -649,7 +649,7 @@ How to find out the available storage options in the DVP web interface:
 
 - Go to the "System" tab, then to the "Storage" section → "Storage Classes".
 
-## Create an empty disk
+### Create an empty disk
 
 Empty disks are usually used to install an OS on them, or to store some data.
 
@@ -862,6 +862,35 @@ Method #2:
 - Click on the "Save" button that appears.
 - The disk status is displayed at the top left, under its name.
 
+### Changing the disk StorageClass
+
+In the DVP commercial editions, it is possible to change the StorageClass for existing disks. At the moment, this is only supported for running VMs (`Phase` should be `Running`).
+
+{{< alert level="warning">}}
+Storage class migration is only available for disks connected statically via (`.spec.blockDeviceRefs`).
+
+To migrate the storage class of disks attached via `VirtualMachineBlockDeviceAttachments`, you must statically reattach them by specifying them in `.spec.blockDeviceRefs`.
+{{< /alert >}}
+
+Example:
+
+```bash
+d8 k patch vd disk --type=merge --patch '{"spec":{"persistentVolumeClaim":{"storageClassName":"new-storage-class-name"}}}'
+```
+
+After the disk configuration is updated, a live migration of the VM will be initiated, during which the VM’s disk will be migrated to the new storage.
+
+If a VM has multiple disks attached and you need to change the storage class for several of them, this operation must be performed sequentially:
+
+```bash
+d8 k patch vd disk1 --type=merge --patch '{"spec":{"persistentVolumeClaim":{"storageClassName":"new-storage-class-name"}}}'
+d8 k patch vd disk2 --type=merge --patch '{"spec":{"persistentVolumeClaim":{"storageClassName":"new-storage-class-name"}}}'
+```
+
+If migration fails, repeated attempts are made with increasing delays (exponential backoff algorithm). The maximum delay is 300 seconds (5 minutes). Delays: 5 seconds (1st attempt), 10 seconds (2nd), then each delay doubles, reaching 300 seconds (7th and subsequent attempts). The first attempt is performed without delay.
+
+To cancel migration, the user must return the storage class in the specification to the original one.
+
 ## Virtual machines
 
 The `VirtualMachine` resource is used to create a virtual machine, its parameters allow you to configure:

docs/USER_GUIDE.ru.md

@@ -625,8 +625,9 @@ EOF
 
 Режим доступа AccessMode:
 
-- `ReadWriteOnce (RWO)` - доступ к диску предоставляется только одному экземпляру виртуальной машины.
 - `ReadWriteMany (RWX)` - множественный доступ к диску. Живая миграция виртуальных машин с такими дисками возможна.
+- `ReadWriteOnce (RWO)` - доступ к диску предоставляется только одному экземпляру виртуальной машины. Живая миграция виртуальных машин с такими дисками возможна только для платных редакций DVP. Живая миграция доступна только если все диски подключенны статически через (`.spec.blockDeviceRefs`). Диски подключенные динамически через `VirtualMachineBlockDeviceAttachments`, необходимо статически подключить их заново, указав их в `.spec.blockDeviceRefs`.
+
 
 При создании диска контроллер самостоятельно определит наиболее оптимальные параметры поддерживаемые хранилищем.
 
@@ -870,6 +871,35 @@ linux-vm-root   Ready   11Gi       12m
 - Нажмите на появившуюся кнопку «Сохранить».
 - Статус диска отображается слева вверху, под его именем.
 
+### Изменение класса хранения диска
+
+Для платных редакций DVP существует возможность изменения класса хранения для созданных дисков. На данный момент это возможно только для работающих ВМ (`Phase` должна быть `Running`).
+
+{{< alert level="warning">}}
+Миграция класса хранения поддерживается только для дисков, статически подключенных через параметр `.spec.blockDeviceRefs` в конфигурации виртуальной машины.
+
+Для миграции класса хранения дисков, подключенных через `VirtualMachineBlockDeviceAttachments`, необходимо переподключить их статически, указав в `.spec.blockDeviceRefs`.
+{{< /alert >}}
+
+Пример:
+
+```bash
+d8 k patch vd disk --type=merge --patch '{"spec":{"persistentVolumeClaim":{"storageClassName":"new-storage-class-name"}}}'
+```
+
+После изменения конфигурации диска запустится живая миграция ВМ, в процессе которой диск ВМ будет смигрирован на новое хранилище.
+
+Если к виртуальной машине подключены несколько дисков и требуется изменить класс хранения для нескольких дисков, эту операцию необходимо выполнить последовательно:
+
+```bash
+d8 k patch vd disk1 --type=merge --patch '{"spec":{"persistentVolumeClaim":{"storageClassName":"new-storage-class-name"}}}'
+d8 k patch vd disk2 --type=merge --patch '{"spec":{"persistentVolumeClaim":{"storageClassName":"new-storage-class-name"}}}'
+```
+
+При неуспешной миграции повторные попытки выполняются с увеличивающимися задержками (алгоритм экспоненциального backoff). Максимальная задержка — 300 секунд (5 минут). Задержки: 5 секунд (1-я попытка), 10 секунд (2-я), далее каждая задержка удваивается, достигая 300 секунд (7-я и последующие попытки). Первая попытка выполняется без задержки.
+
+Для отмены миграции пользователь должен вернуть класс хранения в спецификации на исходный.
+
 ## Виртуальные машины
 
 Для создания виртуальной машины используется ресурс `VirtualMachine`. Его параметры позволяют сконфигурировать: