Files
mtusi2026lab4/REPORT.md

6.2 KiB

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

Студент: Федоров Арсений Группа: БПИ2302 Целевая оценка: 3 (трек на 5 не заявлен) Ветка: solution/BPI2302-fedorov Коммит / Pull Request: заполнить после публикации.

1. Цель и результат

Реализован учебный сервис обмена сообщениями с загрузкой и скачиванием вложений. Исходные изображения PNG/JPEG сохраняются в S3-совместимом хранилище, метаданные — в PostgreSQL. Две реплики Go API работают за Nginx и используют общие хранилища.

2. Архитектура

Клиент → Nginx → api1 / api2 → PostgreSQL, Redis и SeaweedFS (S3 API).

  • Go API: HTTP-обработчики пользователей, сессий, чатов, сообщений и вложений.
  • PostgreSQL 16: постоянные данные и метаданные вложений; SQL-миграции выполняет отдельный сервис migrate.
  • Redis 7: кэширование данных сессий.
  • SeaweedFS: S3-совместимое хранение оригиналов файлов в бакете messenger-attachments; данные размещены в постоянном Docker volume.
  • Nginx: входная точка http://localhost:8080, распределение запросов между двумя репликами API.
  • s3-init: однократная проверка/создание бакета посредством AWS CLI (awslocal из вспомогательного образа LocalStack). Сам LocalStack не используется как хранилище данных.

Для оригиналов используются серверные ключи вида original/<UUID>. Приложение использует переменные окружения для подключения к базе, Redis и S3; локальный .env не должен попадать в Git.

3. Запуск

Требуются Docker Desktop, Docker Compose, Git, Python 3.10+ и GNU Make. Создать .env на основе .env.example, указать собственные значения переменных окружения. Далее из корня репозитория:

docker compose --env-file .env config --quiet
docker compose --env-file .env up -d --build
docker compose --env-file .env ps -a
make check PYTHON="py -3"
make test PYTHON="py -3"

Остановить стенд без удаления данных:

docker compose --env-file .env down

Команда down -v удаляет постоянные тома и не применяется при проверке сохранности файлов.

4. Фактически выполненные проверки

Проверка Фактический результат
docker compose --env-file .env config --quiet Выполнено без ошибок
docker compose --env-file .env up -d --build Сервисы запущены; api1 и api2 имеют статус healthy; migrate и s3-init завершились с кодом 0
make check PYTHON="py -3" PASS (проводилось ранее в ходе работы)
make test PYTHON="py -3" PASS: lab4 public API scenario; infrastructure and grading evidence remain separate.
go test ./... в контейнере Go PASS (проводилось ранее в ходе работы)
Проверка S3-объекта после docker compose down и up -d head-object успешно вернул метаданные исходного PNG

Доказательство сохранности: после перезапуска контейнеров объект original/8d2f350f-8add-49a1-b7e0-6cad21911af1 остался доступен в бакете messenger-attachments. Команда s3api head-object вернула ContentLength: 111817, ContentType: image/png и ETag c2ab21400d8c13ea847e4d5d3c9832ad.

Пример команды проверки:

docker compose --env-file .env run --rm --no-deps --entrypoint awslocal s3-init --endpoint-url=http://s3:4566 s3api head-object --bucket messenger-attachments --key original/8d2f350f-8add-49a1-b7e0-6cad21911af1

5. Что ещё не подтверждено отдельным экспериментом

  • Отказоустойчивость запросов при принудительной остановке одной из двух реплик API.
  • Отказ в доступе к S3-объекту без авторизации (проверка приватности бакета).
  • Нагрузочные характеристики RPS, p50/p95/p99, потребление CPU/RAM.

Эти результаты не заявляются как проверенные. Успешный публичный smoke-тест не заменяет отдельные инфраструктурные испытания.

6. Ограничения

Стенд учебный и использует локальный HTTP; для внешнего доступа необходим TLS. Nginx, PostgreSQL, Redis и экземпляр SeaweedFS остаются потенциальными единичными точками отказа. Полной атомарности операций между PostgreSQL и S3 нет. Для промышленной эксплуатации потребуются ограниченные учётные данные S3, наблюдаемость, резервное копирование и дополнительные проверки безопасности.

7. Источники и инструменты

Исходные требования и контракты лабораторной работы, документация Go, PostgreSQL, Docker Compose и S3 API.