Files
mtusi2026lab4/config_example.toml
T
ricoromaandClaude Opus 5.5 8d4cf7eebf feat: add reconcile strategies, deep check, rate limit and cost profile
- reconcile --strategy head, --deep (checksum_mismatch), restore needs the same SHA-256
- [reconciler] max_objects_per_second (2000), pause interrupted by signal
- --apply stops rechecks once the limit is exceeded (unchecked)
- pass cost in the summary: S3 objects and requests, bytes, DB sessions, phases
- S3 client counters, cleaner exits with os._exit after main()
- fault tests, hook args, driver reconcile-signal --pace
- bench profile reconcile / reconcile_quick: fill outside the API, gateway metrics, background load
- sync spec deltas, rules, AGENTS.md, PLAN.md

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-23 04:52:56 +03:00

124 lines
7.5 KiB
TOML
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.
# Шаблон config.toml: `make env_setup` копирует его, не перезаписывая
# существующий файл. Приоритет: окружение > .env > config.toml >
# значения по умолчанию. Любой параметр можно задать и через
# окружение: SECTION__FIELD, например APP__LOG_LEVEL.
[app]
# Режим (console / docker) задают Makefile, Dockerfile и compose через
# APP__RUN_MODE, а порт — APP__PORT в .env; здесь их не указывать.
log_level = "INFO"
# сколько секунд uvicorn ждёт текущие запросы после SIGTERM
graceful_shutdown_seconds = 8
# сколько секунд uvicorn держит простаивающее keep-alive соединение;
# больше, чем HAProxy держит простаивающее соединение с репликой (timeout
# http-keep-alive 10 с, http-reuse never в infra/haproxy/haproxy.cfg):
# простаивающее соединение закрывает LB
keep_alive_seconds = 60
# instance_id (X-Instance-Id) здесь не задавать: config.toml общий у всех
# реплик, а значение должно различаться. Без него берётся hostname
# процесса (в compose — короткий ID контейнера); в консоли его можно
# заменить окружением APP__INSTANCE_ID.
[database]
# Адрес, порт, пользователь, пароль и имя базы приходят из .env (мосты к
# POSTGRES_*) и из environment compose; здесь их не указывать.
pool_size = 10
# 0 — без переполнения: соединения сверх pool_size переоткрывались бы
max_overflow = 0
# секунды ожидания свободного соединения пула
pool_timeout_seconds = 5
# секунды на установку соединения
connect_timeout_seconds = 3
# миллисекунды, серверный statement_timeout; 0 — без ограничения
statement_timeout_ms = 5000
# секунды на всю работу запроса с БД: зависший сервер, обрыв сети
request_timeout_seconds = 6
# миллисекунды, серверный idle_in_transaction_session_timeout: транзакцию
# замороженной реплики PostgreSQL прерывает и снимает её блокировки.
# 0 — без ограничения, иначе больше request_timeout_seconds
idle_in_transaction_timeout_ms = 10000
[auth]
# секунды жизни сессии с момента входа (контрактное имя
# SESSION_TTL_SECONDS); короткий срок для проверки истечения — окружением
# AUTH__SESSION_TTL_SECONDS=2
session_ttl_seconds = 3600
# сколько хэшей пароля Argon2id считается одновременно: 64 MiB на каждый
kdf_concurrency = 4
[cache]
# Адрес, порт и пароль Valkey приходят из .env (мосты к VALKEY_*) и из
# environment compose; здесь их не указывать.
# секунды на всю команду Valkey (ожидание пула, соединение, ответ);
# дольше — запрос идёт в PostgreSQL
timeout_seconds = 0.2
# секунды, на которые кэш пропускается после отказа Valkey
retry_after_seconds = 5
# секунды жизни карточки чата в кэше
chat_ttl_seconds = 3600
# соединений в пуле клиента Valkey
max_connections = 10
[s3]
# Адрес, порт, bucket и ключи пользователя API приходят из .env (мосты к
# S3_OUT_PORT и S3_API_*, S3__BUCKET) и из environment compose; здесь их
# не указывать.
# регион подписи SigV4; SeaweedFS берёт его из запроса
region = "us-east-1"
# секунды на установку соединения с S3
connect_timeout_seconds = 1
# секунды на весь вызов S3; меньше timeout server HAProxy (10 с)
timeout_seconds = 5
# соединений в пуле клиента S3 на процесс
max_connections = 10
[idempotency]
# секунды, в течение которых повтор POST сообщения с тем же
# Idempotency-Key возвращает исходный результат (имя skeleton
# IDEMPOTENCY_TTL_SECONDS); контракт требует не меньше 86400 — 24 ч.
# Короткий срок для проверки — окружением IDEMPOTENCY__TTL_SECONDS=2
ttl_seconds = 86400
[uploads]
# Места загрузок вложений процесса API; разовая подмена — окружением
# UPLOADS__*. Память загрузок ограничена числом мест, а не клиентов.
# загрузок, которые процесс обрабатывает одновременно
max_concurrent = 4
# загрузок, которые ждут места; 0 — без ожидания, сразу 429
max_waiting = 16
# секунды ожидания места, затем 429 rate_limited с Retry-After; вход,
# членство и ожидание (2 × 6 + 5 = 17 с) меньше timeout server LB пути
# загрузки (30 с). Проверки при старте нет: больше 18 с — 504 от LB
# вместо 429
wait_timeout_seconds = 5
# секунды на всё тело с момента, как загрузка заняла место; иначе 400
body_timeout_seconds = 30
[cleaner]
# Уборщик незавершённых загрузок (сервис compose cleaner); реплики API
# секцию не читают. Разовая подмена — окружением CLEANER__*.
# секунды между проходами
interval_seconds = 60
# секунды: строку pending моложе уборщик не трогает (grace period).
# Должно быть больше 2 × [database] request_timeout_seconds +
# [s3] timeout_seconds (17 с), иначе уборщик не стартует
pending_grace_seconds = 900
# строк pending в одной выборке кандидатов
batch_size = 100
[reconciler]
# Сверка bucket и БД процессом уборщика: плановая в сервисе cleaner и
# разовая — make reconcile. Grace — [cleaner] pending_grace_seconds.
# Разовая подмена — окружением RECONCILER__*.
# секунды между плановыми сверками; 0 — без плановой сверки
interval_seconds = 3600
# ключей на страницу списка S3 и строк на запрос к PostgreSQL, 1–1000
page_size = 1000
# предел изменений за проход: больше — ни одного изменения и код 3;
# разовый проход принимает больший аргументом --max-changes
max_changes = 100
# предел скорости прохода: объектов S3 в секунду (ключи страниц списка,
# HEAD, GET, DELETE) в среднем от начала прохода; 0 — без предела;
# разовый проход принимает другой аргументом --max-objects-per-second
max_objects_per_second = 2000