From 747ad9baedf6f5ce4ef1282782e9cb102abc2ea9 Mon Sep 17 00:00:00 2001 From: vasyukova Date: Thu, 1 Oct 2026 00:05:58 +0300 Subject: [PATCH] =?UTF-8?q?=D0=BE=D0=B1=D0=BD=D0=BE=D0=B2=D0=B8=D0=BB?= =?UTF-8?q?=D0=B0=20=D0=BE=D1=82=D1=87=D0=B5=D1=82=20=D0=B8=20=D1=81=D0=BA?= =?UTF-8?q?=D1=80=D0=B8=D0=BF=D1=82=20=D1=80=D0=B5=D1=81=D1=82=D0=B0=D1=80?= =?UTF-8?q?=D1=82=D0=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- REPORT.md | 34 +++++++++++++++++++++++++++++++++- scripts/restart.bat | 2 +- 2 files changed, 34 insertions(+), 2 deletions(-) diff --git a/REPORT.md b/REPORT.md index 820c05dc..677a94af 100644 --- a/REPORT.md +++ b/REPORT.md @@ -54,7 +54,8 @@ ``` docker run --rm --name mtuci-messenger-lab2 -p 127.0.0.1:8080:8080 --env-file .env --add-host=host.docker.internal:host-gateway mtuci-messenger:lab2 ``` - Флаг `--add-host=host.docker.internal:host-gateway` обязателен, если PostgreSQL работает на хосте, а не в контейнере. + Флаг `--add-host=host.docker.internal:host-gateway` обязателен, если PostgreSQL работает на хосте, а не в контейнере. + 6. Проверка готовности: ``` curl.exe -s http://localhost:8080/health/ready @@ -65,6 +66,37 @@ Альтернативный локальный запуск без Docker: python -m uvicorn src.app.main:app --host 0.0.0.0 --port 8080 --reload + +### Проверки + +`make` в среде автора недоступен (Windows без GNU Make), поэтому использованы эквивалентные прямые вызовы скриптов. Для Linux/CI рядом указаны команды `make`. + +| Makefile-команда | Прямой эквивалент | +| --- | --- | +| `make check` | `python scripts/check_contract.py` | +| `make validate` | `python scripts/validate_openapi.py` | +| `make test` | `python tests/smoke.py --base-url http://localhost:8080` | +| `make test-student` | `python student-tests/run_all.py --base-url http://localhost:8080` | +| `make test-persistence ACTION_SCRIPT=scripts/restart.sh` | `python tests/resilience.py --mode persistence --action-script scripts/restart.bat --base-url http://localhost:8080` | + +Примечание про 2 action-скрипта: +- `scripts/restart.sh` — обязательный артефакт по методичке, для Linux/CI (shebang `#!/bin/sh`, `chmod +x`). +- `scripts/restart.bat` — Windows-эквивалент restart.sh: tests/resilience.py запускает action-script напрямую через subprocess.Popen, и на Windows .sh не исполняется (WinError 193). + +### Остановка и удаление учебных данных + +``` +Ctrl+C в терминале контейнера +или +docker stop mtusi-messenger-lab2 +``` +Данные в PostgreSQL сохраняются (источник истины). Контейнер запускается с флагом `--rm` и удаляется автоматически. + +Альтернативный локальный запуск без Docker: +``` +python -m uvicorn src.app.main:app --host 0.0.0.0 --port 8080 --reload +``` +(в `.env` при этом `DATABASE_URL=postgresql://user:password@localhost:5432/high_load_messenger`) ## Архитектура и решения diff --git a/scripts/restart.bat b/scripts/restart.bat index c57f2ccf..75bf9c9e 100644 --- a/scripts/restart.bat +++ b/scripts/restart.bat @@ -7,7 +7,7 @@ REM Сохраните постоянные тома и схемы/данные; REM Разрешите оператору снять защиту, если это необходимо в lab7; не выводите учетные данные. REM Выходите из программы с кодом 0 только после выполнения запланированного действия; тест отдельно проверяет готовность API. -REM Перезапуск API. PostgreSQL НЕ трогаем — volume с данными сохраняется. +REM Перезапуск API-контейнера. НЕ трогает PostgreSQL и не удаляет volume с данными. docker restart mtusi-messenger-lab2 >nul 2>&1 if errorlevel 1 ( docker stop mtusi-messenger-lab2 >nul 2>&1