Files
mtusi2026lab5/openspec/changes/pipeline-reliability/specs/load-balancing/spec.md
T
2026-10-31 10:08:03 +03:00

3.4 KiB
Raw Blame History

Spec Delta

MODIFIED Requirements

Requirement: Загрузки через балансировщик

Для POST /api/v1/chats/{chat_id}/attachments срок, в который LB ждёт реплику (timeout server), SHALL быть 30 с. Это больше самого длинного молчания живой загрузки:

  • до чтения тела — вход, членство в чате и ожидание места загрузки, не дольше 2 × [database] request_timeout_seconds + [uploads] wait_timeout_seconds (17 с);
  • после тела — проверка изображения, запись метаданных, запись объекта в staging, перевод в queued с заданием и удаление объекта при компенсации, не дольше 2 × request_timeout_seconds + 2 × [s3] timeout_seconds плюс проверка изображения (около 26 с). Брокера на этом пути нет.

У остальных путей срок SHALL оставаться прежним, 10 с: цепочка таймаутов лабы 3 для них не меняется.

Наибольшая длительность живой загрузки — молчание до тела, срок передачи тела ([uploads] body_timeout_seconds) и молчание после тела, около 73 с при значениях по умолчанию. Она и формула SHALL быть в REPORT.md.

Соединение с недочитанным телом SHALL держать в буферах ядра ограниченный объём: буфер приёма сокетов реплики API — не больше 512 KiB, буфер отправки LB к реплике — 256 KiB, буфер приёма LB от клиента — 128 KiB. Так ожидающие и отклонённые загрузки не переносят тела целиком ни в память реплики, ни в память LB.

Scenario: Долгая обработка загрузки

  • WHEN реплика на пути загрузки молчит дольше 10 с, но меньше 30 с: до чтения тела или после него
  • THEN клиент получает ответ реплики, а не 502 или 504 от LB

Scenario: Прежний срок остальных путей

  • WHEN реплика молчит дольше 10 с на любом другом пути
  • THEN через ~10 с клиент получает 504 от LB в формате ошибки контракта

Scenario: Загрузка дольше срока LB

  • WHEN реплика на пути загрузки молчит дольше 30 с
  • THEN через ~30 с клиент получает 504 от LB в формате ошибки контракта

Scenario: Буферы соединений ограничены

  • WHEN 40 клиентов одновременно загружают по 10 MiB через LB в одну реплику с параметрами загрузок по умолчанию
  • THEN пик памяти LB и буферов сокетов реплики растёт не больше чем на 1 MiB на клиента, а реплика и LB не завершены из-за памяти