Files
mtusi2026lab3/REPORT.md

4.6 KiB
Raw Permalink Blame History

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

  • Автор, группа: Соболев Даниил Романович, БПИ2302
  • Целевая оценка; выбранный трек 5, если нужен: 4
  • Commit/PR: TODO после публикации
  • Использованные источники, библиотеки и помощь ИИ: FastAPI, psycopg, redis, argon2-cffi, HAProxy; перенос lab2; помощь ИИ при LB/идемпотентности

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

Prerequisites: Docker Compose; Python 3.9+ для тестов.

cp .env.example .env
powershell -File scripts/make_secrets.ps1   # или sh scripts/make_secrets.sh

docker compose --env-file .env config --quiet
docker compose --env-file .env up -d --build --scale api=2

Публичная точка входа: только LB http://127.0.0.1:8080 (порты API наружу не опубликованы).

Ожидание: GET /health/ready → ok. Миграции — сервис migrate (один раз), API с RUN_MIGRATIONS=false.

make test
# Windows (UTF-8 для чтения contracts/openapi.json):
set PYTHONUTF8=1
py -3 tests\smoke.py --base-url http://localhost:8080
py -3 tests\own.py --base-url http://localhost:8080
py -3 tests\resilience.py --mode persistence --action-script scripts\restart.cmd --base-url http://localhost:8080
py -3 tests\resilience.py --mode failover --action-script scripts\stop-one.cmd --base-url http://localhost:8080
# после failover поднять остановленную реплику:
scripts\start-stopped-api.cmd
# повторить failover для второй реплики

Остановка (volumes сохраняются): docker compose --env-file .env down
Сброс данных: docker compose --env-file .env down -v

Версии: python:3.12.7-slim-bookworm, postgres:16.4-bookworm, redis:7.4.1-bookworm, haproxy:2.9.7-bookworm.

Архитектура и решения

Клиент → HAProxy (LB :8080) → API×2+ → PostgreSQL (истина + idempotency_keys)
                                  ↘ Redis (общие сессии, AOF)
  • Перенос lab2: Postgres, Argon2, Basic→Bearer, Redis-сессии, миграции.
  • lab3: X-Instance-Id = hostname контейнера (стабилен на жизнь процесса; stop-one мапит на container).
  • Идемпотентность: таблица idempotency_keys (user+method+path+key); claim через INSERT ON CONFLICT DO NOTHING + message в одной транзакции; replay 201 / другой body 409.
  • LB: HAProxy round-robin, httpchk GET /health/ready, inter 2s fall 2 (~4 с до исключения backend), DNS api через Docker resolver.
  • SIGTERM: stop_grace_period: 10s, приложение ставит ready=false в lifespan.
  • Лимиты: mem_limit/cpus на сервисах; без container_name.
  • Миграции: однократно migrate job, совместимы с IF NOT EXISTS (работающий API не ломают).
  • Rolling: docker compose up -d --build --scale api=2 (поочерёдная замена контейнеров при recreate).

Доказательства критериев

Критерий Команда Результат Файл
Smoke make test PASS lab3 evidence/smoke.txt
≥2 instance id make test-own ≥2 X-Instance-Id evidence/own.txt
Persistence restart.cmd token+данные evidence/persistence.txt
Failover stop-one.cmd recover ≤10s evidence/failover.txt
Идемпотентность concurrent own 1 message id evidence/own.txt

Обнаружение отказа LB: healthcheck interval 2s, fall 2 → порядка 4 с.

Эксперименты и отказы

Воздействие Ожидание Наблюдение
stop одной API другая обслуживает ≤10с failover PASS
stop каждой по очереди после start предыдущей сценарий защиты
одинаковый Idempotency-Key ×8 1 сообщение own PASS
restart всего стека тот же token persistence PASS

Ограничения

  • Один Docker-host; LB/Postgres/Redis — SPOF.
  • Остановленная реплика не поднимается сама — start-stopped-api после теста.
  • Нет Swarm/многоузлового failover (трек 5).