Files
mtusi2026lab5/openspec/changes/async-attachments/specs/load-balancing/spec.md
T
2026-10-31 04:06:09 +03:00

6.3 KiB
Raw Blame History

Spec Delta

MODIFIED Requirements

Requirement: Вывод реплики из балансировщика перед остановкой

Перед плановой остановкой реплики LB SHALL перестать направлять ей новые запросы. Запросы, которые она уже обрабатывает, SHALL дорабатываться. Остановка SHALL начинаться после того, как запросов в полёте у неё не осталось, или по истечении срока ожидания. Срок SHALL быть больше timeout server LB и больше наибольшей длительности живой загрузки (требование «Загрузки через балансировщик»). Управление LB SHALL быть доступно только изнутри контейнера LB. Из сети compose и с хоста оно MUST NOT быть доступно.

Состояние слота, выставленное при замене, SHALL сниматься, когда адрес удалённой реплики ушёл из слота. Слот, который потом получит новая реплика, SHALL включаться по обычным проверкам готовности.

Scenario: Выведенная реплика не получает запросов

  • WHEN слот реплики переведён в дренаж, и через LB идут запросы
  • THEN все новые ответы приходят от других реплик, а запросы, начатые до дренажа, получают ответ

Scenario: Управление LB недоступно из сети

  • WHEN контейнер в сети стенда или процесс на хосте обращается к портам LB
  • THEN изменить состояние реплики он не может: канал управления LB слушает только loopback внутри контейнера LB

Scenario: Слот после замены

  • WHEN замена завершена
  • THEN в статистике LB нет слотов в дренаже или в обслуживании, выставленном вручную; свободные слоты — только в обслуживании по DNS

Scenario: Загрузка во время дренажа

  • WHEN через LB идёт загрузка вложения, тело которой передаётся дольше 12 с, и во время неё make rolling_update выводит реплику, которая её принимает
  • THEN загрузка получает 202 от этой реплики, и только после ответа реплика останавливается

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 с заданием и либо удаление объекта при компенсации, либо публикация брокеру и запись о ней, не дольше 3 × request_timeout_seconds + [s3] timeout_seconds + [broker] publish_timeout_seconds плюс проверка изображения (около 29 с).

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

Наибольшая длительность живой загрузки — молчание до тела, срок передачи тела ([uploads] body_timeout_seconds) и молчание после тела, около 76 с при значениях по умолчанию. Она и формула 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 не завершены из-за памяти