Files
mtusi2026lab4-fork/REPORT.md

4.9 KiB
Raw Permalink Blame History

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

  • Автор и группа — Samodurov Nikita, bpi2303
  • Целевая оценка — 4
  • Источники — материалы и контракт курса.
  • Использование ИИ — консультации и проверки ИИ.

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

Нужны Docker Engine с Compose v2 и Python 3.9+ на хосте. Контейнер использует Python 3.13.5. По умолчанию API доступен на http://127.0.0.1:8080. При занятом порте задайте PUBLIC_PORT и соответствующий BASE_URL. Команда setup создаёт локальные .env и secrets/.

python scripts/setup.py
make check
docker compose config --quiet
docker compose build migrate
docker compose up -d --wait
make test
make test-persistence ACTION_SCRIPT=scripts/restart.sh
make test-failover ACTION_SCRIPT=scripts/stop-one.sh
docker compose start api-a api-b
python student-tests/check_attachments.py
docker compose exec -T api-a python src/cleanup_attachments.py
docker compose down

В Windows PowerShell используйте следующие проверки после запуска стенда. Перед проверками установите $env:PYTHONUTF8 = '1'.

python scripts/check_contract.py
python tests/smoke.py
python tests/resilience.py --mode persistence --action-script scripts/restart.cmd
python tests/resilience.py --mode failover --action-script scripts/stop-one.cmd
docker compose start api-a api-b
python student-tests/check_attachments.py
docker compose exec -T api-a python src/cleanup_attachments.py

Для полной валидации контракта установите requirements-dev.txt в отдельное окружение и выполните python scripts/validate_openapi.py. Команда docker compose down оставляет именованные тома. Для намеренного сброса учебных данных выполните docker compose down -v.

Архитектура

Из ЛР 3 перенесены HAProxy, общие сессии и идемпотентная отправка сообщений. PostgreSQL хранит метаданные, SeaweedFS хранит байты оригиналов. S3 bootstrap создаёт bucket при необходимости. Административные credentials доступны bootstrap, API получает отдельную учётную запись с действиями Read, Write и List только для bucket вложений. Порты SeaweedFS с хоста не опубликованы.

HTTP-обработчик принимает одно изображение как двоичный поток. Лимит составляет 10 MiB, временный файл заполняется порциями по 64 KiB. Сервер проверяет формат и целостность изображения через Pillow. Лимит 40 млн пикселей проверяется до декодирования. Два параллельных декодирования на реплику ограничивают потребление RAM. Сервер генерирует ключ объекта из UUID. Исходное имя хранится как метаданные.

Сначала создаётся запись о незавершённой загрузке. После успешного PUT она становится доступной участникам чата. Сценарий очистки удаляет записи старше часа и соответствующие S3-объекты. Блокировка строки защищает от одновременной очистки, готовые записи не выбираются. Если S3 недоступен, запись остаётся для следующей попытки очистки.

Для вложений в сообщении используются уникальные UUID того же чата. В fingerprint идемпотентности входят текст и список вложений. Отсутствующий список эквивалентен пустому.

Проверки

Результаты локального Docker-стенда и команды приведены в evidence/local-checks.txt.

Ограничения

При недоступности S3 readiness возвращает 503. Одноузловые PostgreSQL и SeaweedFS сохраняют данные при рестарте с томами, отказ диска или хоста находится за пределами стенда. Удаление незавершённых загрузок запускает оператор.