Files
mtusi2026lab3/REPORT.md
T

1.8 KiB

Отчёт — лабораторная 3

  • Автор, группа: Пойлов А.А., БПИ2303
  • Целевая оценка: 3. Трек 5 не выбран.
  • Commit/PR: <ссылка на PR после публикации>
  • Использованные источники, библиотеки и помощь ИИ:
    • Spring Boot 3.3.0, Spring Data JPA, Spring Security, Flyway, PostgreSQL 15, Nginx 1.25, Docker Compose.
    • Официальная документация Nginx (директивы upstream, proxy_next_upstream) и Docker Compose (--scale).
    • Помощь ИИ (Claude) при настройке отказоустойчивости Nginx и отладке конкурентной идемпотентности.

Запуск из чистого clone

Prerequisites: JDK 21, Maven 3.9+ (или mvnw), Docker Desktop, Python 3.9+.

Версии образов (закреплены):

  • maven:3.9.9-eclipse-temurin-21 (сборка)
  • eclipse-temurin:21-jre-alpine (runtime)
  • postgres:15-alpine (база данных)
  • nginx:1.25-alpine (балансировщик)

Команды:

# 1. Клонировать и перейти в ветку
git clone <URL форка>
cd mtusi2026lab3
git checkout solution/bpi2303-poylov
cp .env.example .env

# 2. Запустить 2 реплики API и Nginx
docker compose up -d --build --scale api=2

# 3. Дождаться готовности (около 20-30 сек)
# Проверка: curl -i http://localhost:8080/health/ready

# 4. Прогнать тесты (на Windows перед Python нужен export PYTHONUTF8=1)
export PYTHONUTF8=1
make test PYTHON=python
make test-persistence ACTION_SCRIPT=scripts/restart.cmd PYTHON=python
make test-failover ACTION_SCRIPT=scripts/stop-one.cmd PYTHON=python