# Отчёт — лабораторная 3 - Автор, группа: Зюлина Екатерина Михайловна, БВТ2302. - Целевая оценка: 3. - Commit/PR: заполнить после публикации. - Использованные источники и помощь: документация/контракт репозитория; собственная реализация lab2; помощь Codex при анализе требований и реализации. ## Запуск из чистого clone (Windows PowerShell + Docker Desktop Linux Engine) Требуются Docker Desktop с Linux containers, Docker Compose v2, Git и Python 3.11. Из PowerShell в корне clone: ```powershell Copy-Item .env.example .env py -3.11 -c 'from pathlib import Path; import secrets; p=Path(".env"); p.write_text(p.read_text().replace("replace-with-a-random-32-character-value", secrets.token_hex(24)))' $env:PYTHONUTF8 = '1' py -3.11 -m venv .venv .\.venv\Scripts\python.exe -m pip install -r requirements-dev.txt docker compose --env-file .env config --quiet docker compose --env-file .env up -d --build Invoke-WebRequest http://localhost:8080/health/ready -UseBasicParsing .\.venv\Scripts\python.exe scripts\check_contract.py .\.venv\Scripts\python.exe tests\smoke.py --base-url http://localhost:8080 .\.venv\Scripts\python.exe tests\concurrent_idempotency.py --base-url http://localhost:8080 .\.venv\Scripts\python.exe tests\resilience.py --mode persistence --action-script scripts\restart.bat --base-url http://localhost:8080 .\.venv\Scripts\python.exe tests\resilience.py --mode failover --action-script scripts\stop-one.bat --base-url http://localhost:8080 ``` Для Linux runner используйте `scripts/restart.sh` и `scripts/stop-one.sh` после `chmod +x scripts/restart.sh scripts/stop-one.sh`. Smoke и отказовые сценарии создают синтетические данные. Для остановки без потери данных: `docker compose --env-file .env down`. Для намеренного удаления тестовой БД и сессий: `docker compose --env-file .env down -v`. ## Архитектура и решения Путь запроса: клиент → Nginx LB → две API-реплики → общие PostgreSQL и Redis. PostgreSQL хранит пользователей, чаты, членство, сообщения, сессии и записи идемпотентности. Redis — общий TTL-cache активных сессий; чтение при cache miss обращается к PostgreSQL. Пароли — scrypt, токены — случайные opaque bearer. Из lab2 перенесены исходники REST API, схема и версии миграций, auth/store и Dockerfile/runtime dependencies. Новая миграция `003_message_idempotency` создаёт уникальную область `(user_id, method, chat_path, key)`. В одной PostgreSQL-транзакции реплика резервирует ключ, создаёт сообщение и фиксирует ссылку; конкурентный запрос блокируется уникальным индексом и возвращает прежнее сообщение либо 409 при другом JSON. Канонизация учитывает отсутствие `attachment_ids` как пустой список. Ключи сохраняются дольше минимальных 24 часов, автоматическая очистка не настроена. Миграции выполняются отдельным одноразовым Compose service `migrate` до запуска API. Nginx распределяет запросы между двумя API-сервисами и исключает недоступный backend при отказе. Для backend используются имена Docker DNS, общими остаются PostgreSQL и Redis. | Роль | Compose service / версия | Назначение | | --- | --- | --- | | LB | `lb`, nginx:1.27.5-alpine | Публичная точка входа на host port 8080. | | API ×2 | `api1` и `api2`, локально собранный `mtusi-messenger-api:3.0.0` на Python 3.11.10 | Взаимозаменяемые экземпляры REST API, доступные LB. | | Миграция | одноразовый `migrate`, `mtusi-messenger-api:3.0.0` | Выполняет `alembic upgrade head` до запуска API. | | PostgreSQL | `db`, postgres:16.4-alpine | Общая БД, данные в named volume `postgres_data`. | | Session cache | `redis`, redis:7.4.2-alpine | Общий cache с AOF `appendfsync always` и named volume `redis_data`. | `POSTGRES_USER`, `POSTGRES_PASSWORD`, `POSTGRES_DB` используются для PostgreSQL и `DATABASE_URL` API/migrate. `APP_PORT` публикует LB; `SESSION_TTL_SECONDS` задаёт TTL. Секрет PostgreSQL передаётся через локальный игнорируемый `.env`. ## Доказательства критериев уровня 3 | Критерий | Команда/сценарий | Наблюдаемый результат | Файл доказательства | | --- | --- | --- | --- | | Структура skeleton | `python scripts/check_contract.py` | PASS. | `evidence/implementation-checks.txt` | | Контракт API через LB | `python tests/smoke.py --base-url http://localhost:8080` | PASS: сценарий публичного API lab3. | `evidence/runtime-checks.txt` | | Общие сессии и разные реплики | Smoke через LB | PASS: запросы одного пользователя обслуживаются API без повторного входа; виден `X-Instance-Id`. | `evidence/runtime-checks.txt` | | Persistence | `python tests/resilience.py --mode persistence --action-script scripts/restart.bat ...` | PASS: прежняя сессия и подтверждённые данные доступны после перезапуска сервисов с сохранением volumes. | `evidence/runtime-checks.txt`, `evidence/persistence-actions.txt` | | Failover API | `python tests/resilience.py --mode failover --action-script scripts/stop-one.bat ...` | PASS: другая реплика продолжает чтение и запись, подтверждённые сообщения сохранены, дубли не появились. | `evidence/runtime-checks.txt`, `evidence/failover-actions.txt` | | Конкурентная идемпотентность | `python tests/concurrent_idempotency.py --base-url http://localhost:8080` | PASS: конкурентный повтор одного ключа создаёт одну запись. | `evidence/runtime-checks.txt` | После failover восстановить остановленный сервис по записи в `evidence/failover-actions.txt`, например `docker compose --env-file .env start api2`, и дождаться ответа через LB. ## Эксперименты и ограничения Failover-сценарий проверяет отказ одной выбранной API-реплики через LB: перед воздействием наблюдаются как минимум две реплики, а операции продолжаются через оставшуюся. Hook записывает соответствие `TARGET_INSTANCE_ID` и Compose-сервиса. Smoke, тест идемпотентности, persistence и failover запускаются отдельными командами. Один Docker host, один LB и одна PostgreSQL — точки отказа; сценарий проверяет отказ одного API-процесса, а не потерю узла/хоста или БД.