4.7 KiB
ЛР3 — две API-реплики
Кузнецов Даниил Русланович, БПИ2304. На 3.
Запуск
Нужны Python 3.13, Git и Docker с Compose. Из папки репозитория:
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 — лог |
| Авторизация, Unicode, конкуренция и идемпотентность | 27 тестов, PASS — лог |
| 20 одновременных повторов через обе реплики, rollback при ошибке | Без дублей — собственные тесты в общем логе |
| Рестарт API/БД/LB, старые токен, курсор и результат отправки | PASS — данные, контейнеры |
| Остановка каждой API-реплики | Восстановление до 10 с, без потери подтверждённых сообщений — JSON |
| TTL=2 на порту 18113, logout и повторные миграции | PASS — expiry, persistence |
| Остановка БД | live 200, ready/API 503, восстановление 200 — сводка |
Чистый клон коммита 09aece58fe4f06845d7c1be81b3a67ccd41574af прошёл полный прогон:
python -X utf8 scripts/lab.py verify --project kuznetsov-lab3-clean --port 18123 --test-port 18133.
Использованы новые секреты и volume. Лог,
сводка.
Hooks проверяют реальный контейнер текущего проекта. После отказа обе реплики восстанавливаются. Временный TTL-стенд освобождает свои сети, сохраняя volume.
Ограничения: один Docker-host, одна БД и LB; проверен отказ одной API за раз. HTTP только для локального учебного стенда. Redis, Swarm и rolling update не заявлены.
Основа — реализация Артура Югая. Для Даниила выделены отдельные настройки, секреты, порты, volumes и проверки. README задания, контракт и публичные тесты сохранены.