Общие сессии и ключ идемпотентности позволяют продолжать чтение и запись, когда одна реплика остановлена.
3.5 KiB
Лабораторная 3
Автор / группа: Колмычков Иван Сергеевич, БВТ2303 Целевая оценка (3/4/5): 4 Трек 5, если заявлен: не заявлен
Что реализовано и что перенесено: из lab2 перенесены PostgreSQL, Redis с AOF, Argon2id, Basic → Bearer и миграции. Добавлены HAProxy как единственная точка входа, две реплики API без published port, общий Redis для сессий, X-Instance-Id, обязательный Idempotency-Key на отправку сообщения и однократный сервис migrate. Отказ одной реплики, перезапуск стенда и поочерёдная замена контейнеров описаны скриптами scripts/stop-one.sh, scripts/restart.sh, scripts/rolling-update.sh.
Команды запуска из чистого clone:
cp .env.example .env
# Подставить локальные пароли в .env. Файл не коммитить.
docker compose --env-file .env config --quiet
docker compose --env-file .env up -d --build
make test
make test-persistence ACTION_SCRIPT=scripts/restart.sh
make test-failover ACTION_SCRIPT=scripts/stop-one.sh
Результаты проверок и ссылка на REPORT.md: подробности и числа в REPORT.md. make check и make test прошли. Persistence сохранил токен и сообщения. Failover каждой реплики: 2 экземпляра до отказа, восстановление записи за 0.209 с и 2.435 с, по одной ошибке. Гонка одного ключа: 12 параллельных POST, один id (evidence/grade4.json). Rolling update под нагрузкой: 14411 успешных и 61 ошибка (evidence/rolling-load.json).
Ограничения / известные ошибки: стенд переживает смерть одного процесса API и перезапуск контейнеров с теми же volumes. Потеря компьютера не переживается: HAProxy, PostgreSQL и Redis в одном экземпляре. X-Instance-Id равен hostname контейнера. Повтор после таймаута безопасен только для POST сообщения с тем же ключом и телом.
Источники и использование ИИ: контракт репозитория, документация HAProxy 2.8 и Docker Compose. Нейросети помогали с написанием кода, написанием отчета, написанием тестов. Числа в отчёте сняты на локальном стенде.
- Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
- Контракт и публичные тесты не ослаблены.
- make check и make test выполнены; приложен реальный вывод.
- Сценарии отказов/безопасности своего уровня воспроизведены.
- Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
- README задания сохранён, REPORT.md содержит инструкцию именно моего решения.