Перенос изменений с помощью SVN
Glossary Item Box
Общие сведения
Система управления версиями является опциональным компонентом, то есть Creatio может работать без нее. Однако, если предполагается активная пользовательская доработка приложения, то использование системы управления версиями является обязательным. Особенно, если доработка ведется группой разработчиков.
Назначение системы управления версиями в Creatio:
- Перенос изменений между рабочими средами, например, между средами разработки.
- Хранение версий конфигурационных схем и пакетов.
Creatio поддерживает работу с системой управления версиями Subversion (SVN) версии 1.8 и выше. Детально ознакомиться с особенностями использования SVN можно в документации. Как настроить и работать с хранилищем SVN в приложении Creatio, подробно изложено в статье "Как настроить хранилище SVN".
Преимущества использования SVN для переноса изменений
- Возможность переноса между рабочими средами и конфигурациями не только схем, но и пакетов.
- Возможность переноса привязанных к пакету данных, например, наполнения справочников или разделов.
- Автоматическая установка из SVN пакетов-зависимостей.
- Независимость от службы поддержки при переносе изменений в облачной среде.
Рекомендуемая последовательность переноса изменений с помощью SVN
ВАЖНО
Для переноса изменений в промышленную среду не рекомендуется использовать SVN. Для этих целей необходимо использовать базовый механизм экспорта и импорта пакетов. Перенос изменений с помощью SVN следует использовать только для сред разработки.
ВАЖНО
Перед обновлением приложения пользователем с помощью SVN необходимо произвести резервное копирование базы данных. Если приложение развернуто в облаке, то необходимо обратиться в службу поддержки.
Возможность возврата на предыдущую версию посредством SVN не предусмотрена!
ВАЖНО
Приведенная последовательность актуальна при работе с хранилищами SVN встроенными средствами Creatio и не пригодна при включенном режиме разработки в файловой системе (см. "Работа с системой контроля версий").
1. Удостовериться, что приложение, в которое нужно перенести изменения, настроено для работы с SVN
Подробно процесс настройки приложения для работы с системой контроля версий приведен в статье "Как настроить хранилище SVN".
2. Включить механизмы автоматического применения изменений
Для того чтобы необходимые изменения применились после переноса, нужно включить механизмы автоматического применения изменений. Для этого необходимо в файле Web.config, который находится в каталоге Terrasoft.WebApp, установить значение true для следующих ключей элемента appSettings:
<add key="AutoUpdateOnCommit" value="true" /> <add key="AutoUpdateDBStructure" value="true" /> <add key="AutoInstallSqlScript" value="true" /> <add key="AutoInstallPackageData" value="true" />
Ключ AutoUpdateOnCommit отвечает за автоматическое обновление пакетов из SVN перед их заливкой. Если для этого ключа установлено значение false, то перед заливкой в SVN приложение предупредит пользователя о необходимости обновления в случае, если схемы пакета были изменены. Ключи AutoUpdateDBStructure, AutoInstallSqlScript, AutoInstallPackageData отвечают соответственно за автоматическое обновление структуры базы данных, автоматическую установку SQL-сценариев и установку привязанных данных.
3. Удостовериться, что все необходимые данные привязаны
Прежде чем переносить пакет из приложения, необходимо удостовериться, что все данные, которые необходимо перенести, привязаны к пакету. Такими данными могут быть, например, наполнение справочников или раздела.
К СВЕДЕНИЮ
Если в процессе создания раздела использовался мастер раздела, то некоторые данные привязываются к текущему пакету автоматически.
4. Удостовериться, что все зависимости пакета могут быть перенесены
Во время разработки к пользовательскому пакету могут быть добавлены зависимости от других пакетов. Если пакеты-зависимости разработаны сторонними разработчиками, то необходимо удостовериться в том, что они уже установлены в приложение, в которое будет осуществляться перенос пользовательского пакета. Если пакеты-зависимости находятся в доступном хранилище SVN, то при необходимости они будут установлены автоматически.
5. Установить пакет из хранилища
Последовательность установки пакетов подробно описана в статье "Установка пакета из системы контроля версий".
ВАЖНО
Начиная с версии приложения 7.11 после установки или обновлении пакета из SVN необходимо выполнить действие [Компилировать все]. Это необходимо для генерирования статического контента (см. "Статический клиентский контент в файловой системе").
