forked from mtusi2026/mtusi2026lab4
58 lines
5.4 KiB
Markdown
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.
|
|
Реализация запускалась и проверялась в локальном окружении. |