Документация

Экспорт и импорт настроек

Переносите конфигурацию организации между рабочими пространствами в виде портативного пакета без перемещения секретов.

Конфигурацию организации можно экспортировать в виде портативного пакета и применить к другой организации. Найдите его в разделе Настройки → Данные → Экспорт настроек.

Эта возможность нужна в трех случаях: для создания второй организации с такой же конфигурацией, как у существующей, для переноса конфигурации из пробной рабочей области в реальную и для сохранения доступной для просмотра записи о текущих настройках рабочей области.

Что включается в пакет

Пакет содержит конфигурацию на уровне организации:

РазделВключено
Политики и требования качестваКорпоративная политика, политики качества, правила проектов, правила жизненного цикла, правила рецензирования
Агенты и моделиПрофили AI, ключи провайдера ссылки
АвтоматизацияХуки, расписания
ПодключенияИнтеграции с системами управления исходным кодом, мосты каналов, серверы MCP
ДоступНастройки корпоративной идентичности, учетные записи служб
ДанныеНастройки хранения данных, параметры хранения, места назначения аудита

Что не включается в пакет

Секреты никогда не переносятся. Ключи провайдера, токены и учетные данные экспортируются в виде плейсхолдеров. В пакете указывается что ключ существует и где он используется, но не его значение — после импорта придется заново вводить секреты.

Также не включаются элементы, относящиеся к идентичности рабочей области, а не к её настройкам: название организации, её участники, информация о оплате, а также операционная история — задачи, запуски и события аудита.

Правило таково: пакет описывает, как рабочая область настроена, а не то, что в ней произошло .

Предварительный просмотр перед применением

При применении пакета сначала выполняется предварительный просмотр, показывающий, что будет сделано в каждом разделе:

СтатусЗначение
appliedНастройка будет создана или обновлена
unchangedУже совпадает; ничего делать не нужно
needsRebindЗависит от элемента, который нужно переопределить локально
failedПрименить нельзя; причина указана

Внимательно изучите результат предварительного просмотра. needsRebind является самым важным — он отмечает настройки, ссылающиеся на элементы, которых нет в целевой области в том же виде, чаще всего это подключения к репозиториям или секреты. Перед тем как конфигурация станет идентичной, этим элементам нужно уделить внимание.

Хранение пакетов в системе контроля версий

Экспортированный пакет — это файл, поэтому его можно разместить в репозитории, сравнивать и проверять. Для команд, рассматривающих конфигурацию как код, это и есть главная ценность: изменение корпоративной политики превращается в доступный для рецензирования дифф, а не в действие, совершённое кем-то по щелчку.

Поскольку секреты представлены плейсхолдерами, пакет можно безопасно коммитить — но перед публикацией проверьте, нет ли в нем элементов, идентифицирующих вашу собственную конфигурацию.