lab3 - БВТ2304 - Тюрина - оценка 4 #29

Closed
Rakshasa wants to merge 2 commits from Rakshasa/mtusi2026lab3-fork:solution/tyurina-bvt2304 into main
First-time contributor

Лабораторная 3

Автор / группа: Тюрина Александра, БВТ2304
Целевая оценка (3/4/5): 4
Трек 5, если заявлен: не заявлен

Что реализовано и что перенесено

Из лабораторной 2 перенесено:

  • PostgreSQL как источник истины для пользователей, чатов, участников, сообщений и сессий.
  • Миграция 001_initial.sql с таблицами и индексами.
  • Регистрация с паролем, хеширование через bcrypt.
  • Аутентификация: Basic только для POST /api/v1/auth/sessions, Bearer для бизнес-запросов.
  • Redis как кэш сессий с TTL и fallback в PostgreSQL.
  • Dockerfile: multi-stage build, non-root user, fixed base images, healthcheck.
  • Собственные тесты и вспомогательные скрипты.

Для лабораторной 3 добавлено:

  • compose.yaml с HAProxy load balancer и минимум двумя API-репликами.
  • Единая точка входа: клиент ходит только через HAProxy на 127.0.0.1:8080.
  • API-реплики не публикуют порты наружу в обход LB, используется только expose.
  • X-Instance-Id добавляется во все ответы API.
  • Обязательный Idempotency-Key для POST /api/v1/chats/{chat_id}/messages.
  • Миграция 002_idempotency.sql с таблицей idempotency_keys.
  • Общая идемпотентность через PostgreSQL: транзакция + pg_advisory_xact_lock по области user + method + path + key.
  • Миграции сериализованы через pg_advisory_lock, чтобы две реплики не применяли миграции одновременно.
  • Health-checks и readiness согласованы с HAProxy: inter 2s, fall 3, rise 2.
  • scripts/stop-one.sh останавливает одну работающую API-реплику.
  • scripts/restart.sh перезапускает стенд без удаления volumes.
  • CPU/RAM-лимиты заданы для всех сервисов.
  • container_name не используется, чтобы не ломать масштабирование Compose-сервиса.

Команды запуска из чистого clone

# 1. Клонирование
git clone <fork-url>
cd mtusi2026lab3-fork

# 2. Локальные секреты/переменные
# .env не коммитится; в репозитории есть только .env.example
cp .env.example .env

# 3. Проверка целостности skeleton/контракта
make check

# 4. Валидация Compose
docker compose --env-file .env config --quiet

# 5. Сборка и запуск стенда
docker compose --env-file .env up -d --build

# 6. Ожидание готовности
docker compose ps

# 7. Публичный smoke
make test

# 8. Failover-проверка
make test-failover ACTION_SCRIPT=scripts/stop-one.sh

# 9. Безопасная остановка без удаления данных
docker compose down

# 10. Намеренное удаление учебных данных
docker compose down -v
## Лабораторная 3 Автор / группа: Тюрина Александра, БВТ2304 Целевая оценка (3/4/5): 4 Трек 5, если заявлен: не заявлен ### Что реализовано и что перенесено Из лабораторной 2 перенесено: - PostgreSQL как источник истины для пользователей, чатов, участников, сообщений и сессий. - Миграция `001_initial.sql` с таблицами и индексами. - Регистрация с паролем, хеширование через bcrypt. - Аутентификация: Basic только для `POST /api/v1/auth/sessions`, Bearer для бизнес-запросов. - Redis как кэш сессий с TTL и fallback в PostgreSQL. - Dockerfile: multi-stage build, non-root user, fixed base images, healthcheck. - Собственные тесты и вспомогательные скрипты. Для лабораторной 3 добавлено: - `compose.yaml` с HAProxy load balancer и минимум двумя API-репликами. - Единая точка входа: клиент ходит только через HAProxy на `127.0.0.1:8080`. - API-реплики не публикуют порты наружу в обход LB, используется только `expose`. - `X-Instance-Id` добавляется во все ответы API. - Обязательный `Idempotency-Key` для `POST /api/v1/chats/{chat_id}/messages`. - Миграция `002_idempotency.sql` с таблицей `idempotency_keys`. - Общая идемпотентность через PostgreSQL: транзакция + `pg_advisory_xact_lock` по области `user + method + path + key`. - Миграции сериализованы через `pg_advisory_lock`, чтобы две реплики не применяли миграции одновременно. - Health-checks и readiness согласованы с HAProxy: `inter 2s`, `fall 3`, `rise 2`. - `scripts/stop-one.sh` останавливает одну работающую API-реплику. - `scripts/restart.sh` перезапускает стенд без удаления volumes. - CPU/RAM-лимиты заданы для всех сервисов. - `container_name` не используется, чтобы не ломать масштабирование Compose-сервиса. ### Команды запуска из чистого clone ```bash # 1. Клонирование git clone <fork-url> cd mtusi2026lab3-fork # 2. Локальные секреты/переменные # .env не коммитится; в репозитории есть только .env.example cp .env.example .env # 3. Проверка целостности skeleton/контракта make check # 4. Валидация Compose docker compose --env-file .env config --quiet # 5. Сборка и запуск стенда docker compose --env-file .env up -d --build # 6. Ожидание готовности docker compose ps # 7. Публичный smoke make test # 8. Failover-проверка make test-failover ACTION_SCRIPT=scripts/stop-one.sh # 9. Безопасная остановка без удаления данных docker compose down # 10. Намеренное удаление учебных данных docker compose down -v
Rakshasa added 1 commit 2026-10-21 14:04:36 +03:00
Owner
  • Dockerfile:5: сборка останавливается на COPY go.mod go.sum ./, поскольку оба файла отсутствуют в репозитории. Добавьте файлы модуля и зависимостей либо исправьте пути на фактическое расположение закоммиченного модуля. Проверьте сборку стенда из чистого клона.
- [Dockerfile:5](https://gitea.privcloud.tech/Rakshasa/mtusi2026lab3-fork/src/commit/55788bb8238c40866aa4b72f1624c683702bb9e8/Dockerfile#L5): сборка останавливается на COPY go.mod go.sum ./, поскольку оба файла отсутствуют в репозитории. Добавьте файлы модуля и зависимостей либо исправьте пути на фактическое расположение закоммиченного модуля. Проверьте сборку стенда из чистого клона.
Rakshasa added 1 commit 2026-10-23 15:14:59 +03:00
Owner

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

Принято. Закрываю МР.
veprickiy closed this pull request 2026-10-31 00:08:58 +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#29