forked from mtusi2026/mtusi2026lab3
4.6 KiB
4.6 KiB
Отчёт — лабораторная 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), DNSapiчерез Docker resolver. - SIGTERM:
stop_grace_period: 10s, приложение ставит ready=false в lifespan. - Лимиты: mem_limit/cpus на сервисах; без
container_name. - Миграции: однократно
migratejob, совместимы с 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).