Перемещение статической группы

Статья находится в разработке

Важно

Эта статья посвящена кластерам 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:

  1. Выключите автоматическое управление статической группой.

  2. Получите текущую конфигурацию статической группы.

  3. Внесите изменения и примените измененную конфигурацию в качестве целевой конфигурации статической группы.

    В конфигурационном файле 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 они отличаются.

  4. Перейдите на страницу мониторинга YDB UI и убедитесь, что VDisk статической группы появился на целевом физическом диске и реплицируется. Подробнее см. Мониторинг статической группы.

  5. Уберите целевую конфигурацию статической группы из файла конфигурации и включите автоматическое управление конфигурацией статической группы.