Files
mtusi2026lab3/REPORT.md
T
DaniilKuznetsovandЮгай Артур Рустамович 09aece58fe ЛР3 на 3
Co-authored-by: Югай Артур Рустамович <f1ekserr@yandex.ru>
2026-11-16 22:23:04 +03:00

61 lines
4.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# ЛР3 — две API-реплики
Кузнецов Даниил Русланович, БПИ2304. На **3**.
## Запуск
Нужны Python 3.13, Git и Docker с Compose. Из папки репозитория:
```powershell
python -X utf8 scripts/lab.py verify
```
Скрипт готовит `.venv`, локальные настройки и секреты, собирает и проверяет стенд.
Повторный setup сохраняет данные. Адрес: `http://127.0.0.1:18103`,
Compose-проект: `kuznetsov-lab3`. Linux: команды через `python3`.
Отдельно доступны `setup`, `build`, `start`, `test`, `restart-check`,
`failover-check`, `restore`, `stop`. Например: `python -X utf8 scripts/lab.py stop`.
Остановка сохраняет БД. Намеренный сброс:
`docker compose -p kuznetsov-lab3 --env-file .env down --volumes`.
## Реализация
Клиент → HAProxy → api1/api2 → PostgreSQL.
Сохранены пароли, Bearer-сессии, права участников и подписанные курсоры.
Обе реплики используют одну БД, сессию и ключ курсоров.
`X-Instance-Id` определяет процесс, балансировка round-robin без sticky sessions.
POST сообщения требует `Idempotency-Key`: повтор возвращает прежний результат,
другое тело даёт 409. Сообщение и результат сохраняются одной SQL-транзакцией,
конкурентные повторы сериализуются блокировкой. Результат хранится 24 часа.
Доступ и действительность токена проверяются заново при каждом повторе.
Python 3.13.14, PostgreSQL 17.11, HAProxy 3.2.26; образы и библиотеки закреплены.
Наружу открыт только LB, API работают без root. LB не повторяет POST автоматически.
`live` проверяет процесс, `ready` — БД и миграции.
## Проверки
Команда: `python -X utf8 scripts/lab.py verify`.
| Проверка | Результат |
| --- | --- |
| Структура, OpenAPI, Compose, публичный smoke | PASS — [лог](evidence/verification.txt) |
| Авторизация, Unicode, конкуренция и идемпотентность | 27 тестов, PASS — [лог](evidence/verification.txt) |
| 20 одновременных повторов через обе реплики, rollback при ошибке | Без дублей — собственные тесты в общем логе |
| Рестарт API/БД/LB, старые токен, курсор и результат отправки | PASS — [данные](evidence/persistence.json), [контейнеры](evidence/restart.json) |
| Остановка каждой API-реплики | Восстановление до 10 с, без потери подтверждённых сообщений — [JSON](evidence/failover.json) |
| TTL=2 на порту 18113, logout и повторные миграции | PASS — [expiry](evidence/expiry.json), [persistence](evidence/persistence.json) |
| Остановка БД | live 200, ready/API 503, восстановление 200 — [сводка](evidence/summary.json) |
Hooks проверяют реальный контейнер текущего проекта. После отказа обе реплики
восстанавливаются. Временный TTL-стенд освобождает свои сети, сохраняя volume.
Ограничения: один Docker-host, одна БД и LB; проверен отказ одной API за раз.
HTTP только для локального учебного стенда. Redis, Swarm и rolling update не заявлены.
Основа — [реализация Артура Югая](https://gitea.privcloud.tech/ArturYugay/mtusi2026lab3/src/commit/5a53b087390e90d6035153d32bd1ae31be72c9ae).
Для Даниила выделены отдельные настройки, секреты, порты, volumes и проверки.
README задания, контракт и публичные тесты сохранены.