Files
mtusi2026lab3-fork/REPORT.md
T

4.4 KiB
Raw Blame History

Отчёт — лабораторная 3

  • Автор и группа — Samodurov Nikita, bpi2303
  • Целевая оценка — 4
  • Источники — материалы и контракт курса.
  • Использование ИИ — консультации и проверки ИИ.

Запуск из чистого клона

Нужны Docker Engine с Compose v2 и Python 3.9+ на хосте. Контейнер использует Python 3.13.5. По умолчанию API доступен на http://127.0.0.1:8080. При занятом порте задайте PUBLIC_PORT и соответствующий BASE_URL. Команда setup создаёт локальные .env и secrets/.

python scripts/setup.py
make check
docker compose config --quiet
docker compose build migrate
docker compose up -d --wait
make test
make test-persistence ACTION_SCRIPT=scripts/restart.sh
make test-failover ACTION_SCRIPT=scripts/stop-one.sh
docker compose start api-a api-b
python student-tests/check_replicas.py
docker compose down

В Windows PowerShell используйте следующие проверки после запуска стенда. Перед проверками установите $env:PYTHONUTF8 = '1'.

python scripts/check_contract.py
python tests/smoke.py
python tests/resilience.py --mode persistence --action-script scripts/restart.cmd
python tests/resilience.py --mode failover --action-script scripts/stop-one.cmd
docker compose start api-a api-b
python student-tests/check_replicas.py

Для полной валидации контракта установите requirements-dev.txt в отдельное окружение и выполните python scripts/validate_openapi.py. Команда docker compose down оставляет именованные тома. Для намеренного сброса учебных данных выполните docker compose down -v.

Архитектура

Из ЛР 2 перенесены PostgreSQL, сессии и кэш профилей. HAProxy распределяет запросы между api-a и api-b по round-robin и проверяет /health/ready раз в секунду. После двух неуспешных проверок реплика исключается. Таймаут каждой проверки — одна секунда. Штатный выход по SIGTERM закрывает слушающий сокет и оставляет обработчикам до пяти секунд. На хост опубликован только HAProxy. Алиас X-Instance-Id соответствует имени сервиса. Разрешение имён использует Docker DNS.

PostgreSQL хранит результат отправки с ключом в области «пользователь + чат + POST». Транзакционная advisory-блокировка сериализует запросы с одинаковым ключом. Сообщение и запись результата фиксируются одним COMMIT. Тот же текст в течение 24 часов возвращает исходный ответ, другой текст даёт 409. После истечения TTL запись того же ключа заменяется при следующем использовании. Сессия и членство проверяются на каждом повторе.

Версионируемые миграции выполняет сервис migrate под блокировкой. Проверка замены реплик использует ту же версию схемы. Миграции с несовместимыми изменениями требуют отдельного плана обновления.

Проверки

Результаты локального Docker-стенда и команды приведены в evidence/local-checks.txt.

Ограничения

Реплики защищают от отказа одного процесса API. HAProxy и PostgreSQL работают по одному экземпляру. Во время исключения остановленного backend возможны короткие ошибки, POST сообщения можно повторить с исходным ключом.