FastAPI + PostgreSQL как единый источник истины: пользователи, Basic/Bearer-сессии, чаты, сообщения. Сессии и идемпотентные ключи хранятся в БД, поэтому реплики взаимозаменяемы. Общая идемпотентность POST сообщения по Idempotency-Key, включая конкурентный повтор через разные реплики. compose.yaml: postgres, one-shot migrate, api1, api2 и nginx как единственная публичная точка входа. Добавлены scripts/stop-one.sh и scripts/restart.sh, student-tests, evidence и заполненный REPORT.md.
Лабораторная 3
Автор / группа: Ким Владимир, БВТ2302
Целевая оценка (3/4/5): 3
Трек 5, если заявлен: -
Что реализовано и что перенесено:
REST API на FastAPI: пользователи, Basic → Bearer-сессии (scrypt-пароли, SHA-256 токена в БД), чаты, сообщения, health. Keyset-пагинация, единый формат ошибок, X-Request-Id/X-Instance-Id. PostgreSQL — единственное состояние; локальных сессий и идемпотентных ключей в API нет. Идемпотентность через PK (user_id, method, path, key) и одну транзакцию «сообщение + ответ», TTL 24 ч, 409 при другом body. Инфраструктура: postgres, one-shot migrate с advisory lock, api1, api2, nginx — единственный публичный порт :8080; healthchecks, лимиты CPU/RAM, graceful shutdown. Отдельного кода lab2 в репозитории нет, его минимум реализован здесь же.
Команды запуска из чистого clone:
cp .env.example .env
docker compose --env-file .env up -d --build
curl -fsS http://localhost:8080/health/ready
make check
make test
make test-persistence ACTION_SCRIPT=scripts/restart.sh
make test-failover ACTION_SCRIPT=scripts/stop-one.sh
Результаты проверок и ссылка на REPORT.md:
make check — PASS, smoke — PASS. Одна сессия обслуживается api-1 и api-2 без повторного входа. Отказ каждой реплики: 85–90 записей, 0 ошибок, восстановление ~0.55 с, подтверждённые сообщения на месте, дублей нет. Persistence — PASS. 40 конкурентных POST с одним ключом дали ровно одно сообщение. Нагрузка 15 с / 4 потока: 3722 запроса, 0 ошибок, 247.6 RPS, p95 32 мс. Сырые выводы — в evidence/.
Ограничения / известные ошибки:
Один Docker-host: PostgreSQL и nginx — SPOF, отказ узла не выдерживается. После восстановления реплика может отсутствовать в пуле до fail_timeout=5s (лечится restart lb). Просроченные ключи чистятся лениво. Redis/Valkey, TLS, rate limiting, вложения, телеметрия не реализованы. На Windows-хосте нет make, поэтому цели выполнены эквивалентными командами (resilience — в Linux-контейнере); на Linux/macOS Makefile работает как есть.
Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
Контракт и публичные тесты не ослаблены.
make check и make test выполнены; приложен реальный вывод.
Сценарии отказов/безопасности своего уровня воспроизведены.
Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
FastAPI + PostgreSQL как единый источник истины: пользователи, Basic/Bearer-сессии, чаты, сообщения. Сессии и идемпотентные ключи хранятся в БД, поэтому реплики взаимозаменяемы. Общая идемпотентность POST сообщения по Idempotency-Key, включая конкурентный повтор через разные реплики. compose.yaml: postgres, one-shot migrate, api1, api2 и nginx как единственная публичная точка входа. Добавлены scripts/stop-one.sh и scripts/restart.sh, student-tests, evidence и заполненный REPORT.md.
## Лабораторная 3
Автор / группа: Ким Владимир, БВТ2302
Целевая оценка (3/4/5): 3
Трек 5, если заявлен: -
Что реализовано и что перенесено:
REST API на FastAPI: пользователи, Basic → Bearer-сессии (scrypt-пароли, SHA-256 токена в БД), чаты, сообщения, health. Keyset-пагинация, единый формат ошибок, X-Request-Id/X-Instance-Id. PostgreSQL — единственное состояние; локальных сессий и идемпотентных ключей в API нет. Идемпотентность через PK (user_id, method, path, key) и одну транзакцию «сообщение + ответ», TTL 24 ч, 409 при другом body. Инфраструктура: postgres, one-shot migrate с advisory lock, api1, api2, nginx — единственный публичный порт :8080; healthchecks, лимиты CPU/RAM, graceful shutdown. Отдельного кода lab2 в репозитории нет, его минимум реализован здесь же.
Команды запуска из чистого clone:
cp .env.example .env
docker compose --env-file .env up -d --build
curl -fsS http://localhost:8080/health/ready
make check
make test
make test-persistence ACTION_SCRIPT=scripts/restart.sh
make test-failover ACTION_SCRIPT=scripts/stop-one.sh
Результаты проверок и ссылка на REPORT.md:
make check — PASS, smoke — PASS. Одна сессия обслуживается api-1 и api-2 без повторного входа. Отказ каждой реплики: 85–90 записей, 0 ошибок, восстановление ~0.55 с, подтверждённые сообщения на месте, дублей нет. Persistence — PASS. 40 конкурентных POST с одним ключом дали ровно одно сообщение. Нагрузка 15 с / 4 потока: 3722 запроса, 0 ошибок, 247.6 RPS, p95 32 мс. Сырые выводы — в evidence/.
Ограничения / известные ошибки:
Один Docker-host: PostgreSQL и nginx — SPOF, отказ узла не выдерживается. После восстановления реплика может отсутствовать в пуле до fail_timeout=5s (лечится restart lb). Просроченные ключи чистятся лениво. Redis/Valkey, TLS, rate limiting, вложения, телеметрия не реализованы. На Windows-хосте нет make, поэтому цели выполнены эквивалентными командами (resilience — в Linux-контейнере); на Linux/macOS Makefile работает как есть.
Источники и использование ИИ:
contracts/,
README.md
, tests/; FastAPI 0.115.0, uvicorn 0.30.6, psycopg 3.2.3, PostgreSQL 16.4, Nginx 1.26.2. все проверки воспроизведены локально.
- [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
- [x] Контракт и публичные тесты не ослаблены.
- [x] make check и make test выполнены; приложен реальный вывод.
- [x] Сценарии отказов/безопасности своего уровня воспроизведены.
- [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
- [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
FastAPI + PostgreSQL как единый источник истины: пользователи, Basic/Bearer-сессии, чаты, сообщения. Сессии и идемпотентные ключи хранятся в БД, поэтому реплики взаимозаменяемы. Общая идемпотентность POST сообщения по Idempotency-Key, включая конкурентный повтор через разные реплики. compose.yaml: postgres, one-shot migrate, api1, api2 и nginx как единственная публичная точка входа. Добавлены scripts/stop-one.sh и scripts/restart.sh, student-tests, evidence и заполненный REPORT.md.
ddientee
changed title from Реализовать стенд лабораторной 3: две API-реплики и балансировка to ЛР 3 — БВТ2302 — Ким — на 32026-11-07 16:14:56 +03:00
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
FastAPI + PostgreSQL как единый источник истины: пользователи, Basic/Bearer-сессии, чаты, сообщения. Сессии и идемпотентные ключи хранятся в БД, поэтому реплики взаимозаменяемы. Общая идемпотентность POST сообщения по Idempotency-Key, включая конкурентный повтор через разные реплики. compose.yaml: postgres, one-shot migrate, api1, api2 и nginx как единственная публичная точка входа. Добавлены scripts/stop-one.sh и scripts/restart.sh, student-tests, evidence и заполненный REPORT.md.
Лабораторная 3
Автор / группа: Ким Владимир, БВТ2302
Целевая оценка (3/4/5): 3
Трек 5, если заявлен: -
Что реализовано и что перенесено:
REST API на FastAPI: пользователи, Basic → Bearer-сессии (scrypt-пароли, SHA-256 токена в БД), чаты, сообщения, health. Keyset-пагинация, единый формат ошибок, X-Request-Id/X-Instance-Id. PostgreSQL — единственное состояние; локальных сессий и идемпотентных ключей в API нет. Идемпотентность через PK (user_id, method, path, key) и одну транзакцию «сообщение + ответ», TTL 24 ч, 409 при другом body. Инфраструктура: postgres, one-shot migrate с advisory lock, api1, api2, nginx — единственный публичный порт :8080; healthchecks, лимиты CPU/RAM, graceful shutdown. Отдельного кода lab2 в репозитории нет, его минимум реализован здесь же.
Команды запуска из чистого clone:
cp .env.example .env
docker compose --env-file .env up -d --build
curl -fsS http://localhost:8080/health/ready
make check
make test
make test-persistence ACTION_SCRIPT=scripts/restart.sh
make test-failover ACTION_SCRIPT=scripts/stop-one.sh
Результаты проверок и ссылка на REPORT.md:
make check — PASS, smoke — PASS. Одна сессия обслуживается api-1 и api-2 без повторного входа. Отказ каждой реплики: 85–90 записей, 0 ошибок, восстановление ~0.55 с, подтверждённые сообщения на месте, дублей нет. Persistence — PASS. 40 конкурентных POST с одним ключом дали ровно одно сообщение. Нагрузка 15 с / 4 потока: 3722 запроса, 0 ошибок, 247.6 RPS, p95 32 мс. Сырые выводы — в evidence/.
Ограничения / известные ошибки:
Один Docker-host: PostgreSQL и nginx — SPOF, отказ узла не выдерживается. После восстановления реплика может отсутствовать в пуле до fail_timeout=5s (лечится restart lb). Просроченные ключи чистятся лениво. Redis/Valkey, TLS, rate limiting, вложения, телеметрия не реализованы. На Windows-хосте нет make, поэтому цели выполнены эквивалентными командами (resilience — в Linux-контейнере); на Linux/macOS Makefile работает как есть.
Источники и использование ИИ:
contracts/,
README.md
, tests/; FastAPI 0.115.0, uvicorn 0.30.6, psycopg 3.2.3, PostgreSQL 16.4, Nginx 1.26.2. все проверки воспроизведены локально.
Реализовать стенд лабораторной 3: две API-реплики и балансировкаto ЛР 3 — БВТ2302 — Ким — на 3Pull request closed