Автор / группа: BVT2304, Шиян Максим Целевая оценка (3/4/5): 4 Трек 5, если заявлен: не заявлен (трек 5 выполнялся в ЛР 2; в ЛР 3 треков нет)
Что реализовано и что перенесено
Перенесено из ЛР 1 и ЛР 2 без изменений функциональности:
Контракт /api/v1/* полностью сохранён: пользователи, сессии (регистрация с паролем, вход, выход, отзыв), чаты, сообщения с пагинацией, вложения не требуются в ЛР 2 — перенесена вся рабочая логика ЛР 2.
Аутентификация: Basic на /auth/sessions, Bearer на защищённых путях, отзыв сессий, идемпотентная инвалидация кэша при выходе (с ретраями DEL и честными 503).
Источник истины — PostgreSQL; Redis — кэш сессий и истории с версионированной инвалидацией и защитой от stampede (single-flight).
Миграции 0001_init.sql, 0002_idempotency.sql идемпотентны и применимы с пустого volume.
Добавлено в ЛР 3 (уровень 4):
Горизонтальное масштабирование:
Две реплики приложения (mtusi-app-1, mtusi-app-2) за балансировщиком nginx на порту 8080.
Реплики не публикуют порты наружу — единственный вход через балансировщик.
Все реплики работают с общей БД и общим кэшем — состояние не хранится локально.
Идемпотентность POST /api/v1/chats/{chatId}/messages:
Заголовок Idempotency-Key обязателен (без него 400).
Уникальный индекс (chat_id, sender_id, idempotency_key) + INSERT ... ON CONFLICT DO NOTHING + повторный SELECT существующей строки.
Ключи не удаляются автоматически — повтор в любой момент возвращает тот же результат.
Идентификация реплики: заголовок X-Instance-Id в каждом ответе — равен hostname контейнера.
Отказоустойчивость:
/health/live и /health/ready раздельные; ready проверяет БД.
Балансировщик использует max_fails + fail_timeout и proxy_next_upstream для быстрого переключения.
Зафиксировано время обнаружения отказа реплики: не более ~6–8 секунд до восстановления трафика.
Лимиты ресурсов реплик (память и CPU заданы в compose.yaml).
Контроль обновлений:docker compose up -d --build app пересоздаёт реплики; при наличии двух реплик и балансировщика обновление проходит с минимальным количеством ошибок на клиенте.
Правила переноса соблюдены: изменения вносятся поверх кода предыдущей лабы, контракт не менялся, публичные тесты tests/* не изменялись.
Команды запуска из чистого clone
git clone <URL_репозитория> &&cd <каталог>
cp .env.example .env # секреты создаются локально, в Git не коммитятся# Сборка и запуск стенда (2 реплики + балансировщик + БД + кэш)
docker compose up --build -d
docker compose ps # все сервисы должны быть здоровы# Проверки
make check # офлайн-проверка контракта (валидация схемы)
make test# публичный функциональный тест против стенда
make test-resilience ACTION_SCRIPT=scripts/stop-one.bat
# сценарий отказа одной реплики# Демонстрация идемпотентности и балансировки# см. scripts/ и REPORT.md — команды и ожидаемый вывод# Остановка
docker compose down # данные сохраняются
docker compose down -v # намеренное удаление учебных данных
## Лабораторная 3
**Автор / группа:** BVT2304, Шиян Максим
**Целевая оценка (3/4/5):** 4
**Трек 5, если заявлен:** не заявлен (трек 5 выполнялся в ЛР 2; в ЛР 3 треков нет)
---
### Что реализовано и что перенесено
**Перенесено из ЛР 1 и ЛР 2 без изменений функциональности:**
- Контракт `/api/v1/*` полностью сохранён: пользователи, сессии (регистрация с паролем, вход, выход, отзыв), чаты, сообщения с пагинацией, вложения не требуются в ЛР 2 — перенесена вся рабочая логика ЛР 2.
- Аутентификация: `Basic` на `/auth/sessions`, `Bearer` на защищённых путях, отзыв сессий, идемпотентная инвалидация кэша при выходе (с ретраями `DEL` и честными 503).
- Источник истины — PostgreSQL; Redis — кэш сессий и истории с версионированной инвалидацией и защитой от stampede (single-flight).
- Миграции `0001_init.sql`, `0002_idempotency.sql` идемпотентны и применимы с пустого volume.
**Добавлено в ЛР 3 (уровень 4):**
1. **Горизонтальное масштабирование:**
- Две реплики приложения (`mtusi-app-1`, `mtusi-app-2`) за балансировщиком **nginx** на порту 8080.
- Реплики не публикуют порты наружу — единственный вход через балансировщик.
- Все реплики работают с общей БД и общим кэшем — состояние не хранится локально.
2. **Идемпотентность `POST /api/v1/chats/{chatId}/messages`:**
- Заголовок `Idempotency-Key` обязателен (без него 400).
- Уникальный индекс `(chat_id, sender_id, idempotency_key)` + `INSERT ... ON CONFLICT DO NOTHING` + повторный `SELECT` существующей строки.
- Ключи не удаляются автоматически — повтор в любой момент возвращает тот же результат.
3. **Идентификация реплики:** заголовок `X-Instance-Id` в каждом ответе — равен `hostname` контейнера.
4. **Отказоустойчивость:**
- `/health/live` и `/health/ready` раздельные; `ready` проверяет БД.
- Балансировщик использует `max_fails` + `fail_timeout` и `proxy_next_upstream` для быстрого переключения.
- Зафиксировано время обнаружения отказа реплики: не более ~6–8 секунд до восстановления трафика.
5. **Лимиты ресурсов реплик** (память и CPU заданы в `compose.yaml`).
6. **Контроль обновлений:** `docker compose up -d --build app` пересоздаёт реплики; при наличии двух реплик и балансировщика обновление проходит с минимальным количеством ошибок на клиенте.
**Правила переноса соблюдены:** изменения вносятся поверх кода предыдущей лабы, контракт не менялся, публичные тесты `tests/*` не изменялись.
---
### Команды запуска из чистого clone
```bash
git clone <URL_репозитория> && cd <каталог>
cp .env.example .env # секреты создаются локально, в Git не коммитятся
# Сборка и запуск стенда (2 реплики + балансировщик + БД + кэш)
docker compose up --build -d
docker compose ps # все сервисы должны быть здоровы
# Проверки
make check # офлайн-проверка контракта (валидация схемы)
make test # публичный функциональный тест против стенда
make test-resilience ACTION_SCRIPT=scripts/stop-one.bat
# сценарий отказа одной реплики
# Демонстрация идемпотентности и балансировки
# см. scripts/ и REPORT.md — команды и ожидаемый вывод
# Остановка
docker compose down # данные сохраняются
docker compose down -v # намеренное удаление учебных данных
nginx.conf:8: после замены двух API-контейнеров все 40 проверочных запросов через nginx обслужила только одна из двух работоспособных новых реплик. Настройте обновление адресов upstream при замене и масштабировании контейнеров. Подтвердите, что после этих операций запросы поступают на каждую здоровую реплику.
compose.yaml:40: ограничения ресурсов заданы только для API. Добавьте ограничения CPU и RAM остальным сервисам стенда, включая PostgreSQL, Redis, nginx и контейнер миграций.
main.go:87: каждая API-реплика запускает миграции при обычном старте, несмотря на наличие отдельного режима migrate-only. Блокировка лишь выполняет эти запуски последовательно. Вынесите миграции в отдельный однократный этап перед запуском API, уберите их из обычного старта реплик и опишите порядок запуска.
- [nginx.conf:8](https://gitea.privcloud.tech/BVT2304_Shiyan/mtusi2026lab3/src/commit/093602c18b89fee36082b32ae578d76ff71c3185/nginx.conf#L8): после замены двух API-контейнеров все 40 проверочных запросов через nginx обслужила только одна из двух работоспособных новых реплик. Настройте обновление адресов upstream при замене и масштабировании контейнеров. Подтвердите, что после этих операций запросы поступают на каждую здоровую реплику.
- [compose.yaml:40](https://gitea.privcloud.tech/BVT2304_Shiyan/mtusi2026lab3/src/commit/093602c18b89fee36082b32ae578d76ff71c3185/compose.yaml#L40): ограничения ресурсов заданы только для API. Добавьте ограничения CPU и RAM остальным сервисам стенда, включая PostgreSQL, Redis, nginx и контейнер миграций.
- [main.go:87](https://gitea.privcloud.tech/BVT2304_Shiyan/mtusi2026lab3/src/commit/093602c18b89fee36082b32ae578d76ff71c3185/src/cmd/server/main.go#L87): каждая API-реплика запускает миграции при обычном старте, несмотря на наличие отдельного режима migrate-only. Блокировка лишь выполняет эти запуски последовательно. Вынесите миграции в отдельный однократный этап перед запуском API, уберите их из обычного старта реплик и опишите порядок запуска.
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
Автор / группа: BVT2304, Шиян Максим
Целевая оценка (3/4/5): 4
Трек 5, если заявлен: не заявлен (трек 5 выполнялся в ЛР 2; в ЛР 3 треков нет)
Что реализовано и что перенесено
Перенесено из ЛР 1 и ЛР 2 без изменений функциональности:
/api/v1/*полностью сохранён: пользователи, сессии (регистрация с паролем, вход, выход, отзыв), чаты, сообщения с пагинацией, вложения не требуются в ЛР 2 — перенесена вся рабочая логика ЛР 2.Basicна/auth/sessions,Bearerна защищённых путях, отзыв сессий, идемпотентная инвалидация кэша при выходе (с ретраямиDELи честными 503).0001_init.sql,0002_idempotency.sqlидемпотентны и применимы с пустого volume.Добавлено в ЛР 3 (уровень 4):
mtusi-app-1,mtusi-app-2) за балансировщиком nginx на порту 8080.POST /api/v1/chats/{chatId}/messages:Idempotency-Keyобязателен (без него 400).(chat_id, sender_id, idempotency_key)+INSERT ... ON CONFLICT DO NOTHING+ повторныйSELECTсуществующей строки.X-Instance-Idв каждом ответе — равенhostnameконтейнера./health/liveи/health/readyраздельные;readyпроверяет БД.max_fails+fail_timeoutиproxy_next_upstreamдля быстрого переключения.compose.yaml).docker compose up -d --build appпересоздаёт реплики; при наличии двух реплик и балансировщика обновление проходит с минимальным количеством ошибок на клиенте.Правила переноса соблюдены: изменения вносятся поверх кода предыдущей лабы, контракт не менялся, публичные тесты
tests/*не изменялись.Команды запуска из чистого clone
lab3-4 оценкаto Shiyan lab3-4 оценкаИсправил
Принято. Закрываю МР.
Pull request closed