В качестве основы использованы исходный шаблон лабораторной №3, контракт API, публичные тесты преподавателя и функциональность предыдущих лабораторных.
При подготовке реализации, настройке Docker, диагностике ошибок, тестировании и оформлении отчёта использовались инструменты ИИ
Все приведённые результаты проверок основаны на фактическом выводе локальных тестов.
## Лабораторная 3
**Автор / группа:** Соколов Илья Сергеевич, факультет ИТ, БВТ2302
**Целевая оценка (3/4/5):** 3
**Трек 5, если заявлен:** Не заявлен
### Что реализовано и что перенесено
- Реализован HTTP API на Go.
- Сохранена функциональность предыдущих лабораторных: авторизация пользователей, сообщения, сессии и работа с PostgreSQL.
- Настроены две независимые API-реплики с балансировкой нагрузки через Nginx.
- Реализована единая публичная точка входа для клиентов.
- Сессии и ключи идемпотентности хранятся в общей PostgreSQL, а не в памяти отдельных реплик.
- Реализована идемпотентная отправка сообщений через `Idempotency-Key`.
- Добавлены три SQL-миграции, включая миграции сессий и идемпотентности.
- Настроены Docker Compose, healthcheck и readiness.
- Добавлены скрипты перезапуска компонентов и остановки одной API-реплики.
- Сохранены исходный контракт, публичные тесты и README преподавателя.
### Команды запуска из чистого clone
Требуются Docker Desktop, Docker Compose v2 и Python.
```powershell
powershell -ExecutionPolicy Bypass -File scripts\init-secrets.ps1
```
Для локального запуска в `.env` устанавливается `PUBLISHED_PORT=18080`, поскольку порт 8080 оказался недоступен.
```powershell
docker compose up -d --build
docker compose ps
$env:PYTHONUTF8 = "1"
make -f Makefile check PYTHON=python
make -f Makefile test PYTHON=python BASE_URL=http://localhost:18080
```
Проверка сохранности данных:
```powershell
python -X utf8 tests\resilience.py --mode persistence --action-script scripts\restart.cmd --base-url http://localhost:18080
```
Проверка отказоустойчивости:
```powershell
python -X utf8 tests\resilience.py --mode failover --action-script scripts\stop-one.cmd --base-url http://localhost:18080
docker ps -a --filter label=com.docker.compose.service=api
docker compose up -d
```
### Результаты проверок и ссылка на REPORT.md
**1. make check — PASS**
Команда:
```powershell
make -f Makefile check PYTHON=python
```
Фактический вывод:
```text
python scripts/check_contract.py
PASS: offline skeleton structure, local refs and Python syntax; application NOT tested.
```
**2. make test — PASS**
Команда:
```powershell
make -f Makefile test PYTHON=python BASE_URL=http://localhost:18080
```
Фактический вывод:
```text
python tests/smoke.py --base-url "http://localhost:18080"
PASS: lab3 public API scenario; infrastructure and grading evidence remain separate.
```
**3. Persistence test — PASS**
Фактический вывод:
```text
Executing explicit persistence hook; hook output suppressed to avoid leaking secrets.
PASS: persistence preserved confirmed data and existing session. Hook scope needs operator evidence.
```
Подтверждена сохранность данных и существующей пользовательской сессии после перезапуска компонентов.
**4. Failover test — PASS**
Фактический вывод:
```json
{
"observed_instances_before": 2,
"successful_writes": 8,
"failed_attempts": 0,
"first_recovery_seconds": 4.203
}
```
```text
PASS: failover preserved confirmed data and existing session. Hook scope needs operator evidence.
```
Результаты:
- Обнаружены две API-реплики.
- Успешных записей: 8.
- Неудачных попыток: 0.
- Время восстановления: 4,203 секунды.
- Подтверждённые данные и пользовательская сессия сохранены.
Во время теста реплика `mtusi-lab3-api-1` получила статус `Exited (0)`, а `mtusi-lab3-api-2` продолжила работать.
После выполнения `docker compose up -d` обе API-реплики и PostgreSQL получили статус Healthy.
**5. Проверка доступности API — PASS**
```text
GET /health/ready
{"status":"ok"}
```
Проверки выполнены локально в Windows PowerShell. Основные функциональные тесты завершились успешно.
**Отчёт:** [[REPORT.md](https://gitea.privcloud.tech/Sokolov-Ilya/mtusi2026lab3/src/branch/solution/bvt2302-sokolov/REPORT.md)](https://gitea.privcloud.tech/Sokolov-Ilya/mtusi2026lab3/src/branch/solution/bvt2302-sokolov/REPORT.md)
### Ограничения / известные ошибки
- PostgreSQL и Nginx остаются единичными точками отказа. Их высокая доступность в рамках целевой оценки 3 не заявляется.
- Проверен отказ реплики `api-1`. Отказ реплики `api-2` отдельно не подтверждён.
- Результаты получены в локальном Docker-окружении; автоматическая проверка CI и оценка преподавателя не подтверждены.
- Публичные тесты не заменяют полноценную проверку инфраструктуры.
- Область воздействия скриптов отказоустойчивости требует отдельного операторского подтверждения.
- Для локального запуска используется порт 18080 вместо 8080.
### Источники и использование ИИ
Использованные технологии: Go, PostgreSQL, Nginx, Docker Compose, Python.
В качестве основы использованы исходный шаблон лабораторной №3, контракт API, публичные тесты преподавателя и функциональность предыдущих лабораторных.
При подготовке реализации, настройке Docker, диагностике ошибок, тестировании и оформлении отчёта использовались инструменты ИИ
Все приведённые результаты проверок основаны на фактическом выводе локальных тестов.
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/4/5): 3
Трек 5, если заявлен: Не заявлен
Что реализовано и что перенесено
Idempotency-Key.Команды запуска из чистого clone
Требуются Docker Desktop, Docker Compose v2 и Python.
Для локального запуска в
.envустанавливаетсяPUBLISHED_PORT=18080, поскольку порт 8080 оказался недоступен.Проверка сохранности данных:
Проверка отказоустойчивости:
Результаты проверок и ссылка на REPORT.md
1. make check — PASS
Команда:
Фактический вывод:
2. make test — PASS
Команда:
Фактический вывод:
3. Persistence test — PASS
Фактический вывод:
Подтверждена сохранность данных и существующей пользовательской сессии после перезапуска компонентов.
4. Failover test — PASS
Фактический вывод:
Результаты:
Во время теста реплика
mtusi-lab3-api-1получила статусExited (0), аmtusi-lab3-api-2продолжила работать.После выполнения
docker compose up -dобе API-реплики и PostgreSQL получили статус Healthy.5. Проверка доступности API — PASS
Проверки выполнены локально в Windows PowerShell. Основные функциональные тесты завершились успешно.
Отчёт: [REPORT.md](https://gitea.privcloud.tech/Sokolov-Ilya/mtusi2026lab3/src/branch/solution/bvt2302-sokolov/REPORT.md)
Ограничения / известные ошибки
api-1. Отказ репликиapi-2отдельно не подтверждён.Источники и использование ИИ
Использованные технологии: Go, PostgreSQL, Nginx, Docker Compose, Python.
В качестве основы использованы исходный шаблон лабораторной №3, контракт API, публичные тесты преподавателя и функциональность предыдущих лабораторных.
При подготовке реализации, настройке Docker, диагностике ошибок, тестировании и оформлении отчёта использовались инструменты ИИ
Все приведённые результаты проверок основаны на фактическом выводе локальных тестов.
Pull request closed