Миграция конфигурации кластера
В YDB поддерживается два механизма управления конфигурацией: V1 и V2 (рекомендуемый, доступен с версии 25.1). Ключевые различия между ними описаны в статье Сравнение конфигураций V1 и V2.
Совет
Новые кластеры YDB рекомендуется разворачивать сразу с использованием конфигурации V2. Если кластер был развёрнут на конфигурации V1, то она продолжит использоваться даже после обновления на версию YDB 25.1 или выше. После такого обновления рекомендуется запланировать и провести миграцию на V2, так как в будущих версиях YDB поддержка V1 будет прекращена. Узнать, какая версия конфигурации используется на кластере, можно по инструкции.
В зависимости от текущего состояния вашего кластера, вы можете выполнить миграцию:
- На конфигурацию V2: Если ваш кластер работает под управлением конфигурации V1 (например, был развернут на версии YDB до 25.1 и был обновлён до 25.1), вы можете перейти на механизм конфигурации V2.
- На конфигурацию V1: Если после перехода на конфигурацию V2 возникли непредвиденные проблемы, или вам необходимо откатить версию YDB ниже 25.1, вы можете выполнить обратную миграцию на ручное управление конфигурацией (V1).
Проблемы при миграции?
Если при использовании инструкций по миграции (особенно при откате на V1) возникли непредвиденные проблемы, рекомендуется незамедлительно сообщать о них в виде GitHub issue, предоставляя максимум контекста и диагностики для воспроизведения.
Прежде чем выполнять миграцию, убедитесь, какая версия конфигурации используется в вашем кластере в данный момент, с помощью инструкции по проверке.