Skip to content

Commit

Permalink
chore(module): update
Browse files Browse the repository at this point in the history
Signed-off-by: Pavel Tishkov <[email protected]>
  • Loading branch information
fl64 committed Oct 7, 2024
1 parent 0d0d27e commit 79ab1b0
Show file tree
Hide file tree
Showing 7 changed files with 55 additions and 55 deletions.
30 changes: 15 additions & 15 deletions docs/ADMIN_GUIDE_RU.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,15 +5,15 @@ weight: 40

В данном разделе приведена информация по созданию и управлению ресурсами доступными только пользователям с правами администраторов платформы.

# Образы
## Образы

Ресурс `ClusterVirtualImage` служит для загрузки образов виртуальных машин во внутрикластерное хранилище, после чего с его помощью можно создавать диски виртуальных машин. Он доступен во всех пространствах имен\проектах кластера.

Процесс создания образа включает следующие шаги:

- Пользователь создаёт ресурс `ClusterVirtualImage`.
- После создания образ автоматически загружается из указанного в спецификации источника в хранилище (DVCR).
- После завершения загрузки, ресурс становится доступным для создания дисков.
- После завершения загрузки ресурс становится доступным для создания дисков.

Существуют различные типы образов:

Expand All @@ -26,17 +26,17 @@ weight: 40
- **Alt Linux**: https://ftp.altlinux.ru/pub/distributions/ALTLinux/platform/images/cloud/x86_64
- **Astra Linux**: https://download.astralinux.ru/ui/native/mg-generic/alse/cloudinit

После создания ресурса, тип и размер образа определяются автоматически, и эта информация отражается в статусе ресурса.
После создания ресурса тип и размер образа определяются автоматически, и эта информация отражается в статусе ресурса.

Образы могут быть загружены из различных источников, таких как HTTP-серверы, где расположены файлы образов, или контейнерные реестры. Также доступна возможность загрузки образов напрямую из командной строки с использованием утилиты curl.

Образы могут быть созданы из других образов и дисков виртуальных машин.

С полным описанием параметров конфигурации ресурса ClusterVirtualImage можно ознакомиться по [ссылке](cr.html#clustervirtualimage).

## Создание образа с HTTP-сервера
### Создание образа с HTTP-сервера

Рассмотрим вариант создания кластерного образа
Рассмотрим вариант создания кластерного образа.

Выполните следующую команду для создания `ClusterVirtualImage`:

Expand Down Expand Up @@ -98,7 +98,7 @@ d8 k get cvi ubuntu-22.04 -w
d8 k describe cvi ubuntu-22.04
```

## Создание образа из Container Registry
### Создание образа из Container Registry

Образ, хранящийся в Container Registry имеет определенный формат. Рассмотрим на примере:

Expand Down Expand Up @@ -145,7 +145,7 @@ spec:
EOF
```

## Загрузка образа из командной строки
### Загрузка образа из командной строки

Чтобы загрузить образ из командной строки, предварительно создайте следующий ресурс, как представлено ниже на примере `ClusterVirtualImage`:

Expand All @@ -162,7 +162,7 @@ spec:
EOF
```

После создания, ресурс перейдет в фазу `WaitForUserUpload` (`d8 k get vi some-image`), а это значит, что он готов для загрузки образа.
После создания, ресурс перейдет в фазу `WaitForUserUpload`, а это значит, что он готов для загрузки образа.

Доступно два варианта загрузки с узла кластера и с произвольного узла за пределами кластера:

Expand Down Expand Up @@ -195,7 +195,7 @@ d8 k get cvi some-image
# some-image Ready false 100% 1m
```

# Классы виртуальных машин
## Классы виртуальных машин

Ресурс `VirtualMachineClass` предназначен для централизованной конфигурации предпочтительных параметров виртуальных машин. Он позволяет определять инструкции CPU и политики конфигурации ресурсов CPU и памяти для виртуальных машин, а также определять соотношения этих ресурсов. Помимо этого, `VirtualMachineClass` обеспечивает управление размещением виртуальных машин по узлам платформы. Это позволяет администраторам эффективно управлять ресурсами платформы виртуализации и оптимально размещать виртуальные машины на узлах платформы.

Expand Down Expand Up @@ -231,7 +231,7 @@ spec:

Администраторы платформы могут создавать требуемые классы виртуальных машин по своим потребностям, но рекомендуется создавать необходимый минимум. Рассмотрим на следующем примере:

## Пример конфигурации VirtualMachineClass
### Пример конфигурации VirtualMachineClass

![](./images/vmclass-examples.ru.png)

Expand Down Expand Up @@ -418,17 +418,17 @@ spec:
type: Model
```

# Механизмы обеспечения надежности
## Механизмы обеспечения надежности

## Миграция / Режим обслуживания
### Миграция / Режим обслуживания

Миграция виртуальных машин является важной функцией в управлении виртуализованной инфраструктурой. Она позволяет перемещать работающие виртуальные машины с одного физического узла на другой без их отключения. Миграция виртуальных машин необходима для ряда задач и сценариев:

- Балансировка нагрузки: Перемещение виртуальных машин между узлами позволяет равномерно распределять нагрузку на серверы, обеспечивая использование ресурсов наилучшим образом.
- Перевод узла в режим обслуживания: Виртуальные машины могут быть перемещены с узлов, которые нужно вывести из эксплуатации для выполнения планового обслуживания или обновления программного обеспечения.
- Обновление "прошивки" виртуальных машин: Миграция позволяет обновить "прошивку" виртуальных машины не прерывая их работу.

### Запуск миграции произвольной машины
#### Запуск миграции произвольной машины

Далее будет рассмотрен пример миграции выбранной виртуальной машины:

Expand Down Expand Up @@ -469,7 +469,7 @@ kubectl get vm -w
# ubuntu-vm Running virtlab-pt-2 10.66.10.14 79m
```

### Режим обслуживания
#### Режим обслуживания

При выполнении работ на узлах с запущенными виртуальными машинами существует риск нарушения их работоспособности. Чтобы этого избежать, узел можно перевести в режим обслуживания и мигрировать виртуальные машины на другие свободные узлы.

Expand All @@ -495,7 +495,7 @@ kubectl uncordon <nodename>

![](./images/drain.ru.png)

## Coldstandby
### ColdStandby

ColdStandby обеспечивает механизм восстановления работы виртуальной машины после сбоя на узле, на котором она была запущена.

Expand Down
4 changes: 2 additions & 2 deletions docs/CHARACTERISTICS_DESCRIPTION_RU.md
Original file line number Diff line number Diff line change
Expand Up @@ -59,7 +59,7 @@ Deckhouse Virtualization Platform позволяет:

- конфигурации типа процессоров виртуальных машин;
- управления размещением виртуальных машин по узлам платформы;
- настройки ресурсов виртуальной машины (процессор, память) для более оптимального планировани и размещения виртуальных машин по узлам платформы.
- настройки ресурсов виртуальной машины (процессор, память) более оптимального планирования и размещения виртуальных машин по узлам платформы.

Класс виртуальной машины настраивается с использованием ресурса `VirtualMachineClass`.

Expand All @@ -77,4 +77,4 @@ Deckhouse Virtualization Platform позволяет:

## Операции над виртуальными машинами

Ресурс `VirtualMachineOperations` предназначен для декларативного управления изменением состоянием виртуальной машины. Ресурс позволяет выполнять следующие действия над виртуальными машинами: Запуск (Start), Остановка (Stop), Рестарт (Restart).
Ресурс `VirtualMachineOperations` предназначен для декларативного изменения состояния виртуальной машины. Ресурс позволяет выполнять следующие действия над виртуальными машинами: Запуск (Start), Остановка (Stop), Рестарт (Restart).
2 changes: 1 addition & 1 deletion docs/FAQ.md
Original file line number Diff line number Diff line change
Expand Up @@ -215,7 +215,7 @@ metadata:
app: old
```

# How to increase the DVCR size
## How to increase the DVCR size

To increase the disk size for DVCR, you must set a larger size in the `virtualization` module configuration than the current size.

Expand Down
4 changes: 2 additions & 2 deletions docs/FAQ_RU.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: "FAQ"
weight: 70
---

# Как установить ОС в виртуальной машине из ISO-образа?
## Как установить ОС в виртуальной машине из ISO-образа?

**Установка ОС в виртуальной машине из ISO-образа на примере установки ОС Windows**

Expand Down Expand Up @@ -222,7 +222,7 @@ metadata:
app: old
```

# Как увеличить размер DVCR
## Как увеличить размер DVCR

Чтобы увеличить размер диска для DVCR, необходимо установить больший размер в конфигурации модуля `virtualization`, чем текущий размер.

Expand Down
22 changes: 11 additions & 11 deletions docs/INSTALL_RU.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,16 +3,16 @@ title: "Установка"
weight: 15
---

# Требования к DVP
## Требования к DVP

## Требования к ресурсам:
### Требования к ресурсам:

Рекомендуются следующие минимальные ресурсы для инфраструктурных узлов в зависимости от их роли в кластере:

- Мастер-узел — 4 CPU, 8 ГБ RAM, 60 ГБ дискового пространства на быстром диске (400+ IOPS);
- Worker-узел — требования аналогичны требованиям к master-узлу, но во многом зависят от характера запускаемой на узле (узлах) нагрузки.

## Требования к узлам платформы:
### Требования к узлам платформы:

- ОС на базе Linux:
- РЕД ОС 7.3, 8.0
Expand All @@ -26,9 +26,9 @@ weight: 15
- Версия ядра Linux >= 5.7
- ЦП с архитектурой x86_64 c с поддержкой инструкций Intel-VT (vmx) или AMD-V (svm)

# Порядок установки
## Порядок установки

1. Разверните кластер Deckhouse Kubernetes Platform по [инструкции](https://deckhouse.ru/gs/).
1. Разверните кластер Deckhouse Kubernetes Platform [по инструкции](https://deckhouse.ru/gs/).

2. Включите необходимые модули.

Expand All @@ -40,15 +40,15 @@ weight: 15
- [CEPH-CSI](/documentation/v1/modules/031-ceph-csi/)

3. [Установите](https://kubernetes.io/docs/tasks/administer-cluster/change-default-storage-class/) `StorageClass` по умолчанию.
4. Включите модуль [console](https://deckhouse.ru/modules/console/stable/), который позволит управлять компонентами виртуализации через графический интерфейс (Данная возможность доступна только пользователям EE-редакции).
4. Включите модуль [console](https://deckhouse.ru/modules/console/stable/), который позволит управлять компонентами виртуализации через графический интерфейс (данная возможность доступна только пользователям EE-редакции).

5. Включите модуль `virtualization`:

{{< alert level="warning" >}}
Внимание! Включение модуля `virtualization` предполагает рестарт kubelet\containerd на всех узлах, где предполагается запуск виртуальных машин. Это необходимо для настройки связности containerd и DVCR.
{{< /alert >}}

Для включения модуля `virtualization`, необходимо создать ресурс `ModuleConfig`, содержащий настройки модуля.
Для включения модуля `virtualization`, необходимо создать ресурс `ModuleConfig` содержащий настройки модуля.

{{< alert level="info" >}}
Полный перечень параметров конфигурации приведен в разделе ["Настройки"](./configuration.html)
Expand Down Expand Up @@ -76,7 +76,7 @@ spec:
EOF
```

Блок `.spec.settings.dvcr` описывает настройки для репозитория для хранения образов виртуальных машин, в данном блоке указывается размер хранилища предоставляемого для хранения образов `.spec.settings.dvcr.storage.persistentVolumeClaim.size`. В блоке `.spec.settings.virtualMachineCIDRs` задается список подсетей. Адреса виртуальных машин будут выделятся автоматически или по по запросу из заданных диапазонов подсетей по порядку.
Блок `.spec.settings.dvcr` описывает настройки для репозитория для хранения образов виртуальных машин, в данном блоке указывается размер хранилища предоставляемого для хранения образов `.spec.settings.dvcr.storage.persistentVolumeClaim.size`. В блоке `.spec.settings.virtualMachineCIDRs` задается список подсетей. Адреса виртуальных машин будут выделяться автоматически или по по запросу из заданных диапазонов подсетей по порядку.

Отследить готовность модуля можно с использованием следующей команды:

Expand All @@ -88,9 +88,9 @@ d8 k get modules virtualization

Статус модуля должен быть `Ready`.

# Обновление платформы
## Обновление платформы

Deckhouse Virtualization Platform использует пять каналов обновлений предназначенных для использования в разных окружениях, к которым с точки зрения надежности применяются разные требования:
Deckhouse Virtualization Platform использует пять каналов обновлений, предназначенных для использования в разных окружениях, к которым с точки зрения надежности применяются разные требования:

| Канал обновлений | Описание |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
Expand All @@ -102,4 +102,4 @@ Deckhouse Virtualization Platform использует пять каналов

Компоненты Deckhouse Virtualization Platform могут обновляться автоматически, либо с ручным подтверждением по мере выхода обновлений в каналах обновления.

Информацию по версиям, доступных на каналах обновления можно получить на данном сайте https://releases.deckhouse.ru/
Информацию по версиям, доступных на каналах обновления, можно получить на данном сайте https://releases.deckhouse.ru/
Loading

0 comments on commit 79ab1b0

Please sign in to comment.