forked from mtusi2026/mtusi2026lab2
Тесты lab1 в student-tests работали через X-User-Id и для lab2 неактуальны. infra/postgres/init.sql дублировал миграции и нигде не подключался. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Инфраструктура
Сервисы
| Роль | Service | Образ | Назначение |
|---|---|---|---|
| API | api |
messenger-lab2-api:local |
FastAPI-приложение, порт 8080 |
| Database | db |
postgres:16.4-alpine |
Источник истины: пользователи, чаты, участники, сообщения, сессии |
| Cache | valkey |
valkey/valkey:8.0.1-alpine |
Кэш сессий sha256(token) → user, без persistence |
| Bootstrap | migrate |
messenger-lab2-api:local |
Одноразовый прогон migrations/*.sql, затем api стартует |
| Tests | api_short_ttl |
messenger-lab2-api:local |
Профиль tests: второй API с SESSION_TTL_SECONDS=3, порт 8081 |
| Tools | db_checks |
messenger-lab2-api:local |
Профиль tools: rollback и EXPLAIN внутри сети compose |
Порты db и valkey наружу не публикуются.
Healthchecks
db:pg_isready;migrateиapiждутservice_healthy.valkey:valkey-cli pingс паролем.api:/health/live(процесс жив),/health/ready(PostgreSQL отвечает). Недоступность Valkey не делает API not ready: кэш обходится.
Запуск
sh scripts/init-secrets.sh
docker compose up -d --build
# для автоматической проверки expiry:
docker compose --profile tests up -d api_short_ttl
Persistence
- Данные PostgreSQL хранятся в named volume
postgres_data. - Valkey намеренно запускается с
--save "" --appendonly no: это кэш, а не хранилище. После рестарта/flush сессии читаются из PostgreSQL и снова кэшируются. docker compose restart,stop/startиdownбез-vданные не удаляют.docker compose down -vудаляет volume — это осознанный сброс учебных данных, в restart-сценарии его использовать нельзя.
Credentials
scripts/init-secrets.sh создаёт в infra/secrets/ случайные
postgres_password.txt, database_url.txt, valkey_password.txt, cache_url.txt
(существующие файлы не перезаписываются). В контейнеры они попадают как Docker
secrets (/run/secrets/*), приложение читает *_FILE. Каталог в .gitignore
и .dockerignore.