Skip to content

Commit

Permalink
Update FAQ_RU.md
Browse files Browse the repository at this point in the history
Signed-off-by: Andrey Polovov <[email protected]>
  • Loading branch information
apolovov authored Jan 19, 2024
1 parent d75cd9c commit 658b3c3
Showing 1 changed file with 19 additions and 23 deletions.
42 changes: 19 additions & 23 deletions docs/FAQ_RU.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,31 +12,27 @@ description: "Распространенные вопросы и ответы н

* В большинстве случаев `BlockDevice`-ресурсы могут не создаваться по причине того, что существующие девайсы не проходят фильтрацию на стороне контроллера. Пожалуйста, убедитесь, что ваши девайсы соответствуют указанным [требованиям](./usage.html#требования-контроллера-к-девайсу).

* `LVMVolumeGroup`-ресурсы могут не создаваться по причине отсутствия `BlockDevice`-ресурсов, так как используют их как
источник данных.
* `LVMVolumeGroup`-ресурсы могут не создаваться по причине отсутствия в кластере `BlockDevice`-ресурсов, так как их имена используются в спецификации `LVMVolumeGroup`.

* В том случае, если `BlockDevice`-ресурсы существуют, а `LVMVolumeGroup`-ресурсы отсутствуют, пожалуйста, убедитесь, что у существующих `Volume Group` имеется специальный тег `storage.deckhouse.io/enabled=true`.
* В том случае, если `BlockDevice`-ресурсы существуют, а `LVMVolumeGroup`-ресурсы отсутствуют, пожалуйста, убедитесь, что у существующих `LVM Volume Group` на узле имеется специальный тег `storage.deckhouse.io/enabled=true`.

## Я удалил ресурс `LVMVolumeGroup`, но `Volume Group` осталась? Что делать?

Удаление ресурса `LVMVolumeGroup` не приводит к удалению указанной в нем `Volume Group`. Для этого в ресурс необходимо
добавить специальную аннотацию на запуск процесса удаления: `storage.deckhouse.io/sds-delete-vg: ""`. Контроллер запустит
процесс удаления `Volume Group` и после его завершения удалит связанный ресурс самостоятельно.
добавить специальную аннотацию: `storage.deckhouse.io/sds-delete-vg: ""`. Контроллер запустит
процесс удаления `LVM Volume Group` с узла и после его завершения удалит связанный ресурс самостоятельно.

> Простое удаление ресурса `LVMVolumeGroup` приведет к созданию нового ресурса со сгенерированным именем по имеющейся `Volume Group`.
> Простое удаление ресурса `LVMVolumeGroup` приведет к созданию нового ресурса со сгенерированным именем по данным из имеющейся `LVM Volume Group` на узле.
## Я добавил аннотацию на удаление, но ресурс `LVMVolumeGroup` продолжает существовать и `Volume Group` на узле осталась. Почему?

Распространенный случай — на `Volume Group`, указанной в ресурсе, имеются `Logical Volume`. Контроллер не удаляет `Logical Volume`, так как эти `volumes` могут иметь различные данные, и пользователь должен самостоятельно очистить их.
Распространенный случай — соответствующая `LVM Volume Group` на узле имеет `Logical Volume`. Контроллер не удаляет `Logical Volume`, так как эти `volumes` могут иметь важные данные, и пользователь должен самостоятельно очистить их.

Через несколько секунд после удаления `Logical Volume` операция удаления `Volume Group` и связанного с ней ресурса должна быть завершена.

> Время удаления может затянуться в случае, если очередь реконсайлера у контроллера забита иными событиями. Если вы хотите немедленного удаления `Volume Group` и связанного ресурса, можете обновить аннотацию удаления, например, добавив к ее значению любую цифру: `storage.deckhouse.io/sds-delete-vg: ""` -> `storage.deckhouse.io/sds-delete-vg: "1"`.
> В таком случае реконсайл на удаление отработает незамедлительно.
Через несколько секунд после удаления `Logical Volume` контроллер должен довести до конца операцию удаления `Volume Group` и связанного с ней ресурса.

## Я пытаюсь создать `Volume Group`, используя ресурс `LVMVolumeGroup`, но у меня ничего не получается. Почему?

Скорее всего, ваш ресурс не проходит валидацию со стороны контроллера.
Скорее всего, ваш ресурс не проходит валидацию со стороны контроллера (при этом, валидация со стороны Kubernetes прошла успешно).
С конкретной причиной неработоспособности вы можете ознакомиться в самом ресурсе в поле `status.message` либо обратиться
к логам контроллера.

Expand All @@ -45,27 +41,27 @@ description: "Распространенные вопросы и ответы н
> - Поле `Consumable` имеет значение `true`.
> - Для `Volume Group` типа `Local` указанные `BlockDevice` принадлежат одному узлу.
<!-- > - Для `Volume Group` типа `Shared` указан единственный ресурс `BlockDevice`. -->
> - Выбранные `BlockDevice` не участвуют в других ресурсах `LVMVolumeGroup` (других `Volume Group`).
> - Указаны актуальные имена ресурсов `BlockDevice`.
>
> С полным списком ожидаемых значений вы можете ознакомиться с помощью [CR-референса](ссылка на реф) `LVMVolumeGroup`-ресурса.
> С полным списком ожидаемых значений вы можете ознакомиться с помощью [CR-референса](./cr.html) `LVMVolumeGroup`-ресурса.
## Что произойдет, если я отключу один из девайсов в `Volume Group`? Соответствующий ресурс `LVMVolumeGroup` удалится?

Ресурс `LVMVolumeGroup` будет существовать до тех пор, пока существует соответствующая `Volume Group`. До тех пор, пока
существует хоть один девайс, `Volume Group` будет существовать, но в «нездоровом» состоянии.
Эти проблемы будут отображены в `Status` ресурса.
Эти проблемы будут отображены в `status` ресурса.

После восстановления отключенного девайса на узле, `LVM Volume Group` восстановит свою работоспособность и соответствующий ресурс `LVMVolumeGroup` также отобразит актуальное состояние.

После восстановления отключенного девайса `Volume Group` восстановит свою работоспособность и соответствующий ресурс `LVMVolumeGroup` также отобразит актуальное состояние.
## Как передать контроллеру управление существующей на узле `LVM Volume Group`?

## Я хочу, чтобы контроллер перестал следить за `Volume Group`. Как мне это сделать?
Достаточно добавить LVM-тег `storage.deckhouse.io/enabled=true` на `LVM Volume Group` (`vgchange myvg-0 --addtag storage.deckhouse.io/enabled=true`).

Достаточно удалить тег `storage.deckhouse.io/enabled=true` у нужной `Volume Group`. После этого контроллер перестанет отслеживать выбранную `Volume Group` и самостоятельно удалит связанный с ней ресурс `LVMVolumeGroup`.
## Я хочу, чтобы контроллер перестал следить за `LVM Volume Group` на узле. Как мне это сделать?

## Я не вешал тег `storage.deckhouse.io/enabled=true` на `Volume Group`, но он появился. Как это возможно?
Достаточно удалить LVM-тег `storage.deckhouse.io/enabled=true` у нужной `LVM Volume Group` на узле (`vgchange myvg-0 --deltag storage.deckhouse.io/enabled=true`). После этого контроллер перестанет отслеживать выбранную `Volume Group` и самостоятельно удалит связанный с ней ресурс `LVMVolumeGroup`.

Это возможно в случае, если вы создавали `Volume group` через ресурс `LVMVolumeGroup` (в таком случае контроллер автоматически вешает данный тег на созданную `Volume Group`) либо на данной `Volume Group` или ее `Thin-pool` был тег модуля `Linstor``linstor-*`.
Модуль `sds-node-configurator` заменяет часть функционала контроллера `linstor-pools-importer` из встроенного модуля `Linstor`.
Поэтому при переходе с встроенного модуля `Linstor` на модули `sds-node-configurator` и `sds-drbd` автоматически происходит изменение тегов `linstor-*` на тег `storage.deckhouse.io/enabled=true` в `Volume Group`. Таким образом, управление этими `Volume Group` передается модулю `sds-node-configurator`.
## Я не вешал LVM-тег `storage.deckhouse.io/enabled=true` на `Volume Group`, но он появился. Как это возможно?

> Контроллер единоразово совершает операцию перетегирования по всем существующим `Volume Group` в момент своего запуска.
Это возможно в случае, если вы создавали `LVM Volume Group` через ресурс `LVMVolumeGroup` (в таком случае контроллер автоматически вешает данный LVM-тег на созданную `LVM Volume Group`). Либо на данной `Volume Group` или ее `Thin-pool` был LVM-тег модуля `Linstor``linstor-*`.
При миграции с встроенного модуля `Linstor` на модули `sds-node-configurator` и `sds-drbd` автоматически происходит изменение LVM-тегов `linstor-*` на LVM-тег `storage.deckhouse.io/enabled=true` в `Volume Group`. Таким образом, управление этими `Volume Group` передается модулю `sds-node-configurator`.

0 comments on commit 658b3c3

Please sign in to comment.