forked from mtusi2026/mtusi2026lab5
Перенесено дерево lab4 целиком: NestJS-приложение с вложениями и S3,
Dockerfile, compose.yaml, infra/{haproxy,minio}, стендовые скрипты,
scripts/lab4, evidence/lab4 и contracts/extensions.openapi.json.
Задание lab5 оставлено своим: README, REPORT, COURSE, lab.json,
contracts/{openapi,infrastructure,jobs.schema,attachment-states,examples},
tests, compose.example.yaml, .github/pull_request_template.md.
Адаптации при переносе:
- docker-проект mtusi-lab4 -> mtusi-lab5 и тег образа mtusi-messenger:lab5,
чтобы тома и контейнеры не пересекались с lab4 (scripts/stop-one.sh:
LAB_PROJECT вместо LAB4_PROJECT);
- Makefile: цели lab5 сохранены, добавлены стендовые (stand-up/down,
wait-ready, init-env, test-e2e, test-dependencies, s3-security,
consistency, bench);
- .env.example: реальные переменные приложения и стенда lab4 (без них
compose.yaml не поднимается) + блок lab5 (BROKER_URL_FILE, WORKER_*).
92 lines
4.3 KiB
Bash
92 lines
4.3 KiB
Bash
# Copy to .env for your LOCAL synthetic test environment; never commit .env.
|
||
# Полный список переменных, которые читают приложение и стенд; значения-образцы
|
||
# не являются секретами. Соответствие «переменная -> фактическая конфигурация»
|
||
# описано в REPORT.md.
|
||
#
|
||
# Приложение (проверяется zod-схемой app/src/config/app-config.schema.ts):
|
||
APP_HOST=0.0.0.0
|
||
APP_PORT=8080
|
||
APP_ENV=lab
|
||
SESSION_TTL_SECONDS=3600
|
||
DATABASE_URL=postgresql://messenger:change-me@postgres:5432/messenger
|
||
REDIS_URL=redis://redis:6379
|
||
DATABASE_POOL_MAX=10
|
||
DATABASE_CONNECTION_TIMEOUT_MS=5000
|
||
DATABASE_STATEMENT_TIMEOUT_MS=5000
|
||
CACHE_TTL_SECONDS=30
|
||
CACHE_MODE=protected
|
||
CACHE_LOCK_TTL_MS=1000
|
||
CACHE_MISS_DELAY_MS=0
|
||
# Бюджет проверки зависимостей в /health/ready: LB пробует ту же ручку
|
||
# (timeout check 500 ms), поэтому проба обязана уложиться заметно раньше.
|
||
HEALTH_TIMEOUT_MS=400
|
||
# Токен доступа к /internal/metrics; сгенерируйте свой.
|
||
METRICS_TOKEN=change-me
|
||
# Дрейн перед выходом по SIGTERM: реплика перестаёт проходить пробы LB,
|
||
# ждёт DRAIN_DELAY_MS (длиннее обнаружения отказа ~1 s) и только потом закрывается.
|
||
DRAIN_DELAY_MS=3000
|
||
# Переопределяет X-Instance-Id; по умолчанию это hostname контейнера
|
||
# (= короткий ID контейнера, по нему работает scripts/stop-one.sh).
|
||
# INSTANCE_ID=api-1
|
||
IDEMPOTENCY_TTL_SECONDS=86400
|
||
|
||
# Стенд (compose.yaml и scripts/):
|
||
API_REPLICAS=2
|
||
API_CPUS_PER_REPLICA=1.5
|
||
API_MEMORY_PER_REPLICA=1024m
|
||
PG_CPUS=1.5
|
||
PG_MEMORY=512m
|
||
REDIS_CPUS=0.25
|
||
REDIS_MEMORY=128m
|
||
LB_CPUS=0.25
|
||
LB_MEMORY=128m
|
||
# Тег образа API; BUILD_ID отличает сборки при rolling update.
|
||
API_IMAGE=mtusi-messenger:lab5
|
||
BUILD_ID=local
|
||
APP_PUBLIC_PORT=8080
|
||
LB_STATS_PORT=8404
|
||
# Loopback-порты PostgreSQL/Redis нужны только операторским проверкам с хоста
|
||
# (make test-e2e, psql). API-реплики портов не публикуют.
|
||
POSTGRES_PUBLISHED_PORT=5432
|
||
REDIS_PUBLISHED_PORT=6379
|
||
|
||
# PostgreSQL (пароль подставьте свой; тот же, что в DATABASE_URL):
|
||
POSTGRES_DB=messenger
|
||
POSTGRES_USER=messenger
|
||
POSTGRES_PASSWORD=change-me
|
||
|
||
# Объектное хранилище MinIO. Credentials — файлы ./secrets/* (scripts/init-env.sh), не здесь.
|
||
S3_ENDPOINT=http://s3:9000
|
||
S3_PUBLIC_ENDPOINT=http://localhost:9000
|
||
S3_REGION=us-east-1
|
||
S3_BUCKET=messenger-attachments
|
||
S3_PUBLIC_BIND=127.0.0.1
|
||
S3_PUBLIC_PORT=9000
|
||
S3_CPUS=1.0
|
||
S3_MEMORY=512m
|
||
S3_CONNECT_TIMEOUT_MS=1000
|
||
S3_REQUEST_TIMEOUT_MS=15000
|
||
MAX_UPLOAD_BYTES=10485760
|
||
MAX_IMAGE_PIXELS=40000000
|
||
# Каждая загрузка держит копию файла (≤ MAX_UPLOAD_BYTES) до полного декода;
|
||
# худший декод (40 Мп RGBA16 interlaced PNG) ≈ 340 MiB. Граница памяти реплики:
|
||
# базовый RSS (~250 MiB) + UPLOAD_MAX_IN_FLIGHT × 10 MiB + IMAGE_DECODE_MAX_CONCURRENT × 340 MiB
|
||
# = 250 + 160 + 340 ≈ 750 MiB при API_MEMORY_PER_REPLICA=1024m.
|
||
UPLOAD_MAX_IN_FLIGHT=16
|
||
# Не больше стольких одновременных загрузок одного пользователя на реплику.
|
||
UPLOAD_MAX_IN_FLIGHT_PER_USER=4
|
||
IMAGE_DECODE_MAX_CONCURRENT=1
|
||
DIRECT_UPLOAD_MAX_PENDING_PER_USER=10
|
||
# UPLOAD_TIMEOUT_MS, DIRECT_UPLOAD_URL_TTL_SECONDS, ATTACHMENT_SWEEP_GRACE_SECONDS,
|
||
# ATTACHMENT_SWEEP_INTERVAL_MS задаются в compose.yaml (environment) с умолчаниями
|
||
# и переопределяются из shell только для экспериментов.
|
||
|
||
# lab5: очередь и асинхронная обработка изображений. Пока не реализовано —
|
||
# приложение эти переменные не читает. URL брокера берётся из файла секрета,
|
||
# байты и credentials в сообщения не попадают.
|
||
BROKER_URL_FILE=/run/secrets/broker_url
|
||
WORKER_CONCURRENCY=2
|
||
JOB_MAX_ATTEMPTS=5
|
||
JOB_TIMEOUT_SECONDS=60
|
||
STAGING_RETENTION_SECONDS=86400
|