Files
2026-10-30 20:24:13 +03:00

3.7 KiB

Отчёт — лабораторная 4

  • Автор, группа: не указаны
  • Целевая оценка: 4
  • Commit/PR: не опубликованы
  • Использованные библиотеки и помощь ИИ: FastAPI, SQLAlchemy, Redis, boto3, Pillow, MinIO; Codex использовался для реализации и проверок.

Запуск из чистого clone

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.

Архитектура и решения

Из 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 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

Ограничения и следующие шаги

MinIO, PostgreSQL и Redis запущены по одному экземпляру. Cleanup предназначен для orphan-объектов; он не восстанавливает отсутствующие объекты для существующих метаданных. Административная консоль MinIO не публикуется в сеть.