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

Важно

Данная статья описывает работу с кластерами YDB, использующими конфигурацию V1. Конфигурация V1 является основным способом конфигурирования кластеров под управлением YDB версии ниже v25.1. Начиная с версии v25.1, YDB поддерживает конфигурацию V2, которая является рекомендуемым способом конфигурирования для кластеров YDB версии v25.1 и выше. Для кластеров, использующих конфигурацию V2, данная инструкция не применима.

Если ваш кластер уже обновлён до версии v25.1 или выше, но ещё использует конфигурацию V1, рекомендуется запланировать миграцию на конфигурацию V2, так как поддержка конфигурации V1 будет прекращена в будущих версиях YDB.

Если нужно вывести из эксплуатации хост кластера YDB, на котором располагается часть статической группы, необходимо переместить её на другой хост.

Важно

Неправильная последовательность действий или ошибка в конфигурации могут привести к недоступности кластера YDB.

В качестве примера рассмотрим кластер YDB, в котором на хосте с node_id:1 сконфигурирован и запущен статический узел. Этот узел обслуживает часть статической группы.

Фрагмент конфигурации статической группы:

...
blob_storage_config:
  ...
  service_set:
    ...
    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. Остановите статический узел кластера на хосте с node_id:1.

    Примечание

    Кластер YDB является отказоустойчивым. Временное выключение узла не приводит к недоступности кластера. Подробнее см. Топология кластера YDB.

  2. В конфигурационном файле config.yaml измените значение node_id, заменив идентификатор удаляемого хоста на идентификатор добавляемого:

    ...
blob_storage_config:
  ...
  service_set:
    ...
    groups:
      ...
      rings:
        ...
        fail_domains:
        - vdisk_locations:
          - node_id: 10
            path: /dev/vda
            pdisk_category: SSD
        ...
      ...
    ...
  ...
...

    Измените путь path и категорию pdisk_category диска, если на хосте с node_id: 10 они отличаются.

  3. Обновите конфигурационные файлы config.yaml для всех узлов кластера, в том числе и динамических.

  4. С помощью процедуры rolling-restart перезапустите все статические узлы кластера.

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

  6. С помощью процедуры rolling-restart перезапустите все динамические узлы кластера.

Предыдущая
Перемещение State Storage
Следующая
Замена FQDN узла