Files
2026-10-06 22:45:35 +03:00
..
2026-10-06 22:45:35 +03:00
2026-10-06 22:45:35 +03:00
2026-10-06 22:45:35 +03:00
2026-10-06 22:45:35 +03:00

Локальный стенд lab2

make up создаёт локальные секреты и запускает compose.yaml: API, PostgreSQL 17.6, Redis 7.4.5. Единственный опубликованный порт — API на 127.0.0.1:8080. Порт 8080 используется по умолчанию, параметр PORT можно не передавать.

./scripts/compose.sh выбирает Docker Compose plugin либо standalone docker-compose; он использует --env-file /dev/null. Настройки задаются Compose-манифестом и переменными процесса, автоматическое чтение локальных env-файлов не требуется.

make bootstrap генерирует secrets/postgres_password и secrets/cursor_key только при отсутствии содержимого. Файлы не печатаются и исключены из Git и Docker context. Каталог имеет права 0700, файлы 0444 для чтения непривилегированным API через Compose secrets на Linux. Не меняйте пароль PostgreSQL при существующем volume без ALTER ROLE. Не меняйте cursor_key, если нужно сохранить действительность выданных cursor.

Настройки API

Переменная По умолчанию Назначение
PORT 8080 Порт процесса; в Compose внешний PORT перенаправляется на внутренний 8080
POSTGRES_HOST / POSTGRES_PORT localhost / 5432 Адрес PostgreSQL; в Compose host=postgres
POSTGRES_USER / POSTGRES_DB messenger / messenger Роль и БД
POSTGRES_PASSWORD_FILE обязателен файл или POSTGRES_PASSWORD Пароль, созданный bootstrap
POSTGRES_MAX_CONNS 10 Верхняя граница pgxpool (min=1, idle=5m, lifetime=1h)
REDIS_ADDR localhost:6379 В Compose redis:6379
QUERY_TIMEOUT_MS 2000 Таймаут SQL, соединения, Redis, ожидания пула
SESSION_TTL_SECONDS 3600 Абсолютный срок сессии; для проверки expiry 2
CURSOR_KEY_FILE обязателен файл или CURSOR_KEY 32 случайных байта в hex для HMAC cursor

Миграции применяет goose CLI v3.27.1 в отдельном сервисе migrations. Compose запускает API только после успешного goose up. В бинарнике API нет кода миграций. SQL-файлы содержат -- +goose Up и -- +goose Down; версия хранится в goose_db_version, DDL и версия коммитятся одной транзакцией. Миграции выполняет один сервис, параллельные ручные запуски не предполагаются. Схема описана в schema.md.

  • make migrate — собрать утилиту и выполнить goose up.
  • make migrate-status — показать применённые версии.
  • make migrate-down — откатить последнюю миграцию. Для начальной миграции это удаление всех таблиц приложения и данных; используйте только намеренно.
  • Проверка SQL без БД: goose -env /dev/null -dir migrations validate.

Контейнер получает пароль через POSTGRES_PASSWORD_FILE и передаёт его драйверу через PGPASSWORD, без пароля в argv. -env /dev/null отключает автоматическую загрузку dotenv. Для локального goose задайте GOOSE_DRIVER=postgres и GOOSE_DBSTRING с адресом/пользователем/БД, затем используйте тот же -dir migrations.

При переходе с прежнего runner миграция 001 распознаёт schema_migrations с записью 001_initial.sql и наличием четырёх таблиц приложения. Goose фиксирует версию 1 без повторного DDL; данные сохраняются. Старый журнал остаётся только для совместимости и больше не используется для новых версий. Отсутствующая часть старой схемы приводит к ошибке, а не к молчаливому пропуску миграции.

PostgreSQL и Redis имеют отдельные именованные volumes. make down сохраняет их. scripts/restart.sh останавливает и запускает API, PostgreSQL и Redis, не удаляя volumes. Redis: TTL через SET PXAT, appendonly=yes, appendfsync=always, без eviction. При исчерпании памяти запись сессии отклоняется с 503 вместо удаления действующих сессий. Ready проверяет обе зависимости, live — только HTTP-процесс.