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

5.4 KiB

Лабораторная 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. Реализация запускалась и проверялась в локальном окружении.