Перемещение статической группы
Статья находится в разработке
Важно
Эта статья посвящена кластерам YDB, в которых используется конфигурация V2. Данный способ конфигурирования пока является экспериментальным и доступен только для версий YDB начиная с v25.1. Для использования в продакшене мы рекомендуем выбирать конфигурацию V1 — она является основной и официально поддерживаемой для всех кластеров YDB.
При использовании Конфигурации V2 управление статической группой выполняется автоматически: механизм SelfHeal реконфигурирует группу при отказе одного из её узлов.
Если требуется управлять конфигурацией статической группы вручную, отключите автоматическое управление, получите текущую конфигурацию, внесите изменения и примените её как целевую. Затем удалите целевую конфигурацию статической группы из файла конфигурации и снова включите автоматическое управление.
Важно
Ошибка в конфигурации подсистем распространения метаданных (в том числе в секции domains_config) или неправильная последовательность изменений могут привести к недоступности кластера YDB.
В качестве примера рассмотрим кластер YDB, в котором на хосте с node_id:1 сконфигурирован и запущен статический узел. Этот узел обслуживает часть статической группы.
Фрагмент конфигурации статической группы:
...
groups:
...
rings:
...
fail_domains:
- vdisk_locations:
- node_id: 1
path: /dev/vda
pdisk_category: SSD
...
...
Для замены node_id:1 используйте другой хост с развернутым на нем статическим узлом с node_id:10.
Чтобы переместить часть статической группы с хоста node_id:1 на node_id:10:
-
Выключите автоматическое управление статической группой.
-
Получите текущую конфигурацию статической группы.
-
Внесите изменения и примените измененную конфигурацию в качестве целевой конфигурации статической группы.
В конфигурационном файле
config.yamlизмените значениеnode_id, заменив идентификатор удаляемого хоста на идентификатор добавляемого:... groups: ... rings: ... fail_domains: - vdisk_locations: - node_id: 10 path: /dev/vda pdisk_category: SSD ... ...Измените путь
pathи категориюpdisk_categoryдиска, если на хосте сnode_id: 10они отличаются. -
Перейдите на страницу мониторинга YDB UI и убедитесь, что VDisk статической группы появился на целевом физическом диске и реплицируется. Подробнее см. Мониторинг статической группы.
-
Уберите целевую конфигурацию статической группы из файла конфигурации и включите автоматическое управление конфигурацией статической группы.