Перенос решений с помощью утилиты командной строки

Общие сведения

Утилита командной строки (Bpmonline Command Line Interface) bpmcli предназначена для интеграции платформы bpm'online с внешними  средствами разработки и CI/CD инструментами (VS, VS Code, Webstorm, Git, Jenkins и другие).

С помощью bpmcli можно:

1. Управлять пакетами bpm'online:
   • создавать новые пакеты в локальной файловой системе;
   • передавать пакеты из локальной файловой системы в приложение;
   • извлекать пакеты из приложения в локальную файловую систему;
   • архивировать пакет в .gz-файл.
2. Управлять приложением bpm'online:
   • перезапускать приложение;
   • выполнять очистку хранилища сеанса и кэша (база данных Redis).
3. Создавать конвейер CI\CD.
4. Конвертировать существующий пакет bpm'online в проект Visual Studio.

Перенос изменений с помощью утилиты bpmcli

ШАГ 1. Регистрация окружения

Окружение — это набор конфигурационных параметров, который включает в себя название, URL сайта bpm'online, имя пользователя и пароль.

Для регистрации нового приложения выполните команду:

bpmcli reg-web-app <ENVIRONMENT_NAME> -u http://mysite.bpmonline.com -l administrator -p password

Для обновления параметров зарегистрированного окружения выполните команду:

bpmcli reg-web-app <ENVIRONMENT_NAME> -u administrator -p password

ШАГ 2. Установка пакета из файловой системы в приложение

1. Выполните команду из текущей директории пакета:

   bpmcli push-pkg <PACKAGE_NAME>
   

2. Для .gz-архива выполните команду с указанием названия архива либо полного пути к файлу:

   bpmcli push-pkg package.gz
   bpmcli push-pkg C:\Packages\package.gz
   

ШАГ 3. Перенос пакета из приложения в файловую систему

Выполните команду с указанием имени окружения:

bpmcli pull-pkg <PACKAGE_NAME> -e <ENVIRONMENT_NAME>

Для текущего приложения выполните команду без указания имени окружения:

bpmcli pull-pkg <PACKAGE_NAME>

ШАГ 4. Удаление пакета

Выполните команду с указанием имени окружения:

bpmcli delete-pkg-remote <PACKAGE_NAME> -e <ENVIRONMENT_NAME>

Для текущего приложения указание имени окружения не требуется:

bpmcli delete-pkg-remote <PACKAGE_NAME>

ШАГ 5. Создание архива пакета

Выполните команду из директории с папками пакетов, либо с указанием полного пути к директории пакета и архиву.

bpmcli generate-pkg-zip <PACKAGE_NAME>
bpmcli generate-pkg-zip C:\Packages\package -d C:\Store\package.gz

ШАГ 6. Перезапуск приложения bpm'online

После внесения изменений рекомендуется перезапустить приложение и очистить хранилища кэша.

Для перезапуска текущего приложения bpm'online выполните команду:

bpmcli restart-web-app

Или укажите имя окружения, которое необходимо перезапустить:

bpmcli restart-web-app <ENVIRONMENT_NAME>

Для очистки базы данных Redis текущего приложения выполните команду:

bpmcli clear-redis-db

Или укажите имя окружения:

bpmcli clear-redis-db <ENVIRONMENT_NAME>