6.2 KiB
Отчёт — лабораторная 2
- Автор, группа: Березин Герман / БВТ2304
- Целевая оценка; выбранный трек 5, если нужен: 4
- Commit/PR: TODO после публикации
- Использованные источники, библиотеки и помощь ИИ: Go stdlib, jackc/pgx/v5, redis/go-redis/v9, golang.org/x/crypto/argon2, Docker Compose, PostgreSQL docs (transactions/EXPLAIN), Valkey persistence; contracts/openapi.json; ИИ — помощь в реализации по заданию; база — собственный lab1 (mtusi2026lab1-fork)
Запуск из чистого clone
Нужны: Docker + Compose, Python 3.9+, make, openssl. Go на хосте не обязателен.
cp .env.example .env
./scripts/mksecrets.sh
docker compose --env-file .env up -d --build
# дождаться /health/ready
make test
make test-own test-race test-rollback
make test-persistence ACTION_SCRIPT=scripts/restart.sh
make test-expiry test-deps explain
Остановка: docker compose --env-file .env down (volumes сохраняются).
Намеренное удаление учебных данных: docker compose --env-file .env down -v.
Образы (pinned tag+digest):
golang:1.26-alpine@sha256:c95332c2af86b6d89b91bd0500f4b9529ccbd090a0d1855c6d1ceaa142ae8615alpine:3.21@sha256:ce64758a109eb420d874a118f87920e625e12d3634e03b4a5573fd9f6e5d3507postgres:17-alpine@sha256:b0f9560a2de083e2cc7382e75f808c7381a32852a7ec49117deedb300e552b24valkey/valkey:8.1-alpine@sha256:081c2f5cb575efc901aa80ff9cdbd1ec6a301682fd35e1ebb4b0990a4a4a8507
Конфиг: APP_HOST, APP_PORT, APP_ENV, SESSION_TTL_SECONDS, SHUTDOWN_TIMEOUT_SECONDS, SESSION_STORE=postgres, DATABASE_URL_FILE, CACHE_URL_FILE. Секреты в ./secrets/ (не в git): postgres_password, database_url, cache_url.
Миграции применяются API при старте (embed + таблица schema_migrations); повторный запуск не дублирует схему/данные.
Архитектура и решения
Клиент → API (Go) → PostgreSQL (источник истины: users/chats/members/messages/sessions)
↘ Valkey (кэш сессий sess:<sha256>, TTL = остаток жизни)
Перенесено из lab1: формат ошибок/X-Request-Id, валидация, keyset-cursor, graceful shutdown, multi-stage Dockerfile.
Изменено: RAM-store → PostgreSQL; X-User-Id → Basic login + opaque Bearer; добавлен Valkey как кэш.
Источник истины сессий — Postgres (sessions.token_hash = sha256(token), expires_at). Valkey — кэш; при miss/ошибке кэша читаем Postgres и (при успехе) пишем кэш. Logout: DELETE в Postgres + DEL в Valkey. TTL не продлевается рестартом.
Транзакции:
- создание чата: одна tx
insert chats+insert chat_members; FK/unknown member → rollback → 400; - регистрация:
UNIQUE(username), гонка → SQLSTATE 23505 → 409; - сообщение: один
INSERT.
Пул: MaxConns=10, MinConns=2, ConnectTimeout=3s, query timeout 3s; только параметризованные запросы.
Пароли: argon2id (m=65536,t=2,p=1). Токен: 32 random bytes (256 bit), base64url.
/health/ready проверяет только Postgres (Valkey некритичен).
Индекс истории: messages_history_idx (chat_id, created_at, id) под keyset
(created_at, id) > ($cursor) + ORDER BY created_at, id LIMIT n.
EXPLAIN на 10001 сообщении: Index Cond по messages_history_idx; OFFSET 5000 сортирует ≥5050 строк (evidence/explain.txt).
Доказательства критериев
| Критерий README | Команда/сценарий | Наблюдаемый результат | Файл доказательства |
|---|---|---|---|
| Публичный smoke | make test |
PASS lab2 public API | evidence/smoke.txt |
| Offline check | make check |
PASS skeleton | evidence/smoke.txt |
| Persistence + session | make test-persistence ACTION_SCRIPT=scripts/restart.sh |
PASS; StartedAt api/postgres/valkey сменились, volumes сохранены | evidence/persistence.txt |
| Own negative/auth | make test-own |
10 tests OK | evidence/own-tests.txt |
| Race username | make test-race |
created=1 conflict=19 | evidence/race-register.txt |
| Rollback chat | make test-rollback |
PASS, чат не в списке | evidence/rollback.txt |
| Session expiry | make test-expiry |
200 → sleep → 401 при TTL=2 | evidence/expiry.txt |
| Deps down | make test-deps |
valkey down → 200; postgres down → 503/503 | evidence/deps-down.txt |
| EXPLAIN index | make explain |
Index Scan на messages_history_idx, 10001 msgs | evidence/explain.txt |
Эксперименты и отказы
Уровень 5 не заявлен.
| Воздействие | Что ожидаем | Что наблюдали | Время восстановления / потеря данных |
|---|---|---|---|
scripts/restart.sh (stop+start всех сервисов) |
тот же Bearer читает те же данные | PASS persistence | ~несколько секунд; данные в volumes |
| Valkey stop | обход кэша, сессия из Postgres | /users/me 200 |
мгновенно; без потери |
| Postgres stop | ready/бизнес → 503 | 503/503 | после start — 200, данные на месте |
| SESSION_TTL_SECONDS=2 | после expiry 401 | 200 затем 401 | сессия отозвана по времени |
Ограничения и следующие шаги
Один API-процесс, нет LB/идемпотентности (lab3+). Valkey с AOF, но для оценки 4 он кэш, не единственное хранилище сессий. Нет delete API — тестовые данные копятся в volume. Следующий шаг курса — балансировка и idempotency.