forked from mtusi2026/mtusi2026lab5
103 lines
6.2 KiB
Bash
103 lines
6.2 KiB
Bash
# Copy to .env for your LOCAL synthetic test environment; never commit .env.
|
||
# These are logical interface suggestions; map actual framework names in REPORT.md.
|
||
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
|
||
IDEMPOTENCY_TTL_SECONDS=86400
|
||
S3_ENDPOINT=http://s3: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
|
||
MAX_UPLOAD_BYTES=10485760
|
||
MAX_IMAGE_PIXELS=40000000
|
||
BROKER_URL_FILE=/run/secrets/broker_url
|
||
WORKER_CONCURRENCY=2
|
||
JOB_MAX_ATTEMPTS=5
|
||
JOB_TIMEOUT_SECONDS=60
|
||
STAGING_RETENTION_SECONDS=86400
|
||
|
||
|
||
# --- Дополнительные настройки этого решения (значения по умолчанию из src/messenger/config.py) ---
|
||
# API_REPLICAS — число реплик API за балансировщиком (deploy.replicas в compose.yaml).
|
||
# IDEMPOTENCY_TTL_SECONDS приложением не читается: ключ хранится вместе с сообщением
|
||
# бессрочно, то есть не меньше 24 ч из контракта (migrations/004_message_idempotency.sql).
|
||
# S3_ACCESS_KEY_ID_FILE / S3_SECRET_ACCESS_KEY_FILE — ключи отдельного пользователя S3 для API и worker
|
||
# (права только на свой bucket, secrets/s3_config.json). Ключи администратора S3 (secrets/s3_root_*)
|
||
# есть только у s3-init, в API и worker не передаются.
|
||
# Сколько секунд сессия может лежать в кэше Valkey (не дольше самой сессии).
|
||
SESSION_CACHE_TTL_SECONDS=30
|
||
# Пул соединений с PostgreSQL и таймауты.
|
||
DB_POOL_MIN_SIZE=1
|
||
DB_POOL_MAX_SIZE=10
|
||
DB_POOL_TIMEOUT_SECONDS=3
|
||
DB_CONNECT_TIMEOUT_SECONDS=3
|
||
DB_STATEMENT_TIMEOUT_MS=5000
|
||
# Valkey: таймаут операции, размер пула соединений, период фоновой проверки (PING).
|
||
CACHE_TIMEOUT_MS=300
|
||
CACHE_POOL_MAX_SIZE=20
|
||
CACHE_CHECK_INTERVAL_SECONDS=1
|
||
# Остановка по SIGTERM: сначала столько секунд /health/ready = 503 (уход из балансировки),
|
||
# потом не дольше GRACEFUL_SHUTDOWN_SECONDS на начатые запросы.
|
||
SHUTDOWN_DRAIN_SECONDS=3
|
||
GRACEFUL_SHUTDOWN_SECONDS=8
|
||
# S3: таймауты и число попыток (недоступный S3 -> быстрый 503).
|
||
S3_CONNECT_TIMEOUT_SECONDS=2
|
||
S3_READ_TIMEOUT_SECONDS=5
|
||
S3_MAX_ATTEMPTS=2
|
||
# Общий предел на одну операцию S3, включая DNS: ответ клиенту не дольше этого.
|
||
S3_OPERATION_TIMEOUT_SECONDS=6
|
||
# Readiness (с lab5): S3 проверяется фоном раз в S3_HEALTH_INTERVAL_SECONDS; нет успешной
|
||
# проверки дольше S3_HEALTH_MAX_AGE_SECONDS -> /health/ready = 503.
|
||
S3_HEALTH_INTERVAL_SECONDS=1
|
||
S3_HEALTH_MAX_AGE_SECONDS=3
|
||
# Приём файла: в памяти не больше UPLOAD_SPOOL_BYTES на загрузку (остальное — временный файл,
|
||
# удаляется после запроса); вся передача не дольше UPLOAD_TIMEOUT_SECONDS. Проверка структуры
|
||
# файла (без декодирования) — не больше IMAGE_CHECK_CONCURRENCY одновременно на реплику,
|
||
# очередь ждёт не дольше IMAGE_CHECK_WAIT_SECONDS (иначе 503).
|
||
UPLOAD_SPOOL_BYTES=1048576
|
||
UPLOAD_TIMEOUT_SECONDS=60
|
||
IMAGE_CHECK_CONCURRENCY=2
|
||
IMAGE_CHECK_WAIT_SECONDS=10
|
||
# --- с lab5: outbox, worker, повторы ---
|
||
# BROKER_URL_FILE — адрес RabbitMQ с паролем (secrets/broker_url). Пароль брокер получает
|
||
# файлом secrets/rabbitmq_credentials.conf. WORKER_CONCURRENCY — заданий одновременно
|
||
# и prefetch брокера; JOB_MAX_ATTEMPTS — всего попыток (первая + повторы);
|
||
# JOB_TIMEOUT_SECONDS — лимит времени одной попытки (дочерний процесс убивается);
|
||
# STAGING_RETENTION_SECONDS — сколько хранится оригинал failed-вложения для replay.
|
||
# Число worker-контейнеров (deploy.replicas в compose.yaml).
|
||
WORKER_REPLICAS=1
|
||
# Лимит памяти одной попытки (адресное пространство дочернего процесса, RLIMIT_AS).
|
||
WORKER_MEMORY_LIMIT_MB=640
|
||
# Backoff с jitter: пауза перед попыткой n+1 — случайная в [d/2, d], d = min(MAX, BASE * 2^(n-1)).
|
||
RETRY_BASE_SECONDS=2
|
||
RETRY_MAX_SECONDS=60
|
||
# Lease: аренда задания на JOB_LEASE_SECONDS, продление каждые JOB_HEARTBEAT_SECONDS;
|
||
# поиск истёкших аренд раз в REAPER_INTERVAL_SECONDS.
|
||
JOB_LEASE_SECONDS=30
|
||
JOB_HEARTBEAT_SECONDS=10
|
||
REAPER_INTERVAL_SECONDS=5
|
||
# Страховка от потерянного сообщения: queued без движения дольше этого — отправить ещё раз.
|
||
QUEUED_REPUBLISH_SECONDS=600
|
||
# Relay outbox: опрос таблицы (кроме мгновенного сигнала после загрузки) и размер пачки.
|
||
RELAY_POLL_SECONDS=1
|
||
RELAY_BATCH_SIZE=50
|
||
# Качество вариантов: JPEG (thumbnail, crop) и WebP (optimized; method 0..6 — скорость/размер).
|
||
JPEG_QUALITY=85
|
||
WEBP_QUALITY=80
|
||
WEBP_METHOD=4
|
||
# Уборка объектов S3 (фоновый поток worker): grace period, период, хранение отправленного outbox.
|
||
ATTACHMENT_GRACE_SECONDS=900
|
||
CLEANUP_INTERVAL_SECONDS=300
|
||
OUTBOX_RETENTION_SECONDS=604800
|
||
# Внедрение отказов для проверок (faults.py). ТОЛЬКО учебный стенд: точки отказа включаются
|
||
# файлами в /tmp/faults внутри контейнера, тесты создают их через docker exec.
|
||
FAULTS_ENABLED=1
|