ЛР3 - БПИ2302 Федоров - на 3 #58

Open
Fedoroff wants to merge 3 commits from Fedoroff/mtusi2026lab3:solution/BPI2302-fedorov into main
First-time contributor

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

Автор / группа: Федоров Арсений, БПИ2302
Целевая оценка: 3
Трек 5, если заявлен: Не заявлен.

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

На основе лабораторной №2 реализована работа приложения с несколькими экземплярами API.

Реализовано в лабораторной №3:

  • Запуск двух экземпляров Go API (api1, api2).
  • Балансировка HTTP-запросов через Nginx.
  • Заголовок X-Instance-Id для определения экземпляра, обработавшего запрос.
  • Общие PostgreSQL и Redis для обоих экземпляров.
  • Идемпотентное создание сообщений с использованием Idempotency-Key.
  • Защита от дублирования сообщений при одновременных повторных запросах.
  • Отдельный сервис migrate для выполнения миграций БД.
  • Docker Compose для запуска инфраструктуры.
  • Скрипты для проверки остановки и восстановления экземпляров.

Сохранено из предыдущих лабораторных:

  • REST API пользователей, чатов и сообщений.
  • Регистрация, авторизация и работа с сессиями.
  • Хранение данных в PostgreSQL.
  • Использование Redis для сессий.
  • Валидация запросов и обработка ошибок.
  • Публичный API-контракт и тесты.

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

git clone https://gitea.privcloud.tech/Fedoroff/mtusi2026lab3.git
cd mtusi2026lab3
git switch solution/BPI2302-fedorov

Создать .env на основе .env.example, указать необходимые переменные окружения.

Запустить приложение:

docker compose --env-file .env up -d --build

Проверить контейнеры:

docker compose --env-file .env ps

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

Результаты проверок и ссылка на REPORT.md

Go-тесты:

docker run --rm -v "${PWD}:/app" -w /app golang:1.25.0-alpine go test ./...

Результат: все тесты успешно пройдены, ошибок FAIL нет.

Smoke-тест:

py -3 tests/smoke.py --base-url "http://localhost:8080"

Результат:

PASS: lab3 public API scenario; infrastructure and grading evidence remain separate.

Проверка идемпотентности:

py -3 tests/idempotency_concurrent.py --base-url "http://localhost:8080"

Результат:

PASS: 16 concurrent retries, one message, replicas: api1, api2

Балансировка: проверено распределение запросов между api1 и api2 по заголовку X-Instance-Id.

Отказоустойчивость: после остановки api1 запросы продолжили успешно обрабатываться экземпляром api2. После восстановления api1 оба экземпляра находились в состоянии healthy.

Отчёт: [REPORT.md](REPORT.md).

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

  • Решение ориентировано на локальный запуск через Docker Compose.
  • Балансировка выполняется одним экземпляром Nginx, поэтому сам балансировщик остаётся единой точкой отказа.
  • Проверена остановка одного экземпляра API; полная отказоустойчивость PostgreSQL, Redis и Nginx не реализована.
  • Полноценные нагрузочные испытания не проводились.
  • Другие известные ошибки по результатам выполненных проверок не обнаружены.

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

Источники:

  • Материалы и требования лабораторных работ №1–3.
  • Документация Go, PostgreSQL, Redis, Docker Compose и Nginx.
  • Публичный API-контракт проекта.

Использование ИИ: ChatGPT использовался для помощи в разработке Go-кода, конфигурации Docker Compose и Nginx, написании тестов, поиске и исправлении ошибок, подготовке документации. Работоспособность решения проверена локально с помощью Docker и автоматизированных тестов.

Чек-лист

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • make check и make test выполнены; приложен реальный вывод.
  • Сценарии отказов/безопасности своего уровня воспроизведены.
  • Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
  • README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
## Лабораторная 3 **Автор / группа:** Федоров Арсений, БПИ2302 **Целевая оценка:** 3 **Трек 5, если заявлен:** Не заявлен. ### Что реализовано и что перенесено На основе лабораторной №2 реализована работа приложения с несколькими экземплярами API. **Реализовано в лабораторной №3:** - Запуск двух экземпляров Go API (`api1`, `api2`). - Балансировка HTTP-запросов через Nginx. - Заголовок `X-Instance-Id` для определения экземпляра, обработавшего запрос. - Общие PostgreSQL и Redis для обоих экземпляров. - Идемпотентное создание сообщений с использованием `Idempotency-Key`. - Защита от дублирования сообщений при одновременных повторных запросах. - Отдельный сервис `migrate` для выполнения миграций БД. - Docker Compose для запуска инфраструктуры. - Скрипты для проверки остановки и восстановления экземпляров. **Сохранено из предыдущих лабораторных:** - REST API пользователей, чатов и сообщений. - Регистрация, авторизация и работа с сессиями. - Хранение данных в PostgreSQL. - Использование Redis для сессий. - Валидация запросов и обработка ошибок. - Публичный API-контракт и тесты. ### Команды запуска из чистого clone ```bash git clone https://gitea.privcloud.tech/Fedoroff/mtusi2026lab3.git cd mtusi2026lab3 git switch solution/BPI2302-fedorov ``` Создать `.env` на основе `.env.example`, указать необходимые переменные окружения. Запустить приложение: ```bash docker compose --env-file .env up -d --build ``` Проверить контейнеры: ```bash docker compose --env-file .env ps ``` Приложение доступно по адресу `http://localhost:8080`. ### Результаты проверок и ссылка на REPORT.md **Go-тесты:** ```bash docker run --rm -v "${PWD}:/app" -w /app golang:1.25.0-alpine go test ./... ``` Результат: все тесты успешно пройдены, ошибок `FAIL` нет. **Smoke-тест:** ```bash py -3 tests/smoke.py --base-url "http://localhost:8080" ``` Результат: ```text PASS: lab3 public API scenario; infrastructure and grading evidence remain separate. ``` **Проверка идемпотентности:** ```bash py -3 tests/idempotency_concurrent.py --base-url "http://localhost:8080" ``` Результат: ```text PASS: 16 concurrent retries, one message, replicas: api1, api2 ``` **Балансировка:** проверено распределение запросов между `api1` и `api2` по заголовку `X-Instance-Id`. **Отказоустойчивость:** после остановки `api1` запросы продолжили успешно обрабатываться экземпляром `api2`. После восстановления `api1` оба экземпляра находились в состоянии `healthy`. **Отчёт:** [[REPORT.md](https://chatgpt.com/c/REPORT.md)](REPORT.md). ### Ограничения / известные ошибки - Решение ориентировано на локальный запуск через Docker Compose. - Балансировка выполняется одним экземпляром Nginx, поэтому сам балансировщик остаётся единой точкой отказа. - Проверена остановка одного экземпляра API; полная отказоустойчивость PostgreSQL, Redis и Nginx не реализована. - Полноценные нагрузочные испытания не проводились. - Другие известные ошибки по результатам выполненных проверок не обнаружены. ### Источники и использование ИИ **Источники:** - Материалы и требования лабораторных работ №1–3. - Документация Go, PostgreSQL, Redis, Docker Compose и Nginx. - Публичный API-контракт проекта. **Использование ИИ:** ChatGPT использовался для помощи в разработке Go-кода, конфигурации Docker Compose и Nginx, написании тестов, поиске и исправлении ошибок, подготовке документации. Работоспособность решения проверена локально с помощью Docker и автоматизированных тестов. ### Чек-лист - [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. - [x] Контракт и публичные тесты не ослаблены. - [x] `make check` и `make test` выполнены; приложен реальный вывод. - [x] Сценарии отказов/безопасности своего уровня воспроизведены. - [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. - [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
Fedoroff added 3 commits 2026-10-27 20:59:49 +03:00
Fedoroff changed title from Solution/bpi2302 fedorov to ЛР3 - БПИ2302 Федоров - на 3 2026-10-27 21:00:39 +03:00
You are not authorized to merge this pull request.
This pull request can be merged automatically.
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u https://gitea.privcloud.tech/Fedoroff/mtusi2026lab3 solution/BPI2302-fedorov:Fedoroff-solution/BPI2302-fedorov
git checkout Fedoroff-solution/BPI2302-fedorov
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: mtusi2026/mtusi2026lab3#58