--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://ydb.tech/docs/en/devops/configuration-management/migration/migration-to-v2.md?version=v26.1 - https://ydb.tech/docs/ru/devops/configuration-management/migration/migration-to-v2.md?version=v26.1 - href: ru/devops/configuration-management/migration/migration-to-v2.md type: text/markdown title: Markdown version - href: ../../../llms.txt type: text/markdown title: llms.txt sourcePath: ru/core/devops/configuration-management/migration/migration-to-v2.md --- > **Documentation Index:** Fetch the complete configuration index at https://ydb.tech/docs/ru/llms.txt # Миграция на конфигурацию V2 {% note warning %} Эта статья посвящена кластерам YDB, в которых используется [конфигурация V2](https://ydb.tech/docs/ru/devops/configuration-management/configuration-v2/index.md?version=v26.1). Данный способ конфигурирования пока является экспериментальным и доступен только для версий YDB начиная с v25.1. Для использования в продакшене мы рекомендуем выбирать [конфигурацию V1](https://ydb.tech/docs/ru/devops/configuration-management/index.md?version=v26.1) — она является основной и официально поддерживаемой для всех кластеров YDB. {% endnote %} Данный документ содержит инструкцию по миграции с [конфигурации V1](https://ydb.tech/docs/ru/devops/configuration-management/configuration-v1/config-overview.md?version=v26.1) на [конфигурацию V2](https://ydb.tech/docs/ru/devops/configuration-management/configuration-v2/config-overview.md?version=v26.1). В конфигурации V1 существует два различных механизма применения конфигурационных файлов: - [статическая конфигурация](https://ydb.tech/docs/ru/devops/configuration-management/configuration-v2/config-overview.md?version=v26.1#static-config) управляет [узлами хранения](https://ydb.tech/docs/ru/concepts/glossary.md?version=v26.1#storage-node) кластера YDB и требует ручного размещения файлов на каждом узле кластера; - [динамическая конфигурация](https://ydb.tech/docs/ru/devops/configuration-management/configuration-v2/config-overview.md?version=v26.1#dynamic-config) управляет [узлами базы данных](https://ydb.tech/docs/ru/concepts/glossary.md?version=v26.1#database-node) кластера YDB и загружается в кластер централизованно с помощью команд YDB CLI. В конфигурации V2 этот процесс унифицирован: единый конфигурационный файл загружается в систему через команды YDB CLI, автоматически доставляясь на все узлы кластера. Компоненты [State Storage](https://ydb.tech/docs/ru/concepts/glossary.md?version=v26.1#state-storage) и [статической группы](https://ydb.tech/docs/ru/concepts/glossary.md?version=v26.1#static-group) кластера YDB являются ключевыми для корректной работы кластера. При работе с конфигурацией V1 данные компоненты настраиваются вручную через задание секций `domains_config` и `blob_storage_config` в конфигурационном файле. В конфигурации V2 возможна [автоматическая конфигурация](https://ydb.tech/docs/ru/devops/configuration-management/configuration-v2/config-overview.md?version=v26.1) этих компонентов без указания соответствующих секций в конфигурационном файле. ## Исходное состояние Миграция на конфигурацию V2 может быть осуществлена в случае выполнения следующих условий: 1. Кластер YDB [обновлён](https://ydb.tech/docs/ru/devops/deployment-options/manual/update-executable.md?version=v26.1) до версии 25.1 и выше. 1. Кластер YDB сконфигурирован с файлом [конфигурации V1](https://ydb.tech/docs/ru/devops/configuration-management/configuration-v2/config-overview.md?version=v26.1#static-config) `config.yaml`, расположенным в файловой системе узлов и подключённым через аргумент `ydbd --yaml-config`. 1. В конфигурационном файле кластера заданы разделы `domains_config` и `blob_storage_config` для настройки State Storage и статической группы соответственно. ## Проверка текущей версии конфигурации Перед началом миграции убедитесь, что ваш кластер работает на конфигурации V1. Узнать текущую версию конфигурации на узлах можно несколькими способами, описанными в статье [Проверка версии конфигурации](https://ydb.tech/docs/ru/devops/configuration-management/check-config-version.md?version=v26.1). Продолжать выполнение данной инструкции следует только в том случае, если узлы работают на версии конфигурации V1. Если на всех узлах уже включена версия V2, миграция не требуется. ## Инструкция по миграции на конфигурацию V2 Для того чтобы перевести кластер YDB на конфигурацию V2, необходимо проделать следующие шаги: 1. Проверить наличие файла [динамической конфигурации](https://ydb.tech/docs/ru/devops/configuration-management/configuration-v2/config-overview.md?version=v26.1#dynamic-config) в кластере. Для этого необходимо выполнить команду [ydb admin cluster config fetch](https://ydb.tech/docs/ru/reference/ydb-cli/commands/configuration/cluster/fetch.md?version=v26.1): ```bash ydb -e grpc://:2135 admin cluster config fetch > config.yaml ``` В случае отсутствия такой конфигурации в кластере команда выдаст сообщение: ```bash No config returned. ``` Если файл найден, следует использовать его и пропустить следующий шаг данной инструкции. 2. В случае отсутствия файла динамической конфигурации в кластере выполнить команду генерации файла динамической конфигурации [ydb admin cluster config generate](https://ydb.tech/docs/ru/reference/ydb-cli/commands/configuration/cluster/generate.md?version=v26.1). Файл будет сгенерирован на основе файла статической конфигурации, расположенного на узлах кластера. ```bash ydb -e grpc://:2135 admin cluster config generate > config.yaml ``` 3. Добавить в полученный на шаге 1 или 2 файл `config.yaml` следующее поле: ```yaml feature_flags: ... switch_to_config_v2: true ``` {% cut "Подробнее" %} Включение данного флага означает, что за хранение конфигурации и операции над ней теперь отвечает таблетка [DS Controller](https://ydb.tech/docs/ru/concepts/glossary.md?version=v26.1#ds-controller), а не таблетка [Console](https://ydb.tech/docs/ru/concepts/glossary.md?version=v26.1#console). Это переключает основной механизм управления конфигурацией кластера. {% endcut %} 4. Разместить файл `config.yaml` на всех узлах кластера, заменив им предыдущий файл конфигурации. 5. Создать директорию для работы узла YDB с конфигурацией на каждом из узлов. В случае запуска нескольких узлов кластера на одном хосте создайте отдельные директории под каждый узел. Инициализируйте директорию, выполнив команду [ydb admin node config init](https://ydb.tech/docs/ru/reference/ydb-cli/commands/configuration/node/init.md?version=v26.1) на каждом из узлов. В параметре `--from-config` укажите путь к файлу `config.yaml`, размещённому на узлах ранее. ```bash sudo mkdir -p /opt/ydb/config-dir sudo chown -R ydb:ydb /opt/ydb/config-dir ydb admin node config init --config-dir /opt/ydb/config-dir --from-config /opt/ydb/cfg/config.yaml ``` {% cut "Подробнее" %} В дальнейшем система самостоятельно будет сохранять актуальную конфигурацию в указанные директории. {% endcut %} 6. Перезапустить все узлы кластера с помощью процедуры [rolling-restart](https://ydb.tech/docs/ru/maintenance/manual/node_restarting.md?version=v26.1), добавив опцию `ydbd --config-dir` при запуске узла с указанием пути до директории, а также убрав опцию `ydbd --yaml-config`. {% list tabs group=manual-systemd %} - Вручную При ручном запуске добавьте опцию `--config-dir` к команде `ydbd server`, не указывая опцию `--yaml-config`: ```bash ydbd server --config-dir /opt/ydb/config-dir ``` - С использованием systemd При использовании systemd добавьте опцию `--config-dir` к команде `ydbd server` в конфигурационный файл systemd, а также удалите опцию `--yaml-config`: ```ini ExecStart=/opt/ydb/bin/ydbd server --config-dir /opt/ydb/config-dir ``` После обновления файла systemd выполните следующую команду, чтобы применить изменения: ```bash sudo systemctl daemon-reload ``` {% endlist %} 7. Загрузить полученный ранее конфигурационный файл `config.yaml` в систему с помощью команды [ydb admin cluster config replace](https://ydb.tech/docs/ru/reference/ydb-cli/commands/configuration/cluster/replace.md?version=v26.1): ```bash ydb -e grpc://:2135 cluster config replace -f config.yaml ``` Команда запросит подтверждение на выполнение операции `This command may damage your cluster, do you want to continue? [y/N]`, в ответ на этот запрос необходимо согласиться и ввести `y`. {% cut "Подробнее" %} После выполнения команды конфигурационный файл загрузится во внутреннее хранилище таблетки [DS Controller](https://ydb.tech/docs/ru/concepts/glossary.md?version=v26.1#ds-controller) и сохранится в директориях, указанных в опции `--config-dir` на каждом узле. С этого момента любое изменение конфигурации на существующих узлах выполняется с помощью [специальных команд](https://ydb.tech/docs/ru/devops/configuration-management/configuration-v2/update-config.md?version=v26.1) YDB CLI. Также при запуске узла актуальная конфигурация будет автоматически загружаться из конфигурационной директории. {% endcut %} 8. Получить текущую конфигурацию кластера с помощью [ydb admin cluster config fetch](https://ydb.tech/docs/ru/reference/ydb-cli/commands/configuration/cluster/fetch.md?version=v26.1): ```bash ydb -e grpc://:2135 admin cluster config fetch > config.yaml ``` Файл `config.yaml` должен совпадать с конфигурационными файлами, разложенными по узлам кластера, за исключением поля `metadata.version`, которое должно быть больше на единицу по сравнению с версией на узлах кластера. 9. Добавить в `config.yaml` в разделе `config` следующий блок: ```yaml self_management_config: enabled: true ``` {% cut "Подробнее" %} Данная секция отвечает за включение механизма [распределённой конфигурации](https://ydb.tech/docs/ru/concepts/glossary.md?version=v26.1#distributed-configuration) в кластере. Хранение конфигурации и любые операции над ней будут осуществляться через данный механизм. {% endcut %} 10. Загрузить обновлённый конфигурационный файл в кластер с помощью [ydb admin cluster config replace](https://ydb.tech/docs/ru/reference/ydb-cli/commands/configuration/cluster/replace.md?version=v26.1): ```bash ydb -e grpc://:2135 cluster config replace -f config.yaml ``` 11. Перезапустить все [узлы хранения](https://ydb.tech/docs/ru/concepts/glossary.md?version=v26.1#storage-node) кластера с помощью процедуры [rolling restart](https://ydb.tech/docs/ru/reference/ydbops/rolling-restart-scenario.md?version=v26.1). 12. При наличии секции `config.domains_config.security_config` в файле `config.yaml` вынести её на уровень выше — в секцию `config`. 13. Удалить из файла `config.yaml` секции `config.blob_storage_config` и `config.domains_config`. 14. Загрузить обновлённый конфигурационный файл в кластер: ```bash ydb -e grpc://:2135 cluster config replace -f config.yaml ``` {% cut "Подробнее" %} После загрузки конфигурации кластер YDB будет переведён в режим автоматического управления конфигурацией [State Storage](https://ydb.tech/docs/ru/reference/configuration/index.md?version=v26.1#domains-state) и [статической группой](https://ydb.tech/docs/ru/reference/configuration/index.md?version=v26.1#blob_storage_config) с помощью механизма распределённой конфигурации. {% endcut %} Убедиться в успешном завершении миграции можно, проверив версию конфигурации на узлах кластера одним из способов, описанных в статье [Проверка версии конфигурации](https://ydb.tech/docs/ru/devops/configuration-management/check-config-version.md?version=v26.1). На всех узлах кластера версия `Configuration version` должна быть равна `v2`. ## Результат В результате проделанных действий кластер будет переведён на режим конфигурации V2. Управление единой конфигурацией осуществляется с помощью [специальных команд](https://ydb.tech/docs/ru/devops/configuration-management/configuration-v2/update-config.md?version=v26.1) YDB CLI, статическая группа и State Storage управляются системой автоматически.