# ЛР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) | Чистый клон коммита `09aece58fe4f06845d7c1be81b3a67ccd41574af` прошёл полный прогон: `python -X utf8 scripts/lab.py verify --project kuznetsov-lab3-clean --port 18123 --test-port 18133`. Использованы новые секреты и volume. [Лог](evidence/clean-clone-verification.txt), [сводка](evidence/clean-clone-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 задания, контракт и публичные тесты сохранены.