Files
mtusi2026lab6/app/cmd/messenger/main.go
T

215 lines
9.9 KiB
Go

// messenger — сервер API мессенджера, один процесс одной реплики. Своего состояния у реплики нет:
// данные лежат в PostgreSQL, сессии в Valkey, поэтому реплик может быть несколько.
//
// Здесь только сборка: загрузка настроек, подключения, создание сервисов, запуск HTTP-сервера и
// штатное завершение по SIGTERM. Логика находится в internal.
package main
import (
"context"
"fmt"
"log/slog"
"os"
"os/signal"
"runtime"
"syscall"
"time"
httpapi "gitflic.ru/project/relationskatie/mtusi2026lab1-ashchkl/internal/api/http"
"gitflic.ru/project/relationskatie/mtusi2026lab1-ashchkl/internal/cache"
"gitflic.ru/project/relationskatie/mtusi2026lab1-ashchkl/internal/config"
"gitflic.ru/project/relationskatie/mtusi2026lab1-ashchkl/internal/logging"
"gitflic.ru/project/relationskatie/mtusi2026lab1-ashchkl/internal/objectstore"
"gitflic.ru/project/relationskatie/mtusi2026lab1-ashchkl/internal/password"
"gitflic.ru/project/relationskatie/mtusi2026lab1-ashchkl/internal/service"
"gitflic.ru/project/relationskatie/mtusi2026lab1-ashchkl/internal/session"
"gitflic.ru/project/relationskatie/mtusi2026lab1-ashchkl/internal/store"
"gitflic.ru/project/relationskatie/mtusi2026lab1-ashchkl/internal/store/db"
"gitflic.ru/project/relationskatie/mtusi2026lab1-ashchkl/internal/telemetry"
)
// main запускает сервер и завершается после сигнала остановки. При ошибке запуска код выхода 1.
// os.Exit не выполняет defer, поэтому перед ним подключение к БД закрывается явно.
func main() {
// Настройки из окружения. Логгера ещё нет, поэтому ошибка идёт прямо в stderr.
cfg, err := config.Load()
if err != nil {
fmt.Fprintln(os.Stderr, err)
os.Exit(1)
}
logger, err := logging.New(cfg.Logger.Level, cfg.Env, cfg.Version)
if err != nil {
fmt.Fprintln(os.Stderr, err)
os.Exit(1)
}
slog.SetDefault(logger)
shutdownTelemetry, err := telemetry.Init(context.Background())
if err != nil {
logger.Error("telemetry init failed")
os.Exit(1)
}
defer shutdownTelemetry()
// Пул подключений к PostgreSQL. Без БД реплика работать не может и завершается: Docker её перезапустит.
pool, err := db.Connect(context.Background(), cfg.Database)
if err != nil {
logger.Error("database connect failed", slog.Any("err", err))
os.Exit(1)
}
// Хранилище с таймаутом запросов на все обращения к БД.
storage := db.New(pool, time.Duration(cfg.Database.QueryTimeoutMs)*time.Millisecond)
defer storage.Close()
// Общее хранилище сессий в Valkey: токен, выданный одной репликой, принимают все остальные.
sessClient, err := session.Connect(context.Background(), cfg.Cache)
if err != nil {
logger.Error("session store connect failed", slog.Any("err", err))
storage.Close()
os.Exit(1)
}
defer sessClient.Close()
sessions := session.NewValkey(sessClient)
// Хеширование паролей. Оно тяжёлое, поэтому одновременных вычислений не больше числа ядер и не больше 4.
hasher := password.NewHasher(password.Default, min(runtime.GOMAXPROCS(0), 4))
auth, err := service.NewAuth(storage, sessions, hasher, time.Duration(cfg.Session.TTLSeconds)*time.Second)
if err != nil {
logger.Error("auth init failed", slog.Any("err", err))
storage.Close()
os.Exit(1)
}
// История сообщений по умолчанию читается прямо из БД. Кэш подключается, только если он включён,
// и заменяет собой источник: остальной код разницы не видит.
var messages store.MessageStore = storage
if cfg.HistoryCache.Mode != cache.ModeOff {
hcClient, err := cache.Connect(cfg.HistoryCache)
if err != nil {
logger.Error("history cache config failed", slog.Any("err", err))
storage.Close()
os.Exit(1)
}
defer hcClient.Close()
hc := cache.New(storage.Messages, hcClient, cache.Options{
Mode: cfg.HistoryCache.Mode,
Outbox: storage.Messages,
PageTTL: time.Duration(cfg.HistoryCache.PageTTLSeconds) * time.Second,
FillDelay: time.Duration(cfg.HistoryCache.FillDelayMs) * time.Millisecond,
Logger: logger,
})
defer hc.Close()
messages = hc
}
logger.Info("history cache", slog.String("mode", cfg.HistoryCache.Mode))
// Клиент S3 не обращается к серверу при создании: bucket готовит сервис s3-init.
objects, err := objectstore.NewS3(cfg.S3)
if err != nil {
logger.Error("object store config failed", slog.Any("err", err))
storage.Close()
os.Exit(1)
}
// Сборка HTTP-сервера из готовых зависимостей.
srv := httpapi.NewServer(httpapi.Deps{
Config: cfg,
Logger: logger,
Store: storage,
Auth: auth,
Users: service.NewUsers(storage, hasher),
Chats: service.NewChats(storage),
Messages: service.NewMessages(messages),
Attachments: service.NewAttachments(storage, objects, service.AttachmentLimits{
MaxUploadBytes: cfg.Attachments.MaxUploadBytes,
MaxImagePixels: cfg.Attachments.MaxImagePixels,
MaxConcurrentUploads: cfg.Attachments.MaxConcurrentUploads,
}, logger),
// Readiness: реплика готова, только если доступны и БД, и Valkey. Иначе LB выведет её из
// работы. Схему БД эта проверка не проверяет. S3 сюда намеренно не входит: без него
// недоступны только вложения (503), а пользователи и текстовые сообщения продолжают работать.
// Если бы S3 входил в readiness, его отказ снял бы с балансировки все реплики сразу.
Ready: func(ctx context.Context) error {
if err := storage.Ping(ctx); err != nil {
return err
}
return sessions.Ping(ctx)
},
})
// ctx отменяется при SIGTERM (docker stop) или Ctrl+C: это начало штатного завершения.
ctx, stop := signal.NotifyContext(context.Background(), os.Interrupt, syscall.SIGTERM)
defer stop()
// Фоновая очистка старых ключей идемпотентности. Останавливается вместе с ctx.
go purgeIdempotencyKeys(ctx, storage, time.Duration(cfg.Idempotency.TTLSeconds)*time.Second, logger)
// Сервер блокирует поток до остановки, поэтому запускается отдельно. Буфер 1 не даёт горутине
// зависнуть на отправке, если её уже никто не ждёт.
startErr := make(chan error, 1)
go func() {
startErr <- srv.Start()
}()
// Ждём первое из двух событий: сервер сам завершился или пришёл сигнал остановки.
select {
case err := <-startErr:
if err != nil {
logger.Error("server failed to start", slog.Any("err", err))
storage.Close()
os.Exit(1)
}
case <-ctx.Done():
logger.Info("shutdown signal received")
// Drain: readiness начинает отвечать 503, но запросы ещё обслуживаются. За это время LB
// выводит реплику, поэтому новые запросы перестают приходить до закрытия порта.
srv.Drain(time.Duration(cfg.HTTP.ShutdownDrainMs) * time.Millisecond)
}
// Предел на завершение открытых запросов. Он должен быть меньше stop_grace_period в compose.yaml,
// иначе Docker пришлёт SIGKILL раньше.
shutdownCtx, cancel := context.WithTimeout(
context.Background(),
time.Duration(cfg.HTTP.ShutdownTimeoutMs)*time.Millisecond,
)
defer cancel()
// Закрыть порт и дождаться открытых запросов. Если не успели за предел, это ошибка завершения.
if err := srv.Shutdown(shutdownCtx); err != nil {
logger.Error("shutdown failed", slog.Any("err", err))
storage.Close()
os.Exit(1)
}
// Эта строка в логе подтверждает штатное завершение: её ищет failure-detection.py.
logger.Info("server stopped cleanly")
}
// Как часто удалять устаревшие ключи идемпотентности.
const idempotencyPurgeInterval = time.Hour
// purgeIdempotencyKeys удаляет ключи старше ttl: сразу при запуске и затем по таймеру. Ошибка не
// опасна: очистка просто повторится позже. Удаление работает на каждой реплике, это безопасно,
// потому что удалять будет нечего после первой из них.
func purgeIdempotencyKeys(ctx context.Context, storage *db.DB, ttl time.Duration, logger *slog.Logger) {
t := time.NewTicker(idempotencyPurgeInterval)
defer t.Stop()
for {
if n, err := storage.PurgeIdempotencyKeys(ctx, ttl); err != nil {
// Ошибка из-за остановки сервера ожидаема: просто выходим.
if ctx.Err() != nil {
return
}
logger.Warn("idempotency keys purge failed", slog.Any("err", err))
} else if n > 0 {
logger.Info("idempotency keys purged", slog.Int64("count", n))
}
select {
case <-ctx.Done():
return
case <-t.C:
}
}
}