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

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

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

Автор / группа: Соколов Илья Сергеевич, факультет ИТ, БВТ2302

Целевая оценка (3/4/5): 3

Трек 5, если заявлен: Не заявлен

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

  • Реализован HTTP API на Go с поддержкой загрузки и скачивания вложений.
  • Сохранена функциональность предыдущих лабораторных: авторизация, сессии, сообщения и идемпотентность запросов.
  • Настроены две API-реплики с балансировкой нагрузки через Nginx.
  • Используется общая база данных PostgreSQL.
  • Реализовано S3-совместимое хранилище изображений с сохранением метаданных в PostgreSQL.
  • Добавлены проверки прав доступа к вложениям.
  • Реализована корректная обработка недоступности S3: HTTP 503 при загрузке, сохранение работоспособности текстовых сообщений.
  • Добавлены четыре SQL-миграции, включая 004_attachments.sql.
  • Настроены Docker Compose, healthcheck и скрипты проверки отказоустойчивости.
  • Сохранены исходные контракт и публичные тесты преподавателя.

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

powershell -ExecutionPolicy Bypass -File scripts\init-secrets.ps1

В локальном .env установить PUBLISHED_PORT=18081.

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:18081

Для проверки сохранности данных и отказоустойчивости:

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

python -X utf8 tests\resilience.py --mode failover --action-script scripts\stop-one.cmd --base-url http://localhost:18081

docker compose up -d

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

1. Проверка структуры — 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. Проверка API — PASS

Команда:

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

Фактический результат:

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

3. Проверка сохранности данных — PASS

PASS: persistence preserved confirmed data and existing session. Hook scope needs operator evidence.

Подтверждена сохранность данных и существующей сессии после перезапуска компонентов.

4. Первый тест отказоустойчивости — PASS

{"observed_instances_before":2,"successful_writes":8,"failed_attempts":0,"first_recovery_seconds":4.157}
PASS: failover preserved confirmed data and existing session.

5. Повторный тест отказоустойчивости — PASS

{"observed_instances_before":2,"successful_writes":8,"failed_attempts":0,"first_recovery_seconds":4.156}
PASS: failover preserved confirmed data and existing session.

При обоих тестах была остановлена реплика api-2. После выполнения тестов контейнеры восстановлены, обе API-реплики получили статус Healthy.

6. Проверка недоступности S3 — PASS

S3-хранилище было намеренно остановлено командой docker compose stop s3.

Фактические результаты:

PASS: S3 unavailable -> HTTP 503
PASS: text messages work without S3
S3 restored

Подтверждено, что при недоступности S3 загрузка вложений возвращает HTTP 503, а отправка текстовых сообщений продолжает работать.

После проверки контейнер S3 восстановлен.

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

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

  • Исходный Docker-образ MinIO оказался недоступен для скачивания. Для локального запуска использован S3-совместимый образ docker.io/pgsty/silo:RELEASE.2026-10-26T00-00-00Z.
  • В обоих успешных тестах Failover останавливалась реплика api-2. Отказ api-1 отдельно не проверялся.
  • Проверки выполнены в локальном Docker-окружении. Автоматическая проверка CI и оценка преподавателя остаются отдельными этапами.
  • Доказательства области воздействия скриптов отказоустойчивости требуют отдельного подтверждения оператором.

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

Использованные технологии: Go, PostgreSQL, Nginx, Docker Compose, S3-совместимое хранилище, Python.

В качестве основы использованы исходный шаблон лабораторной №4, контракт API и публичные тесты преподавателя.

Инструменты ИИ использовались при подготовке реализации, диагностике ошибок Docker, настройке окружения, выполнении проверок и оформлении отчёта. Результаты тестов приведены на основании фактического вывода локального запуска.

## Лабораторная 4 **Автор / группа:** Соколов Илья Сергеевич, факультет ИТ, БВТ2302 **Целевая оценка (3/4/5):** 3 **Трек 5, если заявлен:** Не заявлен ### Что реализовано и что перенесено - Реализован HTTP API на Go с поддержкой загрузки и скачивания вложений. - Сохранена функциональность предыдущих лабораторных: авторизация, сессии, сообщения и идемпотентность запросов. - Настроены две API-реплики с балансировкой нагрузки через Nginx. - Используется общая база данных PostgreSQL. - Реализовано S3-совместимое хранилище изображений с сохранением метаданных в PostgreSQL. - Добавлены проверки прав доступа к вложениям. - Реализована корректная обработка недоступности S3: HTTP 503 при загрузке, сохранение работоспособности текстовых сообщений. - Добавлены четыре SQL-миграции, включая `004_attachments.sql`. - Настроены Docker Compose, healthcheck и скрипты проверки отказоустойчивости. - Сохранены исходные контракт и публичные тесты преподавателя. ### Команды запуска из чистого clone ```powershell powershell -ExecutionPolicy Bypass -File scripts\init-secrets.ps1 ``` В локальном `.env` установить `PUBLISHED_PORT=18081`. ```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:18081 ``` Для проверки сохранности данных и отказоустойчивости: ```powershell python -X utf8 tests\resilience.py --mode persistence --action-script scripts\restart.cmd --base-url http://localhost:18081 python -X utf8 tests\resilience.py --mode failover --action-script scripts\stop-one.cmd --base-url http://localhost:18081 docker compose up -d ``` ### Результаты проверок и ссылка на REPORT.md **1. Проверка структуры — 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. Проверка API — PASS** Команда: ```powershell make -f Makefile test PYTHON=python BASE_URL=http://localhost:18081 ``` Фактический результат: ```text python tests/smoke.py --base-url "http://localhost:18081" PASS: lab4 public API scenario; infrastructure and grading evidence remain separate. ``` **3. Проверка сохранности данных — PASS** ```text PASS: persistence preserved confirmed data and existing session. Hook scope needs operator evidence. ``` Подтверждена сохранность данных и существующей сессии после перезапуска компонентов. **4. Первый тест отказоустойчивости — PASS** ```json {"observed_instances_before":2,"successful_writes":8,"failed_attempts":0,"first_recovery_seconds":4.157} ``` ```text PASS: failover preserved confirmed data and existing session. ``` **5. Повторный тест отказоустойчивости — PASS** ```json {"observed_instances_before":2,"successful_writes":8,"failed_attempts":0,"first_recovery_seconds":4.156} ``` ```text PASS: failover preserved confirmed data and existing session. ``` При обоих тестах была остановлена реплика `api-2`. После выполнения тестов контейнеры восстановлены, обе API-реплики получили статус Healthy. **6. Проверка недоступности S3 — PASS** S3-хранилище было намеренно остановлено командой `docker compose stop s3`. Фактические результаты: ```text PASS: S3 unavailable -> HTTP 503 PASS: text messages work without S3 S3 restored ``` Подтверждено, что при недоступности S3 загрузка вложений возвращает HTTP 503, а отправка текстовых сообщений продолжает работать. После проверки контейнер S3 восстановлен. **Отчёт:** [[REPORT.md](https://chatgpt.com/g/g-p-68fd2f9cd69c81918df234cf426fe94d-ilia/c/REPORT.md)](REPORT.md) ### Ограничения / известные ошибки - Исходный Docker-образ MinIO оказался недоступен для скачивания. Для локального запуска использован S3-совместимый образ `docker.io/pgsty/silo:RELEASE.2026-10-26T00-00-00Z`. - В обоих успешных тестах Failover останавливалась реплика `api-2`. Отказ `api-1` отдельно не проверялся. - Проверки выполнены в локальном Docker-окружении. Автоматическая проверка CI и оценка преподавателя остаются отдельными этапами. - Доказательства области воздействия скриптов отказоустойчивости требуют отдельного подтверждения оператором. ### Источники и использование ИИ Использованные технологии: Go, PostgreSQL, Nginx, Docker Compose, S3-совместимое хранилище, Python. В качестве основы использованы исходный шаблон лабораторной №4, контракт API и публичные тесты преподавателя. Инструменты ИИ использовались при подготовке реализации, диагностике ошибок Docker, настройке окружения, выполнении проверок и оформлении отчёта. Результаты тестов приведены на основании фактического вывода локального запуска.
Sokolov-Ilya added 1 commit 2026-10-31 18:42:58 +03:00
andrey.derbenev closed this pull request 2026-11-12 16:44:47 +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/mtusi2026lab4#46