Разверните приложение на 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 в терминале.
После итоговой приёмки сохраните согласованное состояние. Теперь платформа готова к установке пакета Документооборота. При ошибке компиляции этот результат не достигнут независимо от доступности страницы входа.