Files
mtusi2026lab3/ARCHITECTURE.md
T

3.6 KiB

Архитектура лабораторной 3

Fiber/Fx/Zap, HTTP models → DTO → service → store. PostgreSQL — источник истины для данных, сессий и результатов идемпотентных записей. Valkey хранит профильный кэш и распределённые лимиты. Ключ подписи cursor общий, хранится в Secret.

Повтор сообщения сначала заново проходит аутентификацию, авторизацию и валидацию. Store блокирует строку чата, проверяет запись идемпотентности, затем в одной транзакции создаёт сообщение и результат. Ключ ограничен парой пользователь/чат (метод POST и endpoint сообщений фиксированы). Изменение body даёт конфликт; неуспешная транзакция не сохраняет результат. После 24 часов ключ допускает новую запись. Изоляция чатов предотвращает общий последовательный bottleneck всех записей.

Миграции выполняются командой server migrate в отдельном Kubernetes Job. API при старте проверяет версию схемы. Изменения схемы аддитивны. Job и API создаются одним Helm release; до завершения миграции новая API-реплика не готова, Kubernetes повторяет её запуск. При обновлении старая готовая реплика сохраняется благодаря maxUnavailable=0.

Образы хранятся в Timeweb Cloud Registry и закреплены digest. Локальный токен передаётся Docker через stdin; make init создаёт переносимый imagePullSecret вне Helm release и обновляет его при смене токена. Пароль PostgreSQL и ключ cursor при повторной инициализации сохраняются.

Traefik Ingress hl.agapov.space направляет запросы в Service api и отслеживает EndpointSlice без sticky sessions. Readiness проверяется каждые 2 секунды, timeout 2 секунды, исключение после двух ошибок. PreStop 3 секунды, shutdown timeout 5 секунд, terminationGracePeriodSeconds=20. TLS выдаёт letsencrypt-prod. Kubernetes управляет EndpointSlice, Deployment, rolling update и HPA. HPA использует CPU из metrics-server и не зависит от Grafana. Метрики HTTP имеют ограниченный набор route/method/status labels без user/chat/request ID.

Один namespace highload-applications; существующий release lab2 обновляется на реализацию lab3. Имена api/postgres/valkey, три шарда, PVC и пароль БД сохраняются. Один LB, PostgreSQL и координатор Valkey остаются точками отказа; трек отказа узла не заявляется.

Источники: HPA, metrics-server, PostgreSQL locking.