6.1 KiB
Отчёт — лабораторная 5
- Автор, группа: Григорян Илья Мурадович, БПИ2303 (из отчёта lab4).
- Целевая оценка: 5; исследовательский трек пока не выбран.
- Этап: перенос базы lab4 и заготовки с docstring, без реализации lab5.
- Дата переноса: 07.11.2026.
- Commit/PR lab5: заполнить после публикации.
- Использованные источники: README-файлы и contracts/ репозитория lab5, исходники lab4. Использована помощь Codex. Новых зависимостей нет.
Запуск из чистого clone
Нужны Python 3.12, pip, Docker с Compose. Подготовка и запуск:
python3 -m venv .venv
.venv/bin/python -m pip install -r requirements.txt -r requirements-dev.txt
make init
make up
HTTP: http://localhost:18081. make down останавливает стенд с сохранением данных.
Тестовый стенд: make test-stand-up, остановка: make test-stand-down.
Намеренное удаление учебных данных: make test-stand-destroy для тестового стенда,
docker compose --env-file .env down --volumes для основного.
Версии зависимостей перенесены без обновления. Локальные secrets/.env генерируются заново, не копируются из lab4.
Стенд при переносе не запускался; воспроизводимость после переноса ещё не проверена.
Архитектура и решения
Перенесены приложение FastAPI, PostgreSQL-миграции, общие Redis-сессии, идемпотентность сообщений, приватный MinIO, две API-реплики за Nginx, собственные тесты и скрипты эксплуатации lab4. Перенесена и незакоммиченная правка MinIO bootstrap из исходного рабочего дерева. Исходный lab4 не изменён.
Имена Compose-проектов, образы и порты отделены от lab4. Рабочие настройки — .env.example; там же указаны будущие параметры очереди, пока не используемые. Compose получает настройки environment из .env, включая пути S3, PostgreSQL и MinIO к файлам секретов; секретные значения остаются в secrets/. Пути *_FILE в Compose также задают точки монтирования соответствующих secrets; MinIO bootstrap читает эти пути из окружения. Публичные tests/, contracts/, lab.json и README.md lab5 сохранены.
Будущая архитектура: API → durable staging + PostgreSQL job/outbox → publisher → broker → worker → конечный MinIO + атомарная фиксация metadata в PostgreSQL. Текущая реализация продолжает синхронно сохранять оригинал и возвращает 201 ready. Заготовки lab5 не подключены и вызывают NotImplementedError. Реализация транзакционных границ и восстановления после отказов ещё предстоит.
Доказательства критериев
| Критерий README | Будущая команда/сценарий | Текущий результат | Доказательство |
|---|---|---|---|
| Публичный smoke lab5 | make test | Не запускался; 202/thumbnail ещё не реализованы | Нет |
| 3: сохранён минимум lab4 | Собственные тесты, persistence/failover | Перенесён, повторно не проверен | Не подтверждает lab5 |
| 3: durable приём и broker/worker | Worker stop → upload → restart → ready | Не реализовано | Нет |
| 3: состояния, original/thumbnail, retry, дубли | Smoke + собственные сценарии | Не реализовано | Нет |
| 4: crop/optimized, resource limits | Собственные проверки изображений/лимитов | Не реализовано | Нет |
| 4: outbox и восстановление COMMIT/publish | Fault injection | Не реализовано | Нет |
| 4: backoff/jitter, failed/replay | Сбой до исчерпания и явный replay | Не реализовано | Нет |
| 4: crash до ack, lease, concurrency, cleanup | Fault injection и lifecycle | Не реализовано | Нет |
| 5: законченный исследовательский трек | Методика после выбора трека | Трек не выбран | Нет |
Эксперименты и отказы
Пока не проводились. После выбора трека описать гипотезу, hardware/лимиты, версии, размеры/число файлов, профиль нагрузки, concurrency/prefetch, длительность, прогрев и повторы. Сохранить raw summary без секретов, queue lag, время до ready, RSS и другие метрики выбранного трека.
Ограничения и следующие шаги
Сейчас это база для дальнейшей реализации, не завершённая lab5. Очереди и асинхронной обработки нет; прежние результаты lab4 к этому дереву не относятся. Сначала просмотр пользователем и выбор трека/брокера, затем реализация; тестовый прогон и новые evidence — по отдельному указанию после реализации.