---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://ydb.tech/docs/en/devops/configuration-management/compare-configs.md?version=main
  - https://ydb.tech/docs/ru/devops/configuration-management/compare-configs.md?version=main
sourcePath: ru/core/devops/configuration-management/compare-configs.md
---
> **Documentation Index:** Fetch the complete configuration index at https://ydb.tech/docs/ru/llms.txt

# Сравнение конфигураций кластера YDB: V1 и V2

В YDB существует два основных подхода к управлению конфигурацией кластера: [V1](https://ydb.tech/docs/ru/devops/configuration-management/configuration-v1/index.md?version=main) и [V2](https://ydb.tech/docs/ru/devops/configuration-management/configuration-v2/index.md?version=main). Начиная с версии YDB 25.1, поддерживается конфигурация V2, которая унифицирует управление кластерами YDB, позволяет работать с конфигурацией полностью через [YDB CLI](https://ydb.tech/docs/ru/reference/ydb-cli/index.md?version=main), а также автоматизирует наиболее сложные аспекты конфигурации (управление [статической группой](https://ydb.tech/docs/ru/reference/configuration/index.md?version=main#blob_storage_config) и [State Storage](https://ydb.tech/docs/ru/reference/configuration/index.md?version=main#domains-state)). Конфигурация V2 пока является экспериментальной и не рекомендуется для использования в продуктиве.

В этой статье описываются ключевые различия между этими двумя подходами.

| Характеристика                 | Конфигурация V1                                  | Конфигурация V2                                     |
| ------------------------------ | ------------------------------------------------ | -------------------------------------------------- |
| **Структура конфигурации**     | Раздельная: [статическая](../../devops/configuration-management/configuration-v1/static-config.md) и [динамическая](../../devops/configuration-management/configuration-v1/dynamic-config.md). | [**Единая**](../configuration-management/configuration-v2/config-overview.md) конфигурация. |
| **Управление файлами**         | Статическая: ручное размещение файла на каждом узле.<br>Динамическая: централизованная загрузка через CLI. | Единая: [централизованная загрузка](../configuration-management/configuration-v2/update-config.md) через CLI, автоматическая доставка на все узлы. |
| **Механизм доставки и применения** | Статическая: читается и применяется из локального файла при запуске.<br>Динамическая: через [таблетку `Console`](../../concepts/glossary.md#console). | Полностью автоматически через механизм [распределённой конфигурации](../../concepts/glossary.md#distributed-configuration). [Технические подробности](../../contributor/configuration-v2.md). |
| **Управление State Storage и статической группой** | **Ручное**: через обязательные секции [`domains_config`](../../reference/configuration/index.md#domains-state) и [`blob_storage_config`](../../reference/configuration/index.md#blob_storage_config) в статической конфигурации. | **Автоматическое**: управляется системой [распределённой конфигурации](../../concepts/glossary.md#distributed-configuration). |
| **Рекомендуемое использование** | Продакшн использование для всех версий YDB.                             | Экспериментальное использование на кластерах версии 25.1 и выше.                                |

## Конфигурация V1

[Конфигурация V1](https://ydb.tech/docs/ru/devops/configuration-management/configuration-v1/index.md?version=main) кластера YDB состоит из двух частей:

* **Статическая конфигурация:** управляет ключевыми параметрами узлов, включая конфигурацию [State Storage](https://ydb.tech/docs/ru/reference/configuration/index.md?version=main#domains-state) и [статической группы](https://ydb.tech/docs/ru/reference/configuration/index.md?version=main#blob_storage_config) (секции `domains_config` и `blob_storage_config` соответственно). Требует ручного размещения одного и того же файла конфигурации на каждом узле кластера. Путь до конфигурации указывается при запуске узла через опцию `--yaml-config`.
* **Динамическая конфигурация:** управляет остальными параметрами кластера. Загружается централизованно с помощью команды `ydb admin config replace` и распространяется на узлы базы данных.

Использование конфигурации V1 является рекомендуемым для всех кластеров YDB.

## Конфигурация V2

Начиная с версии YDB 25.1, поддерживается [конфигурация V2](https://ydb.tech/docs/ru/devops/configuration-management/configuration-v2/config-overview.md?version=main). Ключевые особенности:

* **Единый конфигурационный файл:** вся конфигурация кластера хранится и управляется как единое целое.
* **Централизованное управление:** конфигурация загружается на кластер с помощью команды [`ydb admin cluster config replace`](https://ydb.tech/docs/ru/devops/configuration-management/configuration-v2/update-config.md?version=main) и автоматически доставляется до всех узлов самим кластером YDB через механизм [распределённой конфигурации](https://ydb.tech/docs/ru/concepts/glossary.md?version=main#distributed-configuration).
* **Ранняя валидация:** проверка корректности происходит ещё до доставки конфигурационного файла на узлы кластера, а не при рестарте серверных процессов.
* **Автоматическое управление State Storage и статической группой:** V2 поддерживает [автоматическую конфигурацию](https://ydb.tech/docs/ru/devops/configuration-management/configuration-v2/config-overview.md?version=main), что позволяет не указывать эти секции в конфигурационном файле вручную.
* **Хранение на узлах:** актуальная конфигурация автоматически сохраняется каждым узлом в специальной директории (указывается опцией `--config-dir` при запуске `ydbd`) и используется при последующих перезапусках.