Shiyan lab3-4 оценка #28

Closed
BVT2304_Shiyan wants to merge 2 commits from BVT2304_Shiyan/mtusi2026lab3:solution/BVT2304-Shiyan into main
First-time contributor

Лабораторная 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

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 # намеренное удаление учебных данных
BVT2304_Shiyan added 1 commit 2026-10-21 13:38:11 +03:00
BVT2304_Shiyan changed title from lab3-4 оценка to Shiyan lab3-4 оценка 2026-10-22 12:19:11 +03:00
Owner
  • 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, уберите их из обычного старта реплик и опишите порядок запуска.
BVT2304_Shiyan added 1 commit 2026-10-25 13:15:27 +03:00
Author
First-time contributor

Исправил

Исправил
Owner

Принято. Закрываю МР.

Принято. Закрываю МР.
veprickiy closed this pull request 2026-10-31 00:08:59 +03:00

Pull request closed

Please reopen this pull request to perform a merge.
Sign in to join this conversation.
No Reviewers
No labels
3 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: mtusi2026/mtusi2026lab3#28