---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://ydb.tech/docs/en/devops/configuration-management/migration.md
  - https://ydb.tech/docs/ru/devops/configuration-management/migration.md
  - href: ru/devops/configuration-management/migration/index.md
    type: text/markdown
    title: Markdown version
  - href: ../../../llms.txt
    type: text/markdown
    title: llms.txt
sourcePath: ru/core/devops/configuration-management/migration/index.md
---
> **Documentation Index:** Fetch the complete configuration index at https://ydb.tech/docs/ru/llms.txt

# Миграция конфигурации кластера

В YDB поддерживается два механизма управления конфигурацией: [V1](https://ydb.tech/docs/ru/devops/configuration-management/configuration-v1/index.md) и [V2](https://ydb.tech/docs/ru/devops/configuration-management/configuration-v2/config-overview.md) (экспериментальный, доступен с версии 25.1). Ключевые различия между ними описаны в статье [Сравнение конфигураций V1 и V2](https://ydb.tech/docs/ru/devops/configuration-management/compare-configs.md).

<!-- source: ru/devops/configuration-management/_includes/configuration-version-note.md -->
{% note tip %}

Новые кластеры YDB рекомендуется разворачивать сразу с использованием [конфигурации V2](https://ydb.tech/docs/ru/devops/configuration-management/configuration-v2/index.md). Если кластер был развёрнут на [конфигурации V1](https://ydb.tech/docs/ru/devops/configuration-management/configuration-v1/index.md), то она продолжит использоваться даже после обновления на версию YDB 25.1 или выше. После такого обновления рекомендуется запланировать и провести [миграцию на V2](https://ydb.tech/docs/ru/devops/configuration-management/migration/migration-to-v2.md), так как в будущих версиях YDB поддержка V1 будет прекращена. Узнать, какая версия конфигурации используется на кластере, можно [по инструкции](https://ydb.tech/docs/ru/devops/configuration-management/check-config-version.md).

{% endnote %}
<!-- endsource: ru/devops/configuration-management/_includes/configuration-version-note.md -->

В зависимости от текущего состояния вашего кластера, вы можете выполнить миграцию:

* **[На конфигурацию V2](https://ydb.tech/docs/ru/devops/configuration-management/migration/migration-to-v2.md):** Если ваш кластер работает под управлением конфигурации V1, вы можете перейти на экспериментальный механизм конфигурации V2.
* **[На конфигурацию V1](https://ydb.tech/docs/ru/devops/configuration-management/migration/migration-to-v1.md):** Если после перехода на конфигурацию V2 возникли непредвиденные проблемы, вы можете выполнить обратную миграцию на ручное управление конфигурацией (V1).

{% note info "Проблемы при миграции?" %}

Если при использовании инструкций по миграции (особенно при откате на V1) возникли непредвиденные проблемы, рекомендуется незамедлительно сообщать о них в виде [GitHub issue](https://github.com/ydb-platform/ydb/issues/new), предоставляя максимум контекста и диагностики для воспроизведения.

{% endnote %}

Прежде чем выполнять миграцию, убедитесь, какая версия конфигурации используется в вашем кластере в данный момент, с помощью [инструкции по проверке](https://ydb.tech/docs/ru/devops/configuration-management/check-config-version.md).