Files
mtusi2026lab4/LAB4_GUIDE.md
T
2026-11-12 19:38:03 +03:00

45 lines
3.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Проверки и результаты лабораторной 4
Основная инструкция запуска — [README.md](STUDENT_README.md), отчёт — [REPORT.md](STUDENT_REPORT.md).
Выбран трек 2 на оценку 5: согласованность PostgreSQL и приватного S3.
## Команды
```sh
make -f student.mk check validate lint PYTHON=.venv/bin/python
make -f student.mk verify-lab4 PYTHON=.venv/bin/python
```
Полный прогон выполняет 16 этапов последовательно. Он проверяет контракт,
PNG/JPEG, SHA-256, доступ к чатам, ограничения файлов, идемпотентность сообщений,
замечания преподавателя, сверку с внедрением сбоев, память при 10 загрузках,
отказ принявшей файл реплики, restart и сборку с пустыми volumes.
Для отдельных HTTP-проверок локального стенда на порту 8084:
```sh
make -f student.mk test test-attachments test-idempotency BASE_URL=http://127.0.0.1:8084 PYTHON=.venv/bin/python
```
Инфраструктурные проверки временно меняют состояние учебного стенда и восстанавливают
его. Clean-start использует отдельный UUID-проект и удаляет только свои временные
volumes. Обычный restart сохраняет данные API, PostgreSQL, Redis, MinIO, reconciler и LB.
## Доказательства
- `evidence/lab4-final-summary.json` — итог команд и exit codes.
- `evidence/lab4-final-public-smoke.txt` — исходный публичный сценарий lab4.
- `evidence/lab4-final-attachments.txt` — байты оригинала, ACL, MIME и лимиты.
- `evidence/lab4-final-idempotency.txt` — параллельные повторы через две реплики.
- `evidence/lab4-final-reviewer-cases.txt` — ошибки файлов, пиксели, filename, S3-права и frozen PostgreSQL.
- `evidence/lab4-final-reconciliation.txt` — orphan/missing, dry-run, ошибки PUT/COMMIT/DELETE и стоимость обхода.
- `evidence/lab4-final-upload-memory.txt` — 10 одновременных загрузок и RAM.
- `evidence/lab4-final-uploader-failover.txt` — остановка именно загрузившей реплики.
- `evidence/lab4-final-persistence-proof.txt` — сохранность и реальные StartedAt до/после.
- `evidence/lab4-clean-start.json` — пустые volumes, миграция 008 и build без кэша API.
- `evidence/lab4-public-artifacts.json` — контрольные суммы неизменного публичного контракта и тестов.
- `evidence/lab4-research/` — исходные измерения и графики трека 2.
Алгоритм загрузки и сверки: [LAB4_RECONCILIATION.md](LAB4_RECONCILIATION.md).
Соответствие замечаниям преподавателя: [LAB4_AUDIT.md](LAB4_AUDIT.md).