forked from mtusi2026/mtusi2026lab4
@@ -1,37 +1,83 @@
|
||||
# Отчёт — лабораторная 4
|
||||
# ЛР4 — вложения в мессенджере
|
||||
|
||||
- Автор, группа: TODO
|
||||
- Целевая оценка; выбранный трек 5, если нужен: TODO
|
||||
- Commit/PR: TODO после публикации
|
||||
- Использованные источники, библиотеки и помощь ИИ: TODO
|
||||
Кузнецов Даниил Русланович, БПИ2304. Целевая оценка — **3**.
|
||||
|
||||
## Запуск из чистого clone
|
||||
## Запуск
|
||||
|
||||
TODO: версии runtime/образов, prerequisites, команды создания локальных secrets/.env, build, миграций, запуска, ожидания готовности, тестов и остановки. Указать необходимые действия оператора. Не вставлять секреты. Отдельно указать безопасную остановку и команду намеренного удаления учебных данных.
|
||||
Нужны Git, Python 3.13 и Docker с Compose (на Windows — запущенный Docker Desktop).
|
||||
Из папки репозитория:
|
||||
|
||||
## Архитектура и решения
|
||||
```powershell
|
||||
python -X utf8 scripts/lab.py verify
|
||||
```
|
||||
|
||||
TODO: схема процессов/хранилищ, источник истины, транзакционные границы, ограничения. Что перенесено из lab3, что изменено в этой работе. Соответствие переменных из .env.example реальной конфигурации.
|
||||
Команда сама создаёт `.venv`, локальный `.env` и новые секреты, собирает образ,
|
||||
запускает стенд и все проверки. Повторный запуск сохраняет настройки и данные.
|
||||
API доступен на `http://127.0.0.1:18104`. TTL проверяется отдельно на порту 18114.
|
||||
|
||||
## Доказательства критериев
|
||||
Для обычной работы:
|
||||
|
||||
| Критерий README | Команда/сценарий | Наблюдаемый результат | Файл доказательства |
|
||||
| --- | --- | --- | --- |
|
||||
| Публичный smoke | make test | TODO | TODO |
|
||||
| Остальные пункты уровня 3 | TODO | TODO | TODO |
|
||||
| Все пункты уровня 4, если заявлен | TODO | TODO | TODO |
|
||||
| Выбранный трек 5, если заявлен | TODO | TODO | TODO |
|
||||
```powershell
|
||||
python -X utf8 scripts/lab.py start
|
||||
python -X utf8 scripts/lab.py test
|
||||
python -X utf8 scripts/lab.py restart-check
|
||||
python -X utf8 scripts/lab.py failover-check
|
||||
python -X utf8 scripts/lab.py stop
|
||||
```
|
||||
|
||||
TODO: добавить отдельную строку для каждого заявленного критерия. PASS без команды и наблюдения не является доказательством. Проверка инфраструктурного hook требует подтверждения, какие реальные процессы/хранилища перезапущены.
|
||||
`stop` сохраняет volumes. Если нужно специально стереть учебные данные:
|
||||
`docker compose -p kuznetsov-lab4 --env-file .env down --volumes`.
|
||||
|
||||
## Эксперименты и отказы
|
||||
На Linux можно запускать те же команды через `python3`.
|
||||
Команды преподавателя: `make check`, `make validate PYTHON=.venv/bin/python`,
|
||||
`make test BASE_URL=http://127.0.0.1:18104`.
|
||||
На Windows скрипт вызывает те же Python-проверки напрямую.
|
||||
|
||||
TODO: гипотеза, hardware/лимиты, версии, объём данных, профиль нагрузки, concurrency/arrival rate, длительность/прогрев, повторы, успешные RPS, ошибки, p50/p95/p99, CPU/RAM. Сохранить raw summary без tokens и объяснить ограничения измерения.
|
||||
## Что работает
|
||||
|
||||
| Воздействие | Что ожидаем | Что наблюдали | Время восстановления / потеря данных |
|
||||
| --- | --- | --- | --- |
|
||||
| TODO | TODO | TODO | TODO |
|
||||
Клиент → HAProxy → две API-реплики → PostgreSQL + SeaweedFS.
|
||||
Из ЛР3 сохранены парольный вход, Bearer-сессии, доступ по участникам чата,
|
||||
курсорная пагинация и идемпотентная отправка сообщений.
|
||||
|
||||
## Ограничения и следующие шаги
|
||||
Оригиналы лежат в приватном bucket `kuznetsov-lab4-attachments`, метаданные и связи
|
||||
с сообщениями — в БД. Имена объектов назначает сервер. Загрузка принимает PNG/JPEG
|
||||
до 10 MiB и 40 млн пикселей, проверяет MIME, имя, целостность и SHA-256.
|
||||
Скачивание идёт через API с проверкой участника чата.
|
||||
|
||||
TODO: какие отказы выдерживаются и какие нет; что не реализовано; где учебное упрощение; какое улучшение подтверждено, а какое пока гипотеза.
|
||||
Тело пишется потоком во временный файл; файл и декодирование проверяются до публикации.
|
||||
На реплику разрешены две обработки, ожидание и чтение ограничены 15 секундами.
|
||||
S3 имеет таймауты 2/5 секунд; лимит контейнера API — 768 MiB.
|
||||
Сначала выполняется S3 PUT, затем SQL-транзакция с метаданными.
|
||||
Ответ `201 ready` возвращается после обоих сохранений.
|
||||
|
||||
Python 3.13.14, PostgreSQL 17.11, SeaweedFS 4.54 и HAProxy 3.2.26
|
||||
закреплены в Dockerfile/Compose с digest; библиотеки — в lock-файлах.
|
||||
Секреты передаются файлами. Наружу открыт только LB, у S3 и БД портов на хосте нет.
|
||||
|
||||
## Проверки
|
||||
|
||||
Полный сценарий: `python -X utf8 scripts/lab.py verify`.
|
||||
|
||||
| Проверка | Результат | Доказательство |
|
||||
| --- | --- | --- |
|
||||
| Структура, OpenAPI, Compose, публичный smoke | PASS | [Лог](evidence/verification.txt) |
|
||||
| Авторизация, Unicode, конкуренция, идемпотентность и файлы | 37 тестов, PASS | [Лог](evidence/verification.txt) |
|
||||
| PNG/JPEG, точные байты и SHA-256, доступ участников, лимиты | PASS | [Тесты](student-tests/test_attachments.py) и лог |
|
||||
| Прямое анонимное чтение S3 | 403 | [JSON](evidence/private-s3.json) |
|
||||
| Перезапуск обеих API, БД, S3 и LB | Сессии, сообщения и файлы сохранены | [Рестарт](evidence/restart.json), [данные](evidence/persistence.json) |
|
||||
| Остановка каждой загрузившей реплики | Другая возвращает тот же оригинал | [JSON](evidence/attachment-failover.json) |
|
||||
| Идемпотентность после отказа обеих реплик | Без потерь подтверждённых сообщений и дублей | [JSON](evidence/failover.json) |
|
||||
| Недоступность БД и S3 | live 200, ready/download 503; после восстановления 200 | [Сводка](evidence/summary.json) |
|
||||
| Logout и TTL=2 после рестарта API | Отозванный/истёкший токен получает 401 | [JSON](evidence/expiry.json), [данные](evidence/persistence.json) |
|
||||
|
||||
## Ограничения и источники
|
||||
|
||||
Это локальный учебный стенд. Автоматической очистки остатков и эксперимента с памятью
|
||||
для уровня 4 здесь нет. Если S3 PUT прошёл, а сохранение в БД не подтвердилось,
|
||||
объект может остаться без метаданных. При неизвестном результате COMMIT слепое удаление
|
||||
опасно: транзакция могла завершиться. Готовые вложения автоматически не удаляются.
|
||||
|
||||
Основа — [реализация ЛР4 Артура Югая](https://gitea.privcloud.tech/ArturYugay/mtusi2026lab4/src/commit/8c57de52e02ac393fac7929878edfbecb9967f20).
|
||||
Здесь отдельно подготовлен вариант на 3: упрощена публикация, убраны журнал и сервис
|
||||
очистки, нагрузочный эксперимент; настройки, секреты, порты и проверки изолированы.
|
||||
Задание, контракт и публичные тесты преподавателя сохранены.
|
||||
|
||||
Reference in New Issue
Block a user