2.8 KiB
2.8 KiB
Spec Delta
MODIFIED Requirements
Requirement: Недоступность S3
Если S3 недоступен, не ответил за срок вызова или отказал
(object-storage), загрузка и скачивание байтов SHALL отвечать 503
unavailable в формате ошибки. Ответ SHALL приходить не позже срока
вызова S3 с запасом, а не 500 и не зависанием. Без S3 SHALL работать:
- метаданные вложения;
- история чата с
attachment_ids; - отправка сообщений, в том числе со ссылкой на готовое вложение;
/health/ready.
После возврата S3 загрузка и скачивание SHALL проходить без перезапуска API.
503 на загрузке и скачивании SHALL означать только такой отказ S3: недоступен, не ответил за срок или отказал. Доступный S3 MUST NOT давать 503 из-за того, что реплика какое-то время не обращалась к нему, в том числе после скачивания больших оригиналов.
Scenario: S3 остановлен
- WHEN вложение загружено, затем S3 остановлен, и участник
скачивает байты, читает метаданные, отправляет сообщение с этим
вложением и запрашивает
/health/ready - THEN скачивание — 503
unavailable, метаданные — 200, сообщение — 201, готовность — 200 - AND после возврата S3 скачивание — 200 с теми же байтами
Scenario: S3 завис
- WHEN контейнер S3 заморожен (
docker pause), и участник загружает файл и скачивает байты готового вложения - THEN оба ответа 503
unavailableне позже срока вызова S3 с запасом, а после разморозки скачивание — 200
Scenario: Загрузка после простоя S3
- WHEN участники одновременно скачали оригинал в несколько MiB, затем реплика дольше срока вызова S3 не обращалась к S3, а S3 всё это время доступен, и участник одну за другой загружает файлы
- THEN каждая загрузка — 201, ни одной 503
- AND скачанные байты совпадают с загруженными