update

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

docs/EXAMPLES_RU.md

@@ -105,7 +105,10 @@ dvp vnc -n vms linux-vm
 
 ## Образы
 
-`VirtualMachineImage` и `ClusterVirtualMachineImage` используются для хранения образов виртуальных машин, представляющих собой диски виртуальных машин или ISO-образы с установочными файлами, с целью создания и тиражирования идентичных дисков виртуальных машин. При подключении к виртуальной машине эти образы доступны только для чтения, и установочный IS0-образ будет подключен в виде cdrom-устройства.
+`VirtualMachineImage` и `ClusterVirtualMachineImage` используются для хранения образов виртуальных машин.
+Образы могут быть следующих видов:
+- Образ диска виртуальной машины, который предназначен для тиражирования идентичных дисков виртуальных машин.
+- ISO-образ, содержащий файлы для установки ОС. Этот тип образа подключается к виртуальной машине как cdrom.
 
 Ресурс `VirtualMachineImage` доступен только в том пространстве имен, в котором был создан, а `ClusterVirtualMachineImage` доступен для всех пространств имен внутри кластера.
 
@@ -273,7 +276,7 @@ https://virtualization.example.com/upload/dSJSQW0fSOerjH5ziJo4PEWbnZ4q6ffc -T ci
 
 После завершения работы команды `curl` образ должен быть создан.
 
-4. Проверьте, что статус созданного образа успешен:
+4. Проверьте, что статус созданного образа `Ready`:
 
 ```bash
 kubectl get clustervirtualmachineimages
@@ -326,7 +329,7 @@ kubectl get virtualmachinedisk
 
 При создании ресурса диска можно указать желаемый размер. Если размер не указан, то будет создан диск с размером, соответствующим исходному образу диска, который хранится в ресурсе `VirtualMachineImage` или `ClusterVirtualMachineImage`. Если необходимо создать диск большего размера, укажите необходимый размер.
 
-Используйте ранее созданный `ClusterVirtualMachineImage` с именем `ubuntu-2204` (приведено в качестве примера):
+В качестве примера рассмотрен ранее созданный `ClusterVirtualMachineImage` с именем `ubuntu-2204`:
 
 ```yaml
 apiVersion: virtualization.deckhouse.io/v1alpha2
@@ -353,7 +356,7 @@ kubectl patch ubuntu-root --type merge -p '{"spec":{"persistentVolumeClaim":{"si
 
 ### Подключение дисков к запущенным виртуальным машинам
 
-Диски могут быть подключены в работающей виртуальной машине с использованием `VirtualMachineBlockDeviceAttachment` ресурса (приведенного в качестве примера):
+Диски могут быть подключены в работающей виртуальной машине с использованием `VirtualMachineBlockDeviceAttachment` ресурса:
 
 ```yaml
 apiVersion: virtualization.deckhouse.io/v1alpha2
@@ -523,15 +526,15 @@ spec:
 
 ### 3. Настройка порядка применения изменений
 
-Внесенные изменения в конфигурацию виртуальной машины не отобразятся, так как по умолчанию применяется политика изменений `Manual`. Внесенные изменения изменения нужно подтвердить.
+Внесенные изменения в конфигурацию виртуальной машины не отобразятся, так как по умолчанию применяется политика изменений `Manual`. Для применения изменений виртуальную машину требуется перезагрузить.
 
 1. Чтобы проверить статус виртуальной машины, введите командую:
 
 ```bash
 kubectl get linux-vm -o jsonpath='{.status}'
 ```
 
-В поле `.status.pendingChanges` отобразятся изменения, которые требуют подтверждения. 
+В поле `.status.pendingChanges` отобразятся изменения, которые требуют подтверждения.
 
 В поле `.status.message` появится сообщение: для применения изменений, необходимо перезапустить виртуальную машину.
 
@@ -591,7 +594,7 @@ kubectl get virtualmachine
 # linux-vm   Running   node-name-x    10.66.10.1  5m
 ```
 
-Если виртуальная машина снова запустилась:
+Виртуальная машина была перезапущена. Причина перезапуска:
 
 > В отличие от традиционных систем виртуализации, мы используем политику запуска для определения состояния виртуальной машины, которая определяет требуемое состояние виртуальной машины в любое время.
 

docs/FAQ_RU.md

@@ -80,9 +80,9 @@ spec:
         name: win-disk
 ```
 
-После создания ресурса виртуальная машина будет запущена. К ней необходимо подключиться с помощью графического установщика. 
+После создания ресурса виртуальная машина будет запущена. К ней необходимо подключиться, и с помощью графического установщика выполнить установку ОС и драйверов `virtio`.
 
-4. Добавьте драйверы `virtio` и выполните установку ОС:
+Команда для подключения:
 
 ```bash
 dvp vnc -n default win-vm
@@ -104,6 +104,12 @@ spec:
         name: win-disk
 ```
 
+8. После внесенных изменений виртуальная машина запустится, для продолжения работы с ней используйте команду:
+
+```bash
+dvp vnc -n default win-vm
+```
+
 ## Как создать образ виртуальной машины для container registry
 
 Образ диска виртуальной машины, хранящийся в container registry, должен быть сформирован специальным образом.
@@ -176,7 +182,7 @@ spec:
     app: new
 ```
 
-Изменив метки на виртуальной машине, перенаправьте на нее сетевой трафик с сервиса `svc-2`:
+При изменении метки на виртуальной машине, трафик с сервиса `svc-2` будет перенаправлен на виртуальную машину:
 
 ```yaml
 metadata:
@@ -186,18 +192,18 @@ metadata:
 
 # Как увеличить размер DVCR
 
-Чтобы увеличить размер, необходимо установить больший размер в конфигурации модуля `virtualization`, чем текущий размер.
+Чтобы увеличить размер диска для DVCR, необходимо установить больший размер в конфигурации модуля `virtualization`, чем текущий размер.
 
 1. Проверьте текущий размер dvcr:
-   
+
 ```shell
 kubectl get mc virtualization -o jsonpath='{.spec.settings.dvcr.storage.persistentVolumeClaim}'
 #Output
 {"size":"58G","storageClassName":"linstor-thick-data-r1"}
 ```
 
 2. Задайте размер:
-   
+
 ```shell
 kubectl patch mc virtualization \
   --type merge -p '{"spec": {"settings": {"dvcr": {"storage": {"persistentVolumeClaim": {"size":"59G"}}}}}}'
@@ -207,7 +213,7 @@ moduleconfig.deckhouse.io/virtualization patched
 ```
 
 3. Проверьте изменение размера:
-   
+
 ```shell
 kubectl get mc virtualization -o jsonpath='{.spec.settings.dvcr.storage.persistentVolumeClaim}'
 #Output

docs/README_RU.md

@@ -24,7 +24,7 @@ moduleStatus: experimental
 - Модуль [CNI Cilium](/documentation/v1/modules/021-cni-cilium/) для обеспечения сетевой связности виртуальных машин.
 - Модули [SDS-DRBD](https://deckhouse.ru/modules/sds-drbd/stable/) или [CEPH-CSI](/documentation/v1/modules/031-ceph-csi/) для хранения данных виртуальных машин. Также возможно использовать другие варианты хранилищ, поддерживающие создание блочных устройств с режимом доступа `RWX` (`ReadWriteMany`).
 
-## Чтобы включить модуль
+## Как включить модуль?
 
 Порядок действий для включения модуля
 
@@ -52,16 +52,16 @@ API предоставляет возможности для создания и
 
 Образы представляют собой неизменяемые ресурсы, которые позволяют создавать новые виртуальные машины на основе предварительно настроенных и сконфигурированных образов. В зависимости от типа, образы могут быть в форматах `raw`, `qcow2`, `vmdk` и других для образов дисков виртуальных машин, а также в формате `iso` для установочных образов, которые могут быть подключены как `cdrom-устройства`.
 
-Для загрузки образов можно использовать внешние источники, такие как `HTTP-сервер`, `container registry`, а также локальные источники через командную строку (`cli`). Также существует возможность создавать образы из дисков виртуальных машин, например, при необходимости создания базового образа для тиражирования (`golden-image`).
+Для загрузки образов можно использовать внешние источники, такие как `HTTP-сервер`, `container registry`, а также загрузить локальный файл через командную строку (`cli`). Также существует возможность создавать образы из дисков виртуальных машин, например, при необходимости создания базового образа для тиражирования (`golden-image`).
 
 > Образы могут быть подключены к виртуальной машине только в режиме для чтения.
 
-Образы бывают двух типов: 
+Образы бывают двух типов:
 
 * кластерные `ClusterVirtualMachineImage`, которые доступны для всех пользователей платформы;
-* ограниченные по пространству имен `VirtualMachineImage`, которые доступны только для пользователей в рамках определенного `namespace`.
+* ограниченные по пространству имен `VirtualMachineImage`, которые доступны только для пользователей `namespace`, в котором они созданы.
 
-Для `ClusterVirtualMachineImage` образы хранятся только в `DVCR`, а для `VirtualMachineImage` можно использовать как `DVCR`, так и хранилище, предоставляемое платформой (`PVC`).
+Все образы хранятся в `DVCR`.
 
 ### Диски виртуальных машин
 
@@ -77,7 +77,9 @@ Cоздание дисков для виртуальных машины обес
 
 Ресурс `VirtualMachine` отвечает за создание виртуальной машины и управления её жизненным циклом. Через конфигурацию `VirtualMachine` можно определить параметры виртуальной машины, такие как количество процессоров, объем оперативной памяти, подключаемые образы и диски, а также правила размещения на узлах платформы, аналогично тому, как это делается для подов.
 
-Политика запуска виртуальной машины определяет ее состояние. Она может быть включена, выключена или управление состоянием может осуществляться вручную. Во время перезагрузки узла, на котором находится виртуальная машина, эта виртуальная машина будет автоматически перемещена с помощью механизма "живой миграции" на другой доступный узел, который соответствует правилам размещения.
+Политика запуска виртуальной машины определяет ее состояние. Она может быть всегда включена, выключена или управление состоянием может осуществляться вручную.
+
+При переводе узла кластера в режим обслуживания, работающая виртуальная машина будет автоматически перемещена на другой подходящий узел с помощью механизма "живой миграции".
 
 Виртуальная машина запускается внутри пода, что позволяет управлять виртуальными машинами как обычными ресурсами Kubernetes и использовать все возможности платформы, включая балансировщики нагрузки, сетевые политики, средства автоматизации и т. д.