lab5: базовый коммит из lab4 (abba248)

Перенесено дерево 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_*).
This commit is contained in:
2026-11-04 23:44:11 +03:00
parent 276dbdad8a
commit 1982bdb690
153 changed files with 21742 additions and 11 deletions
+75 -9
View File
@@ -1,23 +1,89 @@
# Copy to .env for your LOCAL synthetic test environment; never commit .env.
# These are logical interface suggestions; map actual framework names in REPORT.md.
# Полный список переменных, которые читают приложение и стенд; значения-образцы
# не являются секретами. Соответствие «переменная -> фактическая конфигурация»
# описано в 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
# Choose credentials locally. File paths contain no secret values.
DATABASE_URL_FILE=/run/secrets/database_url
# Optional on 3, required use on 4 in lab2; Redis OR Valkey:
SESSION_STORE=postgres
CACHE_URL_FILE=/run/secrets/cache_url
API_REPLICAS=2
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_ACCESS_KEY_ID_FILE=/run/secrets/s3_access_key_id
S3_SECRET_ACCESS_KEY_FILE=/run/secrets/s3_secret_access_key
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