forked from mtusi2026/mtusi2026lab3
Co-authored-by: Югай Артур Рустамович <f1ekserr@yandex.ru>
61 lines
4.4 KiB
Markdown
61 lines
4.4 KiB
Markdown
# ЛР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 задания, контракт и публичные тесты сохранены.
|