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

  1. Главная
  2. Документы
  3. Документооборот для BPMSoft
  4. Установка продукта Документооборот для BPMSoft
  5. Подготовка среды с нуля
  6. SDK, NuGet и Angular: подготовка компиляции

SDK, NuGet и Angular: подготовка компиляции

Для установки пакета нужна работоспособная компиляция конфигурации BPMSoft. SDK, сетевой источник зависимостей и права должны быть доступны учётной записи приложения, а не только администратору терминала.

Серверная часть

  1. Проверьте наличие SDK 8.0, а не только runtime: dotnet --list-sdks.
  2. Проверьте Microsoft.NETCore.App и Microsoft.AspNetCore.App 8.0: dotnet --list-runtimes.
  3. Войдите в каталог реального приложения и проверьте существующие настройки источников NuGet поставки. Не создавайте новый конфигурационный файл в случайном каталоге: сборка может читать настройки другого уровня.
  4. Если источники заданы профилем пользователя, проверьте профиль именно службы. В Linux его HOME в нашей схеме — /var/lib/bpmsoft; в ветке Windows используется виртуальная учётная запись IIS AppPool\BPMSoft с Load User Profile=True. Для закрытого контура настройте явные пути NuGet.
  5. Выполните исходную серверную компиляцию из «Дизайнер системы → Конфигурация». По первому сообщению ошибки различайте отсутствие пакета, отказ сети, ошибку TLS и отказ записи.

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

sudo -u bpmsoft -H dotnet nuget list source

Если поставка указывает конкретный NuGet.Config, выполните dotnet nuget list source --configfile /ПУТЬ/NuGet.Config. Это просмотр настройки выбранного файла, а не доказательство, что компилятор BPMSoft использовал именно его. Итог подтверждается компиляцией приложения.

Для внутреннего NuGet подготовьте пакеты со всеми транзитивными зависимостями и учтите целевой framework. Самостоятельное копирование нескольких DLL в bin не заменяет восстановление пакетов и не является способом установки Документооборота.

Angular: когда нужны Node.js/npm

Для первого запуска классического интерфейса эти инструменты не являются отдельным обязательным этапом. Установите их до компиляции, если используется Angular или продвинутый дизайнер. Для профиля BPMSoft 1.9 предусмотрены Node.js 22.11.0 и npm 10.9.0; не выбирайте произвольную последнюю major-версию.

Windows

На подготовительном Windows-компьютере загрузите MSI нужной версии и проверьте подпись:

$nodeMsi = 'C:\Install\node-v22.11.0-x64.msi'
Invoke-WebRequest -UseBasicParsing 'https://nodejs.org/dist/v22.11.0/node-v22.11.0-x64.msi' -OutFile $nodeMsi
Get-AuthenticodeSignature $nodeMsi | Select-Object Status, SignerCertificate

Нужны Valid и ожидаемый издатель Node.js. Сохраните SHA256 и проверьте его после переноса на сервер. Подготовьте установщик Node.js x64 согласованной версии из разрешённого источника. Для установки без мастера в административной PowerShell:

$p = Start-Process msiexec.exe -ArgumentList '/i','C:\Install\node-v22.11.0-x64.msi','/qn','/norestart','ALLUSERS=1' -Wait -PassThru
if ($p.ExitCode -notin @(0,3010)) { throw "Установка Node.js: $($p.ExitCode)" }

При коде 3010 завершите перезагрузку. После установки перезапустите пул приложения, чтобы он получил обновлённое окружение.

Откройте новую PowerShell-сессию и выполните node --version, npm --version, where.exe node и where.exe npm. Эти команды подтверждают окружение текущего пользователя. Для службы дополнительно проверьте доступ к пути Node.js и к её каталогам %APPDATA%\npm/npm-cache; затем выполните клиентскую компиляцию из BPMSoft.

Linux

На подготовительном Linux-компьютере:

sudo install -d -m 750 -o "$(id -un)" -g "$(id -gn)" /srv/install/node22
cd /srv/install/node22
curl --fail --show-error --location --output node-v22.11.0-linux-x64.tar.xz https://nodejs.org/dist/v22.11.0/node-v22.11.0-linux-x64.tar.xz
curl --fail --show-error --location --output SHASUMS256.txt https://nodejs.org/dist/v22.11.0/SHASUMS256.txt
sha256sum --check --ignore-missing SHASUMS256.txt
tar -tJf node-v22.11.0-linux-x64.tar.xz | head

Получите OK для нужного архива. Каталог должен быть доступен текущей учётной записи подготовки; при защищённом /srv/install заранее создайте его администратором с нужным владельцем. Перенесите проверенный архив в /srv/install/ целевого узла. Подготовьте x64-архив Node.js выбранной версии и его контрольную сумму. Для новой установки распакуйте в пустой постоянный каталог /opt/node, закройте запись для служебного пользователя. Если каталог уже содержит Node.js, сначала разберите действующую версию и окно замены. Не устанавливайте nvm только в профиль администратора.

sudo install -d -m 755 /opt/node
sudo tar -xJf /srv/install/node-v22.11.0-linux-x64.tar.xz -C /opt/node --strip-components=1
sudo /opt/node/bin/node --version
sudo -u bpmsoft /opt/node/bin/node --version

Для запуска npm с тем же Node.js задайте PATH в unit приложения:

Environment="PATH=/opt/node/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin"

После редактирования выполните sudo systemctl daemon-reload и согласованный перезапуск приложения. Проверьте sudo -u bpmsoft -H env PATH=/opt/node/bin:/usr/bin:/bin npm --version. Версия npm должна соответствовать профилю. Если в архиве другая версия, подготовьте нужный npm из разрешённого источника до закрытия сети; не обновляйте его автоматически до последней версии.

Изолированный контур

Для npm используйте перенос проверенного кэша по процедуре ниже или утверждённый внутренний реестр с доверенным сертификатом. Для NuGet — внутренний источник с полным набором пакетов. Не применяйте strict-ssl=false, отключение TLS или разрешение анонимных пакетов как способ устранить ошибку.

Подготовку проверьте с пустым кэшем в отдельной тестовой среде, чтобы ранее скачанные зависимости не скрыли отсутствующий пакет. Не очищайте кэш работающего приложения в середине установки. После успешной исходной сборки сохраните версии инструментов, источники и перечень зависимостей для повторного развёртывания.

Приёмка

Серверная компиляция завершилась без ошибок; условная Angular-компиляция также успешна; работоспособность подтверждена из интерфейса BPMSoft. Предупреждение само по себе не равно ошибке, но ошибка загрузки пакета или отказ доступа не допускают переход к установке продукта.

Проверка источников перед исходной сборкой

В подключённом к сети тестовом профиле проверьте из серверной сети достижимость https://api.nuget.org/v3/index.json и, при Angular, https://registry.npmjs.org/. Эти адреса — источники пакетов, а не ссылки на внешнюю инструкцию. Если поставка использует иной NuGet feed, используйте его согласованный адрес и требуемую аутентификацию; не передавайте токен в журналы.

В изолированном профиле заранее подготовьте внутренние источники с полными зависимостями, затем выполните реальную сборку без внешней сети. Наличие только SDK не заменяет этих пакетов. При неизвестном источнике или недоступной зависимости результат готовности не фиксируется.

Подготовьте локальный NuGet feed для изоляции

Выполните подготовку до отключения сети на отдельной копии сайта той же сборки. Используйте SDK того же профиля и административную учётную запись копии; на продуктивном сайте не очищайте кэш. Найдите BPMSoft.Configuration/BPMSoft.Configuration.Dev.csproj в поставке. Если он ещё не сформирован, сначала откройте конфигурацию/сгенерируйте исходный код штатным действием BPMSoft в подготовительной копии. Не создавайте проект вручную из шаблона .NET.

На подготовительном Linux-узле:

cd /ПУТЬ/К/КОПИИ/ПРИЛОЖЕНИЯ
umask 077
dotnet restore BPMSoft.Configuration/BPMSoft.Configuration.Dev.csproj --packages /srv/install/nuget-cache
mkdir -p /srv/install/nuget-feed
find /srv/install/nuget-cache -type f -name '*.nupkg' -exec cp -n '{}' /srv/install/nuget-feed/ \;
find /srv/install/nuget-feed -type f -name '*.nupkg' | wc -l

restore должен завершиться без ошибок; каталог feed должен содержать пакеты. Для Windows используйте тот же dotnet restore ... --packages C:\Install\BPMSoft\nuget-cache, затем скопируйте рекурсивно найденные *.nupkg в отдельный nuget-feed. Этот плоский feed содержит архивы, а не только распакованные DLL. Перенесите его с контрольными суммами во внутренний контур.

На Linux разместите feed в /opt/bpmsoft-nuget с чтением для bpmsoft и без записи для него. Создайте /var/lib/bpmsoft/.nuget/NuGet/NuGet.Config (каталоги принадлежат bpmsoft) с содержимым:

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <packageSources>
    <clear />
    <add key="local-bpmsoft" value="/opt/bpmsoft-nuget" />
  </packageSources>
</configuration>

Для Linux при явном указании конфигурации в проекте используйте свойство MSBuild RestoreConfigFile со значением /var/lib/bpmsoft/.nuget/NuGet/NuGet.Config. Сохраните целевой framework из поставки.

Windows: настройте источник для пула BPMSoft

В Windows PowerShell от имени администратора после создания пула выполните команды ниже. Они создают новый каталог для распакованных пакетов и выдают права фактической учётной записи IIS. Поместите подготовленные файлы .nupkg в C:\BPMSoft\nuget-feed. Для приёмки используйте пустой C:\BPMSoft\nuget-packages, чтобы компиляция проверила полноту перенесённого набора.

Import-Module WebAdministration
(Get-Item 'IIS:\AppPools\BPMSoft').processModel |
    Select-Object identityType,loadUserProfile
New-Item -ItemType Directory -Force 'C:\BPMSoft\nuget-feed','C:\BPMSoft\nuget-packages' | Out-Null
icacls 'C:\BPMSoft\nuget-feed' /grant:r 'IIS AppPool\BPMSoft:(OI)(CI)RX'
if ($LASTEXITCODE -ne 0) { throw 'Не выданы права чтения NuGet feed' }
icacls 'C:\BPMSoft\nuget-packages' /grant:r 'IIS AppPool\BPMSoft:(OI)(CI)M'
if ($LASTEXITCODE -ne 0) { throw 'Не выданы права записи NuGet-кэша' }

Ожидаемые параметры пула — ApplicationPoolIdentity и True. Создайте C:\BPMSoft\NuGet.Config вне каталога сайта и выдайте IIS AppPool\BPMSoft право чтения этого файла, например командой icacls 'C:\BPMSoft\NuGet.Config' /grant:r 'IIS AppPool\BPMSoft:R'.

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <config>
    <add key="globalPackagesFolder" value="C:\BPMSoft\nuget-packages" />
  </config>
  <packageSources>
    <clear />
    <add key="local-bpmsoft" value="C:\BPMSoft\nuget-feed" />
  </packageSources>
</configuration>

В существующем BPMSoft.Configuration\BPMSoft.Configuration.Dev.csproj добавьте в PropertyGroup следующие строки. Если свойства уже заданы, измените их значения. Проверьте и связанные проекты на переопределение источников и каталога пакетов.

<RestoreConfigFile>C:\BPMSoft\NuGet.Config</RestoreConfigFile>
<RestorePackagesPath>C:\BPMSoft\nuget-packages</RestorePackagesPath>

Для запуска через CLI можно проверить файл отдельно командой dotnet nuget list source --configfile C:\BPMSoft\NuGet.Config. Итоговая проверка выполняется в интерфейсе BPMSoft при отключённом внешнем доступе. Если сборка сообщает об отсутствующем пакете, добавьте его вместе с транзитивными зависимостями из подготовительной копии и повторите полную компиляцию. Для Angular отдельно подготовьте зависимости npm по процедуре ниже.

Linux: лимит наблюдателей Angular

Если собираются Angular-модули через Nx, задайте постоянный лимит в /etc/sysctl.d/90-bpmsoft-angular.conf:

fs.inotify.max_user_watches=524288

Примените sudo sysctl --system, проверьте sysctl fs.inotify.max_user_watches и повторите сборку. Не снижайте уже установленное большее значение. Проверка лимита не заменяет успешную клиентскую компиляцию.

Определите необходимость и запустите сборку Angular

  1. Под администратором откройте системные настройки и найдите код EnableAngularSupport. Сверьте значение с перечнем требуемых функций поставки. Используемые модули Angular и продвинутый дизайнер требуют подготовки Node.js/npm. Если требуемые функции неизвестны, уточните состав поставки до решения о применимости. Для классического сценария с выключенной поддержкой и без таких функций отметьте клиентскую Angular-сборку как неприменимую.
  2. Для используемых модулей включите «Включить поддержку модулей Angular» и сохраните настройку. Проверьте Node.js/npm в окружении службы и доступность зависимостей.
  3. В «Дизайнер системы → Конфигурация» запустите «Перекомпилировать все». Для настройки страниц в продвинутом дизайнере убедитесь, что у пользовательского пакета заданы зависимости от старшего пакета и AngularDesigner. После серверной сборки откройте «Управление конфигурацией» и выполните «Скомпилировать приложение клиентского интерфейса». Выполняйте действия в административной сессии нужного стенда.
  4. Дождитесь завершения, просмотрите журнал компиляции и записи службы за тот же интервал. Для Angular проверьте отсутствие ошибок npm, Nx и доступа к AngularBuilder. Затем откройте предусмотренную поставкой страницу с модулем или продвинутый дизайнер и проверьте загрузку. Сохраните время, выбранное действие и результат в протоколе.

Перенесите зависимости npm для закрытого стенда

Используйте подключённую подготовительную копию той же сборки BPMSoft на той же ОС и архитектуре. Возьмите полный рабочий каталог сборки, включая AngularBuilder, package.json и согласованный package-lock.json. Если lock-файл ещё не создан, сначала выполните штатную сборку BPMSoft на подключённой копии и возьмите полученный файл. Используйте те же версии Node.js/npm и параметры npm, с которыми его создала сборка.

На Linux под учётной записью подготовки в копии AngularBuilder:

export NPM_CONFIG_CACHE="$PWD/../bpmsoft-npm-cache"
test -f package-lock.json &&
npm ci &&
npm cache verify

На Windows в копии AngularBuilder:

if (-not (Test-Path package-lock.json)) { throw 'Требуется lock-файл штатной сборки' }
$env:NPM_CONFIG_CACHE = Join-Path (Split-Path (Get-Location).Path) 'bpmsoft-npm-cache'
npm.cmd ci
if ($LASTEXITCODE -ne 0) { throw 'npm ci завершился ошибкой' }
npm.cmd cache verify
if ($LASTEXITCODE -ne 0) { throw 'Ошибка проверки кэша npm' }

Перенесите каталог кэша целиком, зафиксируйте контрольные суммы архива кэша и lock-файла. Параметры источника пакетов должны соответствовать lock-файлу. Секреты из .npmrc и журналы npm исключите из переноса. На выделенной копии без Интернета задайте NPM_CONFIG_CACHE путём к перенесённому кэшу и NPM_CONFIG_OFFLINE=true, затем повторите npm ci. Передайте те же переменные процессу приложения. На Linux добавьте строки Environment=NPM_CONFIG_CACHE=/путь/к/кэшу и Environment=NPM_CONFIG_OFFLINE=true в секцию [Service] службы BPMSoft, выполните systemctl daemon-reload и перезапустите службу. На выделенном Windows-сервере задайте обе переменные командой [Environment]::SetEnvironmentVariable('ИМЯ','ЗНАЧЕНИЕ','Machine') из административной PowerShell и перезагрузите сервер. У службы должны быть права чтения и записи в каталог кэша.

Затем выполните штатную компиляцию BPMSoft без внешнего доступа. При ENOTCACHED добавьте недостающие зависимости через повторную штатную сборку на подключённой копии с тем же кэшем. Если скрипт установки сам скачивает артефакт, подготовьте его локальный источник по требованиям конкретного пакета и повторите весь тест. Для контура с внутренним npm-реестром эти артефакты и пакеты должен обслуживать разрешённый источник. Признак готовности в обоих случаях — успешная сборка BPMSoft на изолированной копии.

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