Files
mtusi2026lab4/openspec/changes/fix-upload-put-flake/specs/student-tests/spec.md
T
2026-10-22 22:52:59 +03:00

8.0 KiB

Spec Delta

MODIFIED Requirements

Requirement: Проверки отказов на отдельном стенде

Сценарии отказов SHALL проверяться автоматически одной командой make failure_checks:

  • sessions: «Истёкший токен», «Срок не продлевается», «БД остановлена при запросе с токеном»;
  • data-storage: «Сбой при добавлении участников», «БД остановлена», «БД вернулась», «Соединения исчерпаны»;
  • health: «Хранилище не готово», «Кэш недоступен», «Хранилище объектов недоступно»;
  • chat-cache: «Valkey остановлен», «Valkey завис», «Valkey вернулся», «Очистка кэша»;
  • idempotency: «Сбой при записи сообщения», «Отказ БД при отправке», «Ключ после срока»;
  • api-conventions: «Лимит одновременных загрузок»;
  • attachments: «Запись в S3 не удалась», «Отклонённая загрузка ничего не оставляет», «S3 остановлен», «S3 завис», «Незавершённая загрузка не видна», «Сбой записи метаданных», «Фиксация ready не удалась», «Обрыв передачи тела», «Отказ раньше очереди», «Все места заняты», «Очередь ожидания полна», «Ожидание места», «Место освобождается», «Медленный клиент», «Медленная передача в срок», «Потерянный оригинал», «Загрузка после простоя S3»;
  • storage-consistency: все сценарии.

Команда SHALL:

  • собрать образ из рабочего дерева;

  • поднять отдельный стенд со своими PostgreSQL, Valkey и S3, применить миграции и bootstrap S3;

  • запустить четыре API:

    • с настройками по умолчанию;
    • «тесный» — с коротким сроком сессии и ключа идемпотентности и пулом из одного соединения;
    • «узкий по загрузкам» — с одним местом загрузки, одной загрузкой в очереди, коротким сроком ожидания места и коротким сроком тела;
    • «с коротким сроком S3» — со сроком вызова S3 в одну секунду: простой дольше срока вызова в проверке длится полторы секунды, а не шесть.

    Значения «узкого» API и API с коротким сроком S3 SHALL передаваться проверкам, и проверки SHALL сверять с ними стенд;

  • запустить уборщика с коротким grace и интервалом, сравнимыми со временем теста, без плановой сверки, и передать их значения проверкам. Grace при этом SHALL проходить проверку границы живой загрузки (service-configuration, «Параметры уборщика»). Сверку проверки запускают сами, и плановая сверка не меняет стенд у них за спиной;

  • выполнить проверки отказов;

  • удалить стенд вместе с его данными при любом исходе.

Hook стенда отказов SHALL уметь:

  • сообщить вложения стенда в PostgreSQL с их статусами, id последнего вложения в статусе «загружается» и id вложений с потерянным оригиналом;
  • сообщить, у каких вложений есть объект в bucket стенда, — по самим объектам, а не по каталогам хранилища;
  • внедрить отказ PostgreSQL:
    • при записи метаданных загрузки с заданным filename;
    • при фиксации её ready, и задержать такую фиксацию;
    • при пометке потерянного оригинала такого вложения;
  • убить и снова запустить обычный API стенда;
  • внести расхождения хранилищ:
    • записать объект в bucket стенда мимо API и удалить объект мимо API — только под префиксом вложений базы стенда;
    • удалить метаданные вложения, изменить в них размер и сдвинуть их время в прошлое;
  • выполнить разовую сверку — без изменений или с --apply, с заданным пределом изменений — и вернуть её записи и код выхода;
  • остановить и запустить уборщика стенда, а также запустить отдельного уборщика с коротким интервалом плановой сверки на заданное время и вернуть его журнал.

Других сведений о хранилищах проверки вложений не получают. Объекты без метаданных проверка находит сравнением двух списков: вложений и объектов. Ключи доступа S3 hook не получает и не печатает: объект мимо API записывает процесс в контейнере стенда своими ключами.

Порты PostgreSQL, Valkey и S3 этого стенда MUST NOT публиковаться на хосте, API — только на 127.0.0.1. Рабочий стенд, его база, кэш, хранилище объектов и контейнеры MUST NOT затрагиваться. Код выхода SHALL быть ненулевым, если не прошла хотя бы одна проверка или уборка. Параллельный запуск двух прогонов не поддерживается: уборка хвоста в начале второго удаляет стенд первого.

Scenario: Успешный прогон

  • WHEN рабочий стенд запущен, и выполнен make failure_checks
  • THEN все проверки отказов прошли, код выхода 0, контейнеров и volumes стенда отказов после команды нет, а у контейнеров рабочего стенда прежнее время старта, и рабочий API отвечает

Scenario: Упавшая проверка

  • WHEN во время make failure_checks падает хотя бы одна проверка
  • THEN код выхода ненулевой, журналы API и уборщика стенда отказов выведены, стенд отказов удалён

Scenario: Прерывание

  • WHEN make failure_checks прерван Ctrl+C
  • THEN стенд отказов остановлен и удалён вместе с volumes

Scenario: Хвост прошлого прогона

  • WHEN контейнеры или volumes стенда отказов остались от прогона, убитого без уборки
  • THEN следующий make failure_checks удаляет их и начинает заново