Files
mtusi2026labs/openspec/specs/lab4-object-storage/spec.md
T
ArtyomandClaude Opus 5.5 e4253eb076 Archive the image attachments change
Grade 3 of lab 4 is closed. RustFS with a private bucket runs in the
stand, metadata lives in PostgreSQL and the bytes only in the bucket,
uploads answer 201 ready after the object write and the commit, and
the original is served byte for byte to chat members only. The smoke
test passes from a fresh clone; limits of 10 MiB and 40 MP, content
type by content and dangerous names are covered by 325 own tests; an
upload survives the stop of the replica that took it, both replicas
fail over under writes in under 3.1 s, a full restart keeps metadata
and bytes, and with S3 stopped uploads and downloads answer 503 within
2.6 s while texts, metadata and readiness keep working. 22 checks show
the bucket is private outside the API and the API key is limited.

For the defence: upload the fixture, send it in a message, download it
as the second member and compare SHA-256, get 404 as a stranger and
403 for an anonymous GET in S3, then run persistence, failover and the
upload failover scenario.

The lab4-attachments and lab4-object-storage specs are added, and
message sending, history, idempotent replay, the restart hook and stand
persistence are updated in the main specs.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-10-28 22:20:38 +03:00

4.7 KiB
Raw Blame History

lab4-object-storage Specification

Purpose

Определяет объектное хранилище вложений как часть стенда: S3-совместимый сервер с закреплённой версией и persistent volume, приватный bucket и воспроизводимый bootstrap, раздельные ключи администратора и API, а также то, что байты не живут в БД и на диске реплики и переживают остановку реплики и рестарт стенда.

Requirements

Requirement: S3-сервер и приватный bucket в стенде

Стенд SHALL включать S3-совместимый сервер с образом, закреплённым версией и digest, данными на именованном volume и healthcheck, без опубликованных на хост портов и без доступной административной консоли. Одноразовый bootstrap SHALL создавать bucket S3_BUCKET (по умолчанию messenger-attachments), делать его приватным для анонимного клиента, создавать пользователя API с политикой только на объекты и листинг этого bucket и завершаться кодом 0; повторный запуск SHALL проходить без ошибок и без изменения состояния. Реплики API SHALL стартовать после успешного bootstrap.

Scenario: Анонимный GET объекта

  • WHEN из отдельного контейнера в сети стенда выполняется HTTP GET существующего объекта bucket без подписи
  • THEN ответ 403, байты объекта не возвращаются

Scenario: Порты и консоль

  • WHEN выполняется docker compose ps и запрос к порту консоли внутри контейнера S3
  • THEN у сервиса S3 нет опубликованных портов, а консоль не отвечает

Scenario: Повторный bootstrap

  • WHEN bootstrap запускается ещё два раза на работающем стенде
  • THEN оба запуска завершаются кодом 0, а bucket, его анонимная политика, пользователь и политика API не меняются

Requirement: Раздельные ключи и места хранения

Root-ключи S3 SHALL передаваться файлами compose secrets только S3-серверу, bootstrap и операторскому CLI; реплики API SHALL получать отдельный ключ из S3_ACCESS_KEY_ID_FILE и S3_SECRET_ACCESS_KEY_FILE. Байты вложений SHALL храниться только в bucket: в PostgreSQL SHALL NOT быть столбцов с содержимым файла, у реплик API SHALL NOT быть volume, а корневая файловая система реплики SHALL быть только для чтения. Ключи и адреса хранилища SHALL NOT попадать в ответы API, журнал и Git.

Scenario: Где лежат байты

  • WHEN после загрузки выполняются \d attachments, листинг bucket и docker inspect реплики API
  • THEN в таблице нет bytea, объект лежит в bucket под ключом attachments/<uuid>, у реплики ReadonlyRootfs=true и нет volume

Scenario: Ключ API

  • WHEN проверяются секреты сервиса api в docker compose config
  • THEN у api есть только ключ API S3, а root-ключей нет

Requirement: Файл переживает остановку обслужившей реплики

Вложение, загруженное через одну реплику API, SHALL скачиваться через другую реплику после остановки первой с тем же SHA-256.

Scenario: Upload, остановка реплики, download

  • WHEN выполняется python3 scripts/lab4_scenarios.py failover-upload: upload, остановка реплики из X-Instance-Id ответа хуком scripts/stop-one.sh, скачивание
  • THEN скачивание обслуживает другая реплика, SHA-256 совпадает, сценарий печатает "ok": true