ЛР 4 — БВТ2302 — Ким — на 3 #92

Closed
ddientee wants to merge 1 commits from ddientee/mtusi2026lab4:solution/bvt2302-kim into main
First-time contributor

Стенд: PostgreSQL 16 + две API-реплики за HAProxy + SeaweedFS S3 в приватном bucket. Метаданные вложений в PostgreSQL, байты в S3, object key назначает сервер. Лимиты 10 MiB и 40 млн пикселей, MIME по магическим байтам, проверка filename. Добавлены smoke/негативные тесты, хуки restart/stop-one, сценарий отказа S3 и отчёт с доказательствами.

Лабораторная 4

Автор / группа: Ким Владимир, БВТ2302
Целевая оценка (3/4/5): 3
Трек 5, если заявлен: -

Что реализовано и что перенесено: перенесён весь минимум ЛР3 (PostgreSQL как источник истины,
Basic→Bearer-сессии, ≥2 API-реплики за HAProxy, X-Instance-Id, обязательный Idempotency-Key).
Добавлено для ЛР4: S3 (SeaweedFS 3.71) в общем Compose-стенде, приватный bucket, байты только в S3,
метаданные вложений — в PostgreSQL. POST /api/v1/chats/{chat_id}/attachments?filename= → 201
status=ready; побайтный download через API без redirect; PNG/JPEG ≤10 MiB и ≤40 млн пикселей,
MIME по магическим байтам, опасные filename → 400; чужой чат/вложение → 404. Object key назначает
сервер (chats/<chat_id>/<attachment_id>/original), filename — только для отображения. При сбое
INSERT после PUT объект удаляется компенсацией.

Команды запуска из чистого clone:

cp .env.example .env          # синтетические локальные значения
docker compose --env-file .env up -d --build
curl -fsS http://127.0.0.1:8081/health/ready
python tests/smoke.py --base-url http://127.0.0.1:8081
python -m unittest discover -s student-tests -v
python student-tests/test_api_negative.py --base-url http://127.0.0.1:8081
python tests/resilience.py --mode persistence --action-script scripts/restart.cmd --base-url http://127.0.0.1:8081
python tests/resilience.py --mode failover --action-script scripts/stop-one.cmd --base-url http://127.0.0.1:8081
python scripts/evidence_s3_outage.py

Порт 8080 у автора занят стендом ЛР3, поэтому в .env стоит LAB4_PORT=8081.

Результаты проверок и ссылка на REPORT.md: check_contract.py — PASS; validate_openapi.py —
PASS (OpenAPI 3.1 + JSON Schema); tests/smoke.py — PASS: lab4 public API scenario;
test_api_negative.py — 12/12 PASS; unittest — 6 тестов OK; persistence — PASS; failover — PASS
(2 реплики, 112 записей, 0 ошибок, восстановление 2.33 с); отказ S3 — readiness/upload/download 503,
после старта S3 байты идентичны; приватность bucket — анонимный GET/list 403.
Подробности и файлы доказательств: REPORT.md, каталог evidence/.

Ограничения / известные ошибки: нет reconciler с grace period, нет эксперимента с ≥10 одновременными загрузками и измерением пика RAM, rate limiting
(429) не реализован. Сессии только в PostgreSQL. Один Docker-host: отказ диска/хоста не выдерживается.
make на машине автора не установлен, поэтому проверки выполнены эквивалентными прямыми командами;
цели Makefile (make check, make test, make test-negative, make student-tests) обновлены и
эквивалентны. scripts/restart.sh / stop-one.sh — POSIX-варианты, на Windows не запускались
(рабочие хуки — .cmd).

Источники и использование ИИ: контракт и рубрика репозитория, документация S3/SeaweedFS (S3 gateway,
s3.json identities), boto3/botocore, psycopg 3, Pillow, HAProxy.

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • make check и make test выполнены; приложен реальный вывод. (make не установлен на Windows —
    выполнены прямые эквиваленты scripts/check_contract.py, tests/smoke.py и др.; вывод в evidence/.)
  • Сценарии отказов/безопасности своего уровня воспроизведены.
  • Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
  • README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
Стенд: PostgreSQL 16 + две API-реплики за HAProxy + SeaweedFS S3 в приватном bucket. Метаданные вложений в PostgreSQL, байты в S3, object key назначает сервер. Лимиты 10 MiB и 40 млн пикселей, MIME по магическим байтам, проверка filename. Добавлены smoke/негативные тесты, хуки restart/stop-one, сценарий отказа S3 и отчёт с доказательствами. ## Лабораторная 4 Автор / группа: Ким Владимир, БВТ2302 Целевая оценка (3/4/5): 3 Трек 5, если заявлен: - Что реализовано и что перенесено: перенесён весь минимум ЛР3 (PostgreSQL как источник истины, Basic→Bearer-сессии, ≥2 API-реплики за HAProxy, `X-Instance-Id`, обязательный `Idempotency-Key`). Добавлено для ЛР4: S3 (SeaweedFS 3.71) в общем Compose-стенде, приватный bucket, байты только в S3, метаданные вложений — в PostgreSQL. `POST /api/v1/chats/{chat_id}/attachments?filename=` → `201` `status=ready`; побайтный download через API без redirect; PNG/JPEG ≤10 MiB и ≤40 млн пикселей, MIME по магическим байтам, опасные filename → `400`; чужой чат/вложение → `404`. Object key назначает сервер (`chats/<chat_id>/<attachment_id>/original`), `filename` — только для отображения. При сбое `INSERT` после `PUT` объект удаляется компенсацией. Команды запуска из чистого clone: ```sh cp .env.example .env # синтетические локальные значения docker compose --env-file .env up -d --build curl -fsS http://127.0.0.1:8081/health/ready python tests/smoke.py --base-url http://127.0.0.1:8081 python -m unittest discover -s student-tests -v python student-tests/test_api_negative.py --base-url http://127.0.0.1:8081 python tests/resilience.py --mode persistence --action-script scripts/restart.cmd --base-url http://127.0.0.1:8081 python tests/resilience.py --mode failover --action-script scripts/stop-one.cmd --base-url http://127.0.0.1:8081 python scripts/evidence_s3_outage.py ``` Порт 8080 у автора занят стендом ЛР3, поэтому в `.env` стоит `LAB4_PORT=8081`. Результаты проверок и ссылка на REPORT.md: `check_contract.py` — PASS; `validate_openapi.py` — PASS (OpenAPI 3.1 + JSON Schema); `tests/smoke.py` — `PASS: lab4 public API scenario`; `test_api_negative.py` — 12/12 PASS; `unittest` — 6 тестов OK; persistence — PASS; failover — PASS (2 реплики, 112 записей, 0 ошибок, восстановление 2.33 с); отказ S3 — readiness/upload/download `503`, после старта S3 байты идентичны; приватность bucket — анонимный GET/list `403`. Подробности и файлы доказательств: [REPORT.md](../blob/solution/bvt2302-kim/REPORT.md), каталог `evidence/`. Ограничения / известные ошибки: нет reconciler с grace period, нет эксперимента с ≥10 одновременными загрузками и измерением пика RAM, rate limiting (`429`) не реализован. Сессии только в PostgreSQL. Один Docker-host: отказ диска/хоста не выдерживается. `make` на машине автора не установлен, поэтому проверки выполнены эквивалентными прямыми командами; цели Makefile (`make check`, `make test`, `make test-negative`, `make student-tests`) обновлены и эквивалентны. `scripts/restart.sh` / `stop-one.sh` — POSIX-варианты, на Windows не запускались (рабочие хуки — `.cmd`). Источники и использование ИИ: контракт и рубрика репозитория, документация S3/SeaweedFS (S3 gateway, `s3.json` identities), boto3/botocore, psycopg 3, Pillow, HAProxy. - [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. - [x] Контракт и публичные тесты не ослаблены. - [x] make check и make test выполнены; приложен реальный вывод. (`make` не установлен на Windows — выполнены прямые эквиваленты `scripts/check_contract.py`, `tests/smoke.py` и др.; вывод в `evidence/`.) - [x] Сценарии отказов/безопасности своего уровня воспроизведены. - [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. - [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
ddientee added 1 commit 2026-11-08 14:40:30 +03:00
Стенд: PostgreSQL 16 + две API-реплики за HAProxy + SeaweedFS S3 в приватном bucket. Метаданные вложений в PostgreSQL, байты в S3, object key назначает сервер. Лимиты 10 MiB и 40 млн пикселей, MIME по магическим байтам, проверка filename. Добавлены smoke/негативные тесты, хуки restart/stop-one, сценарий отказа S3 и отчёт с доказательствами.
andrey.derbenev closed this pull request 2026-11-12 16:42:18 +03:00

Pull request closed

Please reopen this pull request to perform a merge.
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: mtusi2026/mtusi2026lab4#92