7.1 KiB
ЛР4 — вложения в мессенджере
Кузнецов Даниил Русланович, БПИ2304. Целевая оценка — 3.
Запуск
Нужны Git, Python 3.13 и Docker с Compose (на Windows — запущенный Docker Desktop). Из папки репозитория:
python -X utf8 scripts/lab.py verify
Команда сама создаёт .venv, локальный .env и новые секреты, собирает образ,
запускает стенд и все проверки. Повторный запуск сохраняет настройки и данные.
API доступен на http://127.0.0.1:18104. TTL проверяется отдельно на порту 18114.
После TTL-проверки временные контейнеры и сети убираются, volumes сохраняются.
Для обычной работы:
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
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-проверки напрямую.
Что работает
Клиент → HAProxy → две API-реплики → PostgreSQL + SeaweedFS. Из ЛР3 сохранены парольный вход, Bearer-сессии, доступ по участникам чата, курсорная пагинация и идемпотентная отправка сообщений.
Оригиналы лежат в приватном bucket kuznetsov-lab4-attachments, метаданные и связи
с сообщениями — в БД. Имена объектов назначает сервер. Загрузка принимает PNG/JPEG
до 10 MiB и 40 млн пикселей, проверяет MIME, имя, целостность и SHA-256.
Скачивание идёт через API с проверкой участника чата.
Тело пишется потоком во временный файл; файл и декодирование проверяются до публикации.
На реплику разрешены две обработки, ожидание и чтение ограничены 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 | Лог |
| Авторизация, Unicode, конкуренция, идемпотентность и файлы | 37 тестов, PASS | Лог |
| PNG/JPEG, точные байты и SHA-256, доступ участников, лимиты | PASS | Тесты и лог |
| Прямое анонимное чтение S3 | 403 | JSON |
| Перезапуск обеих API, БД, S3 и LB | Сессии, сообщения и файлы сохранены | Рестарт, данные |
| Остановка каждой загрузившей реплики | Другая возвращает тот же оригинал | JSON |
| Идемпотентность при отказе каждой реплики | Без потерь подтверждённых сообщений и дублей | JSON |
| Недоступность БД и S3 | live 200, ready/download 503; после восстановления 200 | Сводка |
| Logout и TTL=2 после рестарта API | Отозванный/истёкший токен получает 401 | JSON, данные |
Чистый клон
Полный verify прошёл на коммите 41799ee
из опубликованной ветки: новые секреты, новые volumes, порты 18124/18134.
Команда: python -X utf8 scripts/lab.py verify --project kuznetsov-lab4-clean-final --port 18124 --test-port 18134.
Сводка, полный лог,
результаты.
Первая попытка упёрлась в занятые подсети Docker; причина и повтор
сохранены. Освобождены только сети временных стендов Даниила, volumes сохранены.
Ограничения и источники
Это локальный учебный стенд. Автоматической очистки остатков и эксперимента с памятью для уровня 4 здесь нет. Если S3 PUT прошёл, а сохранение в БД не подтвердилось, объект может остаться без метаданных. При неизвестном результате COMMIT слепое удаление опасно: транзакция могла завершиться. Готовые вложения автоматически не удаляются.
Основа — реализация ЛР4 Артура Югая. Здесь отдельно подготовлен вариант на 3: упрощена публикация, убраны журнал и сервис очистки, нагрузочный эксперимент; настройки, секреты, порты и проверки изолированы. Задание, контракт и публичные тесты преподавателя сохранены.