PASS: 16 concurrent retries, one message, replicas: api1, api2
Балансировка: проверено распределение запросов между api1 и api2 по заголовку X-Instance-Id.
Отказоустойчивость: после остановки api1 запросы продолжили успешно обрабатываться экземпляром api2. После восстановления api1 оба экземпляра находились в состоянии healthy.
Решение ориентировано на локальный запуск через 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 содержит инструкцию именно моего решения.
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
Автор / группа: Федоров Арсений, БПИ2302
Целевая оценка: 3
Трек 5, если заявлен: Не заявлен.
Что реализовано и что перенесено
На основе лабораторной №2 реализована работа приложения с несколькими экземплярами API.
Реализовано в лабораторной №3:
api1,api2).X-Instance-Idдля определения экземпляра, обработавшего запрос.Idempotency-Key.migrateдля выполнения миграций БД.Сохранено из предыдущих лабораторных:
Команды запуска из чистого clone
Создать
.envна основе.env.example, указать необходимые переменные окружения.Запустить приложение:
Проверить контейнеры:
Приложение доступно по адресу
http://localhost:8080.Результаты проверок и ссылка на REPORT.md
Go-тесты:
Результат: все тесты успешно пройдены, ошибок
FAILнет.Smoke-тест:
Результат:
Проверка идемпотентности:
Результат:
Балансировка: проверено распределение запросов между
api1иapi2по заголовкуX-Instance-Id.Отказоустойчивость: после остановки
api1запросы продолжили успешно обрабатываться экземпляромapi2. После восстановленияapi1оба экземпляра находились в состоянииhealthy.Отчёт: [REPORT.md](REPORT.md).
Ограничения / известные ошибки
Источники и использование ИИ
Источники:
Использование ИИ: ChatGPT использовался для помощи в разработке Go-кода, конфигурации Docker Compose и Nginx, написании тестов, поиске и исправлении ошибок, подготовке документации. Работоспособность решения проверена локально с помощью Docker и автоматизированных тестов.
Чек-лист
make checkиmake testвыполнены; приложен реальный вывод.Solution/bpi2302 fedorovto ЛР3 - БПИ2302 Федоров - на 3View command line instructions
Checkout
From your project repository, check out a new branch and test the changes.