Files
mtusi2026lab4/KNOWN_ISSUES.md
T

4.8 KiB
Raw Blame History

Известные дефекты

Найдены попутно, не исправлены без отдельной просьбы (AGENTS.md). Исправленные удаляются отсюда, история — в git.

Bootstrap после удаления bucket на маленьком диске: «api key wait (code 500)»

  • Где: infra/s3/bootstrap.sh (режим apply) и сервер s3 (docker-compose.yml: entrypoint образа добавляет -volume.max=0 -master.volumeSizeLimitMB=1024), SeaweedFS 4.48.
  • Что: после удаления bucket мимо bootstrap (s3.bucket.delete) повторный bootstrap пишет «bucket created», затем «FAILED: api key wait (code 500)». Найдено в правках по verify change s3-storage (2026-10-20); воспроизведено и объяснено пробой design change track2-reconciler (Context, 2026-10-22, проект rcprobe).
  • Причина: не повторное имя bucket, а слоты томов. С -volume.max=0 число слотов считается по свободному месту диска / 1 ГиБ. Удаление bucket удаляет тома его коллекции, но на маленьком диске слоты уже заняты томами коллекции по умолчанию (журналы filer), и новых томов для messenger выделить некуда: в журнале S3 — «No writable volumes and no free volumes left for collection:messenger», PUT получает 500.
  • Условие: диск, на котором -volume.max=0 даёт мало слотов, — tmpfs проб, а не volume стендов проекта. Проба: tmpfs 4 ГБ — 3 слота из 3 заняты, ошибка дважды подряд; tmpfs 16 ГБ — 15 слотов, повтор bootstrap прошёл за 2 с. Рабочий стенд (volume на диске ВМ) — 417 слотов, 403 свободны (weed shell volume.list): удаление bucket и повтор bootstrap этим не падают. Стенды проекта не затронуты.
  • Чем грозит: только временным стендам на маленьком tmpfs: после удаления bucket повтор bootstrap не проходит. Сверка bucket и БД bucket не создаёт и не удаляет: на NoSuchBucket она прерывает проход без изменений (design change track2-reconciler, решение 14).
  • Предложение: на маленьких дисках — -master.volumeSizeLimitMB меньше 1024 (больше слотов на тот же объём) или явный -volume.max; для стендов проекта не нужно. Запись остаётся открытой.

LB отвечает 408 на медленные заголовки текстом HAProxy

  • Где: infra/haproxy/haproxy.cfg, defaults: timeout http-request 10s, HAProxy 3.4.6.
  • Что: клиент, который присылает заголовки запроса дольше 10 с, получает от LB 408 со страницей HAProxy в HTML, а не ошибку в формате контракта ({"error": {...}} с request_id = X-Request-Id). http-error status 408 … lf-string его не меняет: такой ответ HAProxy строит до потока запроса, где http-error уже не действует. Проба change upload-memory (design, Context, п. 4; таблица «HAProxy, сроки»): заголовки за 12 с — 408 HTML и с http-error status 408, и без него. 400 посреди тела после change идёт в формате контракта.
  • Чем грозит: клиент с медленной сетью на заголовках получает ответ вне формата контракта. Путь загрузки и остальные пути API не затронуты: заголовки приходят за миллисекунды.
  • Предложение: errorfile 408 со статичным JSON не годится: request_id в нём один на все ответы, а контракт требует тот же id, что в X-Request-Id, и уникальный. Варианты для разбора: проверить http-errors / errorloc и Lua-ответ в новых версиях HAProxy 3.x; либо поднять timeout http-request и назвать ограничение в REPORT.md (уже названо в спеке load-balancing, «Ошибки балансировщика в формате контракта»).