Files
2026-11-05 23:37:26 +03:00

58 lines
5.4 KiB
Markdown

Лабораторная 4
Автор, группа: Гончаревская Екатерина Александровна, БВТ2304.
Целевая оценка: 3.
Выбранный трек 5: не заявлен.
Commit основной реализации: d073767.
Запуск из чистого clone
Для запуска необходимы Docker, Docker Compose и Python 3. Для сценариев отказоустойчивости также использовался WSL с Python 3.
Получение проекта:
git clone https://gitea.privcloud.tech/Katarhani/mtusi2026lab4.git
cd mtusi2026lab4
Создание локальных секретов:
python scripts/init-secrets.py
Сборка и запуск:
docker compose up --build -d
Публичный API доступен через HAProxy по адресу http://localhost:8080 (http://localhost:8080/).
Проверка состояния контейнеров:
docker compose ps
Запуск публичного теста:
python tests/smoke.py --base-url http://localhost:8080
Остановка проекта:
docker compose down
Удаление контейнеров и учебных данных вместе с томами:
docker compose down -v
Секреты создаются локально и не добавляются в Git.
Архитектура и решения
Реализована система хранения вложений для мессенджера.
В проект входят две API-реплики на Python, HAProxy для распределения запросов, PostgreSQL для хранения метаданных и RustFS в качестве S3-совместимого хранилища бинарных файлов. Также используется Valkey.
Метаданные вложений хранятся в PostgreSQL, а бинарное содержимое — отдельно в S3-совместимом хранилище. Благодаря этому вложения доступны через разные API-реплики.
Добавлены миграции базы данных:
001_initial.sql;
002_idempotency.sql;
003_attachments.sql.
Настроены Docker Compose, HAProxy, политика доступа к хранилищу и скрипты для проверки перезапуска и отказоустойчивости.
Результаты проверок
Публичный smoke-тест запускался командой:
python tests/smoke.py --base-url http://localhost:8080
Результат: PASS. Публичный сценарий API лабораторной работы выполнен успешно.
Проверка сохранения данных после перезапуска запускалась через WSL:
python3 tests/resilience.py --base-url http://localhost:8080 --mode persistence --action-script scripts/restart.sh
Результат: PASS. Подтверждённые данные и существующая сессия сохранились после перезапуска.
Проверка отказоустойчивости запускалась через WSL:
python3 tests/resilience.py --base-url http://localhost:8080 --mode failover --action-script scripts/stop-one.sh
Результат: PASS. Зафиксировано 116 успешных записей, первое восстановление произошло через 2,336 секунды.
Команды make check и make test отдельно не запускались.
Эксперименты и отказы
В ходе проверки сохранения данных выполнялся перезапуск инфраструктуры с помощью scripts/restart.sh. После перезапуска проверялись ранее подтверждённые данные и существующая сессия. Результат — PASS.
В ходе проверки отказоустойчивости с помощью scripts/stop-one.sh останавливалась одна API-реплика. Во время сценария зафиксировано 116 успешных записей. Первое восстановление произошло через 2,336 секунды. Результат — PASS.
Отдельные измерения RPS, p50, p95 и p99 не проводились.
Ограничения и следующие шаги
Проверки выполнялись в локальном Docker-окружении.
Результаты не являются полноценным нагрузочным тестированием производительности.
Для проверки отказоустойчивости используются отдельные управляющие скрипты.
Отдельные файлы с сырыми результатами измерений и подтверждением действий инфраструктурных hooks не подготовлены.
Дополнительные уровни сверх целевой оценки 3 не заявляются.
Источники и использование ИИ
Использованы материалы лабораторной работы и документация Docker Compose, PostgreSQL, HAProxy, Valkey и RustFS.
Реализация запускалась и проверялась в локальном окружении.