From a065f5c6e632c255353068e359e5f7f4f446cc7b Mon Sep 17 00:00:00 2001 From: DmitriyFadin <93384500+DmitriyFadin@users.noreply.github.com> Date: Tue, 13 Oct 2026 22:55:33 +0300 Subject: [PATCH] Document production update and off-server backup policy --- AGENTS.md | 2 ++ docs/server-deployment.md | 9 +++++++++ 2 files changed, 11 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index 5562383..9f67573 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -33,6 +33,8 @@ ## Работа с проектом - С 13 октября 2026 года сервер содержит рабочие данные. Не выполнять серверные операции без согласованной задачи; прежнее разрешение на первоначальное развёртывание не разрешает последующие обновления. +- При обновлении сохранять серверные `.env`, `app.env` и существующие учётные записи без изменений, если пользователь отдельно не поручил их изменить. +- Резервные копии рабочей БД хранить вне сервера приложения и вне Git. Для текущего окружения использовать `~/Documents/TrainingPlannerBackups`; временный серверный дамп удалять только после успешного переноса и сверки контрольных сумм. - Миграции должны сохранять текущие данные. Перед применением на сервере проверить SQL, создать резервную копию и проверить её восстановление и миграцию в отдельной тестовой БД. Не запускать тесты на рабочей базе. - Не пересоздавать рабочую БД, не удалять её тома и не заменять её локальной базой. Потенциально разрушающие изменения требуют отдельного согласования и плана переноса данных. - Учитывать автоматическое применение миграций при запуске приложения: перезапуск новой версии также может изменить БД. При обнаружении проблемы на сервере остановиться и спросить пользователя до исправления. diff --git a/docs/server-deployment.md b/docs/server-deployment.md index 5ab98e3..834b3bc 100644 --- a/docs/server-deployment.md +++ b/docs/server-deployment.md @@ -32,3 +32,12 @@ docker compose logs --tail 100 app При проверке 30 сентября 2026 года Nginx для `trainplan.samsonium.ru` слушает только порт 80 и проксирует на `http://127.0.0.1:8001`. На порту 443 выдаётся сертификат `search.samsonium.ru`, истёкший 19 ноября 2025 года. Конфигурация Nginx и сертификаты при развёртывании приложения не изменяются. На момент первоначальной проверки требовалась настройка HTTPS администратором. 13 октября пользователь сообщил, что завершил настройку сервера; повторная проверка не выполнялась. Прежнюю проблему сертификата не считать актуальной без новой проверки в рамках согласованной задачи. + +## Обновление — 13 октября 2026 + +- Образ приложения: `training-planner:9877052`, код ветки `master`. Исходники сборки: `/home/dimass/training-planner/releases/9877052`. Старый checkout не перезаписан. +- Обновлён только app через `docker compose up -d --no-deps app`; контейнер БД остался прежним. Новых миграций нет. +- `.env`, `app.env` и существующие учётные записи, включая хеши паролей, не изменились: проверено контрольными суммами. Количество клиентов, программ, библиотечных упражнений и миграций осталось прежним. +- HTTPS страницы входа отвечает 200, новый контейнер работает без перезапусков. Вход под рабочей учётной записью и тестовые изменения рабочей БД не выполнялись. +- Резервная копия находится на компьютере пользователя: `~/Documents/TrainingPlannerBackups/before-9877052-20261013-225214/database.dump`. Проверены читаемость каталога архива и совпадение SHA-256 после переноса. Восстановление не выполнялось, миграций в обновлении нет. +- После проверки переноса временный серверный дамп удалён. На сервере остались резервный Compose и контрольные суммы для проверки обновления; env-файлы не изменялись.