Перед установкой или обновлением сохраните согласованное состояние приложения, базы и файлов. Откат отдельных пакетов не заменяет восстановление среды.
Команды Linux в этой статье выполняйте в административной оболочке соответствующего узла: сначала sudo -i. Это необходимо и для cd в закрытые каталоги проектов, а не только для запуска Docker. После завершения работ выйдите командой exit.
Что сохранить
- Базу BPMSoft с данными и схемами.
- Каталог приложения: установленные пакеты, конфигурацию, нативные библиотеки и постоянные данные приложения.
- Ключи защиты/шифрования и сертификаты с закрытыми ключами; пароли — в отдельном защищённом хранилище.
- Оригиналы и версии файлов во внешних папках, S3, Nextcloud или другом используемом хранилище.
- Конфигурацию службы, IIS/nginx, контейнеров и сетевых подключений.
Redis не является резервной копией базы и документов. Не восстанавливайте кэш другой среды в качестве способа вернуть документы.
Зафиксируйте согласованное состояние
В окно обслуживания завершите пользовательские изменения и остановите фоновые записи/интеграции. На Linux остановите только приложение sudo systemctl stop bpmsoft; на Windows остановите нужный сайт и пул IIS, сохранив работу других сайтов. Для внешнего хранилища используйте согласованный снимок, относящийся к тому же состоянию документов.
В профиле PostgreSQL из нашей инструкции на Linux-узле выполните:
sudo -i
cd /opt/bpmsoft-db
umask 077
install -d -m 0700 backup
(
set -e
temp=$(mktemp backup/.bpmsoft.XXXXXXXX)
trap 'rm -f -- "$temp"' EXIT
docker compose exec -T db pg_dump -U postgres -d bpmsoft -Fc > "$temp"
test -s "$temp"
docker compose exec -T db pg_restore --list < "$temp" > /dev/null
mv -T --no-clobber "$temp" backup/bpmsoft-before.backup
test ! -e "$temp" || { echo "Backup already exists. Choose a new filename." >&2; exit 1; }
)
Проверьте код завершения сразу после команды: echo $? должен вернуть 0. Ненулевой код или пустой файл — ошибка. Затем проверьте читаемость оглавления:
docker compose exec -T db pg_restore --list < backup/bpmsoft-before.backup
sha256sum backup/bpmsoft-before.backup
Проверка оглавления подтверждает формат архива, но не заменяет пробное восстановление. Сохраните также определения служебных ролей и секреты подключения принятым защищённым способом; обычный pg_dump не содержит всех ролей сервера.
Пока приложение остановлено, скопируйте его каталог средствами резервного копирования ОС, сохраняя права, и выполните согласованную копию внешних файлов. Запишите версии компонентов и состав комплекта. После окончания включите приложение, проверьте вход и работу контрольной записи.
Проверьте восстановление отдельно
- Выделите изолированную среду с совместимыми версиями. Не направляйте её в рабочие SMTP, Диадок и другие внешние системы. Отключите фоновые отправки до первого запуска восстановленного приложения.
- Восстановите приложение, его ключи и конфигурацию. Замените только адреса изолированной среды; не генерируйте новые ключи вместо сохранённых без процедуры миграции зашифрованных данных.
- Создайте новую пустую БД и восстановите архив. Не выполняйте очистку или восстановление поверх продуктивной базы.
- Восстановите соответствующие файлы внешнего хранилища и отдельный кэш среды. Проверьте права ОС.
- Выполните вход, откройте старый документ и несколько прежних версий вложения, проверьте назначенные задачи и нумерацию. Секреты подключений должны расшифровываться, а не заменяться отключением функции.
Возврат после неуспешного обновления
Остановите изменения в неуспешной среде и сохраните её журналы. Восстановите весь согласованный комплект исходной версии. Учитывайте документы, появившиеся после копии: их потерю или перенос нужно решить до восстановления. После запуска повторите приёмку, затем возвращайте внешние интеграции и пользователей.
Не удаляйте рабочую базу и не выполняйте docker compose down -v как стандартный шаг отката. Каталог резервных копий не должен публиковаться через веб-сайт.
Пример согласованной копии Ubuntu с контейнерной БД
На выделенном узле остановите приложение и подтвердите, что пользователи и интеграции больше не пишут в его файлы/БД. Создайте закрытый каталог на диске резервного хранения, например /srv/backup/bpmsoft/2026-11-06-before-install; дату и путь замените фактическими.
sudo install -d -m 700 /srv/backup/bpmsoft/2026-11-06-before-install
sudo systemctl stop bpmsoft
sudo tar --acls --xattrs -cpf /srv/backup/bpmsoft/2026-11-06-before-install/app.tar -C /opt/bpmsoft app
sudo cp /etc/systemd/system/bpmsoft.service /srv/backup/bpmsoft/2026-11-06-before-install/
sudo cp /etc/nginx/sites-available/bpmsoft /srv/backup/bpmsoft/2026-11-06-before-install/
Скопируйте отдельно сертификаты/ключи, если они находятся вне приложения, и выполните pg_dump из раздела выше. Ключи и JSON/XML подключения делают архив конфиденциальным, даже если документов в нём нет. Сохранение каталога не заменяет снимок внешнего S3/Nextcloud/папки.
Для выделенного кластера PostgreSQL можно дополнительно сохранить роли:
cd /opt/bpmsoft-db
umask 077
install -d -m 0700 backup
docker compose exec -T db pg_dumpall -U postgres --globals-only > backup/globals-before.sql
Файл содержит сведения о ролях и может содержать хеши паролей; храните его закрыто и не прикладывайте к открытой документации. На общем сервере согласуйте состав с администратором БД: не переносите роли других приложений автоматически.
В журнале копии запишите пути, версии, время остановки/запуска и результат каждой команды. Вычислите SHA256 файлов комплекта, перенесите копию на независимый носитель и проверьте суммы после переноса. Не храните единственную копию только в томе, который будет пересоздаваться.
Пример копии Windows
Остановите сайт и пул BPMSoft в IIS, сохранив остальные сайты. В PowerShell администратора выполните копирование в новый каталог:
robocopy 'C:\inetpub\wwwroot\BPMSoft' 'D:\Backups\BPMSoft-before-install\application' /E /COPYALL /DCOPY:DAT /R:2 /W:2 /XJ /LOG:'D:\Backups\BPMSoft-before-install\robocopy.log'
$LASTEXITCODE
Каталог назначения и его родитель должны существовать и быть доступны только администраторам. Коды robocopy ниже 8 не означают обязательную ошибку, но требуют просмотра сводки; 8 и выше — ошибка копирования. /XJ исключает обход junction, поэтому вынесенные через них данные должны копироваться отдельно. Не используйте /MIR без понимания: он может удалить лишние файлы назначения.
Экспортируйте конфигурацию сайта/пула и сертификат с закрытым ключом принятым защищённым способом. Пароль PFX храните отдельно. На Windows-узле PostgreSQL в pgAdmin откройте контекстное меню базы bpmsoft → Backup, выберите формат Custom и сохраните файл в закрытый каталог резервного хранения. Убедитесь, что задача завершилась успешно, и сохраните SHA256 через Get-FileHash -Algorithm SHA256. Проверьте оглавление командой pg_restore.exe --list на узле БД. На изолированном Windows-экземпляре пробное восстановление выполняйте по ветке Windows с отдельной пустой БД, отдельным кэшем и точечным правилом HBA для её имени. Сохраните конфигурацию контейнерного Redis и закрытые секреты тем же согласованным комплектом. Перед запуском сайта проверьте окончание всех частей копирования.
Тест восстановления контейнерного PostgreSQL
На узле изолированного контейнерного PostgreSQL откройте Bash, выполните sudo -i и перейдите в /opt/bpmsoft-db. Поместите копию в backup/bpmsoft-before.backup. Команды создают отдельную базу bpmsoft_restore_check с уже подготовленной ролью bpmsoft и восстанавливают в неё данные.
cd /opt/bpmsoft-db
docker compose exec -T db pg_restore --list < backup/bpmsoft-before.backup &&
docker compose exec -T db psql -U postgres -d postgres -v ON_ERROR_STOP=1 \
-c "CREATE DATABASE bpmsoft_restore_check OWNER bpmsoft TEMPLATE template0 ENCODING 'UTF8'" &&
docker compose exec -T db pg_restore --single-transaction --exit-on-error --no-owner --no-acl --role=bpmsoft -U postgres -d bpmsoft_restore_check < backup/bpmsoft-before.backup &&
docker compose exec -T db psql -U postgres -d bpmsoft_restore_check -v ON_ERROR_STOP=1 -c 'SELECT count(*) FROM "SysSchema";'
Если база с таким именем уже есть, не удаляйте её вслепую: выберите другое новое имя. До запуска тестовой копии в её ConnectionStrings.config укажите Database=bpmsoft_restore_check и отдельный кэш. На узле тестовой БД с правами root откройте /opt/bpmsoft-db/pg_hba.conf. Если действующее правило разрешает вход роли bpmsoft только в одноимённую базу, добавьте отдельное разрешение для bpmsoft_restore_check перед общими правилами reject. Следующая строка разрешает вход только с loopback для приложения и контейнера PostgreSQL на одном узле:
host bpmsoft_restore_check bpmsoft 127.0.0.1/32 scram-sha-256
Для отдельного сервера приложения замените 127.0.0.1/32 фактическим IPv4 источника с маской /32. Если выбрали другое имя базы, подставьте его также в правило HBA, строку подключения и команды восстановления. Для контейнерной БД с сетью host используйте фактический адрес приложения. Если для БД настроен TLS, используйте hostssl. Сохраните файл на месте и выполните в административной оболочке на узле БД:
cd /opt/bpmsoft-db
docker compose exec -T db psql -U postgres -d postgres -v ON_ERROR_STOP=1 -c \
'SELECT line_number, error FROM pg_hba_file_rules WHERE error IS NOT NULL'
При нуле строк примените изменения:
docker compose exec -T db psql -U postgres -d postgres -v ON_ERROR_STOP=1 -c 'SELECT pg_reload_conf()'
Ожидается t. После запуска тестового приложения проверьте сессию приложения на узле БД, подставив в SQL имя bpmsoft_restore_check. До запуска исключите производственные внешние отправки и доступ к рабочим интеграциям на уровне изолированной сети.
Восстановите соответствующий каталог приложения и внешние вложения. Проверьте: вход администратора и обычного сотрудника, открытие старого документа, чтение нескольких прежних версий файла, текущие задачи, нумерацию и расшифровку сохранённых настроек. Запишите длительность восстановления. Ненулевой SysSchema подтверждает только наличие схем, а не все эти проверки.
Когда копию можно считать пригодной
Есть все части одного состояния, контрольные суммы совпали, восстановление в отдельную среду завершилось, контрольные документы/файлы открылись и известен ответственный за возврат. Если отсутствует ключ шифрования или внешний файл, завершение pg_restore не делает копию полной.