Files
mtusi2026lab4/.env.example
T
ricoromaandClaude Opus 5.5 2e997f9b42 feat: add private S3 storage (SeaweedFS) with bootstrap and client
- s3 and s3-bootstrap services: SeaweedFS 4.48 pinned by digest,
  internals on loopback, signing key, private bucket, API user policy,
  privacy checks on every bootstrap
- [s3] settings and aiobotocore client in src/infra/s3: deadline per
  call, no retries, 503 on outage or rejected credentials
- make start_s3, stop_s3, s3_check; run_dev, test_isolated, wipe_data
  and restart hook include S3
- failure_checks with own S3 and readiness check without it; bench
  generates S3 secrets and filters them out of the passport
- rules, AGENTS.md, skill; sync health delta; KNOWN_ISSUES: rollout_from

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-20 20:12:04 +03:00

101 lines
6.0 KiB
Bash
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Шаблон .env: `make env_setup` создаёт из него .env, не перезаписывая
# существующий файл, и подставляет случайные значения в пустые
# POSTGRES_PASSWORD, VALKEY_PASSWORD и пять секретов S3 (S3_ROOT_*,
# S3_JWT_SIGNING_KEY, S3_API_*). В существующий .env новые строки
# переносятся руками, секреты для них — openssl rand -hex 32.
# .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, с lab4 — S3_ENDPOINT,
# S3_REGION, S3_BUCKET, S3_ACCESS_KEY_ID_FILE, S3_SECRET_ACCESS_KEY_FILE,
# MAX_UPLOAD_BYTES, MAX_IMAGE_PIXELS) — в REPORT.md, «Архитектура и
# решения». Имена skeleton S3_* буквально не заводятся: S3 настраивают
# строки блока S3 ниже.
# порт сервиса ([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}
# S3 (SeaweedFS) — байты вложений. Пять пустых секретов make env_setup
# заменяет случайными hex; без них compose не стартует. Кто какой секрет
# получает — docker-compose.yml, якоря x-s3-*
# имя bucket: читают приложение ([s3] bucket) и bootstrap S3, который его
# создаёт; 3–63 символа: строчные буквы, цифры, точка и дефис
S3__BUCKET=messenger
# административные ключ и секрет S3: только сервер s3 (без учётной
# записи он открыт анониму), ни API, ни bootstrap их не получают
S3_ROOT_ACCESS_KEY=
S3_ROOT_SECRET_KEY=
# ключ подписи служебных вызовов SeaweedFS (gRPC шлюза, IAM filer):
# сервер s3 и bootstrap
S3_JWT_SIGNING_KEY=
# ключи пользователя API (только объекты своего bucket): bootstrap
# заводит пользователя с ними, реплики API ходят с ними в S3. Новый
# секрет вступает в силу при следующем bootstrap (make run_docker)
S3_API_ACCESS_KEY=
S3_API_SECRET_KEY=
# адрес и порт API S3 внутри сети compose: по ним ходит API в docker,
# порт слушает сам сервер и проверяет bootstrap
S3_HOST=s3
S3_PORT=8333
# порт на 127.0.0.1 хоста, куда публикуется API S3: к нему подключается
# приложение в console (консоль и UI SeaweedFS не публикуются)
S3_OUT_PORT=8334
# мосты для console: в docker их задаёт environment compose
S3__HOST=127.0.0.1
S3__PORT=${S3_OUT_PORT}
S3__ACCESS_KEY_ID=${S3_API_ACCESS_KEY}
S3__SECRET_ACCESS_KEY=${S3_API_SECRET_KEY}
# make test_isolated: порт на 127.0.0.1, куда публикуется тестовый
# контейнер API
TEST_APP_PORT=18088