forked from mtusi2026/mtusi2026lab4
report.md
This commit is contained in:
@@ -1,18 +1,18 @@
|
||||
## Лабораторная 4
|
||||
|
||||
Автор / группа: TODO
|
||||
Целевая оценка (3/4/5): TODO
|
||||
Трек 5, если заявлен: TODO
|
||||
Автор / группа: не указаны
|
||||
Целевая оценка (3/4/5): 4
|
||||
Трек 5, если заявлен: не заявлен
|
||||
|
||||
Что реализовано и что перенесено: TODO
|
||||
Команды запуска из чистого clone: TODO
|
||||
Результаты проверок и ссылка на REPORT.md: TODO
|
||||
Ограничения / известные ошибки: TODO
|
||||
Источники и использование ИИ: TODO
|
||||
Что реализовано и что перенесено: перенесены PostgreSQL, Redis, Nginx и две API-реплики из lab3; добавлены private MinIO bucket, Attachment, upload/download через API, миграция, очистка orphan-объектов и проверки вложений.
|
||||
Команды запуска из чистого clone: `cp .env.example .env`, задать локальные пароли, затем `docker compose --env-file .env up -d --build` и `make test`.
|
||||
Результаты проверок и ссылка на REPORT.md: smoke, persistence, failover, ошибки вложений и 10 upload прошли; подробности в `REPORT.md`.
|
||||
Ограничения / известные ошибки: S3, PostgreSQL и Redis по одному экземпляру; cleanup удаляет только orphan-объекты старше одного часа.
|
||||
Источники и использование ИИ: FastAPI, SQLAlchemy, boto3, Pillow, MinIO; Codex использовался для реализации и проверок.
|
||||
|
||||
- [ ] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
|
||||
- [ ] Контракт и публичные тесты не ослаблены.
|
||||
- [ ] make check и make test выполнены; приложен реальный вывод.
|
||||
- [ ] Сценарии отказов/безопасности своего уровня воспроизведены.
|
||||
- [ ] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
|
||||
- [ ] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
|
||||
- [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
|
||||
- [x] Контракт и публичные тесты не ослаблены.
|
||||
- [x] make check и make test выполнены; приложен реальный вывод.
|
||||
- [x] Сценарии отказов/безопасности своего уровня воспроизведены.
|
||||
- [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
|
||||
- [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
|
||||
|
||||
@@ -1,37 +1,41 @@
|
||||
# Отчёт — лабораторная 4
|
||||
|
||||
- Автор, группа: TODO
|
||||
- Целевая оценка; выбранный трек 5, если нужен: TODO
|
||||
- Commit/PR: TODO после публикации
|
||||
- Использованные источники, библиотеки и помощь ИИ: TODO
|
||||
- Автор, группа: не указаны
|
||||
- Целевая оценка: 4
|
||||
- Commit/PR: не опубликованы
|
||||
- Использованные библиотеки и помощь ИИ: FastAPI, SQLAlchemy, Redis, boto3, Pillow, MinIO; Codex использовался для реализации и проверок.
|
||||
|
||||
## Запуск из чистого clone
|
||||
|
||||
TODO: версии runtime/образов, prerequisites, команды создания локальных secrets/.env, build, миграций, запуска, ожидания готовности, тестов и остановки. Указать необходимые действия оператора. Не вставлять секреты. Отдельно указать безопасную остановку и команду намеренного удаления учебных данных.
|
||||
```sh
|
||||
cp .env.example .env
|
||||
# Задать свои POSTGRES_PASSWORD, MINIO_ROOT_PASSWORD и S3_SECRET_ACCESS_KEY.
|
||||
docker compose --env-file .env up -d --build
|
||||
make test
|
||||
python student-tests/test_attachments.py
|
||||
python scripts/upload_load.py --concurrency 10 --output evidence/upload-load.json
|
||||
```
|
||||
|
||||
Стенд запускает PostgreSQL, Redis, MinIO, миграции, две API-реплики и Nginx. Остановка: `docker compose down`; намеренное удаление учебных данных: `docker compose down -v`.
|
||||
|
||||
## Архитектура и решения
|
||||
|
||||
TODO: схема процессов/хранилищ, источник истины, транзакционные границы, ограничения. Что перенесено из lab3, что изменено в этой работе. Соответствие переменных из .env.example реальной конфигурации.
|
||||
Из lab3 перенесены PostgreSQL, Redis-сессии, Nginx и две API-реплики. Метаданные вложений хранятся в PostgreSQL, оригиналы — в private bucket MinIO. API генерирует object key; filename используется только при скачивании.
|
||||
|
||||
Upload пишет входной поток во временный файл с лимитом 10 MiB, проверяет PNG/JPEG и не более 40 млн пикселей. Одновременно декодируется не более одного изображения на API-процесс. Между S3 PUT и записью метаданных действует компенсирующая очистка: сервис `cleanup` раз в час удаляет объекты без строки в БД, старше одного часа; общий advisory lock исключает удаление во время commit.
|
||||
|
||||
## Доказательства критериев
|
||||
|
||||
| Критерий 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 |
|
||||
| Публичный smoke | `make test` | PASS: lab4 public API scenario | console |
|
||||
| Persistence | `make test-persistence ACTION_SCRIPT=scripts/restart.cmd` | прежняя сессия, сообщение и оригинал сохранены | console |
|
||||
| Failover | `make test-failover ACTION_SCRIPT=scripts/stop-one.cmd` | PASS; восстановление записи за 6.361 с, файл читается через другую API-реплику | console |
|
||||
| Ошибки вложений | `python student-tests/test_attachments.py` | PASS: большой, повреждённый, подменённый MIME, чужой ID и другой чат дают 4xx | `student-tests/test_attachments.py` |
|
||||
| 10 upload | `python scripts/upload_load.py --concurrency 10` | 10/10 успешны; пик двух API — 191165889 bytes | `scripts/upload_load.py` |
|
||||
| Private bucket | `docker compose exec -T nginx wget -S -O /dev/null http://s3:9000/messenger-attachments` | unauthenticated GET возвращает 403 | console |
|
||||
| S3 unavailable | pause S3, `GET /health/ready`, unpause S3 | через LB: 503; после восстановления: 200 | console |
|
||||
|
||||
## Ограничения и следующие шаги
|
||||
|
||||
TODO: какие отказы выдерживаются и какие нет; что не реализовано; где учебное упрощение; какое улучшение подтверждено, а какое пока гипотеза.
|
||||
MinIO, PostgreSQL и Redis запущены по одному экземпляру. Cleanup предназначен для orphan-объектов; он не восстанавливает отсутствующие объекты для существующих метаданных. Административная консоль MinIO не публикуется в сеть.
|
||||
|
||||
Reference in New Issue
Block a user