репорт

This commit is contained in:
Katarhi
2026-11-05 23:37:26 +03:00
parent d073767e80
commit 267230ef76
+57 -36
View File
@@ -1,37 +1,58 @@
# Отчёт — лабораторная 4
Лабораторная 4
Автор, группа: Гончаревская Екатерина Александровна, БВТ2304.
Целевая оценка: 3.
Выбранный трек 5: не заявлен.
Commit основной реализации: d073767.
- Автор, группа: TODO
- Целевая оценка; выбранный трек 5, если нужен: TODO
- Commit/PR: TODO после публикации
- Использованные источники, библиотеки и помощь ИИ: TODO
## Запуск из чистого clone
TODO: версии runtime/образов, prerequisites, команды создания локальных secrets/.env, build, миграций, запуска, ожидания готовности, тестов и остановки. Указать необходимые действия оператора. Не вставлять секреты. Отдельно указать безопасную остановку и команду намеренного удаления учебных данных.
## Архитектура и решения
TODO: схема процессов/хранилищ, источник истины, транзакционные границы, ограничения. Что перенесено из lab3, что изменено в этой работе. Соответствие переменных из .env.example реальной конфигурации.
## Доказательства критериев
| Критерий README | Команда/сценарий | Наблюдаемый результат | Файл доказательства |
| --- | --- | --- | --- |
| Публичный smoke | make test | TODO | TODO |
| Остальные пункты уровня 3 | TODO | TODO | TODO |
| Все пункты уровня 4, если заявлен | TODO | TODO | TODO |
| Выбранный трек 5, если заявлен | TODO | TODO | TODO |
TODO: добавить отдельную строку для каждого заявленного критерия. PASS без команды и наблюдения не является доказательством. Проверка инфраструктурного hook требует подтверждения, какие реальные процессы/хранилища перезапущены.
## Эксперименты и отказы
TODO: гипотеза, hardware/лимиты, версии, объём данных, профиль нагрузки, concurrency/arrival rate, длительность/прогрев, повторы, успешные RPS, ошибки, p50/p95/p99, CPU/RAM. Сохранить raw summary без tokens и объяснить ограничения измерения.
| Воздействие | Что ожидаем | Что наблюдали | Время восстановления / потеря данных |
| --- | --- | --- | --- |
| TODO | TODO | TODO | TODO |
## Ограничения и следующие шаги
TODO: какие отказы выдерживаются и какие нет; что не реализовано; где учебное упрощение; какое улучшение подтверждено, а какое пока гипотеза.
Запуск из чистого 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.
Реализация запускалась и проверялась в локальном окружении.