forked from mtusi2026/mtusi2026lab6
Перенесено дерево lab5 целиком: NestJS-приложение (API + worker,
RabbitMQ, outbox, S3), Dockerfile, compose.yaml, infra/{haproxy,minio,
rabbitmq}, стендовые скрипты, scripts/lab4, scripts/lab5,
evidence/lab4, evidence/lab5 и contracts/extensions.openapi.json.
Задание lab6 оставлено своим: README, REPORT, COURSE, lab.json,
contracts/{openapi,infrastructure,jobs.schema,attachment-states,
examples,observability}, tests, compose.example.yaml, infra/otel,
.github/pull_request_template.md.
Адаптации при переносе:
- docker-проект mtusi-lab5 -> mtusi-lab6 и тег образа
mtusi-messenger:lab6 (compose.yaml, scripts/stop-one.sh, .env.example,
infra/README.md), чтобы тома и контейнеры не пересекались с lab5;
- Makefile: цели lab5 сохранены целиком (skeleton lab6 не отличается
от skeleton lab5);
- .env.example: переменные приложения и стенда lab5 + блок lab6
(OTEL_*) из skeleton.
125 lines
5.8 KiB
Bash
125 lines
5.8 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
|
||
DATABASE_IDLE_TX_TIMEOUT_MS=30000
|
||
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:lab6
|
||
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 брокера берётся из
|
||
# файла секрета (scripts/init-env.sh), байты и credentials в сообщения не
|
||
# попадают: только job_id/attachment_id/pipeline_version/attempt.
|
||
BROKER_URL_FILE=/run/secrets/broker_url
|
||
BROKER_DELIVERY_LIMIT=10
|
||
BROKER_PUBLISH_TIMEOUT_MS=5000
|
||
# Сколько заданий worker обрабатывает параллельно; prefetch равен этому числу.
|
||
WORKER_CONCURRENCY=2
|
||
JOB_MAX_ATTEMPTS=5
|
||
JOB_TIMEOUT_SECONDS=60
|
||
JOB_LEASE_SECONDS=30
|
||
JOB_RETRY_BASE_MS=1000
|
||
JOB_RETRY_MAX_MS=30000
|
||
PIPELINE_VERSION=1
|
||
OUTBOX_POLL_INTERVAL_MS=500
|
||
LEASE_REAPER_INTERVAL_MS=2000
|
||
# 0 выключает фоновую уборку staging (ручной запуск остаётся).
|
||
STAGING_CLEANUP_INTERVAL_MS=60000
|
||
# Сколько staging-объект неуспешной загрузки живёт до удаления.
|
||
STAGING_RETENTION_SECONDS=86400
|
||
WORKER_HEALTH_PORT=8081
|
||
QUEUED_RECONCILE_GRACE_SECONDS=15
|
||
OUTBOX_RETENTION_SECONDS=86400
|
||
JOB_EVENTS_RETENTION_SECONDS=2592000
|
||
# 1 включает чтение fault:<point> из Redis; в обычном стенде — 0.
|
||
FAULT_INJECTION_ENABLED=0
|
||
WORKER_REPLICAS=1
|
||
WORKER_CPUS=1.5
|
||
# Бюджет worker: база ≈250 MiB + WORKER_CONCURRENCY × (10 MiB исходник +
|
||
# ≈340 MiB худший декод 40 Мп) ≈ 950 MiB при concurrency 2; лимит 1280m.
|
||
WORKER_MEMORY=1280m
|
||
BROKER_CPUS=0.5
|
||
BROKER_MEMORY=512m
|
||
|
||
# lab6: наблюдаемость (OpenTelemetry). Логические имена из задания; worker
|
||
# обязан задать собственный service.name.
|
||
OTEL_SERVICE_NAME=messenger-api
|
||
OTEL_EXPORTER_OTLP_ENDPOINT=http://otel-collector:4318
|
||
OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf
|
||
OTEL_RESOURCE_ATTRIBUTES=deployment.environment.name=lab
|