Как настроить хранилище SVN
Glossary Item Box
Общие сведения
Назначение системы управления версиями в bpm'online:
- Перенос изменений между рабочими пространствами.
- Хранение версий конфигурационных схем.
Система управления версиями является опциональным компонентом, то есть bpm'online может работать без нее. Однако, если предполагается активная доработка приложения со стороны пользователя, то использование системы управления версиями является обязательным.
Bpm'online поддерживает работу с системой управления версиями Subversion (SVN) версии 1.8 и выше.
Детально ознакомиться с особенностями использования SVN можно в документации.
Установка SVN
Для организации работы bpm'online с SVN необходимо:
1. Установить сервер SVN
SVN можно установить на сервере приложений, на сервере СУБД либо разместить на отдельном выделенном сервере.
Для установки сервера SVN можно воспользоваться одним из размещенных в открытом доступе инсталляторов для ОС Windows:
Скачать последнюю версию бинарных файлов сервера SVN для определенной версии операционной системы можно здесь.
Сервер SVN может работать самостоятельно либо через веб-сервер Apache (устанавливается автоматически утилитами VisualSVN и CollabNet). В первом случае доступ к хранилищам осуществляется по протоколу svn://, во втором — http(s)://.
Для организации работы с bpm'online рекомендуется использовать доступ по протоколу http(s)://.
2. Создать пользователя на сервере SVN
Пользователь создается стандартными средствами утилиты, которая использовалась для установки сервера SVN, например VisualSVN (рис. 1). Логин и пароль будут необходимы в дальнейшем при работе с хранилищами в bpm'online для авторизации.
Рис. 1. — Создание нового пользователя на сервере SVN (утилита VisualSVN)
3. Создать хранилище на сервере SVN
Хранилище создается стандартными средствами утилиты, которая использовалась для установки сервера SVN (например, VisualSVN или CollabNET).
К СВЕДЕНИЮ Bpm'online поддерживает одновременную работу с несколькими хранилищами, которые могут размещаться на разных серверах SVN. |
4. Установить клиент SVN
Дополнительно на рабочем месте разработчика можно установить клиент SVN, например, TortoiseSVN.
К СВЕДЕНИЮ Рекомендуется устанавливать клиент TortoiseSVN версии 1.8 и выше. |
Установка клиента SVN является необязательным требованием, поскольку это никак не влияет на функциональность bpm'online. Однако использование клиента может быть полезно для выполнения таких операций, как просмотр локальной рабочей копии, просмотр истории заливок, выполнение откатов ревизий и т.д.
ВАЖНО Для того чтобы приложение bpm'online могло работать с SVN, необходимо внести изменения в конфигурационный файл web.config приложения WebApp (имеется в виду внутренний web.config из папки Terrasoft.WebApp) — параметру useSvn установить значение true: <add key="UseSvn" value="true" /> |
Принципы работы с хранилищами системы контроля версий
- Список хранилищ является общим для всех рабочих пространств системы.
- При создании пакеты можно добавлять в любое хранилище из списка.
- Зафиксировать уже установленный пакет можно только в хранилище, которое указано для пакета при создании или установке.
- В рабочее пространство возможно выброчно установить произвольный набор пакетов из списка доступных хранилищ.
Чтобы использовать хранилище, его нужно зарегистрировать и добавить в список хранилищ.
Список хранилищ
Чтобы открыть список доступных хранилищ (рис. 2), на вкладке [Действия] в интерфейсе раздела [Конфигурация] нужно выбрать действие [Открыть список хранилищ].
Рис. 2. — Окно со списком хранилищ системы контроля версий
Добавление нового хранилища
Для добавления нового хранилища необходимо выбрать действие [Добавить] на панели инструментов реестра. В результате откроется карточка нового хранилища (рис. 3).
Рис. 3. — Карточка нового хранилища
[Имя] — произвольное имя хранилища.
[Адрес хранилища] — сетевой адрес существующего хранилища SVN. Поддерживается адресация хранилищ по протоколам HTTP (стандартный сетевой протокол) и SVN (собственный сетевой протокол системы Subversion).
[Активный] — признак, использовать ли хранилище в работе системы. По умолчанию каждое новое хранилище помечается как активное.
ВАЖНО Для работы с хранилищем его необходимо активировать. При этом при обновлении пакета активными должны быть все хранилища, из которых обновляется исходный пакет, а также все его пакеты-зависимости. |
После регистрации нового хранилилища его можно использовать для создания пользовательских пакетов или для установки уже созднанных пакетов в рабочее пространство.
Авторизация пользователя
Для авторизации пользователя в выбранном хранилище необходимо выбрать действие [Авторизоваться] на панели инструментов реестра. Окно авторизации (рис. 4) имеет два обязательных поля:
Рис. 4. — Окно авторизации пользователя в хранилище системы контроля версий
[Имя пользователя] — имя пользователя в системе контроля версий.
[Пароль] — пароль пользователя в системе контроля версий.
Для авторизации в хранилище в поля [Имя пользователя] и [Пароль] необходимо ввести учетные данные пользователя в SVN. Для этого предварительно создайте пользователя в SVN. При этом его учетные данные не обязательно должны совпадать с учетными данными пользователя в Bpm'online.
К СВЕДЕНИЮ Начиная с версии 7.6.0 пользователь должен пройти авторизацию в выбранном хранилище для каждого из рабочих пространств системы. |
Если при добавлении нового хранилища в список авторизация не была выполнена, система автоматически предложит авторизовать пользователя при создании нового пакета или установке пакета из хранилища.
К СВЕДЕНИЮ Учетные данные пользователя сохраняются внутренними механизмами клиента SVN и не хранятся в базе данных системы. |