Паспорт экземпляра ProjectDB: что записать перед обновлением
Что сохранить о работающем приложении ProjectDB, чтобы после обновления быстро проверить его и при необходимости вернуться назад.
- ЭкземплярИмя, каталог и режим
- ОперацияКонтрольный сценарий
- РезультатПодтверждение работы
Перед обновлением легко забыть мелочь: из какой папки запущено приложение, какая база к нему подключена, кто управляет процессом. Пока всё работает, эти сведения кажутся очевидными. Короткая заметка об экземпляре ProjectDB избавит от догадок, если после обновления что-то пойдёт не так. Особенно когда на одном сервере есть и рабочая, и тестовая копии.
Что записать о приложении
Запишите имя приложения, рабочий каталог, способ запуска и назначение базы. Секреты в паспорт не включаются. Для ProjectDB рабочий каталог имеет практическое значение: локальные файлы конфигурации участвуют в выборе подключения. Одного имени сервера недостаточно, если одинаковое приложение запускается из разных каталогов.
Приложение: PDB-SERVER
Каталог: /opt/pdb
Запуск: служба Linux
База: учебный контур
Проверка: чтение тестовой записи через приложениеКак запущено приложение и куда поступают данные
Руководство описывает интерактивный запуск, службу Linux и PM2. Выберите в паспорте используемый режим. Не запускайте ещё один экземпляр только ради проверки, пока не выяснили, кто уже работает. Для интеграции с прибором добавьте маршрут результата: устройство, обработка файла, принимающая система. Сетевая доступность и успешное появление записи — разные проверки.
Что проверить до обновления
До изменения выполните небольшой контрольный сценарий на разрешённых данных. Сохраните ожидаемый результат и время проверки. После обновления повторите тот же сценарий. Успешная команда перезапуска подтверждает работу управления процессом, но не прохождение всей цепочки. Если меняются настройки подключения, отдельно подтвердите целевую базу на стороне PostgreSQL.
Добавьте место хранения защищённой резервной копии, ответственного за восстановление и последовательность возврата. Пароли, токены и содержимое пользовательских записей в открытые заметки не переносятся. Паспорт должен помогать действовать, а не становиться ещё одним хранилищем реквизитов.
Когда обновлять заметку
Обновляйте эту заметку после смены каталога, способа запуска или интеграции и ставьте дату проверки. Хорошо, если по ней другой человек сможет найти нужное приложение и повторить проверку, не перезапуская соседний экземпляр.