diff --git a/docs/FAQ_RU.md b/docs/FAQ_RU.md index e8758e5e..dffe1693 100644 --- a/docs/FAQ_RU.md +++ b/docs/FAQ_RU.md @@ -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` либо обратиться к логам контроллера. @@ -45,27 +41,27 @@ description: "Распространенные вопросы и ответы н > - Поле `Consumable` имеет значение `true`. > - Для `Volume Group` типа `Local` указанные `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`.