ЛР 3 — БВТ2302 — Соколов — на 3 #83

Closed
Sokolov-Ilya wants to merge 1 commits from Sokolov-Ilya/mtusi2026lab3:solution/bvt2302-sokolov into main
First-time contributor

Лабораторная 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 -ExecutionPolicy Bypass -File scripts\init-secrets.ps1

Для локального запуска в .env устанавливается PUBLISHED_PORT=18080, поскольку порт 8080 оказался недоступен.

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

Проверка сохранности данных:

python -X utf8 tests\resilience.py --mode persistence --action-script scripts\restart.cmd --base-url http://localhost:18080

Проверка отказоустойчивости:

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

Команда:

make -f Makefile check PYTHON=python

Фактический вывод:

python scripts/check_contract.py
PASS: offline skeleton structure, local refs and Python syntax; application NOT tested.

2. make test — PASS

Команда:

make -f Makefile test PYTHON=python BASE_URL=http://localhost:18080

Фактический вывод:

python tests/smoke.py --base-url "http://localhost:18080"
PASS: lab3 public API scenario; infrastructure and grading evidence remain separate.

3. Persistence test — PASS

Фактический вывод:

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

Фактический вывод:

{
  "observed_instances_before": 2,
  "successful_writes": 8,
  "failed_attempts": 0,
  "first_recovery_seconds": 4.203
}
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

GET /health/ready
{"status":"ok"}

Проверки выполнены локально в Windows PowerShell. Основные функциональные тесты завершились успешно.

Отчёт: [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, диагностике ошибок, тестировании и оформлении отчёта использовались инструменты ИИ

Все приведённые результаты проверок основаны на фактическом выводе локальных тестов.

## Лабораторная 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, диагностике ошибок, тестировании и оформлении отчёта использовались инструменты ИИ Все приведённые результаты проверок основаны на фактическом выводе локальных тестов.
Sokolov-Ilya added 1 commit 2026-10-31 17:23:23 +03:00
andrey.derbenev closed this pull request 2026-11-12 16:17:15 +03:00

Pull request closed

Please reopen this pull request to perform a merge.
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#83