Files
mtusi2026lab5/.env.example
T
2026-10-25 21:43:03 +03:00

103 lines
6.2 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.
# 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