ЛР3 - БПИ2303 - Стругов - на 4 #127

Closed
wand3r wants to merge 1 commits from wand3r/mtusi2026lab3-fork:solution/bpi2303-strugov into main
First-time contributor

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

Автор / группа: Стругов Максим БПИ2303
Целевая оценка (3/4/5): 4

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

Перенесено из лабораторной №2:

  • REST API мессенджера на Go: регистрация, авторизация, пользователи, чаты и сообщения.
  • PostgreSQL как основное хранилище данных, Redis как необязательный кэш.
  • Bearer-сессии, проверка прав доступа, хеширование паролей Argon2id.
  • Миграции базы данных через golang-migrate, Dockerfile, healthcheck и graceful shutdown.

Реализовано в лабораторной №3 (цель — оценка 4):

  • Запуск двух реплик Go API через Docker Compose.
  • Балансировка HTTP-запросов между репликами через Nginx.
  • Динамическое обнаружение реплик через Docker DNS.
  • Заголовок X-Instance-Id для определения обработавшей запрос реплики.
  • Идемпотентное создание сообщений по Idempotency-Key с защитой от конкурентных дубликатов на уровне PostgreSQL.
  • Отдельный однократный сервис migrate для применения миграций перед запуском API.
  • Скрипты проверки персистентности, отказоустойчивости и поочерёдной замены реплик.
  • Проверка rolling update под нагрузкой без остановки всего сервиса.
  • Ограничение доступа к секретам и отсутствие публикации PostgreSQL, Redis и API напрямую на хост.

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

Требуются Docker Engine, Docker Compose plugin и Python 3.9+ для тестов. Устанавливать Go на хост необязательно.

cp .env.example .env
./scripts/init-secrets.sh

docker compose --env-file .env config --quiet
docker compose --env-file .env up -d --build --scale api=2 --wait

make check
make validate
make test

Дополнительные проверки:

make test-persistence ACTION_SCRIPT=scripts/restart.sh
make test-failover ACTION_SCRIPT=scripts/stop-one.sh
./scripts/restore.sh

Приложение доступно через Nginx по адресу http://localhost:8080.

Остановка без удаления данных:

docker compose down

Результаты проверок

Подробный отчёт: REPORT.md

Результаты:

  • make check — PASS.
  • make validate — PASS.
  • make test — PASS.
  • Persistence — PASS, подтверждено сохранение данных и действующей сессии после перезапуска.
  • Failover — PASS: 115 успешных записей, 0 ошибок, первое восстановление за 0,474 с.
  • Конкурентная идемпотентность — PASS: 20 параллельных запросов с одинаковым ключом привели к созданию одного сообщения.
  • Проверена работа двух реплик и распределение запросов через Nginx.
  • Миграции PostgreSQL — версия 2, dirty=false.
  • Перезапуск API с ограниченными правами доступа к секретам — успешно, обе реплики healthy.

Нагрузочное тестирование:

  • Базовый тест (30 с, concurrency=4): 11 816 успешных запросов, 0 ошибок, 393,589 RPS, p95=27,642 мс.
  • Первый rolling update выявил проблему Nginx: 5 661 ошибка (14,06%).
  • После изменения конфигурации Nginx повторный rolling update (90 с, concurrency=4): 35 685 успешных запросов, 0 ошибок, 396,409 RPS, p95=25,782 мс, p99=39,431 мс.
  • Обе реплики последовательно заменены под нагрузкой, сервис продолжал обслуживать запросы.

Выводы выполненных тестов сохранены в evidence/. Подробности экспериментов и ограничения приведены в REPORT.md.

Ограничения / известные ошибки

  • Nginx и PostgreSQL остаются едиными точками отказа (SPOF); отказоустойчивость всего хоста не реализована.
  • Проверена поочерёдная замена контейнеров с текущим образом, но не обновление между двумя различными версиями приложения.
  • Миграция 0002_idempotency является добавочной, однако совместимость старой версии API с новой схемой экспериментально не проверялась.
  • Nginx использует DNS-обнаружение реплик и повторные попытки подключения, но не имеет отдельного активного health probe. Нулевая доля ошибок подтверждена для конкретного нагрузочного прогона, а не гарантирована при любых условиях.
  • Автоматическая очистка устаревших ключей идемпотентности не реализована.
  • Redis не используется для принятия решений об авторизации: проверка сессий через PostgreSQL увеличивает нагрузку на базу данных.
  • Высокая доступность PostgreSQL и Nginx, а также полноценное развёртывание новой версии без прерывания соединений остаются за пределами работы.

Источники и использование ИИ

Источники:

  • Контракты и требования курса (contracts/, README репозитория).
  • Официальная документация Go, PostgreSQL, Redis, Docker Compose и Nginx.
  • Документация используемых Go-библиотек: pgx/v5, golang-migrate, go-redis/v9.

Использование ИИ:

  • ChatGPT (OpenAI) применялся для консультаций по архитектуре, реализации и анализу Go-кода, Docker Compose, Nginx, миграций и тестирования.

  • ИИ помогал разбирать ошибки при запуске и rolling update, формировать проверки и документировать результаты.

  • Фактические испытания выполнялись на локальном Docker-хосте; результаты проверялись по выводу команд, логам и файлам evidence/.

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.

  • Контракт и публичные тесты не ослаблены.

  • make check и make test выполнены; приложен реальный вывод.

  • Сценарии отказов/безопасности своего уровня воспроизведены.

  • Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.

  • README задания сохранён, REPORT.md содержит инструкцию именно моего решения.

## Лабораторная 3 Автор / группа: Стругов Максим БПИ2303 Целевая оценка (3/4/5): 4 ### Что реализовано и что перенесено **Перенесено из лабораторной №2:** - REST API мессенджера на Go: регистрация, авторизация, пользователи, чаты и сообщения. - PostgreSQL как основное хранилище данных, Redis как необязательный кэш. - Bearer-сессии, проверка прав доступа, хеширование паролей Argon2id. - Миграции базы данных через `golang-migrate`, Dockerfile, healthcheck и graceful shutdown. **Реализовано в лабораторной №3 (цель — оценка 4):** - Запуск двух реплик Go API через Docker Compose. - Балансировка HTTP-запросов между репликами через Nginx. - Динамическое обнаружение реплик через Docker DNS. - Заголовок `X-Instance-Id` для определения обработавшей запрос реплики. - Идемпотентное создание сообщений по `Idempotency-Key` с защитой от конкурентных дубликатов на уровне PostgreSQL. - Отдельный однократный сервис `migrate` для применения миграций перед запуском API. - Скрипты проверки персистентности, отказоустойчивости и поочерёдной замены реплик. - Проверка rolling update под нагрузкой без остановки всего сервиса. - Ограничение доступа к секретам и отсутствие публикации PostgreSQL, Redis и API напрямую на хост. ### Команды запуска из чистого clone Требуются Docker Engine, Docker Compose plugin и Python 3.9+ для тестов. Устанавливать Go на хост необязательно. ```bash cp .env.example .env ./scripts/init-secrets.sh docker compose --env-file .env config --quiet docker compose --env-file .env up -d --build --scale api=2 --wait make check make validate make test ``` Дополнительные проверки: ```bash make test-persistence ACTION_SCRIPT=scripts/restart.sh make test-failover ACTION_SCRIPT=scripts/stop-one.sh ./scripts/restore.sh ``` Приложение доступно через Nginx по адресу `http://localhost:8080`. Остановка без удаления данных: ```bash docker compose down ``` ### Результаты проверок Подробный отчёт: REPORT.md **Результаты:** - `make check` — PASS. - `make validate` — PASS. - `make test` — PASS. - Persistence — PASS, подтверждено сохранение данных и действующей сессии после перезапуска. - Failover — PASS: 115 успешных записей, 0 ошибок, первое восстановление за 0,474 с. - Конкурентная идемпотентность — PASS: 20 параллельных запросов с одинаковым ключом привели к созданию одного сообщения. - Проверена работа двух реплик и распределение запросов через Nginx. - Миграции PostgreSQL — версия 2, `dirty=false`. - Перезапуск API с ограниченными правами доступа к секретам — успешно, обе реплики `healthy`. **Нагрузочное тестирование:** - Базовый тест (30 с, concurrency=4): 11 816 успешных запросов, 0 ошибок, 393,589 RPS, p95=27,642 мс. - Первый rolling update выявил проблему Nginx: 5 661 ошибка (14,06%). - После изменения конфигурации Nginx повторный rolling update (90 с, concurrency=4): 35 685 успешных запросов, 0 ошибок, 396,409 RPS, p95=25,782 мс, p99=39,431 мс. - Обе реплики последовательно заменены под нагрузкой, сервис продолжал обслуживать запросы. Выводы выполненных тестов сохранены в `evidence/`. Подробности экспериментов и ограничения приведены в `REPORT.md`. ### Ограничения / известные ошибки - Nginx и PostgreSQL остаются едиными точками отказа (SPOF); отказоустойчивость всего хоста не реализована. - Проверена поочерёдная замена контейнеров с текущим образом, но не обновление между двумя различными версиями приложения. - Миграция `0002_idempotency` является добавочной, однако совместимость старой версии API с новой схемой экспериментально не проверялась. - Nginx использует DNS-обнаружение реплик и повторные попытки подключения, но не имеет отдельного активного health probe. Нулевая доля ошибок подтверждена для конкретного нагрузочного прогона, а не гарантирована при любых условиях. - Автоматическая очистка устаревших ключей идемпотентности не реализована. - Redis не используется для принятия решений об авторизации: проверка сессий через PostgreSQL увеличивает нагрузку на базу данных. - Высокая доступность PostgreSQL и Nginx, а также полноценное развёртывание новой версии без прерывания соединений остаются за пределами работы. ### Источники и использование ИИ **Источники:** - Контракты и требования курса (`contracts/`, README репозитория). - Официальная документация Go, PostgreSQL, Redis, Docker Compose и Nginx. - Документация используемых Go-библиотек: `pgx/v5`, `golang-migrate`, `go-redis/v9`. **Использование ИИ:** - ChatGPT (OpenAI) применялся для консультаций по архитектуре, реализации и анализу Go-кода, Docker Compose, Nginx, миграций и тестирования. - ИИ помогал разбирать ошибки при запуске и rolling update, формировать проверки и документировать результаты. - Фактические испытания выполнялись на локальном Docker-хосте; результаты проверялись по выводу команд, логам и файлам `evidence/`. - [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. - [x] Контракт и публичные тесты не ослаблены. - [x] make check и make test выполнены; приложен реальный вывод. - [x] Сценарии отказов/безопасности своего уровня воспроизведены. - [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. - [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
wand3r added 1 commit 2026-11-10 15:24:12 +03:00
Owner

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

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

Pull request closed

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

No dependencies set.

Reference: mtusi2026/mtusi2026lab3#127