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.