Files
mtusi2026lab3/REPORT.md

4.7 KiB
Raw Permalink Blame History

ЛР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 задания, контракт и публичные тесты сохранены.