Из лабораторной №2 перенесены Spring Boot API, PostgreSQL-схема пользователей, сессий, чатов и сообщений, Bearer-аутентификация, Redis cache-aside и Flyway-миграции.
Основной стенд описан в compose.yaml: Nginx является единственной публичной точкой входа, за ним работают две stateless API-реплики с общей PostgreSQL и общим Redis.
Сессии и все данные, влияющие на корректность, хранятся в PostgreSQL; sticky session не используется. Реплики наблюдаются по X-Instance-Id.
Миграции вынесены в отдельный one-shot service migrate; в API-репликах Flyway отключён.
Реализована общая идемпотентность отправки сообщения через message_idempotency, SHA-256 тела и транзакционную PostgreSQL advisory-блокировку.
Добавлены action scripts остановки/восстановления выбранной API-реплики, последовательный failover обеих реплик и rolling replacement под нагрузкой.
Для трека 5 добавлен отдельный трёхузловой Swarm-стенд: один manager, два workers, локальный registry, перенос API task при жёсткой потере worker и проверка сохранности подтверждённых сообщений.
Дополнительные проверки находятся в student_tests; исходные публичные тесты остаются в tests, Spring-тесты — в src/test/java.
Команды запуска из чистого clone:
cp .env.example .env
задать локальный DATABASE_PASSWORD в .env
docker compose --env-file .env config --quiet
docker compose --env-file .env build api
docker compose --env-file .env up -d postgres redis
docker compose --env-file .env run --rm migrate
docker compose --env-file .env up -d --scale api=2 api nginx
curl --fail http://localhost:8080/health/ready
Проверки основного стенда:
make check
make test
make test-idempotency
make test-persistence ACTION_SCRIPT=scripts/restart.sh
make test-failover-each ACTION_SCRIPT=scripts/stop-one.sh RESTORE_SCRIPT=scripts/restore-api.sh
make test-rolling ACTION_SCRIPT=scripts/rolling-update.sh
make check — PASS; основной make test через Nginx — PASS: lab3 public API scenario.
Конкурентная идемпотентность — 32 одновременных запроса через две реплики создали одно сообщение.
Последовательная остановка обеих Compose-реплик — 0 ошибок, 10,839/10,014 successful RPS, первая успешная операция через 1,306/2,672 s.
Rolling replacement — четыре instance ID, 12 147 успешных записей, 177 ошибок, 67,439 successful RPS, error ratio 1,4362%.
Потеря Swarm worker — API task перенесена с worker2 на worker1; 165 чтений, 166 записей, 0 ошибок, первая успешная операция через 1,796 s; подтверждённые данные сохранены.
Полные команды, методика, raw JSON и объяснение архитектуры приведены в REPORT.md и каталоге evidence/.
Ограничения / известные ошибки:
PostgreSQL не реплицирован и остаётся SPOF; отказ его узла не проверялся и не заявляется (database_node_failed=false).
Nginx, единственный Swarm manager, Redis, локальные volumes, underlay и физический Docker host также остаются SPOF.
Nginx OSS использует пассивное runtime-исключение backend, а не активный health-check upstream.
Во время rolling replacement зафиксировано 1,4362% кратковременных ошибок; они намеренно не скрыты клиентским retry.
Swarm-опыт выполнен на DinD-узлах одного Windows/Docker Desktop host и не моделирует потерю разных физических серверов.
Источники и использование ИИ:
Использованы исходный skeleton лабораторной, её OpenAPI-контракт и стандартные open-source зависимости проекта: Spring Boot, PostgreSQL, Redis, Flyway, Nginx, Docker Compose и Docker Swarm.
ИИ применялся для обсуждения архитектуры Compose/Nginx, readiness и graceful shutdown, проектирования общей идемпотентности, подготовки дополнительных тестов и Swarm-сценария, анализа измерений и оформления документации.
Прикладной код готового стороннего сервера не заимствовался. Утверждения о поведении проверены запускаемыми сценариями и сохранёнными raw-результатами в evidence/.
Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
Контракт и публичные тесты не ослаблены.
make check и make test выполнены; приложен реальный вывод.
Сценарии отказов/безопасности своего уровня воспроизведены.
Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
## Лабораторная 3
Автор / группа: Антипин Егор Иванович, БПИ2301
Целевая оценка (3/4/5): 5
Трек 5, если заявлен: трек 2 — «Отказ узла»
Что реализовано и что перенесено:
- Из лабораторной №2 перенесены Spring Boot API, PostgreSQL-схема пользователей, сессий, чатов и сообщений, Bearer-аутентификация, Redis cache-aside и Flyway-миграции.
- Основной стенд описан в `compose.yaml`: Nginx является единственной публичной точкой входа, за ним работают две stateless API-реплики с общей PostgreSQL и общим Redis.
- Сессии и все данные, влияющие на корректность, хранятся в PostgreSQL; sticky session не используется. Реплики наблюдаются по `X-Instance-Id`.
- Миграции вынесены в отдельный one-shot service `migrate`; в API-репликах Flyway отключён.
- Настроены `least_conn`, динамическое обновление Docker DNS, readiness, таймауты, graceful shutdown и пассивное исключение недоступного backend.
- Реализована общая идемпотентность отправки сообщения через `message_idempotency`, SHA-256 тела и транзакционную PostgreSQL advisory-блокировку.
- Добавлены action scripts остановки/восстановления выбранной API-реплики, последовательный failover обеих реплик и rolling replacement под нагрузкой.
- Для трека 5 добавлен отдельный трёхузловой Swarm-стенд: один manager, два workers, локальный registry, перенос API task при жёсткой потере worker и проверка сохранности подтверждённых сообщений.
- Дополнительные проверки находятся в `student_tests`; исходные публичные тесты остаются в `tests`, Spring-тесты — в `src/test/java`.
Команды запуска из чистого clone:
cp .env.example .env
# задать локальный DATABASE_PASSWORD в .env
docker compose --env-file .env config --quiet
docker compose --env-file .env build api
docker compose --env-file .env up -d postgres redis
docker compose --env-file .env run --rm migrate
docker compose --env-file .env up -d --scale api=2 api nginx
curl --fail http://localhost:8080/health/ready
Проверки основного стенда:
make check
make test
make test-idempotency
make test-persistence ACTION_SCRIPT=scripts/restart.sh
make test-failover-each ACTION_SCRIPT=scripts/stop-one.sh RESTORE_SCRIPT=scripts/restore-api.sh
make test-rolling ACTION_SCRIPT=scripts/rolling-update.sh
Трёхузловой Swarm-эксперимент на Windows:
```powershell
make swarm-up
make test-node-failover PYTHON=python
make swarm-down
```
Результаты проверок и ссылка на REPORT.md:
- `make check` — PASS; основной `make test` через Nginx — `PASS: lab3 public API scenario`.
- Конкурентная идемпотентность — 32 одновременных запроса через две реплики создали одно сообщение.
- Последовательная остановка обеих Compose-реплик — 0 ошибок, 10,839/10,014 successful RPS, первая успешная операция через 1,306/2,672 s.
- Rolling replacement — четыре instance ID, 12 147 успешных записей, 177 ошибок, 67,439 successful RPS, error ratio 1,4362%.
- Потеря Swarm worker — API task перенесена с `worker2` на `worker1`; 165 чтений, 166 записей, 0 ошибок, первая успешная операция через 1,796 s; подтверждённые данные сохранены.
- Полные команды, методика, raw JSON и объяснение архитектуры приведены в [REPORT.md](https://gitea.privcloud.tech/Egor_Antipin/mtusi2026lab3/src/branch/solution/bpi2301-antipin/REPORT.md) и каталоге `evidence/`.
Ограничения / известные ошибки:
- PostgreSQL не реплицирован и остаётся SPOF; отказ его узла не проверялся и не заявляется (`database_node_failed=false`).
- Nginx, единственный Swarm manager, Redis, локальные volumes, underlay и физический Docker host также остаются SPOF.
- Nginx OSS использует пассивное runtime-исключение backend, а не активный health-check upstream.
- Во время rolling replacement зафиксировано 1,4362% кратковременных ошибок; они намеренно не скрыты клиентским retry.
- Swarm-опыт выполнен на DinD-узлах одного Windows/Docker Desktop host и не моделирует потерю разных физических серверов.
Источники и использование ИИ:
- Использованы исходный skeleton лабораторной, её OpenAPI-контракт и стандартные open-source зависимости проекта: Spring Boot, PostgreSQL, Redis, Flyway, Nginx, Docker Compose и Docker Swarm.
- ИИ применялся для обсуждения архитектуры Compose/Nginx, readiness и graceful shutdown, проектирования общей идемпотентности, подготовки дополнительных тестов и Swarm-сценария, анализа измерений и оформления документации.
- Прикладной код готового стороннего сервера не заимствовался. Утверждения о поведении проверены запускаемыми сценариями и сохранёнными raw-результатами в `evidence/`.
- [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
- [x] Контракт и публичные тесты не ослаблены.
- [x] make check и make test выполнены; приложен реальный вывод.
- [x] Сценарии отказов/безопасности своего уровня воспроизведены.
- [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
- [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
LB продолжает обслуживать запросы через неготовые API. Минимальное воспроизведение: временно переименовать message_idempotency, дождаться 35 с, запросить readiness и авторизованный /users/me. Обе API стали unhealthy, readiness вернул 503, но бизнес-запрос через LB получил 200. Ожидается исключение неготовых backend; при отсутствии готовых — отказ обслуживания. В infra/nginx.conf:20 настроено пассивное исключение по ошибкам запросов, без связи с readiness. После опыта таблица восстановлена.
У PostgreSQL и Redis основного Compose-стенда нет CPU/RAM-лимитов. После документированного запуска docker inspect показал у обоих NanoCpus=0, Memory=0; ожидаются явные ограничения контейнеров уровня 4. См. compose.yaml:26 и compose.yaml:42. Лимиты API и Nginx применены корректно.
Небольшой недочёт воспроизводимости rolling-команды. В чистом checkout rolling-update.sh имеет режим 100644. Команда из REPORT.md:254 останавливается с FAIL: action script must be executable. Нужно сохранить executable bit либо добавить соответствующий chmod. Сам rolling-сценарий после этой адаптации прошёл.
Обнаруженные проблемы:
1. LB продолжает обслуживать запросы через неготовые API. Минимальное воспроизведение: временно переименовать message_idempotency, дождаться 35 с, запросить readiness и авторизованный /users/me. Обе API стали unhealthy, readiness вернул 503, но бизнес-запрос через LB получил 200. Ожидается исключение неготовых backend; при отсутствии готовых — отказ обслуживания. В [infra/nginx.conf:20](https://gitea.privcloud.tech/Egor_Antipin/mtusi2026lab3/src/commit/7080fdd3e28326f4f756a70f504efc5c3a13a7bb/infra/nginx.conf#L20) настроено пассивное исключение по ошибкам запросов, без связи с readiness. После опыта таблица восстановлена.
2. У PostgreSQL и Redis основного Compose-стенда нет CPU/RAM-лимитов. После документированного запуска docker inspect показал у обоих NanoCpus=0, Memory=0; ожидаются явные ограничения контейнеров уровня 4. См. [compose.yaml:26](https://gitea.privcloud.tech/Egor_Antipin/mtusi2026lab3/src/commit/7080fdd3e28326f4f756a70f504efc5c3a13a7bb/compose.yaml#L26) и [compose.yaml:42](https://gitea.privcloud.tech/Egor_Antipin/mtusi2026lab3/src/commit/7080fdd3e28326f4f756a70f504efc5c3a13a7bb/compose.yaml#L42). Лимиты API и Nginx применены корректно.
3. Небольшой недочёт воспроизводимости rolling-команды. В чистом checkout rolling-update.sh имеет режим 100644. Команда из [REPORT.md:254](https://gitea.privcloud.tech/Egor_Antipin/mtusi2026lab3/src/commit/7080fdd3e28326f4f756a70f504efc5c3a13a7bb/REPORT.md#L254) останавливается с FAIL: action script must be executable. Нужно сохранить executable bit либо добавить соответствующий chmod. Сам rolling-сценарий после этой адаптации прошёл.
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.
Лабораторная 3
Автор / группа: Антипин Егор Иванович, БПИ2301
Целевая оценка (3/4/5): 5
Трек 5, если заявлен: трек 2 — «Отказ узла»
Что реализовано и что перенесено:
compose.yaml: Nginx является единственной публичной точкой входа, за ним работают две stateless API-реплики с общей PostgreSQL и общим Redis.X-Instance-Id.migrate; в API-репликах Flyway отключён.least_conn, динамическое обновление Docker DNS, readiness, таймауты, graceful shutdown и пассивное исключение недоступного backend.message_idempotency, SHA-256 тела и транзакционную PostgreSQL advisory-блокировку.student_tests; исходные публичные тесты остаются вtests, Spring-тесты — вsrc/test/java.Команды запуска из чистого clone:
cp .env.example .env
задать локальный DATABASE_PASSWORD в .env
docker compose --env-file .env config --quiet
docker compose --env-file .env build api
docker compose --env-file .env up -d postgres redis
docker compose --env-file .env run --rm migrate
docker compose --env-file .env up -d --scale api=2 api nginx
curl --fail http://localhost:8080/health/ready
Проверки основного стенда:
make check
make test
make test-idempotency
make test-persistence ACTION_SCRIPT=scripts/restart.sh
make test-failover-each ACTION_SCRIPT=scripts/stop-one.sh RESTORE_SCRIPT=scripts/restore-api.sh
make test-rolling ACTION_SCRIPT=scripts/rolling-update.sh
Трёхузловой Swarm-эксперимент на Windows:
Результаты проверок и ссылка на REPORT.md:
make check— PASS; основнойmake testчерез Nginx —PASS: lab3 public API scenario.worker2наworker1; 165 чтений, 166 записей, 0 ошибок, первая успешная операция через 1,796 s; подтверждённые данные сохранены.evidence/.Ограничения / известные ошибки:
database_node_failed=false).Источники и использование ИИ:
Использованы исходный skeleton лабораторной, её OpenAPI-контракт и стандартные open-source зависимости проекта: Spring Boot, PostgreSQL, Redis, Flyway, Nginx, Docker Compose и Docker Swarm.
ИИ применялся для обсуждения архитектуры Compose/Nginx, readiness и graceful shutdown, проектирования общей идемпотентности, подготовки дополнительных тестов и Swarm-сценария, анализа измерений и оформления документации.
Прикладной код готового стороннего сервера не заимствовался. Утверждения о поведении проверены запускаемыми сценариями и сохранёнными raw-результатами в
evidence/.Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
Контракт и публичные тесты не ослаблены.
make check и make test выполнены; приложен реальный вывод.
Сценарии отказов/безопасности своего уровня воспроизведены.
Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
ЛР 3: масштабирование и отказоустойчивость APIto ЛР3 - БПИ2301 - Антипин- на 5Обнаруженные проблемы:
Принято. Закрываю МР.
Pull request closed