diff --git a/REPORT.md b/REPORT.md index 9ad2b84..532d7fd 100644 --- a/REPORT.md +++ b/REPORT.md @@ -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. +Реализация запускалась и проверялась в локальном окружении. \ No newline at end of file