SelfHeal подсистем распространения метаданных

SelfHeal подсистем распространения метаданных — механизм автоматического управления конфигурациями реплик State Storage, Board и SchemeBoard.

В конфигурации параметры механизма используют историческое имя state_storage_self_heal_config, которое относится ко всем трём подсистемам.

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

Механизм запускается Sentinel — компонентом системы управления кластером CMS.

Включение и выключение SelfHeal подсистем распространения метаданных

Вы можете включать и выключать SelfHeal подсистем распространения метаданных с помощью изменения конфигурации:

1. Получите текущую конфигурацию кластера с помощью команды ydb admin cluster config fetch:

   ydb [global options...] admin cluster config fetch > config.yaml
   

2. Измените конфигурационный файл config.yaml. Для этого поменяйте значение параметра state_storage_self_heal_config.enable на true или на false.

   Для работы SelfHeal необходимо включить Sentinel: установите параметр cms_config.sentinel_config.enable в значение true в секции config файла config.yaml. Примените изменения на шаге 3.

   Пример конфигурации с включёнными Sentinel и SelfHeal:

   config:
       self_management_config:
           enabled: true # Включение распределённой конфигурации
       cms_config:
           sentinel_config:
               enable: true # Включение Sentinel
               state_storage_self_heal_config:
                   enable: true # Включение SelfHeal подсистем распространения метаданных
   

   Примечание

   Для работы механизма требуется конфигурация V2 и включённый CMS Sentinel.

   Наличие self_management_config.enabled: true косвенно указывает на использование конфигурации V2. Установка этого флага сама по себе не переводит кластер на конфигурацию V2. Для перехода выполните шаги инструкции Миграция на конфигурацию V2.

   При значении true у параметра state_storage_self_heal_config.enable включается механизм сохранения работоспособности и отказоустойчивости State Storage, Board, SchemeBoard.

3. Обновите конфигурацию кластера с учетом выполненных изменений с помощью ydb admin cluster config replace:

   ydb [global options...] admin cluster config replace -f config.yaml
   

Управление автоматическим изменением конфигурации

Помимо общего включения/выключения SelfHeal подсистем распространения метаданных (параметр state_storage_self_heal_config.enable), в секции self_management_config конфигурационного файла config.yaml вы можете по отдельности управлять автоматическим изменением конфигурации каждой из подсистем распространения метаданных, а также ограничивать множество узлов, на которые SelfHeal может переносить реплики.

config:
    self_management_config:
        enabled: true
        automatic_state_storage_management: true
        automatic_state_storage_board_management: true
        automatic_scheme_board_management: true
        state_storage_self_heal_allowed_nodes: [1, 2, 3, 4, 5, 6, 7, 8]
        state_storage_board_self_heal_allowed_nodes: [1, 2, 3, 4, 5, 6, 7, 8]
        scheme_board_self_heal_allowed_nodes: [1, 2, 3, 4, 5, 6, 7, 8]

Дополнительные параметры SelfHeal подсистем распространения метаданных

В секции cms_config.sentinel_config.state_storage_self_heal_config конфигурационного файла config.yaml вы можете настроить дополнительные параметры работы механизма SelfHeal подсистем распространения метаданных. Они влияют на то, как быстро реагирует механизм на изменения и сколько реплик подсистем распространения метаданных создаётся. В примере ниже все параметры показаны со значениями по умолчанию:

config:
    cms_config:
        sentinel_config:
            enable: true
            state_storage_self_heal_config:
                enable: true
                wait_for_config_step: 60000000
                relax_time: 600000000
                pileup_replicas: false
                override_replicas_in_ring_count: 0
                override_rings_count: 0
                replicas_specific_volume: 200

Проверка результата

Проверить, что изменения применились, можно в разделе CMS в YDB UI кластера (доступен на порту 8765): перейдите на вкладку Sentinel для просмотра статуса Sentinel и SelfHeal подсистем распространения метаданных.