# Шаблон .env: `make env_setup` создаёт из него .env, не перезаписывая # существующий файл, и подставляет случайные POSTGRES_PASSWORD и # VALKEY_PASSWORD. В существующий .env новые строки переносятся руками. # .env не коммитить. .env читают compose, Makefile и приложение # (pydantic-settings); в контейнеры он не попадает. # Параметры приложения — в формате настроек SECTION__FIELD, без секции — # только то, что приложение не читает. Комментарии — только отдельными # строками: make оставляет хвостовой комментарий частью значения. # Соответствие переменным skeleton (APP_HOST, APP_PORT, APP_ENV, # SESSION_TTL_SECONDS, DATABASE_URL_FILE, SESSION_STORE, CACHE_URL_FILE, # с lab3 — API_REPLICAS, IDEMPOTENCY_TTL_SECONDS) — в REPORT.md, # «Архитектура и решения». # порт сервиса ([app] port): на нём слушает приложение, его же # публикует compose, на нём же healthcheck APP__PORT=8080 # порт на 127.0.0.1 хоста, куда публикуется балансировщик HAProxy — # единственная точка входа; приложение его не читает APP_OUT_PORT=8080 # число реплик сервиса api за балансировщиком (имя skeleton); читают # compose (deploy.replicas) и Makefile, приложение — нет. Разовая # подмена — make replicas API_REPLICAS=N API_REPLICAS=2 # PostgreSQL. POSTGRES_USER, POSTGRES_PASSWORD и POSTGRES_DB читает и # образ postgres; пароль задаётся только при первом создании volume. # Пустой пароль образ postgres не принимает: make env_setup подставляет # случайный POSTGRES_USER=messenger POSTGRES_PASSWORD= POSTGRES_DB=messenger # адрес и порт Postgres внутри сети compose: по ним ходят API и миграции # в docker, порт слушает сам сервер (PGPORT) POSTGRES_HOST=postgres POSTGRES_PORT=5432 # порт на 127.0.0.1 хоста, куда публикуется Postgres: к нему подключается # приложение в console POSTGRES_OUT_PORT=5433 # мосты для console: приложение на хосте берёт значения отсюда, в docker # их задаёт environment compose DATABASE__HOST=127.0.0.1 DATABASE__PORT=${POSTGRES_OUT_PORT} DATABASE__USER=${POSTGRES_USER} DATABASE__PASSWORD=${POSTGRES_PASSWORD} DATABASE__NAME=${POSTGRES_DB} # Valkey — кэш карточек чатов. Пароль читают и сервер (--requirepass), и # приложение; пустой make env_setup заменяет случайным VALKEY_PASSWORD= # адрес и порт Valkey внутри сети compose: по ним ходит API в docker, # порт слушает сам сервер VALKEY_HOST=valkey VALKEY_PORT=6379 # порт на 127.0.0.1 хоста, куда публикуется Valkey: к нему подключается # приложение в console VALKEY_OUT_PORT=6380 # мосты для console: в docker их задаёт environment compose CACHE__HOST=127.0.0.1 CACHE__PORT=${VALKEY_OUT_PORT} CACHE__PASSWORD=${VALKEY_PASSWORD} # make test_isolated: порт на 127.0.0.1, куда публикуется тестовый # контейнер API TEST_APP_PORT=18088