Локальный стенд 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-процесс.