Документооборот для BPMSoft

  1. Главная
  2. Документы
  3. Документооборот для BPMSoft
  4. Установка продукта Документооборот для BPMSoft
  5. Подготовка среды с нуля
  6. Развёртывание BPMSoft на Ubuntu

Развёртывание BPMSoft на Ubuntu

Разверните приложение на Ubuntu Server 24.04 LTS x64 с административным терминалом. PostgreSQL и Redis могут находиться на других серверах. Результат этой ветки — работающая BPMSoft и успешная исходная компиляция; продукт затем устанавливается отдельным пакетом.

1. Подготовьте компоненты

Выполните установку компонентов Ubuntu для всех используемых ролей. Завершите проверку дистрибутива, запишите адреса из подготовки Ubuntu.

2. Запустите PostgreSQL и Redis и восстановите базу

Запустите Redis и выполните настройку PostgreSQL и восстановление исходной базы. Файл базы возьмите из bpmsoft_dist/db архива с дистрибутивом BPMSoft. Проверку подключения BPMSoft выполните после запуска службы.

3. Распакуйте платформу безопасно

В примере проверенный архив с дистрибутивом BPMSoft лежит в /srv/install/bpmsoft/platform.zip. Перед извлечением выполните дополнительную проверку ZIP в Bash с правом sudo. Команда проверяет читаемость записей архива. SHA256 с суммой поставщика сверяется на этапе проверки дистрибутива.

sudo unzip -t /srv/install/bpmsoft/platform.zip

Используйте новый каталог staging вне публикации. Не распаковывайте поверх работающей системы:

sudo install -d -m 700 /srv/install/bpmsoft/staging
sudo unzip /srv/install/bpmsoft/platform.zip -d /srv/install/bpmsoft/staging
sudo find /srv/install/bpmsoft/staging -name BPMSoft.WebHost.dll -print

Для указанной структуры архива корень приложения — каталог bpmsoft_dist. Команда find должна показать один файл BPMSoft.WebHost.dll в этом каталоге. Перейдите в административную оболочку и укажите корень приложения:

sudo -i
source_root='/srv/install/bpmsoft/staging/bpmsoft_dist'
test -f "$source_root/BPMSoft.WebHost.dll" || { echo 'Неверный корень приложения'; exit 1; }

В той же административной оболочке создайте отдельного пользователя и пустые каталоги. Команды копируют приложение без папки резервной копии и выдают службе права на файлы:

id bpmsoft >/dev/null 2>&1 && { echo 'Пользователь уже существует: проверьте назначение до новой установки'; exit 1; }
useradd --system --user-group --create-home --home-dir /var/lib/bpmsoft --shell /usr/sbin/nologin bpmsoft
test ! -e /opt/bpmsoft/app || { echo 'Каталог приложения уже существует'; exit 1; }
install -d -o bpmsoft -g bpmsoft -m 750 /opt/bpmsoft/app /opt/bpmsoft/tmp
set -o pipefail
tar -C "$source_root" --exclude='./db' -cf - . | tar -C /opt/bpmsoft/app -xf -
chown -R bpmsoft:bpmsoft /opt/bpmsoft/app /opt/bpmsoft/tmp
chmod -R o-rwx /opt/bpmsoft/app /opt/bpmsoft/tmp
exit

Внутренний db с исходным дампом не переносится в публикуемое приложение. Сами рабочие PostgreSQL-данные находятся в его контейнерном томе, это другой каталог. Не копируйте одну DLL без файлов поставки.

4. Заполните конфигурацию

Заполните подключения и локальный HTTP endpoint. До запуска службы подготовьте локальные параметры и источники из зависимостей сборки. Для Angular задайте окружение службы в unit.

5. Запустите службу

На сервере приложения откройте файл командой sudoedit /etc/systemd/system/bpmsoft.service и вставьте конфигурацию ниже.

[Unit]
Description=BPMSoft application
After=network-online.target
Wants=network-online.target
[Service]
WorkingDirectory=/opt/bpmsoft/app
ExecStart=/usr/bin/dotnet /opt/bpmsoft/app/BPMSoft.WebHost.dll
User=bpmsoft
Group=bpmsoft
Environment=HOME=/var/lib/bpmsoft
Environment=ASPNETCORE_ENVIRONMENT=Production
Environment=COMPlus_ThreadPool_ForceMinWorkerThreads=100
Restart=on-failure
RestartSec=10
UMask=0027
[Install]
WantedBy=multi-user.target

Проверьте путь командой command -v dotnet и при необходимости замените его в ExecStart. Команды ниже проверяют доступ службы к конфигурации и временному каталогу, затем регистрируют и запускают службу. В журнале ищите сообщение о запуске приложения.

sudo -u bpmsoft test -r /opt/bpmsoft/app/ConnectionStrings.config
sudo -u bpmsoft sh -c 'umask 077; f=$(mktemp /opt/bpmsoft/tmp/ready.XXXXXX) && rm "$f"'
sudo systemd-analyze verify /etc/systemd/system/bpmsoft.service
sudo systemctl daemon-reload
sudo systemctl enable --now bpmsoft
sudo systemctl status bpmsoft --no-pager
sudo journalctl -u bpmsoft -n 100 --no-pager
curl --silent --show-error --output /dev/null --write-out '%{http_code}\n' http://127.0.0.1:5000/

Ожидается активная служба и ответ приложения/перенаправление на вход. HTTP-проверка здесь подтверждает запуск, а не полноценный вход: secure-cookie проверяйте после HTTPS. При циклическом restart исправьте первую ошибку журнала, не переходите к продукту.

Откройте локальный адрес в браузере на сервере или через SSH-туннель. Для туннеля на рабочем месте выполните ssh -L 15000:127.0.0.1:5000 ИМЯ_ПОЛЬЗОВАТЕЛЯ@АДРЕС_СЕРВЕРА и откройте http://127.0.0.1:15000/. Для удалённого доступа пользователей выполните переход на HTTPS после первого запуска.

6. Скомпилируйте BPMSoft

В браузере войдите с данными администратора исходной базы, откройте «Дизайнер системы → Конфигурация» и завершите серверную компиляцию. Подготовьте NuGet/условный Angular из окружения пользователя службы, если сборка требует эти зависимости. Не объявляйте успех по наличию SDK в терминале.

После итоговой приёмки сохраните согласованное состояние. Теперь платформа готова к установке пакета Документооборота. При ошибке компиляции этот результат не достигнут независимо от доступности страницы входа.

Был ли данный материал полезен вам? Да Нет