forked from mtusi2026/mtusi2026lab4
репорт
This commit is contained in:
@@ -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.
|
||||
Реализация запускалась и проверялась в локальном окружении.
|
||||
Reference in New Issue
Block a user