Выгрузка пакетов из SVN при помощи WorkspaceConsole
Glossary Item Box
Общие сведения
Для переноса пользовательских пакетов между рабочими средами, не связанными общим SVN-хранилищем (например, средой разработки и тестовой средой), сначала необходимо выгрузить нужные пакеты в файловую систему. Для выгрузки пакетов из SVN-хранилища используется операция SaveVersionSVNContent утилиты WorkspaceConsole. Подробно основные операции, выполняемые с помощью WorkspaceConsole, а также ее параметры описаны в статье "Параметры утилиты WorkspaceConsole".
К СВЕДЕНИЮ
Прежде чем запускать на выполнение WorkspaceConsole, необходимо удостовериться в правильности ее настроек. Особенности настройки утилиты подробно описаны в статье "Настройка утилиты WorkspaceConsole".
Для выгрузки пакетов из SVN-хранилища необходимо запустить утилиту WorkspaceConsole со следующими значениями параметров (таблица. 1):
Табл. 1. — Параметры WorkspaceConsole для выгрузки пакетов из SVN
| Параметр | Значение | Описание |
|---|---|---|
| operation | SaveVersionSvnContent |
Выгружает иерархию пакетов в виде zip-архивов в каталог -destinationPath из нескольких SVN-хранилищ, перечисленных через запятую в параметре -sourcePath. |
| destinationPath | [Путь к локальному каталогу] |
Путь к локальному каталогу в дисковой системе. В этот каталог будут выгружены заархивированные в формате *.gz пакеты. |
| workingCopyPath | [Путь к локальному каталогу] | Локальный каталог для рабочей копии пакетов, хранящихся в SVN. |
| sourcePath | [Путь к репозиториям SVN] | Адрес хранилища SVN для хранения структуры и метаданных пакетов. Может принимать несколько значений, указанных через запятую. |
| packageName | [Имя пакета] |
Имя пакета из репозитория, который будет использоваться для операции. Важно, что все пакеты, от которых он зависит, также будут задействованы. |
| packageVersion | [Версия пакета] |
Версия пакета из репозитория, который будет использоваться для операции выгрузки. |
| sourceControlLogin | [Имя пользователя SVN] |
Имя пользователя для доступа к хранилищу SVN. |
| sourceControlPassword | [Пароль пользователя SVN] |
Пароль пользователя для доступа к хранилищу SVN. |
| cultureName | [Языковая культура] | Код языковой культуры. Например, en-US. |
| excludeDependentPackages | true или false | Признак необходимости выгрузки пакетов, от которых зависит пакет, указанный в packageName. |
| logPath | [Путь к локальному каталогу] | Путь к каталогу, в который будет сохранен файл с логом операции. Необязательный параметр. |
Сигнатура команды, которую необходимо выполнить в интерпретаторе команд (консоли) Windows для выполнения операции выгрузки из SVN-хранилища:
[Путь к WorkspaceConsole]\Terrasoft.Tools.WorkspaceConsole.exe -operation=SaveVersionSvnContent -destinationPath=[Путь к локальному каталогу] -workingCopyPath=[Путь к локальному каталогу] -sourcePath=[Путь к SVN-хранилищу] -packageName=somePackage -packageVersion=7.8.0 -sourceControlLogin=User -sourceControlPassword=Password -logPath=[Путь к локальному каталогу] -cultureName=ru-RU -excludeDependentPackages=true
Пример выполнения выгрузки пакетов в файловую систему
Описание кейса
Из SVN-хранилища, расположенного по адресу http://server-svn:8050/svn/Packages, выгрузить пакет userPackage в каталог C:\SavedPackages. Языковая культура — русская. Лог операции сохранить в каталог C:\Log. Рабочую копию пакета поместить в папку C:\WorkingCopy. Имя пользователя SVN — User, а его пароль — Password. Приложение установлено в каталог C:\bpmonline7.9.2.
Релизация кейса
Формирование команды запуска утилиты WorkspaceConsole удобно выполнять с помощью любого текстового редактора в файле пакетных команд Windows (*.bat или *.cmd). В этот файл необходимо поместить команду запуска утилиты:
C:\bpmonline7.9.2\Terrasoft.WebApp\DesktopBin\WorkspaceConsole\Terrasoft.Tools.WorkspaceConsole.exe -operation=SaveVersionSvnContent -destinationPath=C:\SavedPackages\ -workingCopyPath=C:\WorkingCopy\ -sourcePath=http://server-svn:8050/svn/Packages -packageName=userPackage -packageVersion=7.8.0 -sourceControlLogin=User -sourceControlPassword=Password -logPath=C:\Log -cultureName=ru-RU -excludeDependentPackages=true
pause
После сохранения пакетного файла и его запуска на выполнение (двойным кликом из проводника Windows), появится консольное окно, в котором будет отображаться процесс выполнения WorkspaceConsole с заданными значениями параметров (рис. 1).
Рис. 1. — Процесс выгрузки пакета из хранилища
В результате выполнения команды в каталог C:\SavedPackages будет выгружен zip-архив, содежащий пакет userPackage (рис. 2).
Рис. 2. — Выгруженный zip-архив с пакетом userPackage
