From f875e2977f6592e1af6228dfe2138a769c327b08 Mon Sep 17 00:00:00 2001 From: kolya5544 Date: Sat, 3 Oct 2026 02:44:56 +0300 Subject: [PATCH 1/3] =?UTF-8?q?=D0=9B=D0=A04:=20=D0=BF=D1=80=D0=B8=D0=B2?= =?UTF-8?q?=D0=B0=D1=82=D0=BD=D0=BE=D0=B5=20S3-=D1=85=D1=80=D0=B0=D0=BD?= =?UTF-8?q?=D0=B8=D0=BB=D0=B8=D1=89=D0=B5=20(SeaweedFS),=20=D0=B2=D0=BB?= =?UTF-8?q?=D0=BE=D0=B6=D0=B5=D0=BD=D0=B8=D1=8F=20PNG/JPEG,=20reconciler,?= =?UTF-8?q?=20=D0=B8=D1=81=D1=81=D0=BB=D0=B5=D0=B4=D0=BE=D0=B2=D0=B0=D0=BD?= =?UTF-8?q?=D0=B8=D0=B5=20=D1=81=D0=BE=D0=B3=D0=BB=D0=B0=D1=81=D0=BE=D0=B2?= =?UTF-8?q?=D0=B0=D0=BD=D0=BD=D0=BE=D1=81=D1=82=D0=B8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .dockerignore | 6 + .env.example | 31 +- Dockerfile | 32 ++ Makefile | 15 + REPORT.md | 104 +++++- compose.yaml | 172 +++++++++ docs/report_lab4.docx | Bin 0 -> 40012 bytes evidence/checks.txt | 46 +++ evidence/track2_reconcile.json | 93 +++++ evidence/upload_memory.json | 50 +++ infra/haproxy/haproxy.cfg | 50 +++ migrations/0001_init.sql | 52 +++ migrations/0002_idempotency.sql | 17 + migrations/0003_send_message_function.sql | 35 ++ migrations/0004_attachments.sql | 90 +++++ requirements.txt | 30 ++ research/failover_sequence.py | 113 ++++++ research/loadgen.py | 172 +++++++++ research/reconcile_bench.py | 170 +++++++++ research/rolling_update.py | 57 +++ research/upload_memory.py | 139 ++++++++ scripts/init-secrets.sh | 31 ++ scripts/restart.cmd | 7 + scripts/restart.sh | 7 + scripts/restore-replicas.sh | 10 + scripts/rolling-update.sh | 32 ++ scripts/stop-one.cmd | 8 + scripts/stop-one.sh | 14 + src/app/attachments.py | 181 ++++++++++ src/app/config.py | 75 ++++ src/app/db.py | 71 ++++ src/app/images.py | 102 ++++++ src/app/main.py | 409 ++++++++++++++++++++++ src/app/migrate.py | 64 ++++ src/app/passwords.py | 31 ++ src/app/reconcile.py | 91 +++++ src/app/s3.py | 85 +++++ src/app/s3_bootstrap.py | 85 +++++ src/app/serve.py | 40 +++ src/app/sessions.py | 131 +++++++ src/app/web.py | 187 ++++++++++ student-tests/fixtures/sample.jpg | Bin 0 -> 24299 bytes student-tests/fixtures/sample.png | Bin 0 -> 111817 bytes student-tests/test_api.py | 208 +++++++++++ student-tests/test_attachments.py | 188 ++++++++++ student-tests/test_dependencies.py | 80 +++++ student-tests/test_expiry.py | 69 ++++ student-tests/test_idempotency.py | 121 +++++++ student-tests/test_s3_failures.py | 121 +++++++ student-tests/test_topology.py | 58 +++ 50 files changed, 3953 insertions(+), 27 deletions(-) create mode 100644 Dockerfile create mode 100644 compose.yaml create mode 100644 docs/report_lab4.docx create mode 100644 evidence/checks.txt create mode 100644 evidence/track2_reconcile.json create mode 100644 evidence/upload_memory.json create mode 100644 infra/haproxy/haproxy.cfg create mode 100644 migrations/0001_init.sql create mode 100644 migrations/0002_idempotency.sql create mode 100644 migrations/0003_send_message_function.sql create mode 100644 migrations/0004_attachments.sql create mode 100644 requirements.txt create mode 100644 research/failover_sequence.py create mode 100644 research/loadgen.py create mode 100644 research/reconcile_bench.py create mode 100644 research/rolling_update.py create mode 100644 research/upload_memory.py create mode 100755 scripts/init-secrets.sh create mode 100644 scripts/restart.cmd create mode 100755 scripts/restart.sh create mode 100755 scripts/restore-replicas.sh create mode 100755 scripts/rolling-update.sh create mode 100644 scripts/stop-one.cmd create mode 100755 scripts/stop-one.sh create mode 100644 src/app/attachments.py create mode 100644 src/app/config.py create mode 100644 src/app/db.py create mode 100644 src/app/images.py create mode 100644 src/app/main.py create mode 100644 src/app/migrate.py create mode 100644 src/app/passwords.py create mode 100644 src/app/reconcile.py create mode 100644 src/app/s3.py create mode 100644 src/app/s3_bootstrap.py create mode 100644 src/app/serve.py create mode 100644 src/app/sessions.py create mode 100644 src/app/web.py create mode 100644 student-tests/fixtures/sample.jpg create mode 100644 student-tests/fixtures/sample.png create mode 100644 student-tests/test_api.py create mode 100644 student-tests/test_attachments.py create mode 100644 student-tests/test_dependencies.py create mode 100644 student-tests/test_expiry.py create mode 100644 student-tests/test_idempotency.py create mode 100644 student-tests/test_s3_failures.py create mode 100644 student-tests/test_topology.py diff --git a/.dockerignore b/.dockerignore index bc16e556..40bc41c9 100644 --- a/.dockerignore +++ b/.dockerignore @@ -18,3 +18,9 @@ __pycache__ node_modules evidence .DS_Store +research +student-tests +scripts +docs +requirements-research.txt +*.md diff --git a/.env.example b/.env.example index d99d26a2..1baab3d8 100644 --- a/.env.example +++ b/.env.example @@ -1,20 +1,27 @@ # Copy to .env for your LOCAL synthetic test environment; never commit .env. -# These are logical interface suggestions; map actual framework names in REPORT.md. +# Секреты (пароль БД, DATABASE_URL) создаёт scripts/init-secrets.sh в каталоге secrets/ — не в .env. APP_HOST=0.0.0.0 APP_PORT=8080 APP_ENV=lab +# Срок жизни сессии; для проверки expiry запускайте с SESSION_TTL_SECONDS=2 (см. student-tests/test_expiry.sh) SESSION_TTL_SECONDS=3600 -# Choose credentials locally. File paths contain no secret values. -DATABASE_URL_FILE=/run/secrets/database_url -# Optional on 3, required use on 4 in lab2; Redis OR Valkey: +# TTL записи в кэше Valkey (не больше остатка жизни сессии) +SESSION_CACHE_TTL_SECONDS=60 +# Источник сессий: PostgreSQL (истина) + Valkey (кэш). Адрес кэша задан в compose.yaml (VALKEY_URL). SESSION_STORE=postgres -CACHE_URL_FILE=/run/secrets/cache_url +DB_POOL_MAX=10 +# Файлы секретов внутри контейнера (создаются scripts/init-secrets.sh) +DATABASE_URL_FILE=/run/secrets/database_url +# --- lab3 --- +# Число API-реплик (compose deploy.replicas); также можно: docker compose up -d --scale api=4 API_REPLICAS=2 -IDEMPOTENCY_TTL_SECONDS=86400 -S3_ENDPOINT=http://s3:9000 -S3_REGION=us-east-1 +API_CPUS=1.0 +API_MEM=256m +POSTGRES_CPUS=1.0 +LB_CPUS=1.0 +# Пауза между SIGTERM и закрытием listener: LB успевает исключить реплику (rolling update без ошибок) +DRAIN_SECONDS=4 +# --- lab4 --- S3_BUCKET=messenger-attachments -S3_ACCESS_KEY_ID_FILE=/run/secrets/s3_access_key_id -S3_SECRET_ACCESS_KEY_FILE=/run/secrets/s3_secret_access_key -MAX_UPLOAD_BYTES=10485760 -MAX_IMAGE_PIXELS=40000000 +S3_CPUS=1.0 +UPLOAD_CONCURRENCY=4 diff --git a/Dockerfile b/Dockerfile new file mode 100644 index 00000000..ee31f7ab --- /dev/null +++ b/Dockerfile @@ -0,0 +1,32 @@ +# syntax=docker/dockerfile:1 +# Базовый образ закреплён тегом и digest (python 3.12.12, Debian bookworm). +ARG PYTHON_IMAGE=python:3.12.12-slim-bookworm@sha256:593bd06efe90efa80dc4eee3948be7c0fde4134606dd40d8dd8dbcade98e669c + +# --- сборка зависимостей в отдельном слое (в runtime не попадают pip и кэш) --- +FROM ${PYTHON_IMAGE} AS builder +ENV PIP_DISABLE_PIP_VERSION_CHECK=1 PIP_NO_CACHE_DIR=1 +WORKDIR /build +COPY requirements.txt . +RUN python -m venv /opt/venv && /opt/venv/bin/pip install -r requirements.txt + +# --- runtime --- +FROM ${PYTHON_IMAGE} +ENV PATH=/opt/venv/bin:$PATH \ + PYTHONUNBUFFERED=1 PYTHONDONTWRITEBYTECODE=1 PYTHONPATH=/srv/src \ + APP_HOST=0.0.0.0 APP_PORT=8080 APP_ENV=lab LIMIT_CONCURRENCY=1000 MIGRATIONS_DIR=/srv/migrations +RUN groupadd --system --gid 10001 app && useradd --system --uid 10001 --gid app --no-create-home app +COPY --from=builder /opt/venv /opt/venv +WORKDIR /srv +COPY src/ /srv/src/ +COPY migrations/ /srv/migrations/ +# ревизия образа (меняется при rolling update; видна в журнале запуска) +ARG REV=dev +LABEL org.opencontainers.image.revision=$REV +ENV APP_REVISION=$REV +USER 10001:10001 +EXPOSE 8080 +HEALTHCHECK --interval=10s --timeout=3s --start-period=5s --retries=3 \ + CMD ["python", "-c", "import urllib.request,os,sys; sys.exit(0 if urllib.request.urlopen('http://127.0.0.1:%s/health/ready' % os.environ.get('APP_PORT','8080'), timeout=2).status == 200 else 1)"] +# exec-форма: сервер = PID 1. Состояние хранится в PostgreSQL/Valkey, процесс stateless; +# масштабирование — репликами контейнера. SIGTERM: drain (readiness 503) -> graceful shutdown (см. app/serve.py). +CMD ["python", "-m", "app.serve"] diff --git a/Makefile b/Makefile index 5d86d171..9a9a3daa 100644 --- a/Makefile +++ b/Makefile @@ -28,3 +28,18 @@ test-persistence: test-failover: @test -n "$(ACTION_SCRIPT)" || (echo "Set ACTION_SCRIPT to your implemented executable stop-one hook"; exit 2) $(PYTHON) tests/resilience.py --mode failover --action-script "$(ACTION_SCRIPT)" --base-url "$(BASE_URL)" $(TLS_ARGS) + +# --- собственные цели студента --- +.PHONY: secrets up down student-test +secrets: + sh scripts/init-secrets.sh + +up: secrets + docker compose --env-file .env up -d --build + +down: + docker compose --env-file .env down + +student-test: + $(PYTHON) -m unittest discover -s student-tests -p "test_api.py" -v + $(PYTHON) -m unittest discover -s student-tests -p "test_attachments.py" -v diff --git a/REPORT.md b/REPORT.md index 9ad2b84f..3db8cc1b 100644 --- a/REPORT.md +++ b/REPORT.md @@ -1,37 +1,111 @@ # Отчёт — лабораторная 4 -- Автор, группа: TODO -- Целевая оценка; выбранный трек 5, если нужен: TODO -- Commit/PR: TODO после публикации -- Использованные источники, библиотеки и помощь ИИ: TODO +- Автор, группа: [ФИО], [группа] +- Целевая оценка; выбранный трек 5, если нужен: **5**, трек 2 «Согласованность двух хранилищ» +- Commit/PR: локальный коммит ветки `solution/lab4`; PR — после публикации +- Использованные источники, библиотеки и помощь ИИ: Python 3.12, uvicorn, asyncpg, aiobotocore (S3), Pillow (проверка изображений), argon2-cffi; SeaweedFS 4.48 (S3); HAProxy; PostgreSQL; Valkey. Код lab3 перенесён. Использование ИИ: [заполняется автором] ## Запуск из чистого clone -TODO: версии runtime/образов, prerequisites, команды создания локальных secrets/.env, build, миграций, запуска, ожидания готовности, тестов и остановки. Указать необходимые действия оператора. Не вставлять секреты. Отдельно указать безопасную остановку и команду намеренного удаления учебных данных. +Prerequisites: Docker Compose v2, bash (Git Bash на Windows), Python ≥ 3.9; на Windows `PYTHONUTF8=1` для `tests/*.py`. +Версии: `python:3.12.12-slim-bookworm@sha256:593bd06e…`, `postgres:17.11-alpine@sha256:b0f9560a…`, `valkey/valkey:8.1.10-alpine@sha256:081c2f5c…`, `haproxy:3.0-alpine@sha256:56b887da…`, `chrislusf/seaweedfs:4.48@sha256:4e61d15f…`, зависимости — `requirements.txt` (закреплены, включая `aiobotocore==3.9.2`, `pillow==12.3.0`). + +```sh +sh scripts/init-secrets.sh # secrets/*: пароль БД, ключи S3 (admin и отдельные ключи API), seaweed_s3.json +cp .env.example .env +docker compose --env-file .env config --quiet +docker compose --env-file .env up -d --build # postgres, valkey, seaweedfs -> migrate + s3-init (один раз) -> api x2 -> lb +curl http://127.0.0.1:8080/health/ready +python3 tests/smoke.py --base-url http://127.0.0.1:8080 +python3 tests/resilience.py --mode persistence --action-script scripts/restart.sh --base-url http://127.0.0.1:8080 +python3 tests/resilience.py --mode failover --action-script scripts/stop-one.sh --base-url http://127.0.0.1:8080 +sh scripts/restore-replicas.sh +# собственные тесты (стенд должен быть запущен) +python3 -m unittest discover -s student-tests -p "test_api.py" -v +python3 -m unittest discover -s student-tests -p "test_attachments.py" -v +python3 student-tests/test_idempotency.py ; python3 student-tests/test_topology.py ; python3 student-tests/test_s3_failures.py +``` + +Windows: `scripts/restart.cmd` и `scripts/stop-one.cmd` вместо `.sh`. Остановка с сохранением данных — `docker compose --env-file .env stop`; **намеренное удаление учебных данных** — `docker compose --env-file .env down -v` (volumes `pgdata`, `valkeydata`, `seaweeddata`). + +**Выбор S3-сервера.** Образы MinIO в Docker Hub (`minio/minio`, `minio/mc`) недоступны для скачивания на момент выполнения (репозиторий не найден, проверено `docker pull`), поэтому воспроизводимый стенд построен на **SeaweedFS** (разрешён README): образ закреплён тегом и digest. SeaweedFS запускается одним процессом (`weed server -filer -s3`), права задаются файлом identities (`secrets/seaweed_s3.json`). ## Архитектура и решения -TODO: схема процессов/хранилищ, источник истины, транзакционные границы, ограничения. Что перенесено из lab3, что изменено в этой работе. Соответствие переменных из .env.example реальной конфигурации. +``` +Клиент ─▶ HAProxy ─▶ API ×2 ─▶ PostgreSQL (метаданные вложений, сообщения, сессии, ключи идемпотентности) + ├─▶ SeaweedFS S3 (приватный bucket, байты вложений) [volume seaweeddata] + └─▶ Valkey (кэш сессий) +``` + +| Роль | Сервис | Health | Volume | Сеть | Credentials | +| --- | --- | --- | --- | --- | --- | +| S3 | `seaweedfs` (master+volume+filer+S3) | `wget …:9333/cluster/status` и `nc -z :8333` | `seaweeddata` | только `backend`, порты не опубликованы, **консоли/админки наружу нет** | `seaweed_s3.json` (secret) | +| bootstrap | `s3-init` (one-shot) | код выхода 0 | — | `backend` | admin-ключи (только он), ключи API для проверки | +| остальные роли | как в lab3 | | | | | + +- **Данные.** Метаданные — таблицы `attachments` (id, chat_id, owner_id, display filename, content_type, size, sha256, status, error_code, s3_key, …) и `message_attachments (message_id, attachment_id, position)`; байты — в S3 под ключом **`att//original`, который назначает сервер**; `filename` используется только как отображаемое имя и нигде не входит в путь/ключ. Байты не хранятся ни в БД, ни в локальном каталоге API (временный буфер загрузки — `SpooledTemporaryFile`, удаляется после запроса). +- **Загрузка** (`POST /chats/{id}/attachments?filename=…`, сырые bytes): авторизация → членство (чужой чат 404) → `filename` (1–255 code points; `/`, `\`, NUL, управляющие символы → 400) → `Content-Type` PNG/JPEG (иначе 415) → **размер ≤ 10 MiB проверяется по `Content-Length` до чтения и по счётчику при потоковом приёме** (413, соединение закрывается) → тело принимается порциями (до 1 MiB в RAM, далее временный файл) с подсчётом SHA-256 → проверка изображения **до полной распаковки**: сигнатура PNG/JPEG должна совпасть с заявленным типом (подмена MIME → 415), формат и размеры по заголовку Pillow, **>40 млн пикселей → 413** (decompression bomb отклоняется по заголовку), целостность: PNG — CRC всех чанков (`verify`) + потоковая распаковка IDAT с проверкой конца потока и ожидаемого размера данных, JPEG — декодирование в режиме draft (≈1/64 памяти) → запись в S3 → строка в PostgreSQL (`status=ready`, `201`). Ограничение одновременных загрузок на реплику (`UPLOAD_CONCURRENCY=4`, очередь 16, далее `429`). +- **Скачивание** (`GET /attachments/{id}/content`, `?variant=original|thumbnail|crop|optimized`): авторизация → доступ по членству в чате вложения (постороннему/несуществующему — 404 без различий) → потоковая отдача из S3 порциями по 64 КиБ с истинным `Content-Type`, `Content-Length`, `X-Content-Type-Options: nosniff`, **без redirect**; недоступный S3 → `503`; несуществующий вариант → 404; невалидный `variant` → 400. +- **Сообщения**: `attachment_ids` (0–10 уникальных UUID, по умолчанию `[]`; пустой текст допустим только с вложением). Вложение другого чата/неизвестное/чужое → 404; дубликаты, >10 → 400; идемпотентный повтор учитывает `attachment_ids` (нормализованное тело: порядок ключей JSON и отсутствие поля == `[]`). Проверка вложений и вставка — внутри той же серверной функции `send_message` (миграция 0004), то есть атомарно. +- **Readiness API** = PostgreSQL. S3 в readiness **не включён осознанно**: при падении S3 текстовые сообщения продолжают работать (проверено тестом), вложения отвечают `503 + Retry-After`. + +### Согласованность S3 и PostgreSQL (механизм компенсации и сверки — уровень 4) + +Порядок записи: сначала объект в S3, затем строка в PostgreSQL. Окна отказа: + +| Сбой | Результат | Исправление | +| --- | --- | --- | +| Клиент оборвал загрузку | ни объекта, ни строки (проверено тестом) | — | +| S3 недоступен | 503, строка не создаётся | — | +| Сбой БД после записи в S3 | клиент получает ошибку; объект **удаляется компенсацией** сразу (проверено внедрением сбоя `FAULT_INJECTION=db_after_put`) | компенсация | +| Сбой БД и неудача удаления (или крах процесса между S3 и COMMIT) | «осиротевший» объект без строки | **reconciler** `python -m app.reconcile` | + +**Reconciler** (`src/app/reconcile.py`): по умолчанию **dry-run**; сравнивает `attachments.s3_key` и листинг bucket. Находит: *orphan_object* (объект без строки; удаляется только если старше `grace` — по умолчанию 900 с, поэтому свежая, ещё не зафиксированная загрузка не затрагивается), *missing_object* (строка `ready` без объекта → `failed/object_missing`, **строка не удаляется**, сообщения сохраняются, скачивание даёт 409), *size_mismatch* (размер объекта ≠ `size_bytes` → `failed/size_mismatch`). Объект, у которого есть строка в БД, не удаляется никогда; перед удалением выполняется повторная проверка строки. Повторный запуск идемпотентен. ## Доказательства критериев | Критерий README | Команда/сценарий | Наблюдаемый результат | Файл доказательства | | --- | --- | --- | --- | -| Публичный smoke | make test | TODO | TODO | -| Остальные пункты уровня 3 | TODO | TODO | TODO | -| Все пункты уровня 4, если заявлен | TODO | TODO | TODO | -| Выбранный трек 5, если заявлен | TODO | TODO | TODO | +| Smoke lab4 (загрузка, checksum, чужой пользователь) | `tests/smoke.py` | PASS | `evidence/checks.txt` | +| Байты в приватном bucket, метаданные в PostgreSQL | описание; `test_bucket_is_private_outside_the_api` | анонимный GET объекта из сети стенда → 403; в БД нет bytea | `evidence/checks.txt` | +| PNG/JPEG ≤10 MiB, ≤40 млн px, MIME по содержимому, опасный filename | `student-tests/test_attachments.py` | 11 тестов OK (413, 415 ×9 вариантов, 400 ×8 вариантов filename) | `evidence/checks.txt` | +| Upload → остановка реплики → download через другую; restart с сохранением volumes | `tests/resilience.py` failover ×2 и persistence | PASS; `StartedAt` seaweedfs/postgres/valkey/api изменился | `evidence/checks.txt` | +| Отдельные тесты (слишком большой, повреждённый, подмена MIME, чужое attachment_id, вложение другого чата) | `test_attachments.py` | OK; ни один случай не приводит к 500 | `evidence/checks.txt` | +| Прерывание загрузки / отказ между S3 и БД: компенсация и сверка | `test_s3_failures.py` | 4 теста OK: компенсация, orphan при неудачной компенсации (dry-run/apply/grace), missing object, отказ S3 | `evidence/checks.txt` | +| ≥10 одновременных загрузок, пик памяти | `research/upload_memory.py` | 12 клиентов × 8.7 MiB: **пик RSS 99 / 116 / 123 MiB** при `UPLOAD_CONCURRENCY` 1 / 4 / 12 (старт процесса 94 MiB, лимит контейнера 256 MiB); все 12 файлов приняты и скачиваются побайтно; `OOMKilled=false` | `evidence/upload_memory.json` | +| Bootstrap идемпотентен, отдельные ключи API с ограниченными правами, консоль не открыта, bucket private | `s3-init`; `docker compose logs s3-init` | повторный запуск: «bucket уже существует», анонимный доступ 403, ключ API не может создать bucket (`AccessDenied`) | логи `s3-init` | +| Лимиты и потоковая обработка | описание; `upload_memory.json` | размер/пиксели проверяются до распаковки; тело не буферизуется целиком | `src/app/attachments.py`, `images.py` | +| **Трек 2** | `research/reconcile_bench.py` | см. ниже | `evidence/track2_reconcile.json` | -TODO: добавить отдельную строку для каждого заявленного критерия. PASS без команды и наблюдения не является доказательством. Проверка инфраструктурного hook требует подтверждения, какие реальные процессы/хранилища перезапущены. +## Эксперименты и отказы (трек 2) -## Эксперименты и отказы +**Гипотеза.** Reconciler обнаруживает ровно внедрённые расхождения в обе стороны, в режиме dry-run ничего не меняет, при apply исправляет только безопасное (осиротевшие объекты старше grace; повреждённые/потерянные вложения помечает failed), не затрагивает свежие и используемые вложения, повторяется идемпотентно, а стоимость обхода линейна по числу объектов. -TODO: гипотеза, hardware/лимиты, версии, объём данных, профиль нагрузки, concurrency/arrival rate, длительность/прогрев, повторы, успешные RPS, ошибки, p50/p95/p99, CPU/RAM. Сохранить raw summary без tokens и объяснить ограничения измерения. +**Методика** (`research/reconcile_bench.py`): ≈15 000 вложений (мелкие PNG, загружены через API); внедрено на **обеих сторонах**: 20 осиротевших объектов в S3, у 20 вложений удалён объект в S3, у 5 вложений объект подменён по размеру; после паузы > grace (5 с) — dry-run дважды, затем `--apply --grace 5` **параллельно с загрузкой 200 новых вложений**, затем повторный apply. Проверки: количество найденного, неизменность при dry-run, целостность 200 используемых и 200 свежих вложений (скачивание, sha256). + +| Показатель | Результат | +| --- | --- | +| dry-run нашёл | 20 orphan, 20 missing, 5 size_mismatch — **ровно внедрённое**; два dry-run дают одинаковый отчёт, `fixed = 0/0` | +| apply (grace 5 с) | удалено 20 осиротевших объектов; 25 вложений помечены `failed` (`object_missing`=20, `size_mismatch`=5) | +| Свежие загрузки во время apply | 200 из 200 принято и скачивается побайтно | +| Используемые вложения | 200 из 200 целы (sha256 совпадает) | +| Повторный apply | изменений 0 (идемпотентно) | +| Стоимость обхода (dry-run) | 13 271 объект → 2.17 с; 14 271 → 2.34 с; 15 271 → 2.50 с (из них листинг S3 ≈ 96 %, запрос к БД 13 мс) — **≈0.16 мс на объект**, линейно; на меньшем наборе (1–3 тыс. объектов, предварительный прогон) 0.28–0.59 с | + +**Границы.** Reconciler сверяет только наличие и размер, не содержимое (содержимое подтверждает sha256 из БД при скачивании на стороне клиента); обход листингом S3 — O(число объектов), для очень больших бакетов нужен инкрементальный обход по префиксам/времени. Если объект удалён, восстановить байты нельзя — вложение остаётся в БД как `failed`. Grace period выбирается больше максимального времени загрузки + таймаутов (здесь 900 с против лимита чтения 15 с). Ограничение: измерения на одном ноутбуке, S3 — один узел SeaweedFS без репликации. + +### Отказы | Воздействие | Что ожидаем | Что наблюдали | Время восстановления / потеря данных | | --- | --- | --- | --- | -| TODO | TODO | TODO | TODO | +| Остановка S3 | загрузка/скачивание 503 + `Retry-After`, текст работает, ready=200 | OK (`test_s3_down…`) | после старта S3 — сразу; метаданные не накапливают «битых» строк | +| Остановка одной реплики после upload | файл скачивается другой репликой | failover PASS ×2 (восстановление записи 2.3 с) | потерь нет | +| Рестарт всего стенда | метаданные и оригинал на месте | persistence PASS | < 90 с | +| Сбой БД после записи в S3 | объект не остаётся | удаляется компенсацией; при сбое компенсации — reconciler | потерь подтверждённых данных нет | ## Ограничения и следующие шаги -TODO: какие отказы выдерживаются и какие нет; что не реализовано; где учебное упрощение; какое улучшение подтверждено, а какое пока гипотеза. +- Один узел S3 и один PostgreSQL (SPOF); репликации нет. Загрузка проксируется через API (прямые подписанные URL не реализованы — трек 1 не выбран). +- Проверка содержимого JPEG — декодирование в режиме draft (1/8), PNG — потоковая проверка; полная валидация пикселей не выполняется (это не нужно для отдачи оригинала). +- Подтверждено экспериментом: обнаружение/исправление расхождений, защита свежих и используемых вложений, линейная стоимость обхода, ограничение памяти при 12 одновременных загрузках. Гипотеза без доказательства: поведение reconciler на бакетах > 100 тыс. объектов. diff --git a/compose.yaml b/compose.yaml new file mode 100644 index 00000000..4f0a57ea --- /dev/null +++ b/compose.yaml @@ -0,0 +1,172 @@ +# Стенд lab4: HAProxy -> API x N -> PostgreSQL (метаданные) + SeaweedFS (приватный S3, байты) + Valkey (кэш сессий). +# Секреты: scripts/init-secrets.sh создаёт secrets/* (в Git не попадают). Запуск и проверки — см. REPORT.md. +name: mtusi-lab4 + +x-common: &common + restart: unless-stopped + logging: + driver: json-file + options: {max-size: "10m", max-file: "3"} + +services: + postgres: + <<: *common + image: postgres:17.11-alpine@sha256:b0f9560a2de083e2cc7382e75f808c7381a32852a7ec49117deedb300e552b24 + environment: + POSTGRES_USER: messenger + POSTGRES_DB: messenger + POSTGRES_PASSWORD_FILE: /run/secrets/postgres_password + secrets: [postgres_password] + volumes: + - pgdata:/var/lib/postgresql/data + command: ["postgres", "-c", "max_connections=200", "-c", "shared_buffers=128MB", "-c", "log_min_duration_statement=500"] + healthcheck: + test: ["CMD-SHELL", "pg_isready -U messenger -d messenger"] + interval: 5s + timeout: 3s + retries: 12 + mem_limit: 512m + cpus: ${POSTGRES_CPUS:-1.0} + networks: [backend] + + valkey: + <<: *common + image: valkey/valkey:8.1.10-alpine@sha256:081c2f5cb575efc901aa80ff9cdbd1ec6a301682fd35e1ebb4b0990a4a4a8507 + command: ["valkey-server", "--appendonly", "yes", "--appendfsync", "everysec", + "--maxmemory", "64mb", "--maxmemory-policy", "volatile-ttl", "--save", ""] + volumes: + - valkeydata:/data + healthcheck: + test: ["CMD", "valkey-cli", "ping"] + interval: 5s + timeout: 3s + retries: 12 + mem_limit: 128m + cpus: 0.5 + networks: [backend] + + # Приватное S3-совместимое хранилище SeaweedFS (all-in-one: master + volume + filer + S3-шлюз). + # Порты наружу не публикуются: доступ только из сети backend и только по ключам из s3.json (identities). + # Анонимный доступ запрещён (при заданных identities запрос без подписи получает 403). + seaweedfs: + <<: *common + image: chrislusf/seaweedfs:4.48@sha256:4e61d15fd35994cb1e43e1e553dff106794841fd9a99ade2fc8c8bfce4d7872d + entrypoint: ["/bin/sh", "-c"] + command: ["exec weed server -dir=/data -ip=seaweedfs -master.volumeSizeLimitMB=512 -volume.max=30 -filer -s3 -s3.port=8333 -s3.config=/run/secrets/seaweed_s3_config"] + secrets: [seaweed_s3_config] + volumes: + - seaweeddata:/data + healthcheck: + test: ["CMD-SHELL", "wget -q -O /dev/null http://127.0.0.1:9333/cluster/status && nc -z 127.0.0.1 8333"] + interval: 5s + timeout: 3s + retries: 24 + start_period: 10s + mem_limit: 768m + cpus: ${S3_CPUS:-1.0} + networks: [backend] + + # Идемпотентный bootstrap: bucket создаётся, если его нет; проверяется, что анонимный доступ запрещён и что ключ API работает. + s3-init: + build: . + image: mtusi-messenger:lab4 + command: ["python", "-m", "app.s3_bootstrap"] + environment: + S3_ENDPOINT: http://seaweedfs:8333 + S3_BUCKET: ${S3_BUCKET:-messenger-attachments} + S3_ADMIN_ACCESS_KEY_FILE: /run/secrets/s3_admin_access_key + S3_ADMIN_SECRET_KEY_FILE: /run/secrets/s3_admin_secret_key + S3_ACCESS_KEY_FILE: /run/secrets/s3_access_key + S3_SECRET_KEY_FILE: /run/secrets/s3_secret_key + secrets: [s3_admin_access_key, s3_admin_secret_key, s3_access_key, s3_secret_key] + depends_on: + seaweedfs: {condition: service_healthy} + restart: "no" + networks: [backend] + + migrate: + build: . + image: mtusi-messenger:lab4 + command: ["python", "-m", "app.migrate"] + environment: + DATABASE_URL_FILE: /run/secrets/database_url + secrets: [database_url] + depends_on: + postgres: {condition: service_healthy} + restart: "no" + networks: [backend] + + api: + <<: *common + build: . + image: mtusi-messenger:lab4 + environment: + APP_ENV: ${APP_ENV:-lab} + DATABASE_URL_FILE: /run/secrets/database_url + VALKEY_URL: redis://valkey:6379/0 + S3_ENDPOINT: http://seaweedfs:8333 + S3_BUCKET: ${S3_BUCKET:-messenger-attachments} + S3_ACCESS_KEY_FILE: /run/secrets/s3_access_key + S3_SECRET_KEY_FILE: /run/secrets/s3_secret_key + SESSION_TTL_SECONDS: ${SESSION_TTL_SECONDS:-3600} + SESSION_CACHE_TTL_SECONDS: ${SESSION_CACHE_TTL_SECONDS:-60} + DB_POOL_MAX: ${DB_POOL_MAX:-10} + DRAIN_SECONDS: ${DRAIN_SECONDS:-4} + MAX_INFLIGHT: ${MAX_INFLIGHT:-64} + ACCESS_LOG: ${ACCESS_LOG:-1} + UPLOAD_CONCURRENCY: ${UPLOAD_CONCURRENCY:-4} + FAULT_INJECTION: ${FAULT_INJECTION:-} + secrets: [database_url, s3_access_key, s3_secret_key] + depends_on: + migrate: {condition: service_completed_successfully} + s3-init: {condition: service_completed_successfully} + valkey: {condition: service_healthy} + stop_grace_period: 15s + mem_limit: ${API_MEM:-256m} + cpus: ${API_CPUS:-1.0} + deploy: + replicas: ${API_REPLICAS:-2} + networks: [backend] + + lb: + <<: *common + image: haproxy:3.0-alpine@sha256:56b887da77428b7a6621e59e480cdbd330cc805c22d3cedb66ceea76ffdea2c6 + volumes: + - ./infra/haproxy/haproxy.cfg:/usr/local/etc/haproxy/haproxy.cfg:ro + depends_on: + - api + ports: + - "127.0.0.1:8080:8080" + healthcheck: + test: ["CMD-SHELL", "wget -q -O /dev/null http://127.0.0.1:8081/healthz"] + interval: 5s + timeout: 3s + retries: 6 + mem_limit: 128m + cpus: ${LB_CPUS:-1.0} + stop_grace_period: 10s + networks: [backend] + +secrets: + postgres_password: + file: ./secrets/postgres_password + database_url: + file: ./secrets/database_url + seaweed_s3_config: + file: ./secrets/seaweed_s3.json + s3_admin_access_key: + file: ./secrets/s3_admin_access_key + s3_admin_secret_key: + file: ./secrets/s3_admin_secret_key + s3_access_key: + file: ./secrets/s3_access_key + s3_secret_key: + file: ./secrets/s3_secret_key + +volumes: + pgdata: + valkeydata: + seaweeddata: + +networks: + backend: diff --git a/docs/report_lab4.docx b/docs/report_lab4.docx new file mode 100644 index 0000000000000000000000000000000000000000..f1aac99e9fd5a473ad7bcf6c022a525aee8c54a5 GIT binary patch literal 40012 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 z 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 сервер исключён (обнаружение отказа <= ~3 с), 2 успеха -> возвращён. + option httpchk + http-check send meth GET uri /health/ready + http-check expect status 200 + default-server check inter 1s fall 2 rise 2 resolvers docker init-addr none + server-template api 1-8 api:8080 diff --git a/migrations/0001_init.sql b/migrations/0001_init.sql new file mode 100644 index 00000000..2effe2e4 --- /dev/null +++ b/migrations/0001_init.sql @@ -0,0 +1,52 @@ +-- 0001: пользователи, чаты, участники, сообщения, сессии. +-- Источник истины для всех данных — PostgreSQL. Каждая миграция выполняется в транзакции. +CREATE TABLE users ( + id uuid PRIMARY KEY, + username text NOT NULL, + display_name text NOT NULL, + password_hash text NOT NULL, + created_at timestamptz NOT NULL DEFAULT clock_timestamp(), + CONSTRAINT users_username_format CHECK (username ~ '^[a-z0-9_]{3,32}$'), + CONSTRAINT users_display_name_len CHECK (char_length(display_name) BETWEEN 1 AND 100) +); +-- Уникальность username: гонка двух регистраций решается ограничением БД, а не проверкой в приложении. +CREATE UNIQUE INDEX users_username_key ON users (username); + +CREATE TABLE chats ( + id uuid PRIMARY KEY, + title text NOT NULL, + created_at timestamptz NOT NULL DEFAULT clock_timestamp(), + CONSTRAINT chats_title_len CHECK (char_length(title) BETWEEN 1 AND 100) +); + +-- chat_created_at денормализован ради keyset-пагинации списка чатов пользователя без join+sort. +CREATE TABLE chat_members ( + chat_id uuid NOT NULL REFERENCES chats (id) ON DELETE CASCADE, + user_id uuid NOT NULL REFERENCES users (id), + chat_created_at timestamptz NOT NULL, + ord smallint NOT NULL, + PRIMARY KEY (chat_id, user_id) +); +CREATE INDEX chat_members_user_chats ON chat_members (user_id, chat_created_at, chat_id); + +CREATE TABLE messages ( + id uuid PRIMARY KEY, + chat_id uuid NOT NULL REFERENCES chats (id) ON DELETE CASCADE, + sender_id uuid NOT NULL REFERENCES users (id), + text text NOT NULL, + created_at timestamptz NOT NULL DEFAULT clock_timestamp(), + CONSTRAINT messages_text_len CHECK (char_length(text) <= 4000) +); +-- История чата: WHERE chat_id = ? AND (created_at, id) > (?, ?) ORDER BY created_at, id LIMIT n +-- обслуживается этим индексом без сортировки и без сканирования всей истории. +CREATE INDEX messages_chat_history ON messages (chat_id, created_at, id); + +-- Серверные сессии. В БД хранится только SHA-256 токена: утечка БД не раскрывает рабочие токены. +CREATE TABLE sessions ( + token_hash bytea PRIMARY KEY, + user_id uuid NOT NULL REFERENCES users (id), + created_at timestamptz NOT NULL DEFAULT now(), + expires_at timestamptz NOT NULL, + revoked_at timestamptz +); +CREATE INDEX sessions_expires_at ON sessions (expires_at); diff --git a/migrations/0002_idempotency.sql b/migrations/0002_idempotency.sql new file mode 100644 index 00000000..a18c45f7 --- /dev/null +++ b/migrations/0002_idempotency.sql @@ -0,0 +1,17 @@ +-- 0002: общая идемпотентность отправки сообщений (lab3). +-- Область уникальности: пользователь + чат + ключ (метод и путь фиксированы: POST /chats/{id}/messages). +-- Запись ключа и сообщения — одна транзакция: побочный эффект и результат фиксируются атомарно. +CREATE TABLE idempotency_keys ( + user_id uuid NOT NULL REFERENCES users (id), + chat_id uuid NOT NULL REFERENCES chats (id) ON DELETE CASCADE, + idem_key text NOT NULL, + request_hash bytea NOT NULL, + message_id uuid NOT NULL, + created_at timestamptz NOT NULL DEFAULT now(), + PRIMARY KEY (user_id, chat_id, idem_key), + CONSTRAINT idem_key_format CHECK (idem_key ~ '^[A-Za-z0-9._:-]{1,128}$'), + -- сообщение вставляется после ключа в той же транзакции -> проверка внешнего ключа откладывается до COMMIT + CONSTRAINT idem_message_fk FOREIGN KEY (message_id) REFERENCES messages (id) ON DELETE CASCADE + DEFERRABLE INITIALLY DEFERRED +); +CREATE INDEX idempotency_keys_created_at ON idempotency_keys (created_at); diff --git a/migrations/0003_send_message_function.sql b/migrations/0003_send_message_function.sql new file mode 100644 index 00000000..f9e8dd85 --- /dev/null +++ b/migrations/0003_send_message_function.sql @@ -0,0 +1,35 @@ +-- 0003: отправка сообщения одной серверной функцией (оптимизация по итогам трека 1: меньше обращений к БД на запрос). +-- Семантика идентична версии «несколько запросов в транзакции» (migrations 0002 + код приложения): +-- проверка членства -> просроченный ключ удаляется -> INSERT ключа (ON CONFLICT DO NOTHING) -> INSERT сообщения. +-- Функция выполняется атомарно (один вызов = одна транзакция); гонку одинаковых ключей по-прежнему решает уникальный индекс. +CREATE FUNCTION send_message(p_chat uuid, p_user uuid, p_key text, p_hash bytea, p_text text, p_ttl double precision) +RETURNS TABLE (outcome text, msg_id uuid, msg_chat uuid, msg_sender uuid, msg_text text, msg_created timestamptz, + request_hash bytea) +LANGUAGE plpgsql AS $$ +DECLARE + v_new uuid := gen_random_uuid(); + v_ins uuid; + v_created timestamptz; +BEGIN + IF NOT EXISTS (SELECT 1 FROM chat_members m WHERE m.chat_id = p_chat AND m.user_id = p_user) THEN + RETURN QUERY SELECT 'not_member'::text, NULL::uuid, NULL::uuid, NULL::uuid, NULL::text, NULL::timestamptz, NULL::bytea; + RETURN; + END IF; + DELETE FROM idempotency_keys k + WHERE k.user_id = p_user AND k.chat_id = p_chat AND k.idem_key = p_key + AND k.created_at < now() - make_interval(secs => p_ttl); + INSERT INTO idempotency_keys (user_id, chat_id, idem_key, request_hash, message_id) + VALUES (p_user, p_chat, p_key, p_hash, v_new) + ON CONFLICT DO NOTHING + RETURNING message_id INTO v_ins; + IF v_ins IS NOT NULL THEN + INSERT INTO messages (id, chat_id, sender_id, text) VALUES (v_new, p_chat, p_user, p_text) + RETURNING created_at INTO v_created; + RETURN QUERY SELECT 'created'::text, v_new, p_chat, p_user, p_text, v_created, p_hash; + ELSE + RETURN QUERY SELECT 'replay'::text, m.id, m.chat_id, m.sender_id, m.text, m.created_at, k.request_hash + FROM idempotency_keys k JOIN messages m ON m.id = k.message_id + WHERE k.user_id = p_user AND k.chat_id = p_chat AND k.idem_key = p_key; + END IF; +END; +$$; diff --git a/migrations/0004_attachments.sql b/migrations/0004_attachments.sql new file mode 100644 index 00000000..e1c15b97 --- /dev/null +++ b/migrations/0004_attachments.sql @@ -0,0 +1,90 @@ +-- 0004 (lab4): метаданные вложений в PostgreSQL, байты — в приватном S3-бакете. +-- Ключ объекта назначает сервер (att//original); filename — только отображаемое имя. +CREATE TABLE attachments ( + id uuid PRIMARY KEY, + chat_id uuid NOT NULL REFERENCES chats (id) ON DELETE CASCADE, + owner_id uuid NOT NULL REFERENCES users (id), + filename text NOT NULL, + content_type text NOT NULL, + size_bytes bigint NOT NULL, + sha256 text NOT NULL, + width integer NOT NULL, + height integer NOT NULL, + status text NOT NULL DEFAULT 'ready', + error_code text, + s3_key text NOT NULL, + created_at timestamptz NOT NULL DEFAULT clock_timestamp(), + updated_at timestamptz NOT NULL DEFAULT clock_timestamp(), + CONSTRAINT attachments_content_type CHECK (content_type IN ('image/png', 'image/jpeg')), + CONSTRAINT attachments_size CHECK (size_bytes BETWEEN 1 AND 10485760), + CONSTRAINT attachments_sha256 CHECK (sha256 ~ '^[a-f0-9]{64}$'), + CONSTRAINT attachments_status CHECK (status IN ('queued', 'processing', 'ready', 'failed')), + CONSTRAINT attachments_filename_len CHECK (char_length(filename) BETWEEN 1 AND 255) +); +CREATE UNIQUE INDEX attachments_s3_key_key ON attachments (s3_key); +CREATE INDEX attachments_chat ON attachments (chat_id); + +-- Связь сообщение <-> вложения (порядок сохраняется). Вложение может быть привязано к нескольким сообщениям чата. +CREATE TABLE message_attachments ( + message_id uuid NOT NULL REFERENCES messages (id) ON DELETE CASCADE, + attachment_id uuid NOT NULL REFERENCES attachments (id), + position smallint NOT NULL, + PRIMARY KEY (message_id, attachment_id) +); +CREATE INDEX message_attachments_attachment ON message_attachments (attachment_id); + +-- Отправка сообщения с вложениями: заменяет функцию из 0003 (добавлен параметр p_atts и результат msg_atts). +DROP FUNCTION send_message(uuid, uuid, text, bytea, text, double precision); +CREATE FUNCTION send_message(p_chat uuid, p_user uuid, p_key text, p_hash bytea, p_text text, p_ttl double precision, + p_atts uuid[]) +RETURNS TABLE (outcome text, msg_id uuid, msg_chat uuid, msg_sender uuid, msg_text text, msg_created timestamptz, + request_hash bytea, msg_atts uuid[]) +LANGUAGE plpgsql AS $$ +DECLARE + v_new uuid := gen_random_uuid(); + v_ins uuid; + v_created timestamptz; + v_found int; + v_failed int; +BEGIN + IF NOT EXISTS (SELECT 1 FROM chat_members m WHERE m.chat_id = p_chat AND m.user_id = p_user) THEN + RETURN QUERY SELECT 'not_member'::text, NULL::uuid, NULL::uuid, NULL::uuid, NULL::text, NULL::timestamptz, + NULL::bytea, NULL::uuid[]; + RETURN; + END IF; + IF cardinality(p_atts) > 0 THEN + SELECT count(*), count(*) FILTER (WHERE a.status = 'failed') INTO v_found, v_failed + FROM attachments a WHERE a.id = ANY (p_atts) AND a.chat_id = p_chat; + IF v_found <> cardinality(p_atts) THEN + RETURN QUERY SELECT 'attachment_not_found'::text, NULL::uuid, NULL::uuid, NULL::uuid, NULL::text, + NULL::timestamptz, NULL::bytea, NULL::uuid[]; + RETURN; + END IF; + IF v_failed > 0 THEN + RETURN QUERY SELECT 'attachment_failed'::text, NULL::uuid, NULL::uuid, NULL::uuid, NULL::text, + NULL::timestamptz, NULL::bytea, NULL::uuid[]; + RETURN; + END IF; + END IF; + DELETE FROM idempotency_keys k + WHERE k.user_id = p_user AND k.chat_id = p_chat AND k.idem_key = p_key + AND k.created_at < now() - make_interval(secs => p_ttl); + INSERT INTO idempotency_keys (user_id, chat_id, idem_key, request_hash, message_id) + VALUES (p_user, p_chat, p_key, p_hash, v_new) + ON CONFLICT DO NOTHING + RETURNING message_id INTO v_ins; + IF v_ins IS NOT NULL THEN + INSERT INTO messages (id, chat_id, sender_id, text) VALUES (v_new, p_chat, p_user, p_text) + RETURNING created_at INTO v_created; + INSERT INTO message_attachments (message_id, attachment_id, position) + SELECT v_new, a, (o - 1)::smallint FROM unnest(p_atts) WITH ORDINALITY AS t(a, o); + RETURN QUERY SELECT 'created'::text, v_new, p_chat, p_user, p_text, v_created, p_hash, p_atts; + ELSE + RETURN QUERY SELECT 'replay'::text, m.id, m.chat_id, m.sender_id, m.text, m.created_at, k.request_hash, + COALESCE((SELECT array_agg(ma.attachment_id ORDER BY ma.position) + FROM message_attachments ma WHERE ma.message_id = m.id), '{}'::uuid[]) + FROM idempotency_keys k JOIN messages m ON m.id = k.message_id + WHERE k.user_id = p_user AND k.chat_id = p_chat AND k.idem_key = p_key; + END IF; +END; +$$; diff --git a/requirements.txt b/requirements.txt new file mode 100644 index 00000000..d7700fd6 --- /dev/null +++ b/requirements.txt @@ -0,0 +1,30 @@ +aiobotocore==3.9.2 +aiohappyeyeballs==2.7.1 +aiohttp==3.14.3 +aioitertools==0.13.0 +aiosignal==1.4.0 +argon2-cffi==23.1.0 +argon2-cffi-bindings==26.1.0 +asyncpg==0.30.0 +attrs==26.1.0 +botocore==1.43.106 +cffi==2.1.1 +click==8.5.0 +frozenlist==1.8.0 +h11==0.16.0 +httptools==0.8.0 +idna==3.20 +jmespath==1.1.0 +multidict==6.9.1 +pillow==12.3.0 +propcache==0.5.4 +pycparser==3.0 +python-dateutil==2.9.0.post0 +redis==5.2.1 +six==1.17.0 +typing_extensions==4.16.0 +urllib3==2.8.0 +uvicorn==0.34.0 +uvloop==0.21.0; sys_platform != "win32" +wrapt==2.5.0 +yarl==1.25.1 diff --git a/research/failover_sequence.py b/research/failover_sequence.py new file mode 100644 index 00000000..af08131d --- /dev/null +++ b/research/failover_sequence.py @@ -0,0 +1,113 @@ +#!/usr/bin/env python3 +"""Уровень 4: последовательная остановка каждой API-реплики под нагрузкой (с восстановлением предыдущей). + +Сценарий (стенд `docker compose up -d` с 2 репликами; нагрузка идёт через LB непрерывно ~70 с): + t=10 остановить реплику A (docker stop --time 0 = мгновенный отказ процесса) + t=25 восстановить (scripts/restore-replicas.sh) + t=40 остановить реплику B + t=55 восстановить +Для каждого отказа считаем: RPS до/во время/после, число ошибочных попыток, время до прекращения ошибок +(= обнаружение отказа балансировщиком), сохранность подтверждённых сообщений и отсутствие дублей. + + python research/failover_sequence.py --out evidence +""" +import argparse +import asyncio +import json +import os +import subprocess +import sys +import threading +import time + +sys.path.insert(0, os.path.dirname(__file__)) +import loadgen # noqa: E402 + +ROOT = os.path.join(os.path.dirname(os.path.abspath(__file__)), "..") +BASE = "http://127.0.0.1:8080" + + +def sh(*args): + return subprocess.run(args, cwd=ROOT, capture_output=True, text=True).stdout.strip() + + +def api_ids(): + return sh("docker", "ps", "-q", "--filter", "label=com.docker.compose.project=mtusi-lab4", + "--filter", "label=com.docker.compose.service=api").split() + + +def scenario(rec, plan): + """Выполняется в отдельном потоке: действия по расписанию относительно rec.t0.""" + for at, action in plan: + time.sleep(max(0, rec.t0 + at - time.time())) + t = time.time() - rec.t0 + if action == "stop": + target = api_ids()[0] + subprocess.run(["docker", "stop", "--time", "0", target], capture_output=True) + rec.marks.append({"t": round(t, 2), "action": "stop", "container": target}) + else: + subprocess.run(["sh", "scripts/restore-replicas.sh"], cwd=ROOT, capture_output=True) + rec.marks.append({"t": round(t, 2), "action": "restore"}) + + +async def main(args): + stand = loadgen.Stand(BASE) + await stand.setup() + rec = loadgen.Recorder() + rec.marks = [] + plan = [(10, "stop"), (25, "restore"), (40, "stop"), (55, "restore")] + threading.Thread(target=scenario, args=(rec, plan), daemon=True).start() + await loadgen.run_load(stand, rec, args.seconds, args.concurrency) + await asyncio.sleep(2) + check = await loadgen.verify(stand, rec) + stops = [m for m in rec.marks if m["action"] == "stop"] + restores = [m for m in rec.marks if m["action"] == "restore"] + windows = [] + for i, stop in enumerate(stops): + t0 = stop["t"] + errs = [e for e in rec.events if e[1] == "POST" and e[2] != 201 and t0 - 0.2 <= e[0] <= t0 + 10] + last_err = max((e[0] for e in errs), default=t0) + restore_t = restores[i]["t"] if i < len(restores) else t0 + 15 + windows.append({"stopped_container": stop["container"], "stop_at_s": t0, + "rps_before": loadgen.summarize(rec, t0 - 8, t0 - 0.5).get("ok_rps"), + "rps_one_replica": loadgen.summarize(rec, t0 + 5, restore_t - 1).get("ok_rps"), + "rps_after_restore": loadgen.summarize(rec, restore_t + 8, restore_t + 14).get("ok_rps"), + "failed_attempts_within_10s": len(errs), + "error_statuses": sorted({str(e[2]) for e in errs}), + "seconds_until_errors_stop": round(last_err - t0, 2) if errs else 0.0, + "p95_ms_one_replica": loadgen.summarize(rec, t0 + 5, restore_t - 1).get("p95_ms")}) + series = loadgen.per_second(rec) + report = {"date": time.strftime("%Y-%m-%d %H:%M:%S"), "args": vars(args), "marks": rec.marks, "windows": windows, + "total": loadgen.summarize(rec), "verification": check, + "invariants_ok": check["confirmed_missing_in_history"] == 0 and check["duplicate_texts_in_history"] == 0, + "timeline": [{"t": t, "ok": b["ok"], "err": b["err"], "p95_ms": loadgen.pct(b["lat"], .95), "instances": len(b["instances"])} + for t, b in sorted(series.items())]} + with open(os.path.join(args.out, "failover_sequence.json"), "w", encoding="utf-8") as fh: + json.dump(report, fh, ensure_ascii=False, indent=2) + plot(report, os.path.join(args.out, "failover_sequence.png")) + print(json.dumps({k: v for k, v in report.items() if k != "timeline"}, ensure_ascii=False, indent=2)) + + +def plot(report, path): + import matplotlib + matplotlib.use("Agg") + import matplotlib.pyplot as plt + tl = report["timeline"] + t = [x["t"] for x in tl] + fig, ax = plt.subplots(3, 1, figsize=(11, 8.5), sharex=True) + ax[0].plot(t, [x["ok"] for x in tl], color="#2e7d32"); ax[0].set_ylabel("успешных POST/с"); ax[0].set_title("Пропускная способность") + ax[1].bar(t, [x["err"] for x in tl], color="#c62828"); ax[1].set_ylabel("ошибочных попыток/с"); ax[1].set_title("Ошибки (до повтора с тем же ключом)") + ax[2].plot(t, [x["p95_ms"] or 0 for x in tl], color="#1565c0"); ax[2].set_ylabel("p95, мс"); ax[2].set_xlabel("время, с"); ax[2].set_title("Латентность успешных POST") + for a in ax: + for m in report["marks"]: + a.axvline(m["t"], color="red" if m["action"] == "stop" else "green", ls="--", lw=1) + ax[0].text(0.01, 0.05, "красная линия — остановка реплики, зелёная — восстановление", transform=ax[0].transAxes, fontsize=9) + fig.tight_layout(); fig.savefig(path, dpi=110) + + +if __name__ == "__main__": + ap = argparse.ArgumentParser() + ap.add_argument("--out", default="evidence") + ap.add_argument("--seconds", type=int, default=70) + ap.add_argument("--concurrency", type=int, default=16) + asyncio.run(main(ap.parse_args())) diff --git a/research/loadgen.py b/research/loadgen.py new file mode 100644 index 00000000..788e5d84 --- /dev/null +++ b/research/loadgen.py @@ -0,0 +1,172 @@ +"""Генератор нагрузки для экспериментов lab4+ (asyncio + aiohttp, closed-loop). + +Каждый воркер выполняет цикл: POST сообщения с новым Idempotency-Key (90 %) или GET первой страницы истории (10 %). +При ошибке соединения/5xx POST повторяется с ТЕМ ЖЕ ключом (до RETRIES раз) — именно так клиент безопасно +повторяет неподтверждённую запись. Результат: по секундам успехи/ошибки/латентности, список подтверждённых +сообщений (для сверки с историей), число повторов. +""" +import asyncio +import base64 +import random +import time +import uuid + +import aiohttp + +RETRIES = 3 + + +class Stand: + """Набор пользователей/чатов, созданных через API (через LB), для одного эксперимента.""" + + def __init__(self, base, users=20, chats=20): + self.base, self.n_users, self.n_chats = base, users, chats + self.users, self.chats = [], [] + + async def setup(self): + timeout = aiohttp.ClientTimeout(total=30) + async with aiohttp.ClientSession(timeout=timeout) as s: + for i in range(self.n_users): + name = "ld_%s" % uuid.uuid4().hex[:14] + pw = "load-test-password-" + uuid.uuid4().hex[:8] + async with s.post(self.base + "/api/v1/users", json={"username": name, "display_name": "load %d" % i, "password": pw}) as r: + user = await r.json() + assert r.status == 201, user + cred = base64.b64encode(("%s:%s" % (name, pw)).encode()).decode() + async with s.post(self.base + "/api/v1/auth/sessions", headers={"Authorization": "Basic " + cred}) as r: + sess = await r.json() + assert r.status == 201, sess + self.users.append({"id": user["id"], "token": sess["token"]}) + for i in range(self.n_chats): + members = random.sample(self.users, 3) + owner = members[0] + async with s.post(self.base + "/api/v1/chats", json={"title": "load %d" % i, "member_ids": [m["id"] for m in members]}, + headers={"Authorization": "Bearer " + owner["token"]}) as r: + chat = await r.json() + assert r.status == 201, chat + self.chats.append({"id": chat["id"], "members": members}) + + +class Recorder: + def __init__(self): + self.t0 = time.time() + self.events = [] # (t, kind, status, latency_ms, instance) + self.confirmed = [] # (chat_id, message_id, text) + self.retries = 0 + self.final_failures = 0 + self.unconfirmed = [] # (chat_id, key, text) — финально не подтверждены (могли записаться!) + + +async def worker(stand, rec, deadline_fn, read_ratio=0.1, text_size=0, think=0.0): + connector = aiohttp.TCPConnector(limit=2) + timeout = aiohttp.ClientTimeout(total=5) + async with aiohttp.ClientSession(connector=connector, timeout=timeout) as s: + n = 0 + while not deadline_fn(): + chat = random.choice(stand.chats) + user = random.choice(chat["members"]) + hdr = {"Authorization": "Bearer " + user["token"]} + if random.random() < read_ratio: + t = time.perf_counter() + try: + async with s.get("%s/api/v1/chats/%s/messages?limit=20" % (stand.base, chat["id"]), headers=hdr) as r: + await r.read() + rec.events.append((time.time() - rec.t0, "GET", r.status, (time.perf_counter() - t) * 1000, r.headers.get("X-Instance-Id"))) + except Exception as exc: + rec.events.append((time.time() - rec.t0, "GET", type(exc).__name__, (time.perf_counter() - t) * 1000, None)) + continue + key = uuid.uuid4().hex + text = "m-%s-%d" % (key[:8], n) + "я" * text_size + n += 1 + for attempt in range(RETRIES + 1): + t = time.perf_counter() + try: + async with s.post("%s/api/v1/chats/%s/messages" % (stand.base, chat["id"]), json={"text": text}, + headers=dict(hdr, **{"Idempotency-Key": key})) as r: + body = await r.json(content_type=None) + status, inst = r.status, r.headers.get("X-Instance-Id") + except Exception as exc: + status, inst, body = type(exc).__name__, None, None + rec.events.append((time.time() - rec.t0, "POST", status, (time.perf_counter() - t) * 1000, inst)) + if status == 201: + rec.confirmed.append((chat["id"], body["id"], text)) + break + if attempt < RETRIES and (not isinstance(status, int) or status >= 500 or status == 429): + rec.retries += 1 + await asyncio.sleep(0.05 * (attempt + 1)) + continue + rec.final_failures += 1 + rec.unconfirmed.append((chat["id"], key, text)) + break + if think: + await asyncio.sleep(think) + + +async def run_load(stand, rec, seconds, concurrency, **kw): + end = time.time() + seconds + await asyncio.gather(*(worker(stand, rec, lambda: time.time() > end, **kw) for _ in range(concurrency))) + + +async def verify(stand, rec): + """Сверка: каждое подтверждённое сообщение читается, дублей по тексту нет, неподтверждённые встречаются не более 1 раза.""" + timeout = aiohttp.ClientTimeout(total=30) + stored = {} + async with aiohttp.ClientSession(timeout=timeout) as s: + for chat in stand.chats: + hdr = {"Authorization": "Bearer " + chat["members"][0]["token"]} + cursor, items = None, [] + while True: + url = "%s/api/v1/chats/%s/messages?limit=100%s" % (stand.base, chat["id"], "&cursor=" + cursor if cursor else "") + async with s.get(url, headers=hdr) as r: + page = await r.json() + assert r.status == 200, page + items += page["items"] + cursor = page["next_cursor"] + if not cursor: + break + stored[chat["id"]] = items + ids = {m["id"] for items in stored.values() for m in items} + texts = [m["text"] for items in stored.values() for m in items] + confirmed_missing = [c for c in rec.confirmed if c[1] not in ids] + dup_texts = len(texts) - len(set(texts)) + unconfirmed_present = sum(1 for c in rec.unconfirmed if c[2] in set(texts)) + return {"stored_messages": len(ids), "confirmed_201": len(rec.confirmed), "confirmed_missing_in_history": len(confirmed_missing), + "duplicate_texts_in_history": dup_texts, "unconfirmed_requests": len(rec.unconfirmed), + "unconfirmed_that_were_written": unconfirmed_present, "retries": rec.retries, "final_failures": rec.final_failures} + + +def per_second(rec, kind="POST"): + buckets = {} + for t, k, status, lat, inst in rec.events: + if k != kind: + continue + b = buckets.setdefault(int(t), {"ok": 0, "err": 0, "lat": [], "instances": set()}) + if status == 201 or (kind == "GET" and status == 200): + b["ok"] += 1 + b["lat"].append(lat) + if inst: + b["instances"].add(inst) + else: + b["err"] += 1 + return buckets + + +def pct(values, p): + if not values: + return None + values = sorted(values) + return round(values[max(0, int(len(values) * p + 0.9999) - 1)], 2) + + +def summarize(rec, t_from=None, t_to=None, kind="POST"): + rows = [e for e in rec.events if e[1] == kind and (t_from is None or e[0] >= t_from) and (t_to is None or e[0] < t_to)] + if not rows: + return {} + dur = (t_to if t_to is not None else max(e[0] for e in rows)) - (t_from if t_from is not None else min(e[0] for e in rows)) + ok = [e[3] for e in rows if e[2] == 201 or (kind == "GET" and e[2] == 200)] + errs = {} + for e in rows: + if not (e[2] == 201 or (kind == "GET" and e[2] == 200)): + errs[str(e[2])] = errs.get(str(e[2]), 0) + 1 + return {"requests": len(rows), "ok": len(ok), "errors": errs, "seconds": round(dur, 2), "ok_rps": round(len(ok) / dur, 1) if dur > 0 else None, + "error_ratio": round((len(rows) - len(ok)) / len(rows), 4), "p50_ms": pct(ok, .5), "p95_ms": pct(ok, .95), "p99_ms": pct(ok, .99)} diff --git a/research/reconcile_bench.py b/research/reconcile_bench.py new file mode 100644 index 00000000..c6e29bdc --- /dev/null +++ b/research/reconcile_bench.py @@ -0,0 +1,170 @@ +#!/usr/bin/env python3 +"""Трек 2 (согласованность двух хранилищ): reconciler S3 <-> PostgreSQL — внедрение ошибок, dry-run/apply, стоимость обхода. + +Сценарий (стенд запущен; используются синтетические данные): + 1. Наращиваем число вложений тремя порциями (до ~N) и после каждой порции замеряем стоимость dry-run обхода. + 2. Внедряем ошибки на ОБЕИХ сторонах: A) 20 «осиротевших» объектов в S3 (нет строки в БД); + B) у 20 вложений удаляем объект в S3 (строка есть, объекта нет); C) у 5 вложений подменяем объект на другой по размеру. + 3. dry-run: находит ровно внедрённое и ничего не меняет (повтор даёт тот же отчёт); + apply с grace=5 с ПАРАЛЛЕЛЬНО идущей загрузкой 200 новых вложений: удаляются только старые осиротевшие объекты; + свежие/используемые вложения не затронуты (скачиваются, sha256 совпадает); + повторный apply — идемпотентен (изменений нет). +Результат: evidence/track2_reconcile.json + python research/reconcile_bench.py --out evidence --total 3000 +""" +import argparse +import asyncio +import base64 +import hashlib +import io +import json +import os +import random +import subprocess +import time +import uuid + +import aiohttp +from PIL import Image + +ROOT = os.path.join(os.path.dirname(os.path.abspath(__file__)), "..") +BASE = "http://127.0.0.1:8080" + + +def sh(*args): + return subprocess.run(args, cwd=ROOT, capture_output=True, text=True, encoding="utf-8") + + +def compose(*args): + return sh("docker", "compose", "--env-file", ".env", *args).stdout + + +def reconcile(*args): + out = compose("run", "--rm", "-T", "api", "python", "-m", "app.reconcile", "--max-listed", "100", *args) + return json.loads(out[out.index("{"):]) + + +def in_api(code): + r = sh("docker", "compose", "--env-file", ".env", "exec", "-T", "api", "python", "-c", code) + if r.returncode != 0: + raise RuntimeError("сбой во внедрении ошибок: " + r.stderr[-500:]) + return r.stdout.strip() + + +def tiny_png(seed): + img = Image.new("RGB", (40, 30), (seed % 256, (seed // 256) % 256, 90)) + buf = io.BytesIO() + img.save(buf, "PNG") + return buf.getvalue() + + +async def register(s): + name = "rc_%s" % uuid.uuid4().hex[:12] + pw = "reconcile-test-" + uuid.uuid4().hex[:6] + async with s.post(BASE + "/api/v1/users", json={"username": name, "display_name": "r", "password": pw}) as r: + user = await r.json() + cred = base64.b64encode(("%s:%s" % (name, pw)).encode()).decode() + async with s.post(BASE + "/api/v1/auth/sessions", headers={"Authorization": "Basic " + cred}) as r: + token = (await r.json())["token"] + async with s.post(BASE + "/api/v1/chats", json={"title": "reconcile", "member_ids": [user["id"]]}, headers={"Authorization": "Bearer " + token}) as r: + chat = await r.json() + return token, chat["id"] + + +async def upload_many(s, token, chat_id, n, offset=0, concurrency=16): + ids, sem = [], asyncio.Semaphore(concurrency) + + async def one(i): + async with sem: + data = tiny_png(offset + i) + for attempt in range(4): # повтор при разрыве keep-alive соединения (гонка закрытия на стороне сервера) + try: + async with s.post("%s/api/v1/chats/%s/attachments?filename=r%d.png" % (BASE, chat_id, i), data=data, + headers={"Authorization": "Bearer " + token, "Content-Type": "image/png"}) as r: + body = await r.json(content_type=None) + if r.status == 201: + ids.append((body["id"], body["sha256"])) + break + except aiohttp.ClientError: + await asyncio.sleep(0.1) + await asyncio.gather(*(one(i) for i in range(n))) + return ids + + +async def check_intact(s, token, items): + ok = 0 + for att_id, sha in items: + async with s.get("%s/api/v1/attachments/%s/content" % (BASE, att_id), headers={"Authorization": "Bearer " + token}) as r: + if r.status == 200 and hashlib.sha256(await r.read()).hexdigest() == sha: + ok += 1 + return ok + + +def keys_for(ids): + out = sh("docker", "compose", "--env-file", ".env", "exec", "-T", "postgres", "psql", "-U", "messenger", "-d", "messenger", "-At", "-c", + "SELECT s3_key FROM attachments WHERE id IN (%s)" % ",".join("'%s'" % i for i in ids)).stdout.split() + return out + + +async def main(args): + report = {"date": time.strftime("%Y-%m-%d %H:%M:%S"), "cost_of_scan": [], "args": vars(args)} + async with aiohttp.ClientSession(timeout=aiohttp.ClientTimeout(total=60), connector=aiohttp.TCPConnector(limit=32)) as s: + token, chat = await register(s) + base = reconcile("--grace", "0", "--apply") # нормализация: убираем следы прошлых прогонов + base = reconcile("--grace", "0") + assert (base["orphan_objects_count"], base["missing_objects_count"], base["size_mismatch_count"]) == (0, 0, 0), base + uploaded, step = [], args.total // 3 + for part in range(3): + t = time.perf_counter() + uploaded += await upload_many(s, token, chat, step, offset=len(uploaded)) + up_s = time.perf_counter() - t + r = reconcile("--grace", "900") + report["cost_of_scan"].append({"db_rows": r["db_rows"], "s3_objects": r["s3_objects"], "timing_ms": r["timing_ms"], + "upload_batch_seconds": round(up_s, 1)}) + print(json.dumps(report["cost_of_scan"][-1])) + # --- внедрение ошибок --- + sample = random.sample(uploaded, 25) + missing_ids = [a for a, _ in sample[:20]] + mismatch_ids = [a for a, _ in sample[20:25]] + used_ids = [a for a, _ in random.sample([u for u in uploaded if u[0] not in set(missing_ids + mismatch_ids)], 200)] + orphans = ["att/%s/original" % uuid.uuid4() for _ in range(20)] + mkeys, xkeys = keys_for(missing_ids), keys_for(mismatch_ids) + code = ("import asyncio\nfrom app import config\nfrom app.s3 import S3\nasync def m():\n s=S3(); await s.start()\n" + " for k in %r: await s.client.put_object(Bucket=config.S3_BUCKET, Key=k, Body=b'orphan')\n" + " for k in %r: await s.delete(k)\n" + " for k in %r: await s.client.put_object(Bucket=config.S3_BUCKET, Key=k, Body=b'x'*7)\n await s.stop()\nasyncio.run(m())" % (orphans, mkeys, xkeys)) + in_api(code) + report["injected"] = {"orphan_objects": 20, "missing_objects": 20, "size_mismatch": 5} + used_pairs = [u for u in uploaded if u[0] in set(used_ids)] + time.sleep(6) # осиротевшие объекты станут старше grace=5 с + # --- dry-run --- + dry1 = reconcile("--grace", "5") + dry2 = reconcile("--grace", "5") + report["dry_run"] = {k: dry1[k] for k in ("orphan_objects_count", "missing_objects_count", "size_mismatch_count", "orphans_skipped_fresh", "timing_ms", "fixed")} + report["dry_run_repeatable"] = all(dry1[k] == dry2[k] for k in ("orphan_objects_count", "missing_objects_count", "size_mismatch_count")) + report["dry_run_found_exactly_injected"] = (dry1["orphan_objects_count"], dry1["missing_objects_count"], dry1["size_mismatch_count"]) == (20, 20, 5) + # --- apply параллельно с загрузкой новых (свежих) вложений --- + fresh_task = asyncio.create_task(upload_many(s, token, chat, 200, offset=100000)) + await asyncio.sleep(1.0) + loop = asyncio.get_running_loop() + applied = await loop.run_in_executor(None, lambda: reconcile("--grace", "5", "--apply")) + fresh = await fresh_task + report["apply"] = {k: applied[k] for k in ("fixed", "orphans_skipped_fresh", "timing_ms", "orphan_objects_count", "missing_objects_count", "size_mismatch_count")} + report["fresh_uploads_during_apply"] = {"uploaded": len(fresh), "intact": await check_intact(s, token, fresh)} + report["in_use_attachments_intact"] = "%d/%d" % (await check_intact(s, token, used_pairs), len(used_pairs)) + again = reconcile("--grace", "5", "--apply") + report["second_apply_idempotent"] = {"fixed": again["fixed"], "orphan_objects_count": again["orphan_objects_count"], + "missing_objects_count": again["missing_objects_count"]} + failed = sh("docker", "compose", "--env-file", ".env", "exec", "-T", "postgres", "psql", "-U", "messenger", "-d", "messenger", "-At", "-c", + "SELECT error_code || '=' || count(*) FROM attachments WHERE status = 'failed' AND chat_id = '%s' GROUP BY error_code ORDER BY 1" % chat).stdout.split() + report["marked_failed"] = failed + with open(os.path.join(args.out, "track2_reconcile.json"), "w", encoding="utf-8") as fh: + json.dump(report, fh, ensure_ascii=False, indent=2) + print(json.dumps({k: v for k, v in report.items() if k != "args"}, ensure_ascii=False, indent=2)) + + +if __name__ == "__main__": + ap = argparse.ArgumentParser() + ap.add_argument("--out", default="evidence") + ap.add_argument("--total", type=int, default=3000) + asyncio.run(main(ap.parse_args())) diff --git a/research/rolling_update.py b/research/rolling_update.py new file mode 100644 index 00000000..dc81c0e4 --- /dev/null +++ b/research/rolling_update.py @@ -0,0 +1,57 @@ +#!/usr/bin/env python3 +"""Уровень 4: rolling update под нагрузкой. Нагрузка идёт через LB 60 с; на t=10 запускается scripts/rolling-update.sh. +Проверяем: ошибки клиента (после повторов с тем же ключом), потерянные/задублированные сообщения, смену instance id.""" +import argparse +import asyncio +import json +import os +import subprocess +import sys +import threading +import time + +sys.path.insert(0, os.path.dirname(__file__)) +import loadgen # noqa: E402 + +ROOT = os.path.join(os.path.dirname(os.path.abspath(__file__)), "..") + + +async def main(args): + stand = loadgen.Stand("http://127.0.0.1:8080") + await stand.setup() + rec = loadgen.Recorder() + info = {} + + def update(): + time.sleep(max(0, rec.t0 + 10 - time.time())) + info["start"] = round(time.time() - rec.t0, 2) + out = subprocess.run(["sh", "scripts/rolling-update.sh", args.revision], cwd=ROOT, capture_output=True, text=True) + info["end"] = round(time.time() - rec.t0, 2) + info["script_exit"] = out.returncode + info["script_output"] = out.stdout.strip().splitlines()[-6:] + + threading.Thread(target=update, daemon=True).start() + await loadgen.run_load(stand, rec, args.seconds, args.concurrency) + await asyncio.sleep(1) + check = await loadgen.verify(stand, rec) + instances_before = {e[4] for e in rec.events if e[1] == "POST" and e[0] < info["start"] and e[4]} + instances_during = {e[4] for e in rec.events if e[1] == "POST" and info["start"] <= e[0] <= info["end"] and e[4]} + instances_after = {e[4] for e in rec.events if e[1] == "POST" and e[0] > info["end"] + 2 and e[4]} + report = {"date": time.strftime("%Y-%m-%d %H:%M:%S"), "update": info, "revision": args.revision, + "instances_before": sorted(instances_before), "instances_during": sorted(instances_during), + "instances_after": sorted(instances_after), "all_replicas_replaced": not (instances_before & instances_after), + "before": loadgen.summarize(rec, 2, info["start"]), "during": loadgen.summarize(rec, info["start"], info["end"]), + "after": loadgen.summarize(rec, info["end"] + 2, None), "total": loadgen.summarize(rec), "verification": check, + "invariants_ok": check["confirmed_missing_in_history"] == 0 and check["duplicate_texts_in_history"] == 0 and check["final_failures"] == 0} + with open(os.path.join(args.out, "rolling_update.json"), "w", encoding="utf-8") as fh: + json.dump(report, fh, ensure_ascii=False, indent=2) + print(json.dumps(report, ensure_ascii=False, indent=2)) + + +if __name__ == "__main__": + ap = argparse.ArgumentParser() + ap.add_argument("--out", default="evidence") + ap.add_argument("--seconds", type=int, default=60) + ap.add_argument("--concurrency", type=int, default=16) + ap.add_argument("--revision", default="rolling-%d" % int(time.time())) + asyncio.run(main(ap.parse_args())) diff --git a/research/upload_memory.py b/research/upload_memory.py new file mode 100644 index 00000000..8adb3a96 --- /dev/null +++ b/research/upload_memory.py @@ -0,0 +1,139 @@ +#!/usr/bin/env python3 +"""Уровень 4: ≥10 одновременных загрузок крупных файлов и пик памяти API. + +Для каждого значения UPLOAD_CONCURRENCY (одновременных загрузок на реплику) пересоздаётся ОДНА реплика API +(пик RSS обнуляется), затем 12 клиентов одновременно грузят ~8 MiB PNG. Пик памяти — VmHWM из /proc/1/status контейнера +(максимум резидентной памяти за время жизни процесса). Результат: evidence/upload_memory.json. + + python research/upload_memory.py --out evidence +Требует Pillow и aiohttp (tools/.venv). Стенд должен быть запущен (docker compose up -d). +""" +import argparse +import asyncio +import base64 +import hashlib +import io +import json +import os +import subprocess +import time +import uuid + +import aiohttp +from PIL import Image + +ROOT = os.path.join(os.path.dirname(os.path.abspath(__file__)), "..") +BASE = "http://127.0.0.1:8080" +PROJECT = "mtusi-lab4" + + +def sh(*args, env=None): + return subprocess.run(args, cwd=ROOT, capture_output=True, text=True, env=dict(os.environ, **(env or {}))).stdout.strip() + + +def noisy_png(side, seed): + """Почти несжимаемый PNG (шум): размер файла близок к side*side*3 байт.""" + raw = os.urandom(side * side * 3) + img = Image.frombytes("RGB", (side, side), raw) + buf = io.BytesIO() + img.save(buf, "PNG", compress_level=1) + return buf.getvalue() + + +def api_containers(): + return sh("docker", "ps", "-q", "--filter", "label=com.docker.compose.project=" + PROJECT, + "--filter", "label=com.docker.compose.service=api").split() + + +def set_api(concurrency, replicas): + sh("docker", "compose", "--env-file", ".env", "up", "-d", "--no-deps", "--force-recreate", "--scale", "api=%d" % replicas, "api", + env={"UPLOAD_CONCURRENCY": str(concurrency)}) + deadline = time.time() + 90 + while time.time() < deadline: + ids = api_containers() + if len(ids) == replicas and all(sh("docker", "inspect", "-f", "{{.State.Health.Status}}", i) == "healthy" for i in ids): + break + time.sleep(1) + time.sleep(6) + + +def peak_rss_mib(cid): + out = sh("docker", "exec", cid, "sh", "-c", "grep -E 'VmHWM|VmRSS' /proc/1/status") + vals = {l.split(":")[0]: int(l.split()[1]) / 1024 for l in out.splitlines()} + return round(vals.get("VmHWM", 0), 1), round(vals.get("VmRSS", 0), 1) + + +async def register(s): + name = "up_%s" % uuid.uuid4().hex[:12] + pw = "upload-test-pw-" + uuid.uuid4().hex[:6] + async with s.post(BASE + "/api/v1/users", json={"username": name, "display_name": "u", "password": pw}) as r: + user = await r.json() + cred = base64.b64encode(("%s:%s" % (name, pw)).encode()).decode() + async with s.post(BASE + "/api/v1/auth/sessions", headers={"Authorization": "Basic " + cred}) as r: + sess = await r.json() + return user["id"], sess["token"] + + +async def one_run(clients, data, token, chat_id, timeout=120): + results = [] + t0 = time.perf_counter() + async with aiohttp.ClientSession(timeout=aiohttp.ClientTimeout(total=timeout), connector=aiohttp.TCPConnector(limit=clients)) as s: + async def up(i): + t = time.perf_counter() + try: + async with s.post("%s/api/v1/chats/%s/attachments?filename=load%d.png" % (BASE, chat_id, i), data=data, + headers={"Authorization": "Bearer " + token, "Content-Type": "image/png"}) as r: + body = await r.json(content_type=None) + results.append((r.status, time.perf_counter() - t, body.get("id") if r.status < 300 else body.get("error", {}).get("code"))) + except Exception as exc: + results.append((type(exc).__name__, time.perf_counter() - t, None)) + await asyncio.gather(*(up(i) for i in range(clients))) + return results, time.perf_counter() - t0 + + +async def main(args): + data = noisy_png(args.side, 1) + print("размер файла: %.1f MiB, sha256 %s" % (len(data) / 1048576, hashlib.sha256(data).hexdigest()[:12])) + report = {"date": time.strftime("%Y-%m-%d %H:%M:%S"), "file_mib": round(len(data) / 1048576, 2), "clients": args.clients, + "api_memory_limit": "256m", "runs": []} + for conc in args.concurrency: + set_api(conc, 1) + cid = api_containers()[0] + async with aiohttp.ClientSession() as s: + uid, token = await register(s) + async with s.post(BASE + "/api/v1/chats", json={"title": "mem", "member_ids": [uid]}, headers={"Authorization": "Bearer " + token}) as r: + chat = await r.json() + baseline_hwm, _ = peak_rss_mib(cid) + results, wall = await one_run(args.clients, data, token, chat["id"]) + peak, rss = peak_rss_mib(cid) + statuses = {} + for st, _, _ in results: + statuses[str(st)] = statuses.get(str(st), 0) + 1 + ok_lat = sorted(t for st, t, _ in results if st == 201) + # проверка целостности: скачиваем каждый принятый файл и сверяем sha256 + intact = 0 + async with aiohttp.ClientSession() as s: + for st, _, att in results: + if st == 201: + async with s.get("%s/api/v1/attachments/%s/content" % (BASE, att), headers={"Authorization": "Bearer " + token}) as r: + if hashlib.sha256(await r.read()).hexdigest() == hashlib.sha256(data).hexdigest(): + intact += 1 + oom = sh("docker", "inspect", "-f", "{{.State.OOMKilled}}", cid) + entry = {"UPLOAD_CONCURRENCY": conc, "statuses": statuses, "wall_seconds": round(wall, 2), "peak_rss_mib": peak, + "rss_before_mib": baseline_hwm, "rss_after_mib": rss, "oom_killed": oom, + "accepted_files_intact": "%d/%d" % (intact, statuses.get("201", 0)), + "p50_s": round(ok_lat[len(ok_lat) // 2], 2) if ok_lat else None, "max_s": round(ok_lat[-1], 2) if ok_lat else None} + print(json.dumps(entry, ensure_ascii=False)) + report["runs"].append(entry) + set_api(4, 2) + with open(os.path.join(args.out, "upload_memory.json"), "w", encoding="utf-8") as fh: + json.dump(report, fh, ensure_ascii=False, indent=2) + + +if __name__ == "__main__": + ap = argparse.ArgumentParser() + ap.add_argument("--out", default="evidence") + ap.add_argument("--clients", type=int, default=12) + ap.add_argument("--side", type=int, default=1700, help="сторона квадрата PNG-шума; 1700 -> около 8.7 MiB") + ap.add_argument("--concurrency", type=int, nargs="+", default=[1, 4, 12]) + asyncio.run(main(ap.parse_args())) diff --git a/scripts/init-secrets.sh b/scripts/init-secrets.sh new file mode 100755 index 00000000..83a7d219 --- /dev/null +++ b/scripts/init-secrets.sh @@ -0,0 +1,31 @@ +#!/usr/bin/env bash +# Создаёт локальные секреты стенда (secrets/ в .gitignore). Идемпотентно: существующие файлы не перезаписываются. +set -eu +cd "$(dirname "$0")/.." +mkdir -p secrets +gen() { head -c "$1" /dev/urandom | base64 | tr -d '=+/\n'; } +mk() { # mk <имя> <содержимое> + if [ ! -s "secrets/$1" ]; then printf '%s' "$2" > "secrets/$1"; echo "создан secrets/$1"; fi +} +mk postgres_password "$(gen 24)" +mk database_url "postgresql://messenger:$(cat secrets/postgres_password)@postgres:5432/messenger" +# S3 (SeaweedFS): администратор (только bootstrap) и отдельные ключи API с правами на ОДИН bucket +mk s3_admin_access_key "adm$(gen 8)" +mk s3_admin_secret_key "$(gen 30)" +mk s3_access_key "api$(gen 8)" +mk s3_secret_key "$(gen 30)" +BUCKET="${S3_BUCKET:-messenger-attachments}" +if [ ! -s secrets/seaweed_s3.json ]; then + cat > secrets/seaweed_s3.json </dev/null || true # читает непривилегированный пользователь контейнера (uid 10001) diff --git a/scripts/restart.cmd b/scripts/restart.cmd new file mode 100644 index 00000000..b61ebaa9 --- /dev/null +++ b/scripts/restart.cmd @@ -0,0 +1,7 @@ +@echo off +rem Windows analogue of restart.sh: restart the whole stand, volumes are kept; wait until healthy. +cd /d "%~dp0.." +docker compose --env-file .env restart postgres valkey seaweedfs api lb >NUL 2>&1 +if errorlevel 1 exit /b 1 +docker compose --env-file .env up -d --wait --no-recreate --no-deps postgres valkey seaweedfs api lb >NUL 2>&1 +exit /b %errorlevel% diff --git a/scripts/restart.sh b/scripts/restart.sh new file mode 100755 index 00000000..01849614 --- /dev/null +++ b/scripts/restart.sh @@ -0,0 +1,7 @@ +#!/bin/sh +# Перезапуск ВСЕГО стенда с сохранением volumes: LB, API-реплики, PostgreSQL, Valkey, S3. Данные не удаляются. +# После рестарта ждём healthy всех сервисов (`up --wait`), чтобы проверка сразу видела готовый стенд (S3 стартует ~10 с). +set -eu +cd "$(dirname "$0")/.." +docker compose --env-file .env restart postgres valkey seaweedfs api lb >/dev/null 2>&1 +docker compose --env-file .env up -d --wait --no-recreate --no-deps postgres valkey seaweedfs api lb >/dev/null 2>&1 diff --git a/scripts/restore-replicas.sh b/scripts/restore-replicas.sh new file mode 100755 index 00000000..aeac4376 --- /dev/null +++ b/scripts/restore-replicas.sh @@ -0,0 +1,10 @@ +#!/bin/sh +# Возвращает стенд к заданному числу API-реплик (API_REPLICAS в .env, по умолчанию 2): +# остановленные контейнеры удаляются и создаются заново; данные (volumes) не затрагиваются. +set -eu +cd "$(dirname "$0")/.." +for cid in $(docker ps -aq --filter "label=com.docker.compose.project=mtusi-lab4" --filter "label=com.docker.compose.service=api" --filter "status=exited"); do + docker rm "$cid" >/dev/null +done +N="${API_REPLICAS:-$(grep -E '^API_REPLICAS=' .env | cut -d= -f2 | tr -d '\r')}" +docker compose --env-file .env up -d --no-deps --scale api="$N" api >/dev/null 2>&1 || { echo "не удалось вернуть $N реплик" >&2; exit 1; } diff --git a/scripts/rolling-update.sh b/scripts/rolling-update.sh new file mode 100755 index 00000000..d7af3274 --- /dev/null +++ b/scripts/rolling-update.sh @@ -0,0 +1,32 @@ +#!/bin/sh +# Rolling update API без простоя: реплики заменяются по одной. +# 1) миграции выполняются ОДИН раз до замены (идемпотентно; должны быть обратно совместимы со старой версией); +# 2) для каждой старой реплики: поднять новую (из нового образа) рядом -> дождаться healthy и попадания в LB -> +# остановить старую штатно (SIGTERM -> drain 4 с -> graceful shutdown) -> удалить. +# Использование: scripts/rolling-update.sh [REVISION] +set -eu +cd "$(dirname "$0")/.." +REV="${1:-$(date +%s)}" +COMPOSE="docker compose --env-file .env" +API_FILTER="--filter label=com.docker.compose.project=mtusi-lab4 --filter label=com.docker.compose.service=api" + +$COMPOSE build --build-arg REV="$REV" api >/dev/null +$COMPOSE run --rm migrate >/dev/null +OLD=$(docker ps -q $API_FILTER) +N=$(echo "$OLD" | wc -w | tr -d ' ') +echo "revision=$REV replicas=$N" +for old in $OLD; do + BEFORE_FILE=$(mktemp) + docker ps -q $API_FILTER | sort > "$BEFORE_FILE" + $COMPOSE up -d --no-deps --no-recreate --scale api=$((N + 1)) api >/dev/null 2>&1 + NEW=$(docker ps -q $API_FILTER | sort | comm -13 "$BEFORE_FILE" -) + rm -f "$BEFORE_FILE" + for i in $(seq 1 60); do + [ "$(docker inspect -f '{{.State.Health.Status}}' "$NEW" 2>/dev/null)" = healthy ] && break + sleep 1 + done + sleep 3 # LB: rise=2 проверки по 1 с -> реплика в ротации + docker stop --time 15 "$old" >/dev/null + docker rm "$old" >/dev/null + echo "заменена реплика $old -> $NEW" +done diff --git a/scripts/stop-one.cmd b/scripts/stop-one.cmd new file mode 100644 index 00000000..457b20b2 --- /dev/null +++ b/scripts/stop-one.cmd @@ -0,0 +1,8 @@ +@echo off +rem Windows analogue of stop-one.sh: stop exactly one API replica and leave it stopped. +set "cid=" +echo %TARGET_INSTANCE_ID%| findstr /r "^[a-f0-9][a-f0-9]*$" >NUL || exit /b 2 +for /f %%i in ('docker ps -q --filter id^=%TARGET_INSTANCE_ID% --filter label^=com.docker.compose.project^=mtusi-lab4 --filter label^=com.docker.compose.service^=api') do set "cid=%%i" +if "%cid%"=="" exit /b 3 +docker stop --time 0 %cid% >NUL 2>&1 +exit /b %errorlevel% diff --git a/scripts/stop-one.sh b/scripts/stop-one.sh new file mode 100755 index 00000000..4958e80d --- /dev/null +++ b/scripts/stop-one.sh @@ -0,0 +1,14 @@ +#!/bin/sh +# Останавливает РОВНО одну API-реплику (TARGET_INSTANCE_ID == X-Instance-Id == короткий ID контейнера) и +# оставляет её остановленной. Не трогает БД, Valkey, LB и volumes. Возвращается быстро (< 2 с). +# `docker stop --time 0`: SIGTERM и немедленный SIGKILL — имитация отказа процесса; политика restart +# после ручной остановки не поднимает контейнер. Восстановление: scripts/restore-replicas.sh +set -eu +: "${TARGET_INSTANCE_ID:?test provides target API instance alias}" +case "$TARGET_INSTANCE_ID" in + ''|*[!a-f0-9]*) echo "некорректный TARGET_INSTANCE_ID" >&2; exit 2 ;; +esac +cid=$(docker ps -q --filter "id=$TARGET_INSTANCE_ID" \ + --filter "label=com.docker.compose.project=mtusi-lab4" --filter "label=com.docker.compose.service=api") +[ -n "$cid" ] || { echo "реплика не найдена среди работающих api-контейнеров" >&2; exit 3; } +docker stop --time 0 "$cid" >/dev/null diff --git a/src/app/attachments.py b/src/app/attachments.py new file mode 100644 index 00000000..3d78a611 --- /dev/null +++ b/src/app/attachments.py @@ -0,0 +1,181 @@ +"""Вложения (lab4): потоковая загрузка PNG/JPEG в приватный S3, метаданные в PostgreSQL, авторизованное скачивание.""" +import asyncio +import hashlib +import tempfile +import unicodedata +import uuid + +from . import config, images +from .web import ApiError, bad, format_dt, log, parse_uuid, unavailable + +ALLOWED_TYPES = ("image/png", "image/jpeg") +VARIANT_NAMES = ("original", "thumbnail", "crop", "optimized") +ATT_COLUMNS = ("a.id, a.chat_id, a.owner_id, a.filename, a.content_type, a.size_bytes, a.sha256, a.status, a.error_code, " + "a.s3_key, a.created_at, a.updated_at") + + +def attachment_json(row, variants=()): + return {"id": str(row["id"]), "chat_id": str(row["chat_id"]), "owner_id": str(row["owner_id"]), "filename": row["filename"], + "content_type": row["content_type"], "size_bytes": row["size_bytes"], "sha256": row["sha256"], "status": row["status"], + "variants": list(variants), "error_code": row["error_code"], "created_at": format_dt(row["created_at"]), + "updated_at": format_dt(row["updated_at"])} + + +def valid_filename(query): + values = query.get("filename") + if not values or len(values) != 1: + raise bad("Требуется параметр filename") + name = values[0] + if not 1 <= len(name) <= 255 or not name.strip(): + raise bad("filename: длина 1–255 символов") + try: + name.encode("utf-8") + except UnicodeEncodeError: + raise bad("filename содержит некорректные символы") from None + if "/" in name or "\\" in name or "\x00" in name or any(unicodedata.category(ch) == "Cc" for ch in name): + raise bad("filename не должен содержать / \\ NUL и управляющие символы") + return name + + +class StreamResponse: + """Потоковый ответ: тело читается из S3 порциями и сразу отдаётся клиенту (без загрузки файла в память).""" + + def __init__(self, content_type, length, stream): + self.content_type, self.length, self.stream = content_type, length, stream + + async def send(self, send, request_id, instance_id): + headers = [(b"content-type", self.content_type.encode()), (b"content-length", str(self.length).encode()), + (b"x-request-id", request_id.encode()), (b"x-content-type-options", b"nosniff"), + (b"cache-control", b"private, no-store")] + if instance_id: + headers.append((b"x-instance-id", instance_id.encode())) + await send({"type": "http.response.start", "status": 200, "headers": headers}) + try: + while True: + chunk = await self.stream.read(config.DOWNLOAD_CHUNK_BYTES) + if not chunk: + break + await send({"type": "http.response.body", "body": chunk, "more_body": True}) + finally: + self.stream.close() + await send({"type": "http.response.body", "body": b""}) + + +class AttachmentMixin: + """Подмешивается в Messenger: требует self.db, self.s3, self.authenticate().""" + + def _init_attachments(self): + self._upload_slots = asyncio.Semaphore(config.UPLOAD_CONCURRENCY) + self._upload_waiting = 0 + + async def _receive_upload(self, req): + """Принимает тело в SpooledTemporaryFile (до 1 MiB в памяти, далее диск), считает SHA-256, ограничивает размер.""" + declared = req.headers.get("content-length") + too_large = ApiError(413, "payload_too_large", "Файл больше 10 MiB", {"connection": "close"}) + if declared is not None: + if not declared.isdigit(): + raise bad("Некорректный Content-Length") + if int(declared) > config.MAX_UPLOAD_BYTES: + raise too_large + spool = tempfile.SpooledTemporaryFile(max_size=1024 * 1024) + digest, size = hashlib.sha256(), 0 + try: + while True: + event = await req.receive() + if event["type"] == "http.disconnect": + raise bad("Соединение закрыто клиентом") + chunk = event.get("body", b"") + size += len(chunk) + if size > config.MAX_UPLOAD_BYTES: + raise too_large + digest.update(chunk) + spool.write(chunk) + if not event.get("more_body"): + break + except BaseException: + spool.close() + raise + if size == 0: + spool.close() + raise bad("Пустой файл") + return spool, digest.hexdigest(), size + + async def upload_attachment(self, req, params): + user_id = await self.authenticate(req) + chat_id = await self._require_member(user_id, params) + filename = valid_filename(req.query) + media = req.headers.get("content-type", "").split(";")[0].strip().lower() + if media not in ALLOWED_TYPES: + raise ApiError(415, "unsupported_media_type", "Ожидается Content-Type: image/png или image/jpeg") + if self._upload_waiting >= config.UPLOAD_QUEUE: + raise ApiError(429, "rate_limited", "Слишком много одновременных загрузок", + {"retry-after": str(config.RETRY_AFTER_SECONDS)}) + self._upload_waiting += 1 + try: + await self._upload_slots.acquire() # ограничение одновременных загрузок на реплику (RAM/диск/CPU) + finally: + self._upload_waiting -= 1 + try: + spool, sha256, size = await self._receive_upload(req) + try: + try: + loop = asyncio.get_running_loop() + content_type, width, height = await loop.run_in_executor(self.image_pool, images.validate, spool, media) + except images.ImageRejected as exc: + raise ApiError(exc.status, exc.code, exc.message) from None + att_id = uuid.uuid4() + key = "att/%s/original" % att_id + spool.seek(0) + await self.s3.put(key, spool, content_type, size) # 1) байты в S3 + try: # 2) метаданные в PostgreSQL + if "db_after_put" in config.FAULT_INJECTION: # только для экспериментов (по умолчанию пусто) + raise RuntimeError("injected: сбой БД после записи в S3") + row = await self.db.fetchrow( + "INSERT INTO attachments (id, chat_id, owner_id, filename, content_type, size_bytes, sha256, width, " + "height, status, s3_key) VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, 'ready', $10) " + "RETURNING id, chat_id, owner_id, filename, content_type, size_bytes, sha256, status, error_code, " + "s3_key, created_at, updated_at", + att_id, uuid.UUID(chat_id), uuid.UUID(user_id), filename, content_type, size, sha256, width, height, + key, retry=False) + except BaseException: + # компенсация: объект без метаданных удаляем сразу; если не вышло — его уберёт reconcile (grace period) + try: + if "s3_delete_fails" in config.FAULT_INJECTION: + raise OSError("injected: компенсирующее удаление не удалось") + await self.s3.delete(key) + except Exception as exc: + log("warning", "s3_orphan_left", error_type=type(exc).__name__) + raise + finally: + spool.close() + finally: + self._upload_slots.release() + return 201, attachment_json(row) + + async def _attachment_for(self, req, params): + user_id = await self.authenticate(req) + att_id = parse_uuid(params["attachment_id"], "attachment_id") + row = await self.db.fetchrow( + "SELECT " + ATT_COLUMNS + " FROM attachments a JOIN chat_members m ON m.chat_id = a.chat_id AND m.user_id = $2 " + "WHERE a.id = $1", att_id, user_id) + if row is None: + raise ApiError(404, "not_found", "Вложение не найдено") + return row + + async def get_attachment(self, req, params): + row = await self._attachment_for(req, params) + return 200, attachment_json(row) + + async def download_attachment(self, req, params): + row = await self._attachment_for(req, params) + variant = "original" + if "variant" in req.query: + if len(req.query["variant"]) != 1 or req.query["variant"][0] not in VARIANT_NAMES: + raise bad("variant: original | thumbnail | crop | optimized") + variant = req.query["variant"][0] + if row["status"] != "ready": + raise ApiError(409, "conflict", "Вложение ещё не готово или не удалось обработать") + if variant != "original": + raise ApiError(404, "not_found", "Вариант отсутствует") + stream, length = await self.s3.open_stream(row["s3_key"]) + return 200, StreamResponse(row["content_type"], length, stream) diff --git a/src/app/config.py b/src/app/config.py new file mode 100644 index 00000000..a3a45584 --- /dev/null +++ b/src/app/config.py @@ -0,0 +1,75 @@ +"""Конфигурация из переменных окружения (см. .env.example).""" +import os + + +def _int(name, default): + value = os.environ.get(name) + return int(value) if value not in (None, "") else default + + +def _float(name, default): + value = os.environ.get(name) + return float(value) if value not in (None, "") else default + + +def _secret(name, default=""): + """Значение из переменной NAME либо из файла NAME_FILE (Docker secrets); файл читается один раз.""" + if os.environ.get(name): + return os.environ[name] + path = os.environ.get(name + "_FILE") + if path and os.path.exists(path): + with open(path, encoding="utf-8") as fh: + return fh.read().strip() + return default + + +APP_HOST = os.environ.get("APP_HOST", "0.0.0.0") +APP_PORT = _int("APP_PORT", 8080) +APP_ENV = os.environ.get("APP_ENV", "lab") + +DATABASE_URL = _secret("DATABASE_URL") +DB_POOL_MIN = _int("DB_POOL_MIN", 2) +DB_POOL_MAX = _int("DB_POOL_MAX", 10) +DB_ACQUIRE_TIMEOUT = _float("DB_ACQUIRE_TIMEOUT", 2.0) # ожидание свободного соединения пула +DB_COMMAND_TIMEOUT = _float("DB_COMMAND_TIMEOUT", 5.0) # таймаут одного запроса +DB_CONNECT_TIMEOUT = _float("DB_CONNECT_TIMEOUT", 2.0) + +VALKEY_URL = os.environ.get("VALKEY_URL", "") # пусто = кэш сессий выключен +VALKEY_TIMEOUT = _float("VALKEY_TIMEOUT", 0.2) +VALKEY_BREAKER_SECONDS = _float("VALKEY_BREAKER_SECONDS", 5.0) + +SESSION_TTL_SECONDS = _int("SESSION_TTL_SECONDS", 3600) +SESSION_CACHE_TTL_SECONDS = _int("SESSION_CACHE_TTL_SECONDS", 60) + +ARGON2_TIME_COST = _int("ARGON2_TIME_COST", 2) +ARGON2_MEMORY_KIB = _int("ARGON2_MEMORY_KIB", 19456) # 19 MiB, рекомендация OWASP +ARGON2_PARALLELISM = _int("ARGON2_PARALLELISM", 1) +HASH_CONCURRENCY = _int("HASH_CONCURRENCY", 4) + +MAX_BODY_BYTES = _int("MAX_BODY_BYTES", 65536) +MAX_INFLIGHT = _int("MAX_INFLIGHT", 64) +LIMIT_CONCURRENCY = _int("LIMIT_CONCURRENCY", 1000) +RETRY_AFTER_SECONDS = _int("RETRY_AFTER_SECONDS", 1) +MIGRATIONS_DIR = os.environ.get("MIGRATIONS_DIR", os.path.join(os.path.dirname(__file__), "..", "..", "migrations")) +DRAIN_SECONDS = _float("DRAIN_SECONDS", 4.0) # после SIGTERM: readiness=503, сервер ещё принимает запросы +GRACEFUL_SHUTDOWN_SECONDS = _int("GRACEFUL_SHUTDOWN_SECONDS", 8) +KEEPALIVE_SECONDS = _int("KEEPALIVE_SECONDS", 5) +IDEMPOTENCY_TTL_SECONDS = _int("IDEMPOTENCY_TTL_SECONDS", 24 * 3600) + +# --- S3 / вложения (lab4) --- +S3_ENDPOINT = os.environ.get("S3_ENDPOINT", "") +S3_BUCKET = os.environ.get("S3_BUCKET", "messenger-attachments") +S3_REGION = os.environ.get("S3_REGION", "us-east-1") +S3_ACCESS_KEY = _secret("S3_ACCESS_KEY") +S3_SECRET_KEY = _secret("S3_SECRET_KEY") +S3_CONNECT_TIMEOUT = _float("S3_CONNECT_TIMEOUT", 2.0) +S3_READ_TIMEOUT = _float("S3_READ_TIMEOUT", 15.0) +S3_POOL = _int("S3_POOL", 20) +MAX_UPLOAD_BYTES = _int("MAX_UPLOAD_BYTES", 10 * 1024 * 1024) # 10 MiB = 10 485 760 +MAX_IMAGE_PIXELS = _int("MAX_IMAGE_PIXELS", 40_000_000) +UPLOAD_CONCURRENCY = _int("UPLOAD_CONCURRENCY", 4) # одновременных загрузок на реплику +UPLOAD_QUEUE = _int("UPLOAD_QUEUE", 16) # ожидающих загрузок; сверх — 429 +IMAGE_THREADS = _int("IMAGE_THREADS", 2) +DOWNLOAD_CHUNK_BYTES = _int("DOWNLOAD_CHUNK_BYTES", 65536) +ORPHAN_GRACE_SECONDS = _int("ORPHAN_GRACE_SECONDS", 900) # объект без метаданных моложе этого возраста не трогаем +FAULT_INJECTION = {x for x in os.environ.get("FAULT_INJECTION", "").split(",") if x} # db_after_put, s3_delete_fails (эксперименты) diff --git a/src/app/db.py b/src/app/db.py new file mode 100644 index 00000000..7e81fb93 --- /dev/null +++ b/src/app/db.py @@ -0,0 +1,71 @@ +"""PostgreSQL: ограниченный пул asyncpg, таймауты, перевод сбоев зависимости в 503.""" +import asyncio +from contextlib import asynccontextmanager + +import asyncpg + +from . import config +from .web import log, unavailable + +DEPENDENCY_ERRORS = (asyncpg.PostgresConnectionError, asyncpg.InterfaceError, asyncpg.exceptions.OperatorInterventionError, + asyncpg.exceptions.InsufficientResourcesError, asyncio.TimeoutError, OSError) +_RETRYABLE = (asyncpg.ConnectionDoesNotExistError, asyncpg.InterfaceError, ConnectionResetError) + + +class Database: + def __init__(self): + self.pool = None + + async def start(self): + if not config.DATABASE_URL: + log("error", "database_url_missing") + return + # min_size=0: приложение стартует и без БД (readiness покажет 503), пул подключается лениво. + self.pool = await asyncpg.create_pool( + dsn=config.DATABASE_URL, min_size=0, max_size=config.DB_POOL_MAX, + command_timeout=config.DB_COMMAND_TIMEOUT, timeout=config.DB_CONNECT_TIMEOUT, + max_inactive_connection_lifetime=60, + server_settings={"application_name": "messenger-api", "timezone": "UTC"}) + + async def stop(self): + if self.pool: + try: + await asyncio.wait_for(self.pool.close(), 3) + except Exception: + self.pool.terminate() + + @asynccontextmanager + async def conn(self): + if self.pool is None: + raise unavailable("База данных не настроена") + try: + async with self.pool.acquire(timeout=config.DB_ACQUIRE_TIMEOUT) as connection: + yield connection + except DEPENDENCY_ERRORS as exc: + log("warning", "db_unavailable", error_type=type(exc).__name__) + raise unavailable() from exc + + async def _run(self, method, sql, args, retry): + for attempt in (0, 1): + try: + async with self.conn() as c: + return await getattr(c, method)(sql, *args) + except Exception as exc: + if attempt == 0 and retry and isinstance(exc.__cause__, _RETRYABLE): + continue # разорванное соединение пула (рестарт БД): один повтор только для чтения + raise + + async def fetch(self, sql, *args): + return await self._run("fetch", sql, args, True) + + async def fetchrow(self, sql, *args, retry=True): + return await self._run("fetchrow", sql, args, retry) + + async def fetchval(self, sql, *args): + return await self._run("fetchval", sql, args, True) + + async def execute(self, sql, *args): + return await self._run("execute", sql, args, False) + + async def ping(self): + return await asyncio.wait_for(self.fetchval("SELECT 1"), 1.0) diff --git a/src/app/images.py b/src/app/images.py new file mode 100644 index 00000000..5c433eac --- /dev/null +++ b/src/app/images.py @@ -0,0 +1,102 @@ +"""Проверка загружаемых изображений ДО полного декодирования: сигнатура, формат Pillow, размеры, целостность. + +PNG/JPEG определяются по содержимому (а не по Content-Type). Лимит пикселей проверяется по заголовку, +поэтому «decompression bomb» отклоняется без декодирования. Целостность: PNG — verify() (CRC всех чанков, без +распаковки в память), JPEG — декодирование в режиме draft (1/8 размера => около 1/64 памяти). +""" +import struct +import zlib + +from PIL import Image, UnidentifiedImageError + +from . import config + +Image.MAX_IMAGE_PIXELS = None # лимит применяем сами по заголовку (ниже), без предупреждений Pillow +PNG_SIGNATURE = b"\x89PNG\r\n\x1a\n" + + +class ImageRejected(Exception): + def __init__(self, status, code, message): + super().__init__(message) + self.status, self.code, self.message = status, code, message + + +def sniff(head): + if head.startswith(PNG_SIGNATURE): + return "image/png" + if head[:3] == b"\xff\xd8\xff": + return "image/jpeg" + return None + + +def _check_png_stream(fileobj, width, height): + """Целостность потока IDAT без аллокации изображения: распаковка порциями, проверка конца потока и размера данных.""" + fileobj.seek(8) + inflater = zlib.decompressobj() + total, channels, bit_depth, interlaced = 0, 0, 0, 0 + while True: + head = fileobj.read(8) + if len(head) < 8: + raise ValueError("truncated") + length, kind = struct.unpack(">I4s", head) + if length > 0x7FFFFFFF: + raise ValueError("chunk") + if kind == b"IHDR": + data = fileobj.read(length) + bit_depth, color_type, _, _, interlaced = struct.unpack(">BBBBB", data[8:13]) + channels = {0: 1, 2: 3, 3: 1, 4: 2, 6: 4}[color_type] + fileobj.read(4) + elif kind == b"IDAT": + remaining = length + while remaining: + piece = fileobj.read(min(remaining, 65536)) + if not piece: + raise ValueError("truncated") + remaining -= len(piece) + pending = piece + while pending: + total += len(inflater.decompress(pending, 1 << 20)) + pending = inflater.unconsumed_tail + fileobj.read(4) + elif kind == b"IEND": + break + else: + fileobj.seek(length + 4, 1) + if not inflater.eof: + raise ValueError("zlib stream incomplete") + if not interlaced: + row = (width * channels * bit_depth + 7) // 8 + if total != height * (row + 1): + raise ValueError("unexpected image data size") + + +def validate(fileobj, declared_type): + """Возвращает (content_type, width, height) либо бросает ImageRejected (415 — не то/повреждено, 413 — много пикселей).""" + fileobj.seek(0) + detected = sniff(fileobj.read(16)) + if detected is None or detected != declared_type: + raise ImageRejected(415, "unsupported_media_type", "Содержимое не соответствует PNG/JPEG или заявленному Content-Type") + fileobj.seek(0) + try: + with Image.open(fileobj) as img: + width, height = img.size + fmt = img.format + except (UnidentifiedImageError, OSError, ValueError, SyntaxError, Image.DecompressionBombError): + raise ImageRejected(415, "unsupported_media_type", "Изображение повреждено или не поддерживается") from None + if fmt not in ("PNG", "JPEG") or width < 1 or height < 1: + raise ImageRejected(415, "unsupported_media_type", "Неподдерживаемый формат изображения") + if width * height > config.MAX_IMAGE_PIXELS: + raise ImageRejected(413, "payload_too_large", "Слишком много пикселей в изображении") + fileobj.seek(0) + try: + img = Image.open(fileobj) + if fmt == "PNG": + img.verify() + _check_png_stream(fileobj, width, height) + else: + img.draft("RGB", (max(1, width // 8), max(1, height // 8))) + img.load() + img.close() + except Exception: # любая ошибка декодера = повреждённый файл + raise ImageRejected(415, "unsupported_media_type", "Изображение повреждено") from None + return detected, width, height diff --git a/src/app/main.py b/src/app/main.py new file mode 100644 index 00000000..bae7f53d --- /dev/null +++ b/src/app/main.py @@ -0,0 +1,409 @@ +"""ASGI-приложение мессенджера (lab2): REST API, PostgreSQL, сессии Bearer, кэш Valkey.""" +import asyncio +from concurrent.futures import ThreadPoolExecutor +import base64 +import binascii +import hashlib +import json +import os +import re +import time +import uuid + +import asyncpg + +from . import config, passwords +from .attachments import AttachmentMixin, StreamResponse +from .db import DEPENDENCY_ERRORS, Database +from .s3 import S3 +from .sessions import SessionCache, Sessions +from .web import (ApiError, Request, bad, dt_to_us, encode_cursor, format_dt, log, new_request_id, page_params, + parse_json_object, parse_uuid, respond, unavailable, us_to_dt, valid_text, USERNAME_RE) + +ROUTES = [ + ("health_live", re.compile(r"/health/live"), {"GET"}), + ("health_ready", re.compile(r"/health/ready"), {"GET"}), + ("users", re.compile(r"/api/v1/users"), {"POST"}), + ("users_me", re.compile(r"/api/v1/users/me"), {"GET"}), + ("create_session", re.compile(r"/api/v1/auth/sessions"), {"POST"}), + ("session_current", re.compile(r"/api/v1/auth/sessions/current"), {"DELETE"}), + ("chats", re.compile(r"/api/v1/chats"), {"GET", "POST"}), + ("chat", re.compile(r"/api/v1/chats/(?P[^/]+)"), {"GET"}), + ("messages", re.compile(r"/api/v1/chats/(?P[^/]+)/messages"), {"GET", "POST"}), + ("upload_attachment", re.compile(r"/api/v1/chats/(?P[^/]+)/attachments"), {"POST"}), + ("get_attachment", re.compile(r"/api/v1/attachments/(?P[^/]+)"), {"GET"}), + ("download_attachment", re.compile(r"/api/v1/attachments/(?P[^/]+)/content"), {"GET"}), +] +ROUTE_LABELS = { + "health_live": "/health/live", "health_ready": "/health/ready", "users": "/api/v1/users", + "users_me": "/api/v1/users/me", "create_session": "/api/v1/auth/sessions", + "session_current": "/api/v1/auth/sessions/current", "chats": "/api/v1/chats", + "chat": "/api/v1/chats/{chat_id}", "messages": "/api/v1/chats/{chat_id}/messages", + "upload_attachment": "/api/v1/chats/{chat_id}/attachments", "get_attachment": "/api/v1/attachments/{attachment_id}", + "download_attachment": "/api/v1/attachments/{attachment_id}/content", +} +TOKEN_RE = re.compile(r"[A-Za-z0-9_-]{32,128}") +IDEMPOTENCY_KEY_RE = re.compile(r"[A-Za-z0-9._:-]{1,128}") +BEARER = 'Bearer realm="messenger"' +BASIC = 'Basic realm="messenger", charset="UTF-8"' +# Идентификатор реплики: имя хоста контейнера (12 hex, == короткий ID контейнера) -> легко сопоставить с docker ps. +INSTANCE_ID = os.environ.get("INSTANCE_ID") or (os.environ.get("HOSTNAME") or uuid.uuid4().hex)[:12] + +MSG_ATTS = ("COALESCE((SELECT array_agg(ma.attachment_id ORDER BY ma.position) FROM message_attachments ma " + "WHERE ma.message_id = messages.id), '{}'::uuid[]) AS attachment_ids") +CHAT_SELECT = ("SELECT c.id, c.title, c.created_at, " + "(SELECT array_agg(m2.user_id ORDER BY m2.ord) FROM chat_members m2 WHERE m2.chat_id = c.id) AS member_ids ") + + +def user_json(row): + return {"id": str(row["id"]), "username": row["username"], "display_name": row["display_name"], + "created_at": format_dt(row["created_at"])} + + +def chat_json(row): + return {"id": str(row["id"]), "title": row["title"], "member_ids": [str(x) for x in row["member_ids"]], + "created_at": format_dt(row["created_at"])} + + +def message_json(row): + return {"id": str(row["id"]), "chat_id": str(row["chat_id"]), "sender_id": str(row["sender_id"]), + "text": row["text"], "created_at": format_dt(row["created_at"]), + "attachment_ids": [str(x) for x in (row["attachment_ids"] or [])]} + + +def unauthorized(challenge=BEARER, message="Требуется действительная сессия"): + return ApiError(401, "unauthorized", message, {"www-authenticate": challenge}) + + +class Messenger(AttachmentMixin): + def __init__(self): + self.db = Database() + self.s3 = S3() + self.image_pool = ThreadPoolExecutor(max_workers=config.IMAGE_THREADS, thread_name_prefix="image") + self._init_attachments() + self.cache = SessionCache() + self.sessions = Sessions(self.db, self.cache) + self.inflight = 0 + self.draining = False + + # --- аутентификация ------------------------------------------------------ + @staticmethod + def bearer_token(req): + header = req.headers.get("authorization", "") + scheme, _, token = header.partition(" ") + if scheme.lower() != "bearer" or not TOKEN_RE.fullmatch(token.strip()): + raise unauthorized() + return token.strip() + + async def authenticate(self, req): + token = self.bearer_token(req) + user_id = await self.sessions.resolve(token) + if user_id is None: + raise unauthorized() + req.user_id, req.token = user_id, token + return user_id + + # --- обработчики ----------------------------------------------------------- + async def health_live(self, req, params): + return 200, {"status": "ok"} + + async def health_ready(self, req, params): + # Критичная зависимость — PostgreSQL. Valkey — необязательный кэш: его отказ не останавливает API. + if self.draining: + raise unavailable("Сервис останавливается") + try: + await self.db.ping() + except ApiError: + raise + except Exception: + raise unavailable() from None + return 200, {"status": "ok"} + + async def users(self, req, params): + req.require_json_media_type() + data = parse_json_object(await req.body(), {"username", "display_name", "password"}, + {"username", "display_name", "password"}) + username = data["username"] + if not isinstance(username, str) or not USERNAME_RE.fullmatch(username): + raise bad("username должен соответствовать [a-z0-9_]{3,32}") + display_name = valid_text(data["display_name"], "display_name", 100) + password = valid_text(data["password"], "password", 128, allow_empty=True) + if len(password) < 12: + raise bad("password должен содержать от 12 до 128 символов") + pw_hash = await passwords.hash_password(password) + row = await self.db.fetchrow( + "INSERT INTO users (id, username, display_name, password_hash) VALUES ($1, $2, $3, $4) " + "ON CONFLICT (username) DO NOTHING RETURNING id, username, display_name, created_at", + uuid.uuid4(), username, display_name, pw_hash) + if row is None: + raise ApiError(409, "conflict", "username уже занят") + return 201, user_json(row) + + async def users_me(self, req, params): + user_id = await self.authenticate(req) + row = await self.db.fetchrow("SELECT id, username, display_name, created_at FROM users WHERE id = $1", user_id) + if row is None: + raise unauthorized() + return 200, user_json(row) + + async def create_session(self, req, params): + header = req.headers.get("authorization", "") + scheme, _, value = header.partition(" ") + if scheme.lower() != "basic" or not value.strip(): + raise unauthorized(BASIC, "Неверные учётные данные") + try: + decoded = base64.b64decode(value.strip(), validate=True).decode("utf-8") + username, sep, password = decoded.partition(":") + if not sep: + raise ValueError + except (binascii.Error, ValueError, UnicodeDecodeError): + raise unauthorized(BASIC, "Неверные учётные данные") from None + row = None + if USERNAME_RE.fullmatch(username): + row = await self.db.fetchrow("SELECT id, username, display_name, created_at, password_hash FROM users " + "WHERE username = $1", username) + ok = await passwords.verify_password(row["password_hash"] if row else None, password) + if not ok: + raise unauthorized(BASIC, "Неверные учётные данные") + token, expires_at = await self.sessions.create(row["id"]) + return 201, {"token": token, "token_type": "Bearer", "expires_at": format_dt(expires_at), "user": user_json(row)} + + async def session_current(self, req, params): + await self.authenticate(req) + await self.sessions.revoke(req.token) + return 204, None + + async def chats(self, req, params): + user_id = await self.authenticate(req) + if req.method == "GET": + limit, after = page_params(req.query, "c", user_id) + if after is None: + rows = await self.db.fetch( + CHAT_SELECT + "FROM chat_members m JOIN chats c ON c.id = m.chat_id WHERE m.user_id = $1 " + "ORDER BY m.chat_created_at, m.chat_id LIMIT $2", user_id, limit + 1) + else: + rows = await self.db.fetch( + CHAT_SELECT + "FROM chat_members m JOIN chats c ON c.id = m.chat_id WHERE m.user_id = $1 " + "AND (m.chat_created_at, m.chat_id) > ($2, $3) ORDER BY m.chat_created_at, m.chat_id LIMIT $4", + user_id, us_to_dt(after[0]), uuid.UUID(after[1]), limit + 1) + more = len(rows) > limit + rows = rows[:limit] + cursor = encode_cursor("c", user_id, (dt_to_us(rows[-1]["created_at"]), str(rows[-1]["id"]))) if more else None + return 200, {"items": [chat_json(r) for r in rows], "next_cursor": cursor} + req.require_json_media_type() + data = parse_json_object(await req.body(), {"title", "member_ids"}, {"title", "member_ids"}) + title = valid_text(data["title"], "title", 100) + members = data["member_ids"] + if not isinstance(members, list) or not 1 <= len(members) <= 100: + raise bad("member_ids должен содержать от 1 до 100 элементов") + ids = [parse_uuid(m, "member_id") for m in members] + if len(set(ids)) != len(ids): + raise bad("member_ids содержит дубликаты") + if user_id not in ids: + raise bad("Создатель должен быть в member_ids") + chat_id = uuid.uuid4() + uuids = [uuid.UUID(i) for i in ids] + try: + async with self.db.conn() as c: + async with c.transaction(): # чат и участники создаются атомарно + # Существование участников проверяет внешний ключ chat_members.user_id: при неизвестном + # участнике вставка падает и откатывается вся транзакция, включая уже созданный чат. + created = await c.fetchval("INSERT INTO chats (id, title) VALUES ($1, $2) RETURNING created_at", + chat_id, title) + await c.execute( + "INSERT INTO chat_members (chat_id, user_id, chat_created_at, ord) " + "SELECT $1, u, $2, o FROM unnest($3::uuid[]) WITH ORDINALITY AS t(u, o)", + chat_id, created, uuids) + except asyncpg.ForeignKeyViolationError: + raise bad("Неизвестный участник") from None + return 201, {"id": str(chat_id), "title": title, "member_ids": ids, "created_at": format_dt(created)} + + async def _require_member(self, user_id, params): + chat_id = parse_uuid(params["chat_id"], "chat_id") + ok = await self.db.fetchval("SELECT 1 FROM chat_members WHERE chat_id = $1 AND user_id = $2", chat_id, user_id) + if not ok: + raise ApiError(404, "not_found", "Чат не найден") + return chat_id + + async def chat(self, req, params): + user_id = await self.authenticate(req) + chat_id = parse_uuid(params["chat_id"], "chat_id") + row = await self.db.fetchrow( + CHAT_SELECT + "FROM chats c JOIN chat_members m ON m.chat_id = c.id AND m.user_id = $2 WHERE c.id = $1", + chat_id, user_id) + if row is None: + raise ApiError(404, "not_found", "Чат не найден") + return 200, chat_json(row) + + async def messages(self, req, params): + user_id = await self.authenticate(req) + if req.method == "POST": + row = await self._post_message(req, parse_uuid(params["chat_id"], "chat_id"), user_id) + return 201, message_json(row) + chat_id = await self._require_member(user_id, params) + if req.method == "GET": + limit, after = page_params(req.query, "m", chat_id) + if after is None: + rows = await self.db.fetch( + "SELECT id, chat_id, sender_id, text, created_at, " + MSG_ATTS + " FROM messages WHERE chat_id = $1 " + "ORDER BY created_at, id LIMIT $2", chat_id, limit + 1) + else: + rows = await self.db.fetch( + "SELECT id, chat_id, sender_id, text, created_at, " + MSG_ATTS + " FROM messages WHERE chat_id = $1 " + "AND (created_at, id) > ($2, $3) ORDER BY created_at, id LIMIT $4", + chat_id, us_to_dt(after[0]), uuid.UUID(after[1]), limit + 1) + more = len(rows) > limit + rows = rows[:limit] + cursor = encode_cursor("m", chat_id, (dt_to_us(rows[-1]["created_at"]), str(rows[-1]["id"]))) if more else None + return 200, {"items": [message_json(r) for r in rows], "next_cursor": cursor} + + async def _post_message(self, req, chat_id, user_id): + # Сначала разбор запроса; ошибка валидации (400/415) возвращается только участнику чата — постороннему всегда 404. + try: + key = req.headers.get("idempotency-key", "") + if not IDEMPOTENCY_KEY_RE.fullmatch(key): + raise bad("Требуется заголовок Idempotency-Key ([A-Za-z0-9._:-]{1,128})") + req.require_json_media_type() + data = parse_json_object(await req.body(), {"text"}, {"text", "attachment_ids"}) + raw_atts = data.get("attachment_ids", []) + if not isinstance(raw_atts, list) or len(raw_atts) > 10: + raise bad("attachment_ids: массив до 10 элементов") + atts = [parse_uuid(a, "attachment_id") for a in raw_atts] + if len(set(atts)) != len(atts): + raise bad("attachment_ids содержит дубликаты") + text = valid_text(data["text"], "text", 4000, allow_empty=bool(atts)) + except ApiError: + await self._require_member(user_id, {"chat_id": chat_id}) + raise + # Нормализованное представление запроса: порядок ключей JSON не важен, отсутствие attachment_ids == []. + request_hash = hashlib.sha256(json.dumps({"text": text, "attachment_ids": atts}, sort_keys=True, + ensure_ascii=False).encode("utf-8")).digest() + row = await self.db.fetchrow("SELECT * FROM send_message($1, $2, $3, $4, $5, $6, $7)", uuid.UUID(chat_id), + uuid.UUID(user_id), key, request_hash, text, float(config.IDEMPOTENCY_TTL_SECONDS), + [uuid.UUID(a) for a in atts], retry=False) + if row["outcome"] == "not_member": + raise ApiError(404, "not_found", "Чат не найден") + if row["outcome"] == "attachment_not_found": + raise ApiError(404, "not_found", "Вложение не найдено") + if row["outcome"] == "attachment_failed": + raise ApiError(409, "conflict", "Вложение не удалось обработать") + if bytes(row["request_hash"]) != request_hash: + raise ApiError(409, "conflict", "Idempotency-Key уже использован с другим телом запроса") + return {"id": row["msg_id"], "chat_id": row["msg_chat"], "sender_id": row["msg_sender"], "text": row["msg_text"], + "created_at": row["msg_created"], "attachment_ids": row["msg_atts"]} + + # --- ASGI ---------------------------------------------------------------------- + async def __call__(self, scope, receive, send): + if scope["type"] == "lifespan": + return await self.lifespan(receive, send) + if scope["type"] != "http": + return + started = time.perf_counter() + request_id = new_request_id() + route_name, status, headers = "unknown", 500, {} + try: + req = Request(scope, receive, request_id) + handler, params, route_name = self.route(req.method, req.path) + if not route_name.startswith("health") and self.inflight >= config.MAX_INFLIGHT: + raise ApiError(429, "rate_limited", "Слишком много одновременных запросов", + {"retry-after": str(config.RETRY_AFTER_SECONDS)}) + self.inflight += 1 + try: + await asyncio.sleep(0) + status, body = await handler(req, params) + finally: + self.inflight -= 1 + except ApiError as exc: + status, headers = exc.status, exc.headers + body = {"error": {"code": exc.code, "message": exc.message, "request_id": request_id}} + except DEPENDENCY_ERRORS as exc: + log("warning", "dependency_error", request_id=request_id, error_type=type(exc).__name__) + status, headers = 503, {"retry-after": str(config.RETRY_AFTER_SECONDS)} + body = {"error": {"code": "unavailable", "message": "Зависимость временно недоступна", "request_id": request_id}} + except Exception as exc: + log("error", "unhandled_exception", request_id=request_id, error_type=type(exc).__name__) + status = 500 + body = {"error": {"code": "internal_error", "message": "Внутренняя ошибка", "request_id": request_id}} + if isinstance(body, StreamResponse): + try: + await body.send(send, request_id, INSTANCE_ID) + except Exception as exc: # клиент оборвал загрузку/ошибка S3 посреди потока + log("warning", "stream_aborted", request_id=request_id, error_type=type(exc).__name__) + else: + await respond(send, status, body, request_id, headers, INSTANCE_ID) + if os.environ.get("ACCESS_LOG", "1") != "0": + log("info", "request", request_id=request_id, method=scope.get("method"), + route=ROUTE_LABELS.get(route_name, "unmatched"), status=status, + duration_ms=round((time.perf_counter() - started) * 1000, 3)) + + async def janitor(self): + """Удаляет давно просроченные ключи идемпотентности и сессии (безопасно запускать на каждой реплике).""" + import random + await asyncio.sleep(random.uniform(5, 30)) + while True: + try: + await self.db.execute("DELETE FROM idempotency_keys WHERE ctid IN (SELECT ctid FROM idempotency_keys " + "WHERE created_at < now() - make_interval(secs => $1) LIMIT 5000)", + float(config.IDEMPOTENCY_TTL_SECONDS) + 3600) + await self.db.execute("DELETE FROM sessions WHERE ctid IN (SELECT ctid FROM sessions " + "WHERE expires_at < now() - interval '1 day' LIMIT 5000)") + except Exception as exc: + log("warning", "janitor_failed", error_type=type(exc).__name__) + await asyncio.sleep(3600) + + def route(self, method, path): + for name, pattern, methods in ROUTES: + m = pattern.fullmatch(path) + if m: + if method not in methods: + raise ApiError(405, "invalid_request", "Метод не поддерживается", {"allow": ", ".join(sorted(methods))}) + return getattr(self, name), m.groupdict(), name + raise ApiError(404, "not_found", "Ресурс не найден") + + async def lifespan(self, receive, send): + while True: + event = await receive() + if event["type"] == "lifespan.startup": + await self.db.start() + await self.cache.start() + await self.s3.start() + self._janitor = asyncio.create_task(self.janitor()) + log("info", "startup", env=config.APP_ENV, instance=INSTANCE_ID, revision=os.environ.get("APP_REVISION", "dev"), cache=bool(config.VALKEY_URL), + session_ttl=config.SESSION_TTL_SECONDS, pool_max=config.DB_POOL_MAX) + await send({"type": "lifespan.startup.complete"}) + elif event["type"] == "lifespan.shutdown": + self.draining = True + self._janitor.cancel() + await self.cache.stop() + await self.s3.stop() + await self.db.stop() + log("info", "shutdown") + await send({"type": "lifespan.shutdown.complete"}) + return + + +async def overloaded_app(scope, receive, send): + """Ответ uvicorn при превышении --limit-concurrency в контрактном формате.""" + if scope["type"] != "http": + return + request_id = new_request_id() + body = {"error": {"code": "unavailable", "message": "Сервер перегружен: слишком много соединений", + "request_id": request_id}} + await respond(send, 503, body, request_id, {"retry-after": str(config.RETRY_AFTER_SECONDS), "connection": "close"}, INSTANCE_ID) + + +def _install_overload_response(): + for name in ("uvicorn.protocols.http.httptools_impl", "uvicorn.protocols.http.h11_impl"): + try: + module = __import__(name, fromlist=["service_unavailable"]) + except ImportError: + continue + module.service_unavailable = overloaded_app + + +def create_app(): + _install_overload_response() + return Messenger() + + +app = create_app() diff --git a/src/app/migrate.py b/src/app/migrate.py new file mode 100644 index 00000000..e979d89c --- /dev/null +++ b/src/app/migrate.py @@ -0,0 +1,64 @@ +"""Применение версионируемых SQL-миграций: python -m app.migrate + +Свойства: + * повторный запуск ничего не делает (таблица schema_migrations); + * одновременный запуск нескольких экземпляров безопасен (advisory lock); + * каждая миграция — одна транзакция вместе с записью о применении; + * ждёт готовности PostgreSQL до MIGRATE_WAIT_SECONDS. +""" +import asyncio +import hashlib +import os +import sys +import time + +import asyncpg + +from . import config +from .web import log + +LOCK_ID = 7352001 + + +async def connect(deadline): + while True: + try: + return await asyncpg.connect(config.DATABASE_URL, timeout=3) + except (OSError, asyncpg.PostgresError, asyncio.TimeoutError) as exc: + if time.monotonic() > deadline: + raise + log("info", "waiting_for_database", error_type=type(exc).__name__) + await asyncio.sleep(1) + + +async def main(): + wait = float(os.environ.get("MIGRATE_WAIT_SECONDS", "60")) + conn = await connect(time.monotonic() + wait) + try: + await conn.execute("SELECT pg_advisory_lock($1)", LOCK_ID) + await conn.execute("CREATE TABLE IF NOT EXISTS schema_migrations (" + "version text PRIMARY KEY, checksum text NOT NULL, applied_at timestamptz NOT NULL DEFAULT now())") + applied = {r["version"]: r["checksum"] for r in await conn.fetch("SELECT version, checksum FROM schema_migrations")} + directory = os.path.abspath(config.MIGRATIONS_DIR) + files = sorted(f for f in os.listdir(directory) if f.endswith(".sql")) + count = 0 + for name in files: + sql = open(os.path.join(directory, name), encoding="utf-8").read() + checksum = hashlib.sha256(sql.encode("utf-8")).hexdigest() + if name in applied: + if applied[name] != checksum: + log("error", "migration_modified", version=name) + sys.exit(2) + continue + async with conn.transaction(): + await conn.execute(sql) + await conn.execute("INSERT INTO schema_migrations (version, checksum) VALUES ($1, $2)", name, checksum) + count += 1 + log("info", "migration_applied", version=name) + log("info", "migrations_done", applied=count, total=len(files)) + finally: + await conn.close() + + +if __name__ == "__main__": + asyncio.run(main()) diff --git a/src/app/passwords.py b/src/app/passwords.py new file mode 100644 index 00000000..650e7b39 --- /dev/null +++ b/src/app/passwords.py @@ -0,0 +1,31 @@ +"""Хеширование паролей: Argon2id (библиотека argon2-cffi), вычисления вне event loop.""" +import asyncio +from concurrent.futures import ThreadPoolExecutor + +from argon2 import PasswordHasher +from argon2.exceptions import InvalidHashError, VerificationError, VerifyMismatchError + +from . import config + +_hasher = PasswordHasher(time_cost=config.ARGON2_TIME_COST, memory_cost=config.ARGON2_MEMORY_KIB, + parallelism=config.ARGON2_PARALLELISM) +_pool = ThreadPoolExecutor(max_workers=config.HASH_CONCURRENCY, thread_name_prefix="argon2") +# Для неизвестного username проверяем фиктивный хеш: время ответа не выдаёт существование пользователя. +_DUMMY = _hasher.hash("dummy-password-for-timing-equalisation") + + +async def hash_password(password): + return await asyncio.get_running_loop().run_in_executor(_pool, _hasher.hash, password) + + +def _verify(stored, password): + try: + return _hasher.verify(stored, password) + except (VerifyMismatchError, VerificationError, InvalidHashError): + return False + + +async def verify_password(stored, password): + """stored=None -> проверка фиктивного хеша, результат всегда False.""" + ok = await asyncio.get_running_loop().run_in_executor(_pool, _verify, stored or _DUMMY, password) + return ok and stored is not None diff --git a/src/app/reconcile.py b/src/app/reconcile.py new file mode 100644 index 00000000..ea4538c9 --- /dev/null +++ b/src/app/reconcile.py @@ -0,0 +1,91 @@ +"""Сверка S3 и PostgreSQL (reconcile): python -m app.reconcile [--apply] [--grace СЕКУНДЫ] [--prefix att/] + +Находит и (с --apply) безопасно исправляет расхождения двух хранилищ: + * orphan_object — объект в S3 без строки в attachments (сбой между записью в S3 и COMMIT метаданных, прерванная загрузка); + удаляется ТОЛЬКО если старше grace (по умолчанию ORPHAN_GRACE_SECONDS=900 с): свежий объект может быть + загрузкой, метаданные которой ещё не зафиксированы; + * missing_object — строка attachments (ready) без объекта в S3 (потеря/удаление объекта): строка НЕ удаляется, + статус -> failed, error_code=object_missing (сообщения со ссылкой остаются, скачивание даёт 409); + * size_mismatch — размер объекта не совпадает с size_bytes: статус -> failed, error_code=size_mismatch. +Режим по умолчанию — dry-run (ничего не меняет). Повторный запуск идемпотентен. Используемые (привязанные к сообщению) +вложения и свежие объекты не удаляются никогда: удаляются только объекты, у которых нет строки в БД. +Выход: JSON-отчёт со счётчиками и временем обхода. +""" +import argparse +import asyncio +import json +import time +from datetime import datetime, timedelta, timezone + +import asyncpg + +from . import config +from .s3 import S3 + + +async def reconcile(apply, grace, prefix): + started = time.perf_counter() + s3 = S3() + await s3.start() + conn = await asyncpg.connect(config.DATABASE_URL, timeout=5) + try: + t0 = time.perf_counter() + rows = await conn.fetch("SELECT id, s3_key, size_bytes, status, created_at FROM attachments") + db_ms = (time.perf_counter() - t0) * 1000 + by_key = {r["s3_key"]: r for r in rows} + t0 = time.perf_counter() + objects = {} + async for key, size, modified in s3.list_keys(prefix): + objects[key] = (size, modified) + list_ms = (time.perf_counter() - t0) * 1000 + now = datetime.now(timezone.utc) + cutoff = now - timedelta(seconds=grace) + report = {"mode": "apply" if apply else "dry-run", "grace_seconds": grace, "db_rows": len(rows), "s3_objects": len(objects), + "orphan_objects": [], "orphans_skipped_fresh": 0, "missing_objects": [], "size_mismatch": [], "fixed": {"deleted_orphans": 0, "marked_failed": 0}} + for key, (size, modified) in objects.items(): + row = by_key.get(key) + if row is None: + if modified < cutoff: + report["orphan_objects"].append(key) + else: + report["orphans_skipped_fresh"] += 1 + elif row["status"] == "ready" and row["size_bytes"] != size: + report["size_mismatch"].append(str(row["id"])) + for key, row in by_key.items(): + if key.startswith(prefix) and key not in objects and row["status"] == "ready" and row["created_at"] < cutoff: + report["missing_objects"].append(str(row["id"])) + if apply: + for key in report["orphan_objects"]: + # повторная проверка перед удалением: за время обхода строка могла появиться + if await conn.fetchval("SELECT 1 FROM attachments WHERE s3_key = $1", key) is None: + await s3.delete(key) + report["fixed"]["deleted_orphans"] += 1 + for ids, code in ((report["missing_objects"], "object_missing"), (report["size_mismatch"], "size_mismatch")): + for att_id in ids: + n = await conn.execute("UPDATE attachments SET status = 'failed', error_code = $2, updated_at = now() " + "WHERE id = $1 AND status = 'ready'", att_id, code) + report["fixed"]["marked_failed"] += int(n.split()[-1]) + report["timing_ms"] = {"db_query": round(db_ms, 1), "s3_listing": round(list_ms, 1), + "total": round((time.perf_counter() - started) * 1000, 1)} + return report + finally: + await conn.close() + await s3.stop() + + +def main(): + ap = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter) + ap.add_argument("--apply", action="store_true", help="исправлять (по умолчанию dry-run)") + ap.add_argument("--grace", type=int, default=config.ORPHAN_GRACE_SECONDS) + ap.add_argument("--prefix", default="att/") + ap.add_argument("--max-listed", type=int, default=20, help="сколько идентификаторов печатать в отчёте") + args = ap.parse_args() + report = asyncio.run(reconcile(args.apply, args.grace, args.prefix)) + for k in ("orphan_objects", "missing_objects", "size_mismatch"): + report[k + "_count"] = len(report[k]) + report[k] = report[k][:args.max_listed] + print(json.dumps(report, ensure_ascii=False, indent=2)) + + +if __name__ == "__main__": + main() diff --git a/src/app/s3.py b/src/app/s3.py new file mode 100644 index 00000000..28b73a8e --- /dev/null +++ b/src/app/s3.py @@ -0,0 +1,85 @@ +"""Приватное S3-хранилище (MinIO) через aiobotocore: потоковая загрузка/скачивание, таймауты, перевод сбоев в 503.""" +import asyncio + +from aiobotocore.config import AioConfig +from aiobotocore.session import get_session +from botocore.exceptions import BotoCoreError, ClientError + +from . import config +from .web import log, unavailable + +S3_ERRORS = (BotoCoreError, ClientError, asyncio.TimeoutError, OSError) + + +class S3: + def __init__(self): + self._ctx = None + self.client = None + + async def start(self): + if not config.S3_ENDPOINT: + log("error", "s3_endpoint_missing") + return + session = get_session() + self._ctx = session.create_client( + "s3", endpoint_url=config.S3_ENDPOINT, region_name=config.S3_REGION, + aws_access_key_id=config.S3_ACCESS_KEY, aws_secret_access_key=config.S3_SECRET_KEY, + config=AioConfig(connect_timeout=config.S3_CONNECT_TIMEOUT, read_timeout=config.S3_READ_TIMEOUT, + retries={"max_attempts": 2, "mode": "standard"}, max_pool_connections=config.S3_POOL, + s3={"addressing_style": "path"})) + self.client = await self._ctx.__aenter__() + + async def stop(self): + if self._ctx: + await self._ctx.__aexit__(None, None, None) + + def _check(self): + if self.client is None: + raise unavailable("Хранилище файлов не настроено") + + async def put(self, key, fileobj, content_type, size): + self._check() + try: + await self.client.put_object(Bucket=config.S3_BUCKET, Key=key, Body=fileobj, ContentType=content_type, + ContentLength=size) + except S3_ERRORS as exc: + log("warning", "s3_put_failed", error_type=type(exc).__name__) + raise unavailable("Хранилище файлов недоступно") from exc + + async def open_stream(self, key): + """Возвращает (stream, content_length). Вызывающий обязан закрыть stream.""" + self._check() + try: + resp = await self.client.get_object(Bucket=config.S3_BUCKET, Key=key) + except S3_ERRORS as exc: + log("warning", "s3_get_failed", error_type=type(exc).__name__) + raise unavailable("Хранилище файлов недоступно") from exc + return resp["Body"], resp["ContentLength"] + + async def delete(self, key): + self._check() + await self.client.delete_object(Bucket=config.S3_BUCKET, Key=key) + + async def head(self, key): + """Метаданные объекта или None, если его нет.""" + self._check() + try: + return await self.client.head_object(Bucket=config.S3_BUCKET, Key=key) + except ClientError as exc: + if exc.response.get("Error", {}).get("Code") in ("404", "NoSuchKey", "NotFound"): + return None + raise unavailable("Хранилище файлов недоступно") from exc + except S3_ERRORS as exc: + raise unavailable("Хранилище файлов недоступно") from exc + + async def ping(self): + self._check() + await asyncio.wait_for(self.client.head_bucket(Bucket=config.S3_BUCKET), 2.0) + + async def list_keys(self, prefix): + """Асинхронный итератор (key, size, last_modified) по префиксу — для сверки (reconcile).""" + self._check() + paginator = self.client.get_paginator("list_objects_v2") + async for page in paginator.paginate(Bucket=config.S3_BUCKET, Prefix=prefix): + for obj in page.get("Contents", []): + yield obj["Key"], obj["Size"], obj["LastModified"] diff --git a/src/app/s3_bootstrap.py b/src/app/s3_bootstrap.py new file mode 100644 index 00000000..6004a859 --- /dev/null +++ b/src/app/s3_bootstrap.py @@ -0,0 +1,85 @@ +"""Идемпотентный bootstrap S3: python -m app.s3_bootstrap (one-shot сервис s3-init при каждом `docker compose up`). + + 1) bucket создаётся администратором, если его ещё нет (повтор ничего не меняет); + 2) проверяется, что анонимный запрос к bucket отклоняется (private); + 3) проверяется, что отдельный ключ API (права только на этот bucket) может писать/читать/удалять и НЕ может создавать bucket. +Ключи читаются из файлов секретов; в вывод не попадают. Код выхода != 0, если любая проверка не пройдена. +""" +import asyncio +import os +import sys +import time +import urllib.error +import urllib.request + +from aiobotocore.config import AioConfig +from aiobotocore.session import get_session +from botocore.exceptions import ClientError + +from . import config + + +def secret(name): + path = os.environ.get(name + "_FILE") + with open(path, encoding="utf-8") as fh: + return fh.read().strip() + + +def client(session, access, secret_key): + return session.create_client("s3", endpoint_url=config.S3_ENDPOINT, region_name=config.S3_REGION, aws_access_key_id=access, + aws_secret_access_key=secret_key, + config=AioConfig(connect_timeout=3, read_timeout=10, retries={"max_attempts": 1}, + s3={"addressing_style": "path"})) + + +async def main(): + bucket = config.S3_BUCKET + session = get_session() + deadline = time.time() + 60 + async with client(session, secret("S3_ADMIN_ACCESS_KEY"), secret("S3_ADMIN_SECRET_KEY")) as admin: + while True: + try: + await admin.list_buckets() + break + except Exception as exc: + if time.time() > deadline: + print("S3 недоступен:", type(exc).__name__) + return 1 + await asyncio.sleep(1) + try: + await admin.head_bucket(Bucket=bucket) + print("bucket %s уже существует" % bucket) + except ClientError: + await admin.create_bucket(Bucket=bucket) + print("bucket %s создан" % bucket) + # приватность: запрос без подписи отклоняется + try: + urllib.request.urlopen("%s/%s/" % (config.S3_ENDPOINT, bucket), timeout=5) + print("ОШИБКА: bucket доступен анонимно") + return 2 + except urllib.error.HTTPError as exc: + if exc.code not in (401, 403): + print("ОШИБКА: анонимный доступ вернул %d, ожидался 401/403" % exc.code) + return 2 + print("анонимный доступ запрещён (HTTP %d)" % exc.code) + # ключ API: рабочие права на bucket, нет прав администратора + async with client(session, config.S3_ACCESS_KEY, config.S3_SECRET_KEY) as api: + key = "bootstrap-check/%d" % int(time.time()) + await api.put_object(Bucket=bucket, Key=key, Body=b"ok") + got = await (await api.get_object(Bucket=bucket, Key=key))["Body"].read() + await api.delete_object(Bucket=bucket, Key=key) + if got != b"ok": + print("ОШИБКА: чтение/запись ключом API") + return 3 + try: + await api.create_bucket(Bucket="not-allowed-" + str(int(time.time()))) + print("ОШИБКА: ключ API смог создать bucket (избыточные права)") + return 4 + except ClientError as exc: + print("ключ API ограничен одним bucket (create_bucket отклонён: %s)" % exc.response["Error"]["Code"]) + print("bootstrap завершён") + return 0 + + +if __name__ == "__main__": + sys.exit(asyncio.run(main())) diff --git a/src/app/serve.py b/src/app/serve.py new file mode 100644 index 00000000..9980988c --- /dev/null +++ b/src/app/serve.py @@ -0,0 +1,40 @@ +"""Точка входа: uvicorn с управляемым завершением (drain). + +SIGTERM -> readiness сразу 503 -> DRAIN_SECONDS продолжаем обслуживать запросы, пока балансировщик +исключает реплику -> uvicorn прекращает приём и дожидается текущих запросов (timeout_graceful_shutdown). +Так плановая остановка/rolling update не даёт ошибок клиентам. +""" +import signal +import threading + +import uvicorn + +from . import config +from .main import app +from .web import log + + +class DrainingServer(uvicorn.Server): + _draining = False + + def handle_exit(self, sig, frame): + if sig == signal.SIGTERM and not self._draining and config.DRAIN_SECONDS > 0: + self._draining = True + app.draining = True + log("info", "draining", seconds=config.DRAIN_SECONDS) + timer = threading.Timer(config.DRAIN_SECONDS, super().handle_exit, args=(sig, frame)) + timer.daemon = True + timer.start() + return + super().handle_exit(sig, frame) + + +def main(): + cfg = uvicorn.Config(app, host=config.APP_HOST, port=config.APP_PORT, workers=1, access_log=False, + log_level="warning", timeout_graceful_shutdown=config.GRACEFUL_SHUTDOWN_SECONDS, + timeout_keep_alive=config.KEEPALIVE_SECONDS, limit_concurrency=config.LIMIT_CONCURRENCY) + DrainingServer(cfg).run() + + +if __name__ == "__main__": + main() diff --git a/src/app/sessions.py b/src/app/sessions.py new file mode 100644 index 00000000..b07117c0 --- /dev/null +++ b/src/app/sessions.py @@ -0,0 +1,131 @@ +"""Сессии: PostgreSQL — источник истины; Valkey — кэш с TTL (read-through). + +Политики: + * токен — 256 бит из secrets; в БД и Valkey хранится только SHA-256 токена; + * expiry: expires_at в БД (по часам БД). В кэше TTL = min(остаток жизни, SESSION_CACHE_TTL_SECONDS); + * инвалидация: logout помечает revoked_at в БД и удаляет ключ в Valkey; + * Valkey недоступен -> кэш обходится (чтение из БД), анонимный запрос никогда не считается доверенным; + circuit breaker не даёт каждому запросу ждать таймаут; + * окно устаревания: если Valkey был недоступен во время logout, ключ может прожить до SESSION_CACHE_TTL_SECONDS. +""" +import hashlib +import secrets +import time + +from . import config +from .web import log + +try: + import redis.asyncio as aioredis +except ImportError: # кэш опционален + aioredis = None + + +def token_hash(token): + return hashlib.sha256(token.encode("ascii")).digest() + + +class SessionCache: + def __init__(self): + self.client = None + self.down_until = 0.0 + self.stats = {"hit": 0, "miss": 0, "error": 0} + + async def start(self): + if config.VALKEY_URL and aioredis: + self.client = aioredis.Redis.from_url(config.VALKEY_URL, socket_timeout=config.VALKEY_TIMEOUT, + socket_connect_timeout=config.VALKEY_TIMEOUT) + + async def stop(self): + if self.client: + await self.client.aclose() + + def _usable(self): + return self.client is not None and time.monotonic() >= self.down_until + + def _fail(self, exc): + self.stats["error"] += 1 + if time.monotonic() >= self.down_until: + log("warning", "session_cache_unavailable", error_type=type(exc).__name__) + self.down_until = time.monotonic() + config.VALKEY_BREAKER_SECONDS + + async def get(self, key): + if not self._usable(): + return None + try: + value = await self.client.get(b"s:" + key) + except Exception as exc: + self._fail(exc) + return None + self.stats["hit" if value is not None else "miss"] += 1 + return value + + async def put(self, key, value, ttl): + if not self._usable() or ttl <= 0: + return + try: + await self.client.set(b"s:" + key, value, ex=max(1, int(ttl))) + except Exception as exc: + self._fail(exc) + + async def delete(self, key): + if not self._usable(): + return + try: + await self.client.delete(b"s:" + key) + except Exception as exc: + self._fail(exc) + + async def ping(self): + if self.client is None: + return None + try: + return bool(await self.client.ping()) + except Exception: + return False + + +class Sessions: + def __init__(self, db, cache): + self.db, self.cache = db, cache + + @staticmethod + def _cache_value(user_id, expires_at): + return ("%s|%d" % (user_id, int(expires_at.timestamp() * 1000))).encode() + + async def create(self, user_id): + token = secrets.token_urlsafe(32) # 256 бит энтропии + digest = token_hash(token) + row = await self.db.fetchrow( + "INSERT INTO sessions (token_hash, user_id, expires_at) " + "VALUES ($1, $2, now() + make_interval(secs => $3)) RETURNING expires_at", + digest, user_id, float(config.SESSION_TTL_SECONDS)) + remaining = row["expires_at"].timestamp() - time.time() + await self.cache.put(digest, self._cache_value(user_id, row["expires_at"]), + min(remaining, config.SESSION_CACHE_TTL_SECONDS)) + return token, row["expires_at"] + + async def resolve(self, token): + """token -> user_id (str) либо None, если сессии нет/истекла/отозвана.""" + digest = token_hash(token) + cached = await self.cache.get(digest) + if cached is not None: + user_id, _, expires_ms = cached.decode().partition("|") + if int(expires_ms) > time.time() * 1000: + return user_id + await self.cache.delete(digest) + row = await self.db.fetchrow( + "SELECT user_id, expires_at FROM sessions " + "WHERE token_hash = $1 AND revoked_at IS NULL AND expires_at > now()", digest) + if row is None: + return None + user_id = str(row["user_id"]) + remaining = row["expires_at"].timestamp() - time.time() + await self.cache.put(digest, self._cache_value(user_id, row["expires_at"]), + min(remaining, config.SESSION_CACHE_TTL_SECONDS)) + return user_id + + async def revoke(self, token): + digest = token_hash(token) + await self.db.execute("UPDATE sessions SET revoked_at = now() WHERE token_hash = $1 AND revoked_at IS NULL", digest) + await self.cache.delete(digest) diff --git a/src/app/web.py b/src/app/web.py new file mode 100644 index 00000000..f463b5d8 --- /dev/null +++ b/src/app/web.py @@ -0,0 +1,187 @@ +"""Общий HTTP-слой: ошибки, запрос, валидация, курсоры, ответы, журнал.""" +import base64 +import json +import re +import sys +import time +import uuid +from datetime import datetime, timedelta, timezone +from urllib.parse import parse_qsl + +from . import config + +UUID_RE = re.compile(r"[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}") +USERNAME_RE = re.compile(r"[a-z0-9_]{3,32}") +LIMIT_RE = re.compile(r"[0-9]{1,9}") +EPOCH = datetime(1970, 1, 1, tzinfo=timezone.utc) + + +class ApiError(Exception): + def __init__(self, status, code, message, headers=None): + super().__init__(message) + self.status, self.code, self.message, self.headers = status, code, message, headers or {} + + +def bad(message): + return ApiError(400, "invalid_request", message) + + +def unavailable(message="Зависимость временно недоступна"): + return ApiError(503, "unavailable", message, {"retry-after": str(config.RETRY_AFTER_SECONDS)}) + + +def log(level, msg, **fields): + record = {"ts": time.strftime("%Y-%m-%dT%H:%M:%SZ", time.gmtime()), "level": level, "msg": msg} + record.update(fields) + sys.stdout.write(json.dumps(record, ensure_ascii=False) + "\n") + sys.stdout.flush() + + +# --- время ------------------------------------------------------------------- +def format_dt(value): + value = value.astimezone(timezone.utc) + return value.strftime("%Y-%m-%dT%H:%M:%S.") + "%06dZ" % value.microsecond + + +def dt_to_us(value): + return (value - EPOCH) // timedelta(microseconds=1) + + +def us_to_dt(us): + return EPOCH + timedelta(microseconds=us) + + +# --- валидация --------------------------------------------------------------- +def parse_uuid(value, what="id"): + if not isinstance(value, str) or not UUID_RE.fullmatch(value): + raise bad("Некорректный %s" % what) + return value.lower() + + +def valid_text(value, field, maximum, allow_empty=False): + if not isinstance(value, str): + raise bad("Поле %s должно быть строкой" % field) + try: + value.encode("utf-8") + except UnicodeEncodeError: + raise bad("Поле %s содержит некорректные символы" % field) from None + if "\x00" in value: + raise bad("Поле %s содержит NUL" % field) + if len(value) > maximum: + raise bad("Поле %s слишком длинное" % field) + if not allow_empty and not value.strip(): + raise bad("Поле %s не может быть пустым" % field) + return value + + +def _reject_constant(name): + raise ValueError(name) + + +def parse_json_object(raw, required, allowed): + try: + data = json.loads(raw.decode("utf-8"), parse_constant=_reject_constant) + except (UnicodeDecodeError, ValueError, RecursionError): + raise bad("Тело запроса — некорректный JSON") from None + if not isinstance(data, dict): + raise bad("Ожидается JSON-объект") + if set(data) - allowed: + raise bad("Лишние поля в запросе") + if any(key not in data for key in required): + raise bad("Не хватает обязательных полей") + return data + + +def encode_cursor(kind, resource, key): + payload = json.dumps({"k": kind, "r": resource, "t": key[0], "i": key[1]}, separators=(",", ":")) + return base64.urlsafe_b64encode(payload.encode()).decode().rstrip("=") + + +def decode_cursor(text, kind, resource): + try: + data = json.loads(base64.urlsafe_b64decode(text + "=" * (-len(text) % 4)).decode()) + if (not isinstance(data, dict) or data.get("k") != kind or data.get("r") != resource + or not isinstance(data.get("t"), int) or isinstance(data.get("t"), bool) + or not isinstance(data.get("i"), str) or not UUID_RE.fullmatch(data["i"]) + or not -62135596800000000 < data["t"] < 253402300799000000): + raise ValueError + return data["t"], data["i"] + except (ValueError, UnicodeError): + raise bad("Некорректный cursor") from None + + +def page_params(query, kind, resource): + limit, cursor = 50, None + if "limit" in query: + if len(query["limit"]) != 1 or not LIMIT_RE.fullmatch(query["limit"][0]): + raise bad("limit должен быть целым числом 1–100") + limit = int(query["limit"][0]) + if not 1 <= limit <= 100: + raise bad("limit должен быть целым числом 1–100") + if "cursor" in query: + if len(query["cursor"]) != 1 or not query["cursor"][0]: + raise bad("Некорректный cursor") + cursor = decode_cursor(query["cursor"][0], kind, resource) + return limit, cursor + + +def parse_query(raw): + result = {} + if raw: + for key, value in parse_qsl(raw.decode("latin-1"), keep_blank_values=True): + result.setdefault(key, []).append(value) + return result + + +class Request: + def __init__(self, scope, receive, request_id): + self.method = scope["method"] + self.path = scope["path"] + self.query = parse_query(scope.get("query_string", b"")) + self.headers = {k.decode("latin-1").lower(): v.decode("latin-1") for k, v in scope["headers"]} + self.receive = receive + self.request_id = request_id + self.user_id = None + + async def body(self): + declared = self.headers.get("content-length") + if declared is not None: + if not declared.isdigit(): + raise bad("Некорректный Content-Length") + if int(declared) > config.MAX_BODY_BYTES: + raise ApiError(413, "payload_too_large", "Тело запроса слишком большое", {"connection": "close"}) + chunks, size = [], 0 + while True: + event = await self.receive() + if event["type"] == "http.disconnect": + raise bad("Соединение закрыто клиентом") + chunk = event.get("body", b"") + size += len(chunk) + if size > config.MAX_BODY_BYTES: + raise ApiError(413, "payload_too_large", "Тело запроса слишком большое", {"connection": "close"}) + chunks.append(chunk) + if not event.get("more_body"): + return b"".join(chunks) + + def require_json_media_type(self): + media = self.headers.get("content-type", "").split(";")[0].strip().lower() + if media != "application/json": + raise ApiError(415, "unsupported_media_type", "Ожидается Content-Type: application/json") + + +async def respond(send, status, body, request_id, extra=None, instance_id=None): + payload = b"" if status == 204 else json.dumps(body, ensure_ascii=False, separators=(",", ":")).encode("utf-8") + headers = [(b"x-request-id", request_id.encode())] + if status != 204: + headers += [(b"content-type", b"application/json"), (b"content-length", str(len(payload)).encode())] + else: + headers.append((b"content-length", b"0")) + if instance_id: + headers.append((b"x-instance-id", instance_id.encode())) + headers += [(k.encode(), v.encode()) for k, v in (extra or {}).items()] + await send({"type": "http.response.start", "status": status, "headers": headers}) + await send({"type": "http.response.body", "body": payload}) + + +def new_request_id(): + return uuid.uuid4().hex diff --git a/student-tests/fixtures/sample.jpg b/student-tests/fixtures/sample.jpg new file mode 100644 index 0000000000000000000000000000000000000000..6b1f3ef8186943531211a47fa5431eb36b849c7a GIT binary patch literal 24299 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 Hayb4U3Y~JT literal 0 HcmV?d00001 diff --git a/student-tests/fixtures/sample.png b/student-tests/fixtures/sample.png new file mode 100644 index 0000000000000000000000000000000000000000..e7c920789e90d16586ecff5029a87d1fc247b086 GIT binary patch literal 111817 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ðy=(TIZ6WiN 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 literal 0 HcmV?d00001 diff --git a/student-tests/test_api.py b/student-tests/test_api.py new file mode 100644 index 00000000..46e5e765 --- /dev/null +++ b/student-tests/test_api.py @@ -0,0 +1,208 @@ +"""Собственные тесты lab2 против запущенного стенда (docker compose up -d). + + python -m unittest discover -s student-tests -v # BASE_URL по умолчанию http://127.0.0.1:8080 +Тесты используют только синтетические данные и ничего не удаляют. Проверки expiry и недоступности +зависимостей лежат отдельно (test_expiry.py, test_dependencies.py): они управляют контейнерами. +""" +import base64 +import json +import os +import subprocess +import unittest +import urllib.error +import urllib.request +import uuid +from concurrent.futures import ThreadPoolExecutor +from urllib.parse import quote + +BASE = os.environ.get("BASE_URL", "http://127.0.0.1:8080").rstrip("/") +ROOT = os.path.join(os.path.dirname(__file__), "..") + + +def call(method, path, body=None, token=None, headers=None, raw=None): + h = dict(headers or {}) + if method == "POST" and path.endswith("/messages") and headers is None: + h["Idempotency-Key"] = uuid.uuid4().hex # lab3: ключ обязателен; тесты без ключа — в test_idempotency.py + data = raw + if body is not None: + data = json.dumps(body, ensure_ascii=False).encode("utf-8") + h.setdefault("Content-Type", "application/json") + if token: + h["Authorization"] = "Bearer " + token + req = urllib.request.Request(BASE + path, data=data, headers=h, method=method) + try: + with urllib.request.urlopen(req, timeout=10) as resp: + status, hdrs, payload = resp.status, resp.headers, resp.read() + except urllib.error.HTTPError as err: + status, hdrs, payload = err.code, err.headers, err.read() + return status, hdrs, (json.loads(payload) if payload else None) + + +def basic(username, password): + return {"Authorization": "Basic " + base64.b64encode((username + ":" + password).encode("utf-8")).decode()} + + +def register(prefix="u"): + name = "%s_%s" % (prefix, uuid.uuid4().hex[:12]) + password = "Pa55:word-" + uuid.uuid4().hex # двоеточие в пароле допустимо + status, _, user = call("POST", "/api/v1/users", {"username": name, "display_name": "Имя " + name, "password": password}) + assert status == 201, user + status, _, session = call("POST", "/api/v1/auth/sessions", headers=basic(name, password)) + assert status == 201, session + return {"user": user, "password": password, "token": session["token"], "session": session} + + +def psql(sql): + out = subprocess.run(["docker", "compose", "--env-file", ".env", "exec", "-T", "postgres", "psql", "-U", "messenger", + "-d", "messenger", "-Atc", sql], cwd=ROOT, capture_output=True, text=True, check=True) + return out.stdout.strip() + + +class AuthTest(unittest.TestCase): + def assertError(self, result, status, code): + self.assertEqual(result[0], status, result[2]) + self.assertEqual(result[2]["error"]["code"], code) + self.assertEqual(result[2]["error"]["request_id"], result[1]["X-Request-Id"]) + + def test_register_validation(self): + base = {"username": "val_" + uuid.uuid4().hex[:8], "display_name": "x", "password": "p" * 12} + for patch in ({"password": "short"}, {"password": "p" * 129}, {"password": 12345678901234}, {"extra": 1}, + {"username": "BAD"}, {"display_name": " "}): + body = dict(base, **patch) + self.assertError(call("POST", "/api/v1/users", body), 400, "invalid_request") + missing = {k: v for k, v in base.items() if k != "password"} + self.assertError(call("POST", "/api/v1/users", missing), 400, "invalid_request") + self.assertEqual(call("POST", "/api/v1/users", dict(base, password="я" * 12))[0], 201) # 12 code points + + def test_password_is_not_exposed_or_stored_plain(self): + actor = register() + self.assertEqual(set(actor["user"]), {"id", "username", "display_name", "created_at"}) + stored = psql("SELECT password_hash FROM users WHERE username = '%s'" % actor["user"]["username"]) + self.assertTrue(stored.startswith("$argon2id$"), stored[:12]) + self.assertNotIn(actor["password"], stored) + + def test_wrong_password_and_unknown_user_are_indistinguishable(self): + actor = register() + wrong = call("POST", "/api/v1/auth/sessions", headers=basic(actor["user"]["username"], "wrong-password-123")) + unknown = call("POST", "/api/v1/auth/sessions", headers=basic("nobody_" + uuid.uuid4().hex[:8], "wrong-password-123")) + for r in (wrong, unknown): + self.assertError(r, 401, "unauthorized") + self.assertEqual(r[1]["WWW-Authenticate"], 'Basic realm="messenger", charset="UTF-8"') + self.assertEqual(wrong[2]["error"]["message"], unknown[2]["error"]["message"]) + for bad in ({}, {"Authorization": "Basic !!!"}, {"Authorization": "Basic " + base64.b64encode(b"nocolon").decode()}, + {"Authorization": "Bearer abc"}): + self.assertEqual(call("POST", "/api/v1/auth/sessions", headers=bad)[0], 401) + + def test_bearer_rules(self): + actor = register() + self.assertEqual(call("GET", "/api/v1/users/me", token=actor["token"])[2], actor["user"]) + for headers in ({}, basic(actor["user"]["username"], actor["password"]), {"X-User-Id": actor["user"]["id"]}, + {"Authorization": "Bearer " + "A" * 43}, {"Authorization": "Bearer short"}): + r = call("GET", "/api/v1/users/me", headers=headers) + self.assertError(r, 401, "unauthorized") + self.assertEqual(r[1]["WWW-Authenticate"], 'Bearer realm="messenger"') + other = register() + me = call("GET", "/api/v1/users/me", token=actor["token"], headers={"X-User-Id": other["user"]["id"]})[2] + self.assertEqual(me["id"], actor["user"]["id"]) # X-User-Id игнорируется + + def test_session_shape_entropy_and_logout(self): + actor = register() + s = actor["session"] + self.assertEqual(s["token_type"], "Bearer") + self.assertGreaterEqual(len(s["token"]), 43) # 32 байта в base64url = 256 бит + self.assertNotIn(actor["user"]["id"], s["token"]) + self.assertNotEqual(register()["token"], s["token"]) + self.assertEqual(call("DELETE", "/api/v1/auth/sessions/current", token=s["token"])[0], 204) + self.assertError(call("GET", "/api/v1/users/me", token=s["token"]), 401, "unauthorized") + self.assertError(call("DELETE", "/api/v1/auth/sessions/current", token=s["token"]), 401, "unauthorized") + + def test_logout_revokes_in_database_and_cache(self): + actor = register() + call("GET", "/api/v1/users/me", token=actor["token"]) # прогреваем кэш + call("DELETE", "/api/v1/auth/sessions/current", token=actor["token"]) + revoked = psql("SELECT count(*) FROM sessions s JOIN users u ON u.id = s.user_id " + "WHERE u.username = '%s' AND s.revoked_at IS NOT NULL" % actor["user"]["username"]) + self.assertEqual(revoked, "1") + + def test_token_only_stored_as_hash(self): + actor = register() + count = psql("SELECT count(*) FROM sessions WHERE token_hash = '\\x00'::bytea OR encode(token_hash,'escape') = '%s'" % actor["token"]) + self.assertEqual(count, "0") + + def test_concurrent_registration_of_same_username(self): + name = "race_" + uuid.uuid4().hex[:10] + body = {"username": name, "display_name": "x", "password": "racing-password-1"} + with ThreadPoolExecutor(12) as pool: + codes = sorted(pool.map(lambda _: call("POST", "/api/v1/users", body)[0], range(12))) + self.assertEqual(codes, [201] + [409] * 11) + self.assertEqual(psql("SELECT count(*) FROM users WHERE username = '%s'" % name), "1") + + +class DataTest(unittest.TestCase): + def test_chat_creation_is_atomic(self): + a = register() + before = psql("SELECT (SELECT count(*) FROM chats) || '/' || (SELECT count(*) FROM chat_members)") + ghost = str(uuid.uuid4()) + r = call("POST", "/api/v1/chats", {"title": "откат", "member_ids": [a["user"]["id"], ghost]}, token=a["token"]) + self.assertEqual(r[0], 400) + after = psql("SELECT (SELECT count(*) FROM chats) || '/' || (SELECT count(*) FROM chat_members)") + self.assertEqual(before, after, "после неудачного создания не должно остаться чата или участников") + ok = call("POST", "/api/v1/chats", {"title": "ок", "member_ids": [a["user"]["id"]]}, token=a["token"]) + self.assertEqual(ok[0], 201) + + def test_foreign_chat_empty_message_bad_json(self): + a, b, eve = register(), register(), register() + chat = call("POST", "/api/v1/chats", {"title": "ЛС", "member_ids": [a["user"]["id"], b["user"]["id"]]}, a["token"])[2] + path = "/api/v1/chats/%s/messages" % chat["id"] + self.assertEqual(call("POST", path, {"text": "чужое"}, eve["token"])[0], 404) + self.assertEqual(call("GET", path, token=eve["token"])[0], 404) + self.assertEqual(call("POST", path, {"text": " "}, a["token"])[0], 400) + self.assertEqual(call("POST", path, raw=b"{oops", token=a["token"], headers={"Content-Type": "application/json"})[0], 400) + self.assertEqual(call("POST", path, {"text": "x", "sender_id": b["user"]["id"]}, a["token"])[0], 400) + sent = call("POST", path, {"text": "Привет 👋"}, a["token"])[2] + self.assertEqual(sent["sender_id"], a["user"]["id"]) + + def test_multi_page_history_and_cursor_binding(self): + a, b = register(), register() + chat = call("POST", "/api/v1/chats", {"title": "стр", "member_ids": [a["user"]["id"], b["user"]["id"]]}, a["token"])[2] + other = call("POST", "/api/v1/chats", {"title": "др", "member_ids": [a["user"]["id"]]}, a["token"])[2] + path = "/api/v1/chats/%s/messages" % chat["id"] + sent = [call("POST", path, {"text": "m%d" % i}, (a if i % 2 else b)["token"])[2] for i in range(23)] + walked, cursor, pages = [], None, 0 + while True: + q = "?limit=%d" % (5 if pages % 2 == 0 else 8) + ("&cursor=" + quote(cursor, safe="") if cursor else "") + page = call("GET", path + q, token=b["token"])[2] + walked += page["items"] + pages += 1 + cursor = page["next_cursor"] + if not cursor: + break + self.assertEqual(walked, sent) + self.assertGreaterEqual(pages, 3) + first = call("GET", path + "?limit=1", token=a["token"])[2]["next_cursor"] + r = call("GET", "/api/v1/chats/%s/messages?cursor=%s" % (other["id"], quote(first, safe="")), token=a["token"]) + self.assertEqual(r[0], 400) + + def test_parallel_writes_from_many_clients(self): + users = [register() for _ in range(5)] + chat = call("POST", "/api/v1/chats", {"title": "гонки", "member_ids": [u["user"]["id"] for u in users]}, users[0]["token"])[2] + path = "/api/v1/chats/%s/messages" % chat["id"] + + def client(u): + return [call("POST", path, {"text": "%s-%d" % (u["user"]["username"], i)}, u["token"])[0] for i in range(20)] + + with ThreadPoolExecutor(5) as pool: + codes = [c for part in pool.map(client, users) for c in part] + self.assertEqual(codes, [201] * 100) + total, cursor = [], None + while True: + page = call("GET", path + "?limit=100" + ("&cursor=" + quote(cursor, safe="") if cursor else ""), token=users[0]["token"])[2] + total += page["items"] + cursor = page["next_cursor"] + if not cursor: + break + self.assertEqual(len({m["id"] for m in total}), 100) + + +if __name__ == "__main__": + unittest.main() diff --git a/student-tests/test_attachments.py b/student-tests/test_attachments.py new file mode 100644 index 00000000..aa0a76c5 --- /dev/null +++ b/student-tests/test_attachments.py @@ -0,0 +1,188 @@ +"""Собственные тесты вложений lab4 (негативные сценарии и права). Запуск: + python -m unittest discover -s student-tests -p "test_attachments.py" -v (BASE_URL по умолчанию http://127.0.0.1:8080) +""" +import hashlib +import json +import os +import socket +import struct +import sys +import unittest +import urllib.error +import urllib.parse +import urllib.request +import uuid +import zlib + +sys.path.insert(0, os.path.dirname(__file__)) +from test_api import BASE, ROOT, call, psql, register # noqa: E402 + +FIX = os.path.join(os.path.dirname(__file__), "fixtures") +PNG = open(os.path.join(FIX, "sample.png"), "rb").read() +JPG = open(os.path.join(FIX, "sample.jpg"), "rb").read() + + +def upload(token, chat_id, data, ctype="image/png", filename="sample.png", raw_filename=None): + qs = raw_filename if raw_filename is not None else "filename=" + filename + req = urllib.request.Request("%s/api/v1/chats/%s/attachments?%s" % (BASE, chat_id, qs), data=data, method="POST", + headers={"Authorization": "Bearer " + token, "Content-Type": ctype}) + try: + with urllib.request.urlopen(req, timeout=30) as r: + return r.status, r.headers, json.loads(r.read()) + except urllib.error.HTTPError as err: + body = err.read() + return err.code, err.headers, (json.loads(body) if body else None) + + +def download(token, att_id, suffix="/content"): + req = urllib.request.Request("%s/api/v1/attachments/%s%s" % (BASE, att_id, suffix), + headers={"Authorization": "Bearer " + token if token else ""}) + try: + with urllib.request.urlopen(req, timeout=30) as r: + return r.status, r.headers, r.read() + except urllib.error.HTTPError as err: + return err.code, err.headers, err.read() + + +def png_chunk(kind, data): + return struct.pack(">I", len(data)) + kind + data + struct.pack(">I", zlib.crc32(kind + data) & 0xFFFFFFFF) + + +def bomb_png(width=20000, height=20000): + """Корректный по структуре PNG, заявляющий 400 млн пикселей, без данных изображения (отклоняется по заголовку).""" + ihdr = struct.pack(">IIBBBBB", width, height, 8, 2, 0, 0, 0) + return b"\x89PNG\r\n\x1a\n" + png_chunk(b"IHDR", ihdr) + png_chunk(b"IDAT", zlib.compress(b"\x00" * 16)) + png_chunk(b"IEND", b"") + + +class AttachmentTest(unittest.TestCase): + def setUp(self): + self.a, self.b, self.eve = register("att"), register("att"), register("att") + self.chat = call("POST", "/api/v1/chats", {"title": "файлы", "member_ids": [self.a["user"]["id"], self.b["user"]["id"]]}, self.a["token"])[2] + self.other = call("POST", "/api/v1/chats", {"title": "другой", "member_ids": [self.a["user"]["id"]]}, self.a["token"])[2] + + def assertError(self, result, status, code=None): + self.assertEqual(result[0], status, result[2]) + if code: + self.assertEqual(result[2]["error"]["code"], code) + + def test_png_and_jpeg_roundtrip_with_checksum(self): + for data, ctype, name in ((PNG, "image/png", "фото.png"), (JPG, "image/jpeg", "photo.jpg")): + status, headers, att = upload(self.a["token"], self.chat["id"], data, ctype, urllib.parse.quote(name)) + self.assertEqual(status, 201, att) + self.assertEqual((att["status"], att["variants"], att["error_code"]), ("ready", [], None)) + self.assertEqual((att["size_bytes"], att["sha256"], att["content_type"]), (len(data), hashlib.sha256(data).hexdigest(), ctype)) + self.assertEqual((att["chat_id"], att["owner_id"], att["filename"]), (self.chat["id"], self.a["user"]["id"], name)) + code, hdr, body = download(self.b["token"], att["id"]) # другой участник чата + self.assertEqual((code, body, hdr.get_content_type()), (200, data, ctype)) + self.assertEqual(download(self.b["token"], att["id"], "")[0], 200) + + def test_too_large_is_413_and_nothing_is_stored(self): + before = psql("SELECT count(*) FROM attachments") + r = upload(self.a["token"], self.chat["id"], PNG[:8] + b"\x00" * (10 * 1024 * 1024 + 1)) + self.assertError(r, 413, "payload_too_large") + self.assertEqual(psql("SELECT count(*) FROM attachments"), before) + + def test_corrupted_and_spoofed_files_are_415_not_500(self): + cases = { + "truncated png": (PNG[: len(PNG) // 2], "image/png"), + "garbage png": (b"\x89PNG\r\n\x1a\n" + b"\x00" * 200, "image/png"), + "random bytes": (os.urandom(500), "image/png"), + "truncated jpeg": (JPG[: len(JPG) // 2], "image/jpeg"), + "garbage jpeg": (b"\xff\xd8\xff\xe0" + b"\x00" * 200, "image/jpeg"), + "png as jpeg": (PNG, "image/jpeg"), + "jpeg as png": (JPG, "image/png"), + "text as png": (b"hello, i am not an image", "image/png"), + "gif": (b"GIF89a" + b"\x00" * 50, "image/png"), + } + for name, (data, ctype) in cases.items(): + with self.subTest(name): + self.assertError(upload(self.a["token"], self.chat["id"], data, ctype), 415, "unsupported_media_type") + self.assertError(upload(self.a["token"], self.chat["id"], PNG, "text/plain"), 415) + self.assertError(upload(self.a["token"], self.chat["id"], PNG, "multipart/form-data; boundary=x"), 415) + + def test_decompression_bomb_header_is_413(self): + self.assertError(upload(self.a["token"], self.chat["id"], bomb_png()), 413, "payload_too_large") + # 6000x6600 = 39.6 млн пикселей < лимита: по размерам допустимо, но данных изображения нет -> файл повреждён (415) + self.assertEqual(upload(self.a["token"], self.chat["id"], bomb_png(6000, 6600))[0], 415) + + def test_dangerous_filenames_are_400(self): + bad = ["a%2Fb.png", "..%5Cx.png", "x%00.png", "x%0A.png", "x%7F.png", "", "%20%20", "n" * 256] + for name in bad: + with self.subTest(name): + self.assertError(upload(self.a["token"], self.chat["id"], PNG, raw_filename="filename=" + name), 400, "invalid_request") + self.assertError(upload(self.a["token"], self.chat["id"], PNG, raw_filename=""), 400) + self.assertEqual(upload(self.a["token"], self.chat["id"], PNG, raw_filename="filename=" + "n" * 255)[0], 201) + + def test_empty_body_is_400(self): + self.assertError(upload(self.a["token"], self.chat["id"], b""), 400) + + def test_foreign_user_cannot_upload_read_or_download(self): + self.assertError(upload(self.eve["token"], self.chat["id"], PNG), 404) + att = upload(self.a["token"], self.chat["id"], PNG)[2] + for suffix in ("", "/content"): + self.assertEqual(download(self.eve["token"], att["id"], suffix)[0], 404) + self.assertEqual(download(None, att["id"], suffix)[0], 401) + self.assertEqual(download(self.a["token"], str(uuid.uuid4()))[0], 404) + self.assertEqual(download(self.a["token"], "not-a-uuid")[0], 400) + self.assertEqual(download(self.a["token"], att["id"], "/content?variant=thumbnail")[0], 404) # вариантов в lab4 нет + self.assertEqual(download(self.a["token"], att["id"], "/content?variant=bogus")[0], 400) + + def test_message_with_attachments_and_chat_binding(self): + att = upload(self.a["token"], self.chat["id"], PNG)[2] + foreign_chat_att = upload(self.a["token"], self.other["id"], JPG, "image/jpeg")[2] + path = "/api/v1/chats/%s/messages" % self.chat["id"] + sent = call("POST", path, {"text": "", "attachment_ids": [att["id"]]}, self.a["token"]) + self.assertEqual(sent[0], 201, sent[2]) + self.assertEqual(sent[2]["attachment_ids"], [att["id"]]) + self.assertEqual(call("POST", path, {"text": "ещё раз то же вложение", "attachment_ids": [att["id"]]}, self.b["token"])[0], 201) + listed = call("GET", path + "?limit=10", token=self.b["token"])[2]["items"] + self.assertEqual([m["attachment_ids"] for m in listed], [[att["id"]], [att["id"]]]) + # вложение другого чата / несуществующее -> 404; дубликаты, >10, пустое сообщение без вложений -> 400 + self.assertEqual(call("POST", path, {"text": "x", "attachment_ids": [foreign_chat_att["id"]]}, self.a["token"])[0], 404) + self.assertEqual(call("POST", path, {"text": "x", "attachment_ids": [str(uuid.uuid4())]}, self.a["token"])[0], 404) + self.assertEqual(call("POST", path, {"text": "x", "attachment_ids": [att["id"], att["id"]]}, self.a["token"])[0], 400) + self.assertEqual(call("POST", path, {"text": "x", "attachment_ids": [str(uuid.uuid4()) for _ in range(11)]}, self.a["token"])[0], 400) + self.assertEqual(call("POST", path, {"text": " ", "attachment_ids": []}, self.a["token"])[0], 400) + self.assertEqual(call("POST", path, {"text": "x", "attachment_ids": "nope"}, self.a["token"])[0], 400) + # чужой пользователь не может сослаться на вложение + self.assertEqual(call("POST", path, {"text": "x", "attachment_ids": [att["id"]]}, self.eve["token"])[0], 404) + + def test_idempotent_replay_with_attachments(self): + att = upload(self.a["token"], self.chat["id"], PNG)[2] + path = "/api/v1/chats/%s/messages" % self.chat["id"] + key = uuid.uuid4().hex + h = {"Idempotency-Key": key} + first = call("POST", path, {"text": "t", "attachment_ids": [att["id"]]}, self.a["token"], headers=h) + again = call("POST", path, {"attachment_ids": [att["id"]], "text": "t"}, self.a["token"], headers=h) # другой порядок ключей + self.assertEqual((first[0], again[0], first[2]), (201, 201, again[2])) + self.assertEqual(call("POST", path, {"text": "t"}, self.a["token"], headers=h)[0], 409) # другое тело + text_key = uuid.uuid4().hex + m1 = call("POST", path, {"text": "без вложений"}, self.a["token"], headers={"Idempotency-Key": text_key}) + m2 = call("POST", path, {"text": "без вложений", "attachment_ids": []}, self.a["token"], headers={"Idempotency-Key": text_key}) + self.assertEqual(m1[2], m2[2]) # отсутствие == [] + self.assertEqual(m1[2]["attachment_ids"], []) + + def test_aborted_upload_leaves_nothing(self): + before = (psql("SELECT count(*) FROM attachments")) + host, port = BASE.split("//")[1].split(":") + with socket.create_connection((host, int(port))) as s: + s.sendall(("POST /api/v1/chats/%s/attachments?filename=a.png HTTP/1.1\r\nHost: x\r\nAuthorization: Bearer %s\r\n" + "Content-Type: image/png\r\nContent-Length: 200000\r\n\r\n" % (self.chat["id"], self.a["token"])).encode() + PNG[:5000]) + import time + time.sleep(1) + self.assertEqual(psql("SELECT count(*) FROM attachments"), before) + + def test_bucket_is_private_outside_the_api(self): + att = upload(self.a["token"], self.chat["id"], PNG)[2] + key = psql("SELECT s3_key FROM attachments WHERE id = '%s'" % att["id"]) + import subprocess + code = ("import urllib.request,urllib.error,sys\n" + "try:\n urllib.request.urlopen('http://seaweedfs:8333/messenger-attachments/%s', timeout=5); print('OPEN')\n" + "except urllib.error.HTTPError as e: print(e.code)\n" % key) + out = subprocess.run(["docker", "compose", "--env-file", ".env", "exec", "-T", "api", "python", "-c", code], cwd=ROOT, + capture_output=True, text=True).stdout.strip() + self.assertEqual(out, "403", "анонимный GET объекта напрямую из S3 должен быть запрещён") + + +if __name__ == "__main__": + unittest.main() diff --git a/student-tests/test_dependencies.py b/student-tests/test_dependencies.py new file mode 100644 index 00000000..7235777c --- /dev/null +++ b/student-tests/test_dependencies.py @@ -0,0 +1,80 @@ +"""Поведение при недоступности зависимостей: Valkey (кэш) и PostgreSQL (источник истины). + + python student-tests/test_dependencies.py +Контейнеры останавливаются и запускаются обратно (volumes сохраняются). Ожидания: + * Valkey остановлен -> кэш обходится, API работает (чтение сессии из PostgreSQL), logout работает; + * PostgreSQL остановлен -> 503 в контрактном формате с Retry-After (не 500, не «анонимный» доступ), + /health/ready = 503, запрос без токена по-прежнему 401; после запуска БД API восстанавливается сам. +""" +import os +import subprocess +import sys +import time +import unittest + +sys.path.insert(0, os.path.dirname(__file__)) +from test_api import ROOT, basic, call, register # noqa: E402 + + +def compose(*args): + return subprocess.run(["docker", "compose", "--env-file", ".env", *args], cwd=ROOT, check=True, capture_output=True, text=True) + + +def wait(predicate, seconds=60): + deadline = time.time() + seconds + while time.time() < deadline: + try: + if predicate(): + return + except Exception: + pass + time.sleep(0.5) + raise RuntimeError("условие не выполнено за %d с" % seconds) + + +class DependencyTest(unittest.TestCase): + def tearDown(self): + compose("start", "postgres", "valkey") + wait(lambda: call("GET", "/health/ready")[0] == 200) + + def test_valkey_down_is_bypassed(self): + actor = register("dep") + self.assertEqual(call("GET", "/api/v1/users/me", token=actor["token"])[0], 200) + compose("stop", "valkey") + started = time.time() + for _ in range(5): + self.assertEqual(call("GET", "/api/v1/users/me", token=actor["token"])[0], 200) + self.assertLess(time.time() - started, 3, "circuit breaker не должен давать каждому запросу ждать таймаут") + # вход и выход работают без кэша + s = call("POST", "/api/v1/auth/sessions", headers=basic(actor["user"]["username"], actor["password"])) + self.assertEqual(s[0], 201) + self.assertEqual(call("DELETE", "/api/v1/auth/sessions/current", token=s[2]["token"])[0], 204) + self.assertEqual(call("GET", "/api/v1/users/me", token=s[2]["token"])[0], 401) # отзыв виден без кэша + self.assertEqual(call("GET", "/health/ready")[0], 200) # кэш не критичен для readiness + + def test_postgres_down_gives_bounded_503_never_anonymous_access(self): + actor = register("dep") + self.assertEqual(call("GET", "/api/v1/users/me", token=actor["token"])[0], 200) # токен в кэше + compose("stop", "postgres") + time.sleep(1) + for method, path, body, token in (("GET", "/api/v1/users/me", None, actor["token"]), + ("GET", "/api/v1/chats", None, actor["token"]), + ("POST", "/api/v1/chats", {"title": "x", "member_ids": [actor["user"]["id"]]}, actor["token"]), + ("GET", "/api/v1/users/me", None, "Z" * 43)): # неизвестный токен: кэш пуст -> БД -> 503 + r = call(method, path, body, token) + self.assertEqual(r[0], 503, (path, r)) + self.assertEqual(r[2]["error"]["code"], "unavailable") + self.assertGreaterEqual(int(r[1]["Retry-After"]), 1) + self.assertEqual(r[2]["error"]["request_id"], r[1]["X-Request-Id"]) + r = call("POST", "/api/v1/auth/sessions", headers=basic(actor["user"]["username"], actor["password"])) + self.assertEqual(r[0], 503) + self.assertEqual(call("GET", "/health/ready")[0], 503) + self.assertEqual(call("GET", "/health/live")[0], 200) + self.assertEqual(call("GET", "/api/v1/users/me")[0], 401) # без токена — по-прежнему 401 + compose("start", "postgres") + wait(lambda: call("GET", "/health/ready")[0] == 200) + self.assertEqual(call("GET", "/api/v1/users/me", token=actor["token"])[0], 200) # сессия пережила простой БД + + +if __name__ == "__main__": + unittest.main() diff --git a/student-tests/test_expiry.py b/student-tests/test_expiry.py new file mode 100644 index 00000000..293fd059 --- /dev/null +++ b/student-tests/test_expiry.py @@ -0,0 +1,69 @@ +"""Проверка срока жизни сессии при коротком SESSION_TTL_SECONDS (по умолчанию 2). + + python student-tests/test_expiry.py +Скрипт пересоздаёт только контейнер api с SESSION_TTL_SECONDS=2, проверяет expiry и возвращает настройки +по умолчанию. Данные и volumes не затрагиваются. +""" +import os +import subprocess +import sys +import time +import unittest + +sys.path.insert(0, os.path.dirname(__file__)) +from test_api import ROOT, call, register # noqa: E402 + +TTL = 2 + + +def compose(*args, env=None): + return subprocess.run(["docker", "compose", "--env-file", ".env", *args], cwd=ROOT, check=True, + capture_output=True, text=True, env=dict(os.environ, **(env or {}))) + + +def wait_ready(seconds=60): + deadline = time.time() + seconds + while time.time() < deadline: + try: + if call("GET", "/health/ready")[0] == 200: + return + except Exception: + pass + time.sleep(0.5) + raise RuntimeError("api не стал ready") + + +class ExpiryTest(unittest.TestCase): + @classmethod + def setUpClass(cls): + compose("up", "-d", "--no-deps", "--force-recreate", "api", env={"SESSION_TTL_SECONDS": str(TTL)}) + wait_ready() + + @classmethod + def tearDownClass(cls): + compose("up", "-d", "--no-deps", "--force-recreate", "api") + wait_ready() + + def test_session_expires_after_ttl(self): + actor = register("exp") + session = actor["session"] + self.assertEqual(call("GET", "/api/v1/users/me", token=actor["token"])[0], 200) # валидна, кэш прогрет + time.sleep(TTL + 1.5) + r = call("GET", "/api/v1/users/me", token=actor["token"]) + self.assertEqual(r[0], 401, "после TTL токен должен быть отвергнут (и кэшем, и БД)") + self.assertEqual(r[1]["WWW-Authenticate"], 'Bearer realm="messenger"') + self.assertEqual(r[2]["error"]["code"], "unauthorized") + self.assertEqual(call("DELETE", "/api/v1/auth/sessions/current", token=actor["token"])[0], 401) + self.assertIn("expires_at", session) + + def test_expiry_is_not_extended_by_use(self): + actor = register("exp") + for _ in range(3): + call("GET", "/api/v1/users/me", token=actor["token"]) + time.sleep(0.5) + time.sleep(1.5) + self.assertEqual(call("GET", "/api/v1/users/me", token=actor["token"])[0], 401) + + +if __name__ == "__main__": + unittest.main() diff --git a/student-tests/test_idempotency.py b/student-tests/test_idempotency.py new file mode 100644 index 00000000..e421a8e9 --- /dev/null +++ b/student-tests/test_idempotency.py @@ -0,0 +1,121 @@ +"""Идемпотентность отправки сообщений (lab3) и распределение по репликам. Запуск: + python student-tests/test_idempotency.py (BASE_URL по умолчанию http://127.0.0.1:8080, через LB) +""" +import os +import sys +import unittest +import uuid +from concurrent.futures import ThreadPoolExecutor +from urllib.parse import quote + +sys.path.insert(0, os.path.dirname(__file__)) +from test_api import call, psql, register # noqa: E402 + + +def chat_with(owner, *others): + ids = [owner["user"]["id"]] + [o["user"]["id"] for o in others] + return call("POST", "/api/v1/chats", {"title": "идемпотентность", "member_ids": ids}, owner["token"])[2] + + +def history(token, chat_id): + items, cursor = [], None + while True: + page = call("GET", "/api/v1/chats/%s/messages?limit=100%s" % (chat_id, "&cursor=" + quote(cursor, safe="") if cursor else ""), token=token)[2] + items += page["items"] + cursor = page["next_cursor"] + if not cursor: + return items + + +class IdempotencyTest(unittest.TestCase): + def setUp(self): + self.a, self.b, self.eve = register(), register(), register() + self.chat = chat_with(self.a, self.b) + self.path = "/api/v1/chats/%s/messages" % self.chat["id"] + + def post(self, actor, body, key, path=None): + return call("POST", path or self.path, body, actor["token"], headers={"Idempotency-Key": key}) + + def test_key_validation(self): + for headers in ({}, {"Idempotency-Key": ""}, {"Idempotency-Key": "a b"}, + {"Idempotency-Key": "x" * 129}, {"Idempotency-Key": "a/b"}): + h = dict(headers) + h.setdefault("Content-Type", "application/json") + r = call("POST", self.path, raw=b'{"text":"x"}', token=self.a["token"], headers=h) + self.assertEqual(r[0], 400, headers) + self.assertEqual(r[2]["error"]["code"], "invalid_request") + self.assertEqual(self.post(self.a, {"text": "ok"}, "A-z_0.9:-" + "k" * 100)[0], 201) + + def test_replay_returns_same_message_and_creates_no_duplicate(self): + key = uuid.uuid4().hex + first = self.post(self.a, {"text": "один раз"}, key) + second = self.post(self.a, {"text": "один раз"}, key) + self.assertEqual((first[0], second[0]), (201, 201)) + self.assertEqual(first[2], second[2]) + self.assertEqual(len([m for m in history(self.b["token"], self.chat["id"]) if m["text"] == "один раз"]), 1) + + def test_different_body_same_key_is_409(self): + key = uuid.uuid4().hex + self.post(self.a, {"text": "первое"}, key) + r = self.post(self.a, {"text": "другое"}, key) + self.assertEqual(r[0], 409) + self.assertEqual(r[2]["error"]["code"], "conflict") + + def test_scope_is_user_and_chat(self): + key = uuid.uuid4().hex + m1 = self.post(self.a, {"text": "общий ключ"}, key)[2] + m2 = self.post(self.b, {"text": "общий ключ"}, key)[2] # другой пользователь + other = chat_with(self.a) + m3 = self.post(self.a, {"text": "общий ключ"}, key, "/api/v1/chats/%s/messages" % other["id"])[2] # другой чат + self.assertEqual(len({m1["id"], m2["id"], m3["id"]}), 3) + + def test_replay_rechecks_session_and_membership(self): + key = uuid.uuid4().hex + self.post(self.a, {"text": "защищено"}, key) + self.assertEqual(self.post(self.eve, {"text": "защищено"}, key)[0], 404) # посторонний + r = call("POST", self.path, {"text": "защищено"}, "Z" * 43, headers={"Idempotency-Key": key}) + self.assertEqual(r[0], 401) # недействительный токен + logout = register() + chat = chat_with(logout) + path = "/api/v1/chats/%s/messages" % chat["id"] + self.post(logout, {"text": "x"}, key, path) + call("DELETE", "/api/v1/auth/sessions/current", token=logout["token"]) + self.assertEqual(call("POST", path, {"text": "x"}, logout["token"], headers={"Idempotency-Key": key})[0], 401) + + def test_semantically_equal_body_is_replayed(self): + key = uuid.uuid4().hex + first = self.post(self.a, {"text": "эквивалент"}, key) + raw = call("POST", self.path, raw=b'{ "text" : "\u044d\u043a\u0432\u0438\u0432\u0430\u043b\u0435\u043d\u0442" }', + token=self.a["token"], headers={"Idempotency-Key": key, "Content-Type": "application/json"}) + self.assertEqual((raw[0], raw[2]), (201, first[2])) + + def test_concurrent_same_key_creates_exactly_one_message_across_replicas(self): + key = uuid.uuid4().hex + with ThreadPoolExecutor(24) as pool: + results = list(pool.map(lambda _: self.post(self.a, {"text": "гонка ключа"}, key), range(24))) + self.assertEqual({r[0] for r in results}, {201}) + self.assertEqual(len({r[2]["id"] for r in results}), 1) + instances = {r[1]["X-Instance-Id"] for r in results} + self.assertGreaterEqual(len(instances), 2, "повторы должны обслуживаться разными репликами: %s" % instances) + found = [m for m in history(self.b["token"], self.chat["id"]) if m["text"] == "гонка ключа"] + self.assertEqual(len(found), 1) + + def test_expired_key_is_reusable_after_ttl(self): + key = uuid.uuid4().hex + first = self.post(self.a, {"text": "ttl"}, key)[2] + psql("UPDATE idempotency_keys SET created_at = now() - interval '25 hours' WHERE idem_key = '%s'" % key) + again = self.post(self.a, {"text": "ttl"}, key) + self.assertEqual(again[0], 201) + self.assertNotEqual(again[2]["id"], first["id"], "после 24 ч ключ считается новым") + + def test_session_is_shared_between_replicas_without_relogin(self): + seen = set() + for _ in range(30): + r = call("GET", "/api/v1/users/me", token=self.a["token"]) + self.assertEqual(r[0], 200) + seen.add(r[1]["X-Instance-Id"]) + self.assertGreaterEqual(len(seen), 2, seen) + + +if __name__ == "__main__": + unittest.main() diff --git a/student-tests/test_s3_failures.py b/student-tests/test_s3_failures.py new file mode 100644 index 00000000..9b13b55e --- /dev/null +++ b/student-tests/test_s3_failures.py @@ -0,0 +1,121 @@ +"""Отказы S3 и согласованность S3 <-> PostgreSQL (уровень 4). Запуск: python student-tests/test_s3_failures.py +Тесты останавливают/запускают контейнеры и пересоздают api с внедрением сбоев (volumes сохраняются). +""" +import json +import os +import subprocess +import sys +import time +import unittest + +sys.path.insert(0, os.path.dirname(__file__)) +from test_api import ROOT, call, psql, register # noqa: E402 +from test_attachments import PNG, download, upload # noqa: E402 + + +def compose(*args, env=None, check=True): + return subprocess.run(["docker", "compose", "--env-file", ".env", *args], cwd=ROOT, capture_output=True, text=True, + env=dict(os.environ, **(env or {})), check=check) + + +def wait(predicate, seconds=90): + deadline = time.time() + seconds + while time.time() < deadline: + try: + if predicate(): + return + except Exception: + pass + time.sleep(1) + raise AssertionError("условие не выполнено за %d с" % seconds) + + +def recreate_api(env=None): + compose("up", "-d", "--no-deps", "--force-recreate", "api", env=env) + wait(lambda: call("GET", "/health/ready")[0] == 200) + time.sleep(3) + + +def reconcile(*args): + out = compose("run", "--rm", "-T", "api", "python", "-m", "app.reconcile", *args).stdout + return json.loads(out[out.index("{"):]) + + +def s3_python(code): + return compose("exec", "-T", "api", "python", "-c", code).stdout.strip() + + +class S3FailureTest(unittest.TestCase): + @classmethod + def tearDownClass(cls): + compose("start", "seaweedfs", check=False) + recreate_api() + + def setUp(self): + compose("start", "seaweedfs", check=False) + wait(lambda: call("GET", "/health/ready")[0] == 200) + self.a = register("s3f") + self.chat = call("POST", "/api/v1/chats", {"title": "s3", "member_ids": [self.a["user"]["id"]]}, self.a["token"])[2] + + def test_s3_down_gives_503_text_path_keeps_working(self): + att = upload(self.a["token"], self.chat["id"], PNG)[2] + count = psql("SELECT count(*) FROM attachments") + compose("stop", "seaweedfs") + r = upload(self.a["token"], self.chat["id"], PNG) + self.assertEqual(r[0], 503, r[2]) + self.assertEqual(r[2]["error"]["code"], "unavailable") + self.assertGreaterEqual(int(r[1]["Retry-After"]), 1) + self.assertEqual(download(self.a["token"], att["id"])[0], 503) + self.assertEqual(download(self.a["token"], att["id"], "")[0], 200) # метаданные — из PostgreSQL + self.assertEqual(call("POST", "/api/v1/chats/%s/messages" % self.chat["id"], {"text": "текст без S3"}, self.a["token"])[0], 201) + self.assertEqual(call("GET", "/health/ready")[0], 200) # readiness не зависит от S3 + self.assertEqual(psql("SELECT count(*) FROM attachments"), count, "неудачная загрузка не должна оставлять метаданные") + compose("start", "seaweedfs") + wait(lambda: download(self.a["token"], att["id"])[0] == 200, 90) + self.assertEqual(upload(self.a["token"], self.chat["id"], PNG)[0], 201) + + def test_db_failure_after_s3_write_is_compensated(self): + recreate_api({"FAULT_INJECTION": "db_after_put"}) + before = reconcile("--grace", "0")["s3_objects"] + r = upload(self.a["token"], self.chat["id"], PNG) + self.assertEqual(r[0], 500) + self.assertEqual(r[2]["error"]["code"], "internal_error") + after = reconcile("--grace", "0") + self.assertEqual(after["s3_objects"], before, "объект должен быть удалён компенсацией") + self.assertEqual(after["orphan_objects_count"], 0) + recreate_api() + + def test_orphan_left_by_failed_compensation_is_found_and_cleaned_safely(self): + keeper = upload(self.a["token"], self.chat["id"], PNG)[2] # используемое вложение + recreate_api({"FAULT_INJECTION": "db_after_put,s3_delete_fails"}) + r = upload(self.a["token"], self.chat["id"], PNG) + self.assertEqual(r[0], 500) + recreate_api() + fresh = reconcile("--grace", "900") # grace period: свежий объект не трогаем + self.assertGreaterEqual(fresh["orphans_skipped_fresh"], 1) + self.assertEqual(fresh["orphan_objects_count"], 0) + dry = reconcile("--grace", "0") # dry-run находит, но не удаляет + self.assertGreaterEqual(dry["orphan_objects_count"], 1) + self.assertEqual(dry["fixed"], {"deleted_orphans": 0, "marked_failed": 0}) + self.assertEqual(reconcile("--grace", "0")["orphan_objects_count"], dry["orphan_objects_count"]) # dry-run ничего не меняет + applied = reconcile("--grace", "0", "--apply") + self.assertEqual(applied["fixed"]["deleted_orphans"], dry["orphan_objects_count"]) + self.assertEqual(reconcile("--grace", "0")["orphan_objects_count"], 0) # повторный запуск идемпотентен + self.assertEqual(download(self.a["token"], keeper["id"])[0], 200, "используемое вложение удалять нельзя") + + def test_missing_object_is_reported_and_attachment_marked_failed(self): + att = upload(self.a["token"], self.chat["id"], PNG)[2] + key = psql("SELECT s3_key FROM attachments WHERE id = '%s'" % att["id"]) + code = ("import asyncio\nfrom app.s3 import S3\nasync def m():\n s=S3(); await s.start(); await s.delete('%s'); await s.stop()\n" + "asyncio.run(m())" % key) + s3_python(code) + dry = reconcile("--grace", "0") + self.assertIn(att["id"], dry["missing_objects"]) + self.assertEqual(psql("SELECT status FROM attachments WHERE id = '%s'" % att["id"]), "ready") # dry-run не меняет + reconcile("--grace", "0", "--apply") + self.assertEqual(psql("SELECT status || ':' || error_code FROM attachments WHERE id = '%s'" % att["id"]), "failed:object_missing") + self.assertEqual(download(self.a["token"], att["id"])[0], 409) + + +if __name__ == "__main__": + unittest.main() diff --git a/student-tests/test_topology.py b/student-tests/test_topology.py new file mode 100644 index 00000000..a3150e98 --- /dev/null +++ b/student-tests/test_topology.py @@ -0,0 +1,58 @@ +"""Проверка топологии стенда (уровень 4): число реплик, отсутствие публикации портов API, лимиты ресурсов, healthcheck, +отсутствие container_name, единая публичная точка входа. Запуск: python student-tests/test_topology.py""" +import json +import subprocess +import unittest + +PROJECT = "mtusi-lab4" + + +def sh(*args): + return subprocess.run(args, capture_output=True, text=True, encoding="utf-8").stdout.strip() + + +def containers(service): + ids = sh("docker", "ps", "-q", "--filter", "label=com.docker.compose.project=" + PROJECT, + "--filter", "label=com.docker.compose.service=" + service).split() + return [json.loads(sh("docker", "inspect", i))[0] for i in ids] + + +class TopologyTest(unittest.TestCase): + def test_at_least_two_api_replicas_without_published_ports(self): + api = containers("api") + self.assertGreaterEqual(len(api), 2) + for c in api: + self.assertFalse([p for p in c["HostConfig"]["PortBindings"] or {}], "реплика API публикует порт в обход LB") + self.assertEqual(c["State"]["Health"]["Status"], "healthy") + + def test_only_lb_is_published_and_only_on_localhost(self): + published = {} + for service in ("api", "postgres", "valkey", "lb", "seaweedfs"): + for c in containers(service): + for port, binds in (c["HostConfig"]["PortBindings"] or {}).items(): + published.setdefault(service, []).extend((port, b["HostIp"], b["HostPort"]) for b in binds) + self.assertEqual(list(published), ["lb"], published) + self.assertEqual(published["lb"], [("8080/tcp", "127.0.0.1", "8080")]) + + def test_resource_limits_are_set(self): + for service in ("api", "postgres", "valkey", "lb", "seaweedfs"): + for c in containers(service): + self.assertGreater(c["HostConfig"]["Memory"], 0, service) + self.assertGreater(c["HostConfig"]["NanoCpus"], 0, service) + + def test_no_fixed_container_names(self): + for c in containers("api"): + labels = c["Config"]["Labels"] + self.assertEqual(c["Name"].lstrip("/"), "%s-api-%s" % (PROJECT, labels["com.docker.compose.container-number"])) + + def test_api_runs_as_non_root(self): + for c in containers("api"): + self.assertEqual(c["Config"]["User"], "10001:10001") + + def test_stop_grace_period_covers_drain(self): + for c in containers("api"): + self.assertGreaterEqual(c["Config"].get("StopTimeout", 10), 15) + + +if __name__ == "__main__": + unittest.main() -- 2.54.0 From 0150b91ec04cf22a7d0a355dad869eb4e2e03d27 Mon Sep 17 00:00:00 2001 From: kolya5544 Date: Wed, 11 Nov 2026 18:25:57 +0300 Subject: [PATCH 2/3] fix(lab4): preserve error contract and verify storage consistency --- REPORT.md | 99 +++++++---- docs/pull_request_lab4.md | 48 +++++ docs/report_lab4.docx | Bin 40012 -> 40432 bytes evidence/checks_2026-11-11.txt | 167 ++++++++++++++++++ evidence/checks_before_fix_2026-11-11.txt | 159 +++++++++++++++++ evidence/recheck_2026-11-11/commands.txt | 116 ++++++++++++ .../commands_before_client_fix.txt | 42 +++++ evidence/recheck_2026-11-11/lifecycle.json | 116 ++++++++++++ .../recheck_2026-11-11/source_metadata.json | 51 ++++++ .../recheck_2026-11-11/track2_reconcile.json | 98 ++++++++++ .../recheck_2026-11-11/upload_memory.json | 62 +++++++ infra/haproxy/haproxy.cfg | 14 +- research/reconcile_bench.py | 41 ++++- research/requirements.txt | 2 + research/upload_memory.py | 13 +- student-tests/README.md | 44 +++++ student-tests/test_dependencies.py | 4 +- student-tests/test_s3_failures.py | 10 ++ 18 files changed, 1051 insertions(+), 35 deletions(-) create mode 100644 docs/pull_request_lab4.md create mode 100644 evidence/checks_2026-11-11.txt create mode 100644 evidence/checks_before_fix_2026-11-11.txt create mode 100644 evidence/recheck_2026-11-11/commands.txt create mode 100644 evidence/recheck_2026-11-11/commands_before_client_fix.txt create mode 100644 evidence/recheck_2026-11-11/lifecycle.json create mode 100644 evidence/recheck_2026-11-11/source_metadata.json create mode 100644 evidence/recheck_2026-11-11/track2_reconcile.json create mode 100644 evidence/recheck_2026-11-11/upload_memory.json create mode 100644 research/requirements.txt create mode 100644 student-tests/README.md diff --git a/REPORT.md b/REPORT.md index 3db8cc1b..62fe4f95 100644 --- a/REPORT.md +++ b/REPORT.md @@ -1,9 +1,9 @@ # Отчёт — лабораторная 4 -- Автор, группа: [ФИО], [группа] +- Автор, группа: Кушнаренко Николай Вячеславович, БПИ2302 - Целевая оценка; выбранный трек 5, если нужен: **5**, трек 2 «Согласованность двух хранилищ» -- Commit/PR: локальный коммит ветки `solution/lab4`; PR — после публикации -- Использованные источники, библиотеки и помощь ИИ: Python 3.12, uvicorn, asyncpg, aiobotocore (S3), Pillow (проверка изображений), argon2-cffi; SeaweedFS 4.48 (S3); HAProxy; PostgreSQL; Valkey. Код lab3 перенесён. Использование ИИ: [заполняется автором] +- Commit/PR: ветка `solution/bpi2302-kushnarenko` в [форке kolya](https://gitea.privcloud.tech/kolya/mtusi2026lab4); ссылка на PR добавляется после открытия +- Использованные источники, библиотеки и помощь ИИ: Python 3.12, uvicorn, asyncpg, aiobotocore (S3), Pillow (проверка изображений), argon2-cffi; SeaweedFS 4.48 (S3); HAProxy; PostgreSQL; Valkey. Код lab3 перенесён. ИИ-ассистенты использовались для помощи с кодом, тестами и отчётом; Codex проверил подготовку к сдаче, усилил проверки исследования и выполнил реальные запуски 11.11.2026 ## Запуск из чистого clone @@ -23,12 +23,16 @@ sh scripts/restore-replicas.sh # собственные тесты (стенд должен быть запущен) python3 -m unittest discover -s student-tests -p "test_api.py" -v python3 -m unittest discover -s student-tests -p "test_attachments.py" -v -python3 student-tests/test_idempotency.py ; python3 student-tests/test_topology.py ; python3 student-tests/test_s3_failures.py +python3 student-tests/test_idempotency.py +python3 student-tests/test_topology.py +python3 student-tests/test_s3_failures.py +python3 student-tests/test_expiry.py +python3 student-tests/test_dependencies.py ``` Windows: `scripts/restart.cmd` и `scripts/stop-one.cmd` вместо `.sh`. Остановка с сохранением данных — `docker compose --env-file .env stop`; **намеренное удаление учебных данных** — `docker compose --env-file .env down -v` (volumes `pgdata`, `valkeydata`, `seaweeddata`). -**Выбор S3-сервера.** Образы MinIO в Docker Hub (`minio/minio`, `minio/mc`) недоступны для скачивания на момент выполнения (репозиторий не найден, проверено `docker pull`), поэтому воспроизводимый стенд построен на **SeaweedFS** (разрешён README): образ закреплён тегом и digest. SeaweedFS запускается одним процессом (`weed server -filer -s3`), права задаются файлом identities (`secrets/seaweed_s3.json`). +**Выбор S3-сервера.** Используется **SeaweedFS**, разрешённый заданием. Образ закреплён тегом и digest. SeaweedFS запускается одним процессом (`weed server -filer -s3`), права задаются файлом identities (`secrets/seaweed_s3.json`). ## Архитектура и решения @@ -63,44 +67,79 @@ Windows: `scripts/restart.cmd` и `scripts/stop-one.cmd` вместо `.sh`. О **Reconciler** (`src/app/reconcile.py`): по умолчанию **dry-run**; сравнивает `attachments.s3_key` и листинг bucket. Находит: *orphan_object* (объект без строки; удаляется только если старше `grace` — по умолчанию 900 с, поэтому свежая, ещё не зафиксированная загрузка не затрагивается), *missing_object* (строка `ready` без объекта → `failed/object_missing`, **строка не удаляется**, сообщения сохраняются, скачивание даёт 409), *size_mismatch* (размер объекта ≠ `size_bytes` → `failed/size_mismatch`). Объект, у которого есть строка в БД, не удаляется никогда; перед удалением выполняется повторная проверка строки. Повторный запуск идемпотентен. -## Доказательства критериев +### Исправление отказа общей БД при подготовке к сдаче -| Критерий README | Команда/сценарий | Наблюдаемый результат | Файл доказательства | -| --- | --- | --- | --- | -| Smoke lab4 (загрузка, checksum, чужой пользователь) | `tests/smoke.py` | PASS | `evidence/checks.txt` | -| Байты в приватном bucket, метаданные в PostgreSQL | описание; `test_bucket_is_private_outside_the_api` | анонимный GET объекта из сети стенда → 403; в БД нет bytea | `evidence/checks.txt` | -| PNG/JPEG ≤10 MiB, ≤40 млн px, MIME по содержимому, опасный filename | `student-tests/test_attachments.py` | 11 тестов OK (413, 415 ×9 вариантов, 400 ×8 вариантов filename) | `evidence/checks.txt` | -| Upload → остановка реплики → download через другую; restart с сохранением volumes | `tests/resilience.py` failover ×2 и persistence | PASS; `StartedAt` seaweedfs/postgres/valkey/api изменился | `evidence/checks.txt` | -| Отдельные тесты (слишком большой, повреждённый, подмена MIME, чужое attachment_id, вложение другого чата) | `test_attachments.py` | OK; ни один случай не приводит к 500 | `evidence/checks.txt` | -| Прерывание загрузки / отказ между S3 и БД: компенсация и сверка | `test_s3_failures.py` | 4 теста OK: компенсация, orphan при неудачной компенсации (dry-run/apply/grace), missing object, отказ S3 | `evidence/checks.txt` | -| ≥10 одновременных загрузок, пик памяти | `research/upload_memory.py` | 12 клиентов × 8.7 MiB: **пик RSS 99 / 116 / 123 MiB** при `UPLOAD_CONCURRENCY` 1 / 4 / 12 (старт процесса 94 MiB, лимит контейнера 256 MiB); все 12 файлов приняты и скачиваются побайтно; `OOMKilled=false` | `evidence/upload_memory.json` | -| Bootstrap идемпотентен, отдельные ключи API с ограниченными правами, консоль не открыта, bucket private | `s3-init`; `docker compose logs s3-init` | повторный запуск: «bucket уже существует», анонимный доступ 403, ключ API не может создать bucket (`AccessDenied`) | логи `s3-init` | -| Лимиты и потоковая обработка | описание; `upload_memory.json` | размер/пиксели проверяются до распаковки; тело не буферизуется целиком | `src/app/attachments.py`, `images.py` | -| **Трек 2** | `research/reconcile_bench.py` | см. ниже | `evidence/track2_reconcile.json` | +В первом повторе 11.11.2026 тест остановки PostgreSQL обнаружил ответ вне JSON-контракта: после отрицательного readiness всех реплик HAProxy отдавал собственную ошибку вместо ответа приложения. Добавлен резервный backend по liveness, используемый только при отсутствии ready-реплик. Теперь живое приложение возвращает 503 с Retry-After и X-Request-Id, сохраняет 401 для запроса без токена и 200 для /health/live. Основная маршрутизация по readiness сохранена. Тест ждёт 5 с после остановки БД, чтобы гарантированно покрыть состояние после healthcheck балансировщика. + +Также автоматические повторы HAProxy ограничены ошибкой установления соединения: ответ/таймаут уже отправленного upload POST не повторяется, поскольку контракт не делает загрузку идемпотентной. Описание директив: [HAProxy 3.0 Configuration Manual](https://docs.haproxy.org/3.0/configuration.html). Первичный сбой сохранён в `evidence/checks_before_fix_2026-11-11.txt`; полный итоговый прогон — в `evidence/checks_2026-11-11.txt`. + +## Доказательства критериев — повторная проверка 11.11.2026 + +Проверены текущая ветка решения и исходный skeleton `ec540a1`. README задания, COURSE, CONTRIBUTING, публичные `tests/` и `contracts/` сохранены без изменений. Команды и фактический вывод: [evidence/checks_2026-11-11.txt](evidence/checks_2026-11-11.txt). В Windows выполнены Python-команды, соответствующие `make check`, `make validate` и `make test`; GNU Make для проверки не требуется. + +| Критерий | Проверка | Результат | +| --- | --- | --- | +| Контракт и публичный сценарий | check_contract, validate_openapi, smoke | PASS | +| API, авторизация и идемпотентность между репликами | test_api + test_idempotency | 12 + 9 тестов OK | +| Изображения, лимиты, MIME, filename, ACL, чужой чат, прерывание upload, private bucket | test_attachments | 11 тестов OK; пользовательские ошибки не дают 500; анонимный S3 GET → 403 | +| Реплики, порты, лимиты, непривилегированный пользователь | test_topology | 6 тестов OK | +| Компенсация, dry-run/apply, свежие orphan, используемые вложения, отказ S3 | test_s3_failures | 4 теста OK; защищённый файл связан с сообщением, ссылка сохранена | +| Истечение сессии, недоступность PostgreSQL и Valkey | test_expiry + test_dependencies | 2 + 2 теста OK | +| Сохранность при restart и остановке обслужившей реплики | tests/resilience.py | persistence/failover PASS; восстановление записи 2.329 с, 105 успешных записей, 0 неуспешных попыток | +| Идемпотентный bootstrap, отдельные ограниченные ключи API | два повторных запуска s3-init | существующий bucket сохранён; anonymous → 403; create_bucket ключом API → AccessDenied | +| ≥10 параллельных загрузок и пик памяти | research/upload_memory.py | 12 клиентов; все файлы приняты и SHA-256 совпали; OOM нет | +| Трек 2: обнаружение и исправление расхождений, стоимость обхода | research/reconcile_bench.py | 20 orphan / 20 missing / 5 size mismatch; безопасное исправление и повтор без изменений | + +Всего **46 собственных тестов**. После экспериментов дополнительно повторены persistence и smoke. В [lifecycle.json](evidence/recheck_2026-11-11/lifecycle.json) зафиксировано изменение StartedAt всех сервисов (включая обе API-реплики и S3), сохранение имён volumes и healthy после restart. ## Эксперименты и отказы (трек 2) -**Гипотеза.** Reconciler обнаруживает ровно внедрённые расхождения в обе стороны, в режиме dry-run ничего не меняет, при apply исправляет только безопасное (осиротевшие объекты старше grace; повреждённые/потерянные вложения помечает failed), не затрагивает свежие и используемые вложения, повторяется идемпотентно, а стоимость обхода линейна по числу объектов. +**Гипотеза.** Reconciler находит внедрённые расхождения в обе стороны; dry-run ничего не меняет; apply удаляет только старые объекты без строки в БД, помечает потерянные/повреждённые вложения failed и сохраняет свежие объекты и файлы сообщений. Повтор apply не вносит изменений. Стоимость полного обхода увеличивается с числом объектов. -**Методика** (`research/reconcile_bench.py`): ≈15 000 вложений (мелкие PNG, загружены через API); внедрено на **обеих сторонах**: 20 осиротевших объектов в S3, у 20 вложений удалён объект в S3, у 5 вложений объект подменён по размеру; после паузы > grace (5 с) — dry-run дважды, затем `--apply --grace 5` **параллельно с загрузкой 200 новых вложений**, затем повторный apply. Проверки: количество найденного, неизменность при dry-run, целостность 200 используемых и 200 свежих вложений (скачивание, sha256). +**Методика и окружение.** Windows, Docker Desktop с Linux-контейнерами, Python клиента 3.11.9, aiohttp 3.14.3, Pillow 12.3.0; приложение — Python 3.12.12. Образы и лимиты закреплены в compose.yaml. Во время исследования на машине оставался другой Docker-проект; абсолютные времена зависят от фоновой нагрузки. Один измерительный прогон на точку, статистическая значимость различий не оценивалась. Команды воспроизведения — [student-tests/README.md](student-tests/README.md). -| Показатель | Результат | +В клиенте исследования сверки отключено повторное использование HTTP-соединений: блокирующий вызов Docker мог длиться дольше keep-alive сервера, и первая попытка остановилась с ServerDisconnectedError до внедрения расхождений. После исправления выполнен полный повтор сверки; исходный вывод сохранён в `evidence/recheck_2026-11-11/commands_before_client_fix.txt`. Замеры памяти не повторялись: они завершились успешно и не зависели от этого клиента. SHA-256 проверенных исходников записаны в `source_metadata.json` рядом с результатами. + +### Память при одновременных загрузках + +12 клиентов загружают по 8.73 MiB PNG (шум 1700×1700). Для каждой точки создаётся одна новая API-реплика, 1 CPU / 256 MiB; меняется только UPLOAD_CONCURRENCY. Пик — VmHWM процесса API, это не суммарная память всех контейнеров. После измерения каждый принятый файл скачивается и проверяется SHA-256. В конце восстановлены две реплики с UPLOAD_CONCURRENCY=4. + +| UPLOAD_CONCURRENCY | Пик RSS, MiB | Загрузка всех файлов, с | Принято и цело | OOMKilled | +| --- | --- | --- | --- | --- | +| 1 | 99.2 | 1.31 | 12/12 | false | +| 4 | 119.0 | 1.18 | 12/12 | false | +| 12 | 121.2 | 1.14 | 12/12 | false | + +### Сверка двух хранилищ + +К существующим синтетическим данным добавлены 3000 вложений тремя порциями по 1000. После каждой порции измерен dry-run. Затем созданы 20 orphan в S3, удалены объекты 20 существующих вложений и изменён размер ещё 5. **200 других вложений прикреплены к 20 сообщениям** (по 10); перед исправлением сохранены идентификаторы сообщений и их attachment_ids. + +После паузы больше 5 с выполняются два dry-run, затем apply с grace=5 параллельно с задачей загрузки 200 новых файлов, затем повторный apply. Рабочее значение grace — 900 с; короткий grace используется только в эксперименте. Отдельный тест детерминированно оставляет свежий orphan и подтверждает, что `--apply --grace 900` его не удаляет. + +| Проверка | Фактический результат | | --- | --- | -| dry-run нашёл | 20 orphan, 20 missing, 5 size_mismatch — **ровно внедрённое**; два dry-run дают одинаковый отчёт, `fixed = 0/0` | -| apply (grace 5 с) | удалено 20 осиротевших объектов; 25 вложений помечены `failed` (`object_missing`=20, `size_mismatch`=5) | -| Свежие загрузки во время apply | 200 из 200 принято и скачивается побайтно | -| Используемые вложения | 200 из 200 целы (sha256 совпадает) | -| Повторный apply | изменений 0 (идемпотентно) | -| Стоимость обхода (dry-run) | 13 271 объект → 2.17 с; 14 271 → 2.34 с; 15 271 → 2.50 с (из них листинг S3 ≈ 96 %, запрос к БД 13 мс) — **≈0.16 мс на объект**, линейно; на меньшем наборе (1–3 тыс. объектов, предварительный прогон) 0.28–0.59 с | +| dry-run ×2 | ровно 20 orphan, 20 missing, 5 size mismatch; fixed=0/0; повторяемо | +| apply | удалено 20 старых orphan, 25 строк помечены failed (20 object_missing, 5 size_mismatch) | +| Новые загрузки | 200/200 приняты и скачаны с совпадающей SHA-256 | +| Вложения сообщений | 200/200 целы; все 20 сообщений и attachment_ids неизменны | +| Повтор apply | 0 удалений, 0 изменений статусов, новых расхождений нет | -**Границы.** Reconciler сверяет только наличие и размер, не содержимое (содержимое подтверждает sha256 из БД при скачивании на стороне клиента); обход листингом S3 — O(число объектов), для очень больших бакетов нужен инкрементальный обход по префиксам/времени. Если объект удалён, восстановить байты нельзя — вложение остаётся в БД как `failed`. Grace period выбирается больше максимального времени загрузки + таймаутов (здесь 900 с против лимита чтения 15 с). Ограничение: измерения на одном ноутбуке, S3 — один узел SeaweedFS без репликации. +| Строк БД | Объектов S3 | Запрос БД, мс | Листинг S3, мс | Весь обход, мс | +| --- | --- | --- | --- | --- | +| 19554 | 19530 | 20.2 | 3540.6 | 3649.4 | +| 20554 | 20530 | 19.0 | 3697.2 | 3806.4 | +| 21554 | 21530 | 21.2 | 3939.1 | 4055.0 | + +На проверенном наборе основную стоимость даёт листинг S3; результаты трёх точек не доказывают линейное время на произвольном объёме. Алгоритм хранит снимки метаданных и листинга в памяти: время и дополнительная память — O(N). Сырой результат: [upload_memory.json](evidence/recheck_2026-11-11/upload_memory.json), [track2_reconcile.json](evidence/recheck_2026-11-11/track2_reconcile.json); вывод команд — [commands.txt](evidence/recheck_2026-11-11/commands.txt). + +**Границы.** Сверяются наличие и размер, но не содержимое S3-объектов: подмена байтов без изменения размера этим reconciler не обнаруживается. Целостность контрольных файлов подтверждает скачивание с SHA-256. Потерянные байты не восстанавливаются, строка остаётся failed. Grace должен превышать время загрузки и таймаутов; для рабочих запусков принят 900 с. S3 и PostgreSQL — по одному узлу. Старые октябрьские результаты сохранены в `evidence/checks.txt`, `evidence/upload_memory.json` и `evidence/track2_reconcile.json`; текущие выводы опираются на повтор 11.11.2026. ### Отказы | Воздействие | Что ожидаем | Что наблюдали | Время восстановления / потеря данных | | --- | --- | --- | --- | | Остановка S3 | загрузка/скачивание 503 + `Retry-After`, текст работает, ready=200 | OK (`test_s3_down…`) | после старта S3 — сразу; метаданные не накапливают «битых» строк | -| Остановка одной реплики после upload | файл скачивается другой репликой | failover PASS ×2 (восстановление записи 2.3 с) | потерь нет | +| Остановка одной реплики после upload | файл скачивается другой репликой | failover PASS (восстановление записи 2.329 с) | потерь нет | | Рестарт всего стенда | метаданные и оригинал на месте | persistence PASS | < 90 с | | Сбой БД после записи в S3 | объект не остаётся | удаляется компенсацией; при сбое компенсации — reconciler | потерь подтверждённых данных нет | @@ -108,4 +147,4 @@ Windows: `scripts/restart.cmd` и `scripts/stop-one.cmd` вместо `.sh`. О - Один узел S3 и один PostgreSQL (SPOF); репликации нет. Загрузка проксируется через API (прямые подписанные URL не реализованы — трек 1 не выбран). - Проверка содержимого JPEG — декодирование в режиме draft (1/8), PNG — потоковая проверка; полная валидация пикселей не выполняется (это не нужно для отдачи оригинала). -- Подтверждено экспериментом: обнаружение/исправление расхождений, защита свежих и используемых вложений, линейная стоимость обхода, ограничение памяти при 12 одновременных загрузках. Гипотеза без доказательства: поведение reconciler на бакетах > 100 тыс. объектов. +- Подтверждено экспериментом: обнаружение/исправление расхождений, защита свежих и используемых вложений, стоимость обхода на трёх размерах набора, ограничение памяти при 12 одновременных загрузках. Гипотеза без доказательства: поведение reconciler на бакетах > 100 тыс. объектов. diff --git a/docs/pull_request_lab4.md b/docs/pull_request_lab4.md new file mode 100644 index 00000000..b6a53b4a --- /dev/null +++ b/docs/pull_request_lab4.md @@ -0,0 +1,48 @@ +## Лабораторная 4 + +Автор / группа: Кушнаренко Николай Вячеславович, БПИ2302 +Целевая оценка (3/4/5): 5 +Трек 5, если заявлен: Трек 2 — согласованность двух хранилищ + +Что реализовано и что перенесено: +Из ЛР3 перенесены PostgreSQL, сессии, Valkey, HAProxy, две API-реплики, идемпотентность сообщений, миграции и сценарии отказов. Добавлены приватное S3-хранилище SeaweedFS, метаданные вложений в PostgreSQL, binary upload PNG/JPEG и авторизованный download через API с побайтной сохранностью. Ограничения: 10 MiB, 40 млн пикселей, проверка MIME по содержимому и безопасного filename, потоковая обработка и лимит параллельных загрузок. Реализованы attachment_ids в сообщениях, компенсация ошибки между S3/БД и reconciler с dry-run, grace period и повторным безопасным запуском. Bootstrap идемпотентен, API использует отдельные ключи с ограниченными правами. Исправлена маршрутизация HAProxy при отказе общей БД: даже после снятия ready всех реплик живые API сохраняют контракт ошибок и liveness; повтор отправленного upload POST отключён. + +Команды запуска из чистого clone (bash / Git Bash): + +```sh +sh scripts/init-secrets.sh +cp .env.example .env +docker compose --env-file .env config --quiet +docker compose --env-file .env up -d --build +python3 scripts/check_contract.py +python3 tests/smoke.py --base-url http://127.0.0.1:8080 +python3 tests/resilience.py --mode persistence --action-script scripts/restart.sh --base-url http://127.0.0.1:8080 +python3 tests/resilience.py --mode failover --action-script scripts/stop-one.sh --base-url http://127.0.0.1:8080 +sh scripts/restore-replicas.sh +``` +На Windows: PYTHONUTF8=1 и hooks scripts/restart.cmd, scripts/stop-one.cmd. Полная инструкция, собственные тесты и эксперименты — в [REPORT.md](https://gitea.privcloud.tech/kolya/mtusi2026lab4/src/branch/solution/bpi2302-kushnarenko/REPORT.md) и [student-tests/README.md](https://gitea.privcloud.tech/kolya/mtusi2026lab4/src/branch/solution/bpi2302-kushnarenko/student-tests/README.md). + +Результаты проверок (повтор 11.11.2026): + +- check_contract, полная валидация OpenAPI и публичный smoke — PASS; +- 46 собственных тестов — OK: авторизация, идемпотентность, вложения/ACL, топология, отказы S3/БД/кэша, TTL сессий; +- persistence и failover — PASS; восстановление записи 2.329 с, 105 успешных записей, 0 неуспешных попыток; сохранность оригинала проверена по SHA-256; +- bootstrap дважды — OK: анонимный доступ 403, создание bucket ключом API запрещено; +- 12 параллельных загрузок по 8.73 MiB: пик RSS 99.2–121.2 MiB при лимите 256 MiB; все файлы целы, OOM нет; +- трек 2: обнаружены ровно 20 orphan / 20 missing / 5 size mismatch; dry-run ничего не меняет; apply удаляет 20 старых orphan и помечает 25 строк failed; повтор без изменений; +- свежий orphan защищён grace period; 200 новых файлов и 200 вложений в 20 сообщениях сохранены, attachment_ids неизменны. Стоимость обхода: 19530 объектов → 3.65 с; 20530 объектов → 3.81 с; 21530 объектов → 4.05 с. + +Доказательства: [checks_2026-11-11.txt](https://gitea.privcloud.tech/kolya/mtusi2026lab4/src/branch/solution/bpi2302-kushnarenko/evidence/checks_2026-11-11.txt), [JSON и команды исследований](https://gitea.privcloud.tech/kolya/mtusi2026lab4/src/branch/solution/bpi2302-kushnarenko/evidence/recheck_2026-11-11), отчёт [REPORT.md](https://gitea.privcloud.tech/kolya/mtusi2026lab4/src/branch/solution/bpi2302-kushnarenko/REPORT.md) и [Word](https://gitea.privcloud.tech/kolya/mtusi2026lab4/src/branch/solution/bpi2302-kushnarenko/docs/report_lab4.docx). + +Ограничения / известные ошибки: +S3 и PostgreSQL работают по одному узлу; потерянные байты reconciler не восстанавливает. Сверяется наличие и размер, подмена содержимого при том же размере не обнаруживается. Полный обход требует O(N) времени и памяти. Замеры сделаны на одном компьютере, по одному прогону на точку, с фоновой нагрузкой другого Docker-проекта. Прямой presigned upload не реализован — выбран трек 2. + +Источники и использование ИИ: +Python, uvicorn, asyncpg, aiobotocore, Pillow, argon2-cffi, SeaweedFS, PostgreSQL, Valkey, HAProxy; первичные материалы — в README задания. ИИ-ассистенты использовались для помощи с кодом, тестами и отчётом; Codex выполнил проверку подготовки к сдаче, усилил доказательства исследования и проверил результаты реальными запусками. + +- [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. +- [x] Контракт и публичные тесты не ослаблены. +- [x] make check и make test выполнены через эквивалентные Python-команды; приложен реальный вывод. +- [x] Сценарии отказов/безопасности своего уровня воспроизведены. +- [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. +- [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения. diff --git a/docs/report_lab4.docx b/docs/report_lab4.docx index f1aac99e9fd5a473ad7bcf6c022a525aee8c54a5..d1526929ca86b4f26cfdf244370da48ffb0cdef7 100644 GIT binary patch delta 5276 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 b_wj?%@+d*k2*mGH3WRVTKDs~h@0I=sVP~Bm delta 4932 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 C=;V6< diff --git a/evidence/checks_2026-11-11.txt b/evidence/checks_2026-11-11.txt new file mode 100644 index 00000000..50f43cf1 --- /dev/null +++ b/evidence/checks_2026-11-11.txt @@ -0,0 +1,167 @@ +$ python scripts/check_contract.py +PASS: offline skeleton structure, local refs and Python syntax; application NOT tested. +exit=0 + +$ python scripts/validate_openapi.py +PASS: full OpenAPI 3.1 and JSON Schema validation; application NOT tested. +exit=0 + +$ python tests/smoke.py --base-url http://127.0.0.1:8080 +PASS: lab4 public API scenario; infrastructure and grading evidence remain separate. +exit=0 + +$ python -m unittest discover -s student-tests -p test_api.py -v +test_bearer_rules (test_api.AuthTest.test_bearer_rules) ... ok +test_concurrent_registration_of_same_username (test_api.AuthTest.test_concurrent_registration_of_same_username) ... ok +test_logout_revokes_in_database_and_cache (test_api.AuthTest.test_logout_revokes_in_database_and_cache) ... ok +test_password_is_not_exposed_or_stored_plain (test_api.AuthTest.test_password_is_not_exposed_or_stored_plain) ... ok +test_register_validation (test_api.AuthTest.test_register_validation) ... ok +test_session_shape_entropy_and_logout (test_api.AuthTest.test_session_shape_entropy_and_logout) ... ok +test_token_only_stored_as_hash (test_api.AuthTest.test_token_only_stored_as_hash) ... ok +test_wrong_password_and_unknown_user_are_indistinguishable (test_api.AuthTest.test_wrong_password_and_unknown_user_are_indistinguishable) ... ok +test_chat_creation_is_atomic (test_api.DataTest.test_chat_creation_is_atomic) ... ok +test_foreign_chat_empty_message_bad_json (test_api.DataTest.test_foreign_chat_empty_message_bad_json) ... ok +test_multi_page_history_and_cursor_binding (test_api.DataTest.test_multi_page_history_and_cursor_binding) ... ok +test_parallel_writes_from_many_clients (test_api.DataTest.test_parallel_writes_from_many_clients) ... ok + +---------------------------------------------------------------------- +Ran 12 tests in 2.711s + +OK +exit=0 + +$ python -m unittest discover -s student-tests -p test_idempotency.py -v +test_concurrent_same_key_creates_exactly_one_message_across_replicas (test_idempotency.IdempotencyTest.test_concurrent_same_key_creates_exactly_one_message_across_replicas) ... ok +test_different_body_same_key_is_409 (test_idempotency.IdempotencyTest.test_different_body_same_key_is_409) ... ok +test_expired_key_is_reusable_after_ttl (test_idempotency.IdempotencyTest.test_expired_key_is_reusable_after_ttl) ... ok +test_key_validation (test_idempotency.IdempotencyTest.test_key_validation) ... ok +test_replay_rechecks_session_and_membership (test_idempotency.IdempotencyTest.test_replay_rechecks_session_and_membership) ... ok +test_replay_returns_same_message_and_creates_no_duplicate (test_idempotency.IdempotencyTest.test_replay_returns_same_message_and_creates_no_duplicate) ... ok +test_scope_is_user_and_chat (test_idempotency.IdempotencyTest.test_scope_is_user_and_chat) ... ok +test_semantically_equal_body_is_replayed (test_idempotency.IdempotencyTest.test_semantically_equal_body_is_replayed) ... ok +test_session_is_shared_between_replicas_without_relogin (test_idempotency.IdempotencyTest.test_session_is_shared_between_replicas_without_relogin) ... ok + +---------------------------------------------------------------------- +Ran 9 tests in 1.920s + +OK +exit=0 + +$ python -m unittest discover -s student-tests -p test_attachments.py -v +test_aborted_upload_leaves_nothing (test_attachments.AttachmentTest.test_aborted_upload_leaves_nothing) ... ok +test_bucket_is_private_outside_the_api (test_attachments.AttachmentTest.test_bucket_is_private_outside_the_api) ... ok +test_corrupted_and_spoofed_files_are_415_not_500 (test_attachments.AttachmentTest.test_corrupted_and_spoofed_files_are_415_not_500) ... ok +test_dangerous_filenames_are_400 (test_attachments.AttachmentTest.test_dangerous_filenames_are_400) ... ok +test_decompression_bomb_header_is_413 (test_attachments.AttachmentTest.test_decompression_bomb_header_is_413) ... ok +test_empty_body_is_400 (test_attachments.AttachmentTest.test_empty_body_is_400) ... ok +test_foreign_user_cannot_upload_read_or_download (test_attachments.AttachmentTest.test_foreign_user_cannot_upload_read_or_download) ... ok +test_idempotent_replay_with_attachments (test_attachments.AttachmentTest.test_idempotent_replay_with_attachments) ... ok +test_message_with_attachments_and_chat_binding (test_attachments.AttachmentTest.test_message_with_attachments_and_chat_binding) ... ok +test_png_and_jpeg_roundtrip_with_checksum (test_attachments.AttachmentTest.test_png_and_jpeg_roundtrip_with_checksum) ... ok +test_too_large_is_413_and_nothing_is_stored (test_attachments.AttachmentTest.test_too_large_is_413_and_nothing_is_stored) ... ok + +---------------------------------------------------------------------- +Ran 11 tests in 4.285s + +OK +exit=0 + +$ python -m unittest discover -s student-tests -p test_topology.py -v +test_api_runs_as_non_root (test_topology.TopologyTest.test_api_runs_as_non_root) ... ok +test_at_least_two_api_replicas_without_published_ports (test_topology.TopologyTest.test_at_least_two_api_replicas_without_published_ports) ... ok +test_no_fixed_container_names (test_topology.TopologyTest.test_no_fixed_container_names) ... ok +test_only_lb_is_published_and_only_on_localhost (test_topology.TopologyTest.test_only_lb_is_published_and_only_on_localhost) ... ok +test_resource_limits_are_set (test_topology.TopologyTest.test_resource_limits_are_set) ... ok +test_stop_grace_period_covers_drain (test_topology.TopologyTest.test_stop_grace_period_covers_drain) ... ok + +---------------------------------------------------------------------- +Ran 6 tests in 1.649s + +OK +exit=0 + +$ python -m unittest discover -s student-tests -p test_s3_failures.py -v +test_db_failure_after_s3_write_is_compensated (test_s3_failures.S3FailureTest.test_db_failure_after_s3_write_is_compensated) ... ok +test_missing_object_is_reported_and_attachment_marked_failed (test_s3_failures.S3FailureTest.test_missing_object_is_reported_and_attachment_marked_failed) ... ok +test_orphan_left_by_failed_compensation_is_found_and_cleaned_safely (test_s3_failures.S3FailureTest.test_orphan_left_by_failed_compensation_is_found_and_cleaned_safely) ... ok +test_s3_down_gives_503_text_path_keeps_working (test_s3_failures.S3FailureTest.test_s3_down_gives_503_text_path_keeps_working) ... ok + +---------------------------------------------------------------------- +Ran 4 tests in 189.512s + +OK +exit=0 + +$ python tests/resilience.py --mode persistence --action-script scripts/restart.cmd --base-url http://127.0.0.1:8080 +Executing explicit persistence hook; hook output suppressed to avoid leaking secrets. +PASS: persistence preserved confirmed data and existing session. Hook scope needs operator evidence. +exit=0 + +$ python tests/resilience.py --mode failover --action-script scripts/stop-one.cmd --base-url http://127.0.0.1:8080 +Executing explicit failover hook; hook output suppressed to avoid leaking secrets. +{"observed_instances_before": 2, "successful_writes": 105, "failed_attempts": 0, "first_recovery_seconds": 2.329} +PASS: failover preserved confirmed data and existing session. Hook scope needs operator evidence. +exit=0 + +$ docker compose --env-file .env start api + Container mtusi-lab4-postgres-1 Waiting + Container mtusi-lab4-seaweedfs-1 Waiting + Container mtusi-lab4-seaweedfs-1 Healthy + Container mtusi-lab4-s3-init-1 Starting + Container mtusi-lab4-postgres-1 Healthy + Container mtusi-lab4-migrate-1 Starting + Container mtusi-lab4-migrate-1 Started + Container mtusi-lab4-s3-init-1 Started + Container mtusi-lab4-s3-init-1 Waiting + Container mtusi-lab4-valkey-1 Waiting + Container mtusi-lab4-migrate-1 Waiting + Container mtusi-lab4-valkey-1 Healthy + Container mtusi-lab4-migrate-1 Exited + Container mtusi-lab4-s3-init-1 Exited + Container mtusi-lab4-api-5 Starting + Container mtusi-lab4-api-5 Started +exit=0 + +$ python student-tests/test_expiry.py +.. +---------------------------------------------------------------------- +Ran 2 tests in 19.361s + +OK +exit=0 + +$ python student-tests/test_dependencies.py +.. +---------------------------------------------------------------------- +Ran 2 tests in 19.594s + +OK +exit=0 + +$ docker compose --env-file .env run --rm -T s3-init + Container mtusi-lab4-seaweedfs-1 Running + Container mtusi-lab4-seaweedfs-1 Waiting + Container mtusi-lab4-seaweedfs-1 Healthy + Container mtusi-lab4-s3-init-run-da275e60a199 Creating + Container mtusi-lab4-s3-init-run-da275e60a199 Created +bucket messenger-attachments уже существует +анонимный доступ запрещён (HTTP 403) +ключ API ограничен одним bucket (create_bucket отклонён: AccessDenied) +bootstrap завершён +exit=0 + +$ docker compose --env-file .env run --rm -T s3-init + Container mtusi-lab4-seaweedfs-1 Running + Container mtusi-lab4-seaweedfs-1 Waiting + Container mtusi-lab4-seaweedfs-1 Healthy + Container mtusi-lab4-s3-init-run-cc1f19e0054b Creating + Container mtusi-lab4-s3-init-run-cc1f19e0054b Created +bucket messenger-attachments уже существует +анонимный доступ запрещён (HTTP 403) +ключ API ограничен одним bucket (create_bucket отклонён: AccessDenied) +bootstrap завершён +exit=0 + +$ python tests/smoke.py --base-url http://127.0.0.1:8080 +PASS: lab4 public API scenario; infrastructure and grading evidence remain separate. +exit=0 diff --git a/evidence/checks_before_fix_2026-11-11.txt b/evidence/checks_before_fix_2026-11-11.txt new file mode 100644 index 00000000..1426d6b1 --- /dev/null +++ b/evidence/checks_before_fix_2026-11-11.txt @@ -0,0 +1,159 @@ +$ python scripts/check_contract.py +PASS: offline skeleton structure, local refs and Python syntax; application NOT tested. +exit=0 + +$ python scripts/validate_openapi.py +PASS: full OpenAPI 3.1 and JSON Schema validation; application NOT tested. +exit=0 + +$ python tests/smoke.py --base-url http://127.0.0.1:8080 +PASS: lab4 public API scenario; infrastructure and grading evidence remain separate. +exit=0 + +$ python -m unittest discover -s student-tests -p test_api.py -v +test_bearer_rules (test_api.AuthTest.test_bearer_rules) ... ok +test_concurrent_registration_of_same_username (test_api.AuthTest.test_concurrent_registration_of_same_username) ... ok +test_logout_revokes_in_database_and_cache (test_api.AuthTest.test_logout_revokes_in_database_and_cache) ... ok +test_password_is_not_exposed_or_stored_plain (test_api.AuthTest.test_password_is_not_exposed_or_stored_plain) ... ok +test_register_validation (test_api.AuthTest.test_register_validation) ... ok +test_session_shape_entropy_and_logout (test_api.AuthTest.test_session_shape_entropy_and_logout) ... ok +test_token_only_stored_as_hash (test_api.AuthTest.test_token_only_stored_as_hash) ... ok +test_wrong_password_and_unknown_user_are_indistinguishable (test_api.AuthTest.test_wrong_password_and_unknown_user_are_indistinguishable) ... ok +test_chat_creation_is_atomic (test_api.DataTest.test_chat_creation_is_atomic) ... ok +test_foreign_chat_empty_message_bad_json (test_api.DataTest.test_foreign_chat_empty_message_bad_json) ... ok +test_multi_page_history_and_cursor_binding (test_api.DataTest.test_multi_page_history_and_cursor_binding) ... ok +test_parallel_writes_from_many_clients (test_api.DataTest.test_parallel_writes_from_many_clients) ... ok + +---------------------------------------------------------------------- +Ran 12 tests in 2.524s + +OK +exit=0 + +$ python -m unittest discover -s student-tests -p test_idempotency.py -v +test_concurrent_same_key_creates_exactly_one_message_across_replicas (test_idempotency.IdempotencyTest.test_concurrent_same_key_creates_exactly_one_message_across_replicas) ... ok +test_different_body_same_key_is_409 (test_idempotency.IdempotencyTest.test_different_body_same_key_is_409) ... ok +test_expired_key_is_reusable_after_ttl (test_idempotency.IdempotencyTest.test_expired_key_is_reusable_after_ttl) ... ok +test_key_validation (test_idempotency.IdempotencyTest.test_key_validation) ... ok +test_replay_rechecks_session_and_membership (test_idempotency.IdempotencyTest.test_replay_rechecks_session_and_membership) ... ok +test_replay_returns_same_message_and_creates_no_duplicate (test_idempotency.IdempotencyTest.test_replay_returns_same_message_and_creates_no_duplicate) ... ok +test_scope_is_user_and_chat (test_idempotency.IdempotencyTest.test_scope_is_user_and_chat) ... ok +test_semantically_equal_body_is_replayed (test_idempotency.IdempotencyTest.test_semantically_equal_body_is_replayed) ... ok +test_session_is_shared_between_replicas_without_relogin (test_idempotency.IdempotencyTest.test_session_is_shared_between_replicas_without_relogin) ... ok + +---------------------------------------------------------------------- +Ran 9 tests in 1.769s + +OK +exit=0 + +$ python -m unittest discover -s student-tests -p test_attachments.py -v +test_aborted_upload_leaves_nothing (test_attachments.AttachmentTest.test_aborted_upload_leaves_nothing) ... ok +test_bucket_is_private_outside_the_api (test_attachments.AttachmentTest.test_bucket_is_private_outside_the_api) ... ok +test_corrupted_and_spoofed_files_are_415_not_500 (test_attachments.AttachmentTest.test_corrupted_and_spoofed_files_are_415_not_500) ... ok +test_dangerous_filenames_are_400 (test_attachments.AttachmentTest.test_dangerous_filenames_are_400) ... ok +test_decompression_bomb_header_is_413 (test_attachments.AttachmentTest.test_decompression_bomb_header_is_413) ... ok +test_empty_body_is_400 (test_attachments.AttachmentTest.test_empty_body_is_400) ... ok +test_foreign_user_cannot_upload_read_or_download (test_attachments.AttachmentTest.test_foreign_user_cannot_upload_read_or_download) ... ok +test_idempotent_replay_with_attachments (test_attachments.AttachmentTest.test_idempotent_replay_with_attachments) ... ok +test_message_with_attachments_and_chat_binding (test_attachments.AttachmentTest.test_message_with_attachments_and_chat_binding) ... ok +test_png_and_jpeg_roundtrip_with_checksum (test_attachments.AttachmentTest.test_png_and_jpeg_roundtrip_with_checksum) ... ok +test_too_large_is_413_and_nothing_is_stored (test_attachments.AttachmentTest.test_too_large_is_413_and_nothing_is_stored) ... ok + +---------------------------------------------------------------------- +Ran 11 tests in 4.352s + +OK +exit=0 + +$ python -m unittest discover -s student-tests -p test_topology.py -v +test_api_runs_as_non_root (test_topology.TopologyTest.test_api_runs_as_non_root) ... ok +test_at_least_two_api_replicas_without_published_ports (test_topology.TopologyTest.test_at_least_two_api_replicas_without_published_ports) ... ok +test_no_fixed_container_names (test_topology.TopologyTest.test_no_fixed_container_names) ... ok +test_only_lb_is_published_and_only_on_localhost (test_topology.TopologyTest.test_only_lb_is_published_and_only_on_localhost) ... ok +test_resource_limits_are_set (test_topology.TopologyTest.test_resource_limits_are_set) ... ok +test_stop_grace_period_covers_drain (test_topology.TopologyTest.test_stop_grace_period_covers_drain) ... ok + +---------------------------------------------------------------------- +Ran 6 tests in 1.580s + +OK +exit=0 + +$ python -m unittest discover -s student-tests -p test_s3_failures.py -v +test_db_failure_after_s3_write_is_compensated (test_s3_failures.S3FailureTest.test_db_failure_after_s3_write_is_compensated) ... ok +test_missing_object_is_reported_and_attachment_marked_failed (test_s3_failures.S3FailureTest.test_missing_object_is_reported_and_attachment_marked_failed) ... ok +test_orphan_left_by_failed_compensation_is_found_and_cleaned_safely (test_s3_failures.S3FailureTest.test_orphan_left_by_failed_compensation_is_found_and_cleaned_safely) ... ok +test_s3_down_gives_503_text_path_keeps_working (test_s3_failures.S3FailureTest.test_s3_down_gives_503_text_path_keeps_working) ... ok + +---------------------------------------------------------------------- +Ran 4 tests in 193.833s + +OK +exit=0 + +$ python tests/resilience.py --mode persistence --action-script scripts/restart.cmd --base-url http://127.0.0.1:8080 +Executing explicit persistence hook; hook output suppressed to avoid leaking secrets. +PASS: persistence preserved confirmed data and existing session. Hook scope needs operator evidence. +exit=0 + +$ python tests/resilience.py --mode failover --action-script scripts/stop-one.cmd --base-url http://127.0.0.1:8080 +Executing explicit failover hook; hook output suppressed to avoid leaking secrets. +{"observed_instances_before": 2, "successful_writes": 115, "failed_attempts": 0, "first_recovery_seconds": 2.328} +PASS: failover preserved confirmed data and existing session. Hook scope needs operator evidence. +exit=0 + +$ docker compose --env-file .env start api + Container mtusi-lab4-postgres-1 Waiting + Container mtusi-lab4-seaweedfs-1 Waiting + Container mtusi-lab4-seaweedfs-1 Healthy + Container mtusi-lab4-postgres-1 Healthy + Container mtusi-lab4-s3-init-1 Starting + Container mtusi-lab4-migrate-1 Starting + Container mtusi-lab4-migrate-1 Started + Container mtusi-lab4-s3-init-1 Started + Container mtusi-lab4-s3-init-1 Waiting + Container mtusi-lab4-valkey-1 Waiting + Container mtusi-lab4-migrate-1 Waiting + Container mtusi-lab4-valkey-1 Healthy + Container mtusi-lab4-migrate-1 Exited + Container mtusi-lab4-s3-init-1 Exited + Container mtusi-lab4-api-4 Starting + Container mtusi-lab4-api-4 Started +exit=0 + +$ python student-tests/test_expiry.py +.. +---------------------------------------------------------------------- +Ran 2 tests in 23.614s + +OK +exit=0 + +$ python student-tests/test_dependencies.py +E. +====================================================================== +ERROR: test_postgres_down_gives_bounded_503_never_anonymous_access (__main__.DependencyTest.test_postgres_down_gives_bounded_503_never_anonymous_access) +---------------------------------------------------------------------- +Traceback (most recent call last): + File "C:\Users\kolya5544\source\repos\vmdMTUCI\mtusi2026lab4\student-tests\test_dependencies.py", line 64, in test_postgres_down_gives_bounded_503_never_anonymous_access + r = call(method, path, body, token) + ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + File "C:\Users\kolya5544\source\repos\vmdMTUCI\mtusi2026lab4\student-tests\test_api.py", line 38, in call + return status, hdrs, (json.loads(payload) if payload else None) + ^^^^^^^^^^^^^^^^^^^ + File "C:\Users\kolya5544\AppData\Local\Programs\Python\Python311\Lib\json\__init__.py", line 346, in loads + return _default_decoder.decode(s) + ^^^^^^^^^^^^^^^^^^^^^^^^^^ + File "C:\Users\kolya5544\AppData\Local\Programs\Python\Python311\Lib\json\decoder.py", line 337, in decode + obj, end = self.raw_decode(s, idx=_w(s, 0).end()) + ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + File "C:\Users\kolya5544\AppData\Local\Programs\Python\Python311\Lib\json\decoder.py", line 355, in raw_decode + raise JSONDecodeError("Expecting value", s, err.value) from None +json.decoder.JSONDecodeError: Expecting value: line 1 column 1 (char 0) + +---------------------------------------------------------------------- +Ran 2 tests in 9.323s + +FAILED (errors=1) +exit=1 diff --git a/evidence/recheck_2026-11-11/commands.txt b/evidence/recheck_2026-11-11/commands.txt new file mode 100644 index 00000000..60a726b0 --- /dev/null +++ b/evidence/recheck_2026-11-11/commands.txt @@ -0,0 +1,116 @@ +$ python -u research/upload_memory.py --out evidence\recheck_2026-11-11 +размер файла: 8.7 MiB, sha256 9fcc26eea979 +{"UPLOAD_CONCURRENCY": 1, "statuses": {"201": 12}, "wall_seconds": 1.31, "peak_rss_mib": 99.2, "resource_limits": {"memory_bytes": 268435456, "nano_cpus": 1000000000}, "rss_before_mib": 93.3, "rss_after_mib": 99.2, "oom_killed": "false", "accepted_files_intact": "12/12", "p50_s": 0.83, "max_s": 1.3} +{"UPLOAD_CONCURRENCY": 4, "statuses": {"201": 12}, "wall_seconds": 1.18, "peak_rss_mib": 119.0, "resource_limits": {"memory_bytes": 268435456, "nano_cpus": 1000000000}, "rss_before_mib": 93.5, "rss_after_mib": 119.0, "oom_killed": "false", "accepted_files_intact": "12/12", "p50_s": 0.87, "max_s": 1.17} +{"UPLOAD_CONCURRENCY": 12, "statuses": {"201": 12}, "wall_seconds": 1.14, "peak_rss_mib": 121.2, "resource_limits": {"memory_bytes": 268435456, "nano_cpus": 1000000000}, "rss_before_mib": 93.4, "rss_after_mib": 121.2, "oom_killed": "false", "accepted_files_intact": "12/12", "p50_s": 0.94, "max_s": 1.13} +exit=0 + +# Reconciliation rerun after disabling stale HTTP keep-alive reuse; memory results above retained. +$ python -u research/reconcile_bench.py --out evidence\recheck_2026-11-11 --total 3000 +{"db_rows": 19554, "s3_objects": 19530, "timing_ms": {"db_query": 20.2, "s3_listing": 3540.6, "total": 3649.4}, "upload_batch_seconds": 2.3} +{"db_rows": 20554, "s3_objects": 20530, "timing_ms": {"db_query": 19.0, "s3_listing": 3697.2, "total": 3806.4}, "upload_batch_seconds": 2.2} +{"db_rows": 21554, "s3_objects": 21530, "timing_ms": {"db_query": 21.2, "s3_listing": 3939.1, "total": 4055.0}, "upload_batch_seconds": 2.1} +{ + "date": "2026-11-11 18:21:28", + "cost_of_scan": [ + { + "db_rows": 19554, + "s3_objects": 19530, + "timing_ms": { + "db_query": 20.2, + "s3_listing": 3540.6, + "total": 3649.4 + }, + "upload_batch_seconds": 2.3 + }, + { + "db_rows": 20554, + "s3_objects": 20530, + "timing_ms": { + "db_query": 19.0, + "s3_listing": 3697.2, + "total": 3806.4 + }, + "upload_batch_seconds": 2.2 + }, + { + "db_rows": 21554, + "s3_objects": 21530, + "timing_ms": { + "db_query": 21.2, + "s3_listing": 3939.1, + "total": 4055.0 + }, + "upload_batch_seconds": 2.1 + } + ], + "injected": { + "orphan_objects": 20, + "missing_objects": 20, + "size_mismatch": 5 + }, + "dry_run": { + "orphan_objects_count": 20, + "missing_objects_count": 20, + "size_mismatch_count": 5, + "orphans_skipped_fresh": 0, + "timing_ms": { + "db_query": 18.7, + "s3_listing": 3652.1, + "total": 3761.7 + }, + "fixed": { + "deleted_orphans": 0, + "marked_failed": 0 + } + }, + "dry_run_repeatable": true, + "dry_run_found_exactly_injected": true, + "apply": { + "fixed": { + "deleted_orphans": 20, + "marked_failed": 25 + }, + "orphans_skipped_fresh": 0, + "timing_ms": { + "db_query": 19.1, + "s3_listing": 3859.1, + "total": 4048.6 + }, + "orphan_objects_count": 20, + "missing_objects_count": 20, + "size_mismatch_count": 5 + }, + "fresh_uploads_during_apply": { + "uploaded": 200, + "intact": 200 + }, + "in_use_attachments_intact": "200/200", + "message_bindings": { + "messages": 20, + "attachments": 200, + "unchanged": true + }, + "second_apply_idempotent": { + "fixed": { + "deleted_orphans": 0, + "marked_failed": 0 + }, + "orphan_objects_count": 0, + "missing_objects_count": 0 + }, + "marked_failed": [ + "object_missing=20", + "size_mismatch=5" + ] +} +exit=0 + +$ python tests/resilience.py --mode persistence --action-script scripts/restart.cmd --base-url http://127.0.0.1:8080 +Executing explicit persistence hook; hook output suppressed to avoid leaking secrets. +PASS: persistence preserved confirmed data and existing session. Hook scope needs operator evidence. +exit=0 + +$ python tests/smoke.py --base-url http://127.0.0.1:8080 +PASS: lab4 public API scenario; infrastructure and grading evidence remain separate. +exit=0 diff --git a/evidence/recheck_2026-11-11/commands_before_client_fix.txt b/evidence/recheck_2026-11-11/commands_before_client_fix.txt new file mode 100644 index 00000000..d6293f49 --- /dev/null +++ b/evidence/recheck_2026-11-11/commands_before_client_fix.txt @@ -0,0 +1,42 @@ +$ python -u research/upload_memory.py --out evidence\recheck_2026-11-11 +размер файла: 8.7 MiB, sha256 9fcc26eea979 +{"UPLOAD_CONCURRENCY": 1, "statuses": {"201": 12}, "wall_seconds": 1.31, "peak_rss_mib": 99.2, "resource_limits": {"memory_bytes": 268435456, "nano_cpus": 1000000000}, "rss_before_mib": 93.3, "rss_after_mib": 99.2, "oom_killed": "false", "accepted_files_intact": "12/12", "p50_s": 0.83, "max_s": 1.3} +{"UPLOAD_CONCURRENCY": 4, "statuses": {"201": 12}, "wall_seconds": 1.18, "peak_rss_mib": 119.0, "resource_limits": {"memory_bytes": 268435456, "nano_cpus": 1000000000}, "rss_before_mib": 93.5, "rss_after_mib": 119.0, "oom_killed": "false", "accepted_files_intact": "12/12", "p50_s": 0.87, "max_s": 1.17} +{"UPLOAD_CONCURRENCY": 12, "statuses": {"201": 12}, "wall_seconds": 1.14, "peak_rss_mib": 121.2, "resource_limits": {"memory_bytes": 268435456, "nano_cpus": 1000000000}, "rss_before_mib": 93.4, "rss_after_mib": 121.2, "oom_killed": "false", "accepted_files_intact": "12/12", "p50_s": 0.94, "max_s": 1.13} +exit=0 + +$ python -u research/reconcile_bench.py --out evidence\recheck_2026-11-11 --total 3000 +{"db_rows": 16554, "s3_objects": 16530, "timing_ms": {"db_query": 17.7, "s3_listing": 2891.3, "total": 2998.3}, "upload_batch_seconds": 2.6} +{"db_rows": 17554, "s3_objects": 17530, "timing_ms": {"db_query": 18.4, "s3_listing": 3280.3, "total": 3383.1}, "upload_batch_seconds": 2.2} +{"db_rows": 18554, "s3_objects": 18530, "timing_ms": {"db_query": 16.8, "s3_listing": 3647.2, "total": 3754.3}, "upload_batch_seconds": 2.0} +Traceback (most recent call last): + File "C:\Users\kolya5544\source\repos\vmdMTUCI\mtusi2026lab4\research\reconcile_bench.py", line 204, in + asyncio.run(main(ap.parse_args())) + File "C:\Users\kolya5544\AppData\Local\Programs\Python\Python311\Lib\asyncio\runners.py", line 190, in run + return runner.run(main) + ^^^^^^^^^^^^^^^^ + File "C:\Users\kolya5544\AppData\Local\Programs\Python\Python311\Lib\asyncio\runners.py", line 118, in run + return self._loop.run_until_complete(task) + ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + File "C:\Users\kolya5544\AppData\Local\Programs\Python\Python311\Lib\asyncio\base_events.py", line 654, in run_until_complete + return future.result() + ^^^^^^^^^^^^^^^ + File "C:\Users\kolya5544\source\repos\vmdMTUCI\mtusi2026lab4\research\reconcile_bench.py", line 150, in main + await bind_to_messages(s, token, chat, used_ids) + File "C:\Users\kolya5544\source\repos\vmdMTUCI\mtusi2026lab4\research\reconcile_bench.py", line 114, in bind_to_messages + async with s.post("%s/api/v1/chats/%s/messages" % (BASE, chat), + File "C:\Users\kolya5544\source\repos\vmdMTUCI\tools\.venv\Lib\site-packages\aiohttp\client.py", line 1693, in __aenter__ + self._resp: _RetType_co = await self._coro + ^^^^^^^^^^^^^^^^ + File "C:\Users\kolya5544\source\repos\vmdMTUCI\tools\.venv\Lib\site-packages\aiohttp\client.py", line 858, in _request + resp = await handler(req) + ^^^^^^^^^^^^^^^^^^ + File "C:\Users\kolya5544\source\repos\vmdMTUCI\tools\.venv\Lib\site-packages\aiohttp\client.py", line 836, in _connect_and_send_request + await resp.start(conn) + File "C:\Users\kolya5544\source\repos\vmdMTUCI\tools\.venv\Lib\site-packages\aiohttp\client_reqrep.py", line 558, in start + message, payload = await protocol.read() # type: ignore[union-attr] + ^^^^^^^^^^^^^^^^^^^^^ + File "C:\Users\kolya5544\source\repos\vmdMTUCI\tools\.venv\Lib\site-packages\aiohttp\streams.py", line 705, in read + await self._waiter +aiohttp.client_exceptions.ServerDisconnectedError: Server disconnected +exit=1 diff --git a/evidence/recheck_2026-11-11/lifecycle.json b/evidence/recheck_2026-11-11/lifecycle.json new file mode 100644 index 00000000..efa4940e --- /dev/null +++ b/evidence/recheck_2026-11-11/lifecycle.json @@ -0,0 +1,116 @@ +{ + "before": { + "mtusi-lab4-api-4": { + "service": "api", + "started_at": "2026-11-11T15:19:40.270198114Z", + "health": "healthy", + "volumes": [], + "memory_bytes": 268435456, + "nano_cpus": 1000000000 + }, + "mtusi-lab4-api-5": { + "service": "api", + "started_at": "2026-11-11T15:19:40.450834393Z", + "health": "healthy", + "volumes": [], + "memory_bytes": 268435456, + "nano_cpus": 1000000000 + }, + "mtusi-lab4-lb-1": { + "service": "lb", + "started_at": "2026-11-11T15:17:05.882305757Z", + "health": "healthy", + "volumes": [], + "memory_bytes": 134217728, + "nano_cpus": 1000000000 + }, + "mtusi-lab4-postgres-1": { + "service": "postgres", + "started_at": "2026-11-11T15:18:29.832733162Z", + "health": "healthy", + "volumes": [ + "mtusi-lab4_pgdata" + ], + "memory_bytes": 536870912, + "nano_cpus": 1000000000 + }, + "mtusi-lab4-seaweedfs-1": { + "service": "seaweedfs", + "started_at": "2026-11-11T15:17:06.948359559Z", + "health": "healthy", + "volumes": [ + "mtusi-lab4_seaweeddata" + ], + "memory_bytes": 805306368, + "nano_cpus": 1000000000 + }, + "mtusi-lab4-valkey-1": { + "service": "valkey", + "started_at": "2026-11-11T15:18:32.43836843Z", + "health": "healthy", + "volumes": [ + "mtusi-lab4_valkeydata" + ], + "memory_bytes": 134217728, + "nano_cpus": 500000000 + } + }, + "after": { + "mtusi-lab4-api-4": { + "service": "api", + "started_at": "2026-11-11T15:22:57.324421301Z", + "health": "healthy", + "volumes": [], + "memory_bytes": 268435456, + "nano_cpus": 1000000000 + }, + "mtusi-lab4-api-5": { + "service": "api", + "started_at": "2026-11-11T15:22:57.482181899Z", + "health": "healthy", + "volumes": [], + "memory_bytes": 268435456, + "nano_cpus": 1000000000 + }, + "mtusi-lab4-lb-1": { + "service": "lb", + "started_at": "2026-11-11T15:22:53.438585878Z", + "health": "healthy", + "volumes": [], + "memory_bytes": 134217728, + "nano_cpus": 1000000000 + }, + "mtusi-lab4-postgres-1": { + "service": "postgres", + "started_at": "2026-11-11T15:22:53.862285534Z", + "health": "healthy", + "volumes": [ + "mtusi-lab4_pgdata" + ], + "memory_bytes": 536870912, + "nano_cpus": 1000000000 + }, + "mtusi-lab4-seaweedfs-1": { + "service": "seaweedfs", + "started_at": "2026-11-11T15:22:54.073709276Z", + "health": "healthy", + "volumes": [ + "mtusi-lab4_seaweeddata" + ], + "memory_bytes": 805306368, + "nano_cpus": 1000000000 + }, + "mtusi-lab4-valkey-1": { + "service": "valkey", + "started_at": "2026-11-11T15:22:53.5998755Z", + "health": "healthy", + "volumes": [ + "mtusi-lab4_valkeydata" + ], + "memory_bytes": 134217728, + "nano_cpus": 500000000 + } + }, + "all_services_restarted": true, + "volumes_preserved": true +} \ No newline at end of file diff --git a/evidence/recheck_2026-11-11/source_metadata.json b/evidence/recheck_2026-11-11/source_metadata.json new file mode 100644 index 00000000..8dc22718 --- /dev/null +++ b/evidence/recheck_2026-11-11/source_metadata.json @@ -0,0 +1,51 @@ +{ + "date": "2026-11-11", + "base_solution_commit": "f875e2977f6592e1af6228dfe2138a769c327b08", + "branch": "solution/bpi2302-kushnarenko", + "python_client": "3.11.9 (tags/v3.11.9:de54cf5, Apr 2 2024, 10:12:12) [MSC v.1938 64 bit (AMD64)]", + "source_sha256": { + "Dockerfile": "f1dc711cacf00e3e2bd6b4a0616c925e357446ebda370e7e5fdb3170eaecd4cb", + "compose.yaml": "e7f52308ad5f0f55bf1d61b83275bad2fb80be9f97b695cdd659d0d878cdd6a5", + "infra/README.md": "33a4f7b870fd0b2bed98d46daf26d45dd7436176739672925246f8e3fe7c2278", + "infra/haproxy/haproxy.cfg": "511fb24b32740c332cd7b6ea42d3f1cf252e1452de754ff97c8e6886f3692061", + "requirements.txt": "709710dfd92af5f023ef9909488e9a14a7cacb62c67d67fff261d34ae4b779a0", + "research/failover_sequence.py": "5cf120dfc9c79756a7bc913c900702ee597cc89ed4d7e21471a784a75b752ca4", + "research/loadgen.py": "ec758237e5c57efe405fddac13ed80aab2ea31ff400761a951f89a31d7769b8b", + "research/reconcile_bench.py": "6a6814f925b9e36621f6f7237473ad6b085b94e2717c2be79313cef7c8906a5a", + "research/rolling_update.py": "447da4a9e2161bb232669f0558d6cb15ae3f0ef181fdf563e19cd56135b58240", + "research/upload_memory.py": "07784bde3bf9cd15f586025adf6a37a2c3413ee756e099034c23cc789fbe7df1", + "scripts/check_contract.py": "61e300fe5c1074360418e24b4653b12f96808247a2beaf2a64859aa360f81493", + "scripts/init-secrets.sh": "7df8c218002a46ccb545d96051a6b958cf8b4dee14d94299a85984576b483f5b", + "scripts/restart.cmd": "78e2689f97b3d0aafa72a0352a4a8cce2f41d78684c34042711e0af38e7cad19", + "scripts/restart.example.sh": "0328246ba75defbced992104e986fde973f63e3830d83251eced5953263e944b", + "scripts/restart.sh": "c57ad938ecaca510120296e9406918e6ef9ed24eb1b6dff16cf1b4d95c787e41", + "scripts/restore-replicas.sh": "f55116712bb7f511bfc756507c3574a411256a41ea7ee6ba473c610ea5d1184b", + "scripts/rolling-update.sh": "465791a134b48738a3e8d59819762159cc173d9332c6de9e2afcb583a4674559", + "scripts/stop-one.cmd": "1955b8b0c879ea50d8efeb7fb43e8497356bb45482a91f90bd81a9c3fececdbf", + "scripts/stop-one.example.sh": "1bcf34394520b89d95b7605ec56675be799eea920e83cfbba306d5dc0a6d9811", + "scripts/stop-one.sh": "897cd2b56e6481cca7ac82378a0c071791f1e0e395d6a2e8d2a9f8e8faf50b38", + "scripts/validate_openapi.py": "cd7a33221b1860c5d2330e52afa6cb222d375db671ae9ab379ba51a0d3a77946", + "src/app/attachments.py": "430cf9672744a2192a72e9a9b64ab968510acb660590fd818b5f6dc6c3128ee0", + "src/app/config.py": "2d0eb339e9b9caf9c69c1b497ba233758f9567c79e2edf76eb5facda3314fd38", + "src/app/db.py": "7510882b0e8c9f6a24d680a156c285bc1a0fcf021473ca47173aa0744d845a78", + "src/app/images.py": "3dc7434cbfbc9d4c01b95eb897c1332b2a2748dd9df88c99a7086f3e4cdf4c41", + "src/app/main.py": "355aec75a78eaa7a8696684b251221a16c0828533fe1dbcfb30ab8cd04ca9b5c", + "src/app/migrate.py": "cabc192ca4182af780636415a008d2dd4636dad7d3cf0f4a8a2b52a48aedaa7e", + "src/app/passwords.py": "836fc282093058f6717eaa6374775251ed655dcd517f325dc60323a88154f261", + "src/app/reconcile.py": "dd795a9d53a32bf2c107d2c053c170f7c4c7731b99aff57747af1edf49883a51", + "src/app/s3.py": "d31dec589dd96607b3fa7fb5fa6013e3882638eb536a737dc766013209ce6247", + "src/app/s3_bootstrap.py": "216d8121d6e7b25d95b845f4deaff18fd31eeb28484e51fe4c463c646a3af0d1", + "src/app/serve.py": "3ebe12cf8cb2dddfc7d7234bba9bd190d868cc88d02e61fe640ba51dcf115b55", + "src/app/sessions.py": "f975eb27c50c024f3e562f755ee97bb7bfe21cf5e01cc1d347bf107971c30670", + "src/app/web.py": "23271be669a19bd7abfd6eaae25e25ce214718f0f623406cb9a2f6e77e365b83", + "student-tests/fixtures/sample.jpg": "33a614b40fe6ae25fdbd99af22e7d9d3e5dbea455b36aac750de112c034a6311", + "student-tests/fixtures/sample.png": "99ea7533c441f79cd630d15ce4d58d1ec4e06f6f0efb3b77a5c088305cd1bd75", + "student-tests/test_api.py": "2635113842a5b26ec1fdd98ea42fc861edb1d10895e8be6c2eff46ed73fdba9d", + "student-tests/test_attachments.py": "90128b76736336bb3c37746549c951cbd853b93084b1d1c9605fffb3b77ffbbb", + "student-tests/test_dependencies.py": "e152b87441d1374ce9b69d3d441d262e47890313d2ccc798f5e2cff2e3719399", + "student-tests/test_expiry.py": "16a374ebe3df15c50c07a9fc3bc801c6c532dde3c4185b164c6aea4605923f83", + "student-tests/test_idempotency.py": "4ee985a3ef26fefa816fdb136fa2b0644cca13d73fe3a226d1ba975a55698b5b", + "student-tests/test_s3_failures.py": "81f8b7acbde19700c87e8d65af1803c071e9b0549d10788ae1f53729a64be175", + "student-tests/test_topology.py": "576ff231fad871fa05cf6f14c6544c32389961f204b9dec8d2ecf250da15e157" + } +} \ No newline at end of file diff --git a/evidence/recheck_2026-11-11/track2_reconcile.json b/evidence/recheck_2026-11-11/track2_reconcile.json new file mode 100644 index 00000000..cbdfabca --- /dev/null +++ b/evidence/recheck_2026-11-11/track2_reconcile.json @@ -0,0 +1,98 @@ +{ + "date": "2026-11-11 18:21:28", + "cost_of_scan": [ + { + "db_rows": 19554, + "s3_objects": 19530, + "timing_ms": { + "db_query": 20.2, + "s3_listing": 3540.6, + "total": 3649.4 + }, + "upload_batch_seconds": 2.3 + }, + { + "db_rows": 20554, + "s3_objects": 20530, + "timing_ms": { + "db_query": 19.0, + "s3_listing": 3697.2, + "total": 3806.4 + }, + "upload_batch_seconds": 2.2 + }, + { + "db_rows": 21554, + "s3_objects": 21530, + "timing_ms": { + "db_query": 21.2, + "s3_listing": 3939.1, + "total": 4055.0 + }, + "upload_batch_seconds": 2.1 + } + ], + "args": { + "out": "evidence\\recheck_2026-11-11", + "total": 3000 + }, + "injected": { + "orphan_objects": 20, + "missing_objects": 20, + "size_mismatch": 5 + }, + "dry_run": { + "orphan_objects_count": 20, + "missing_objects_count": 20, + "size_mismatch_count": 5, + "orphans_skipped_fresh": 0, + "timing_ms": { + "db_query": 18.7, + "s3_listing": 3652.1, + "total": 3761.7 + }, + "fixed": { + "deleted_orphans": 0, + "marked_failed": 0 + } + }, + "dry_run_repeatable": true, + "dry_run_found_exactly_injected": true, + "apply": { + "fixed": { + "deleted_orphans": 20, + "marked_failed": 25 + }, + "orphans_skipped_fresh": 0, + "timing_ms": { + "db_query": 19.1, + "s3_listing": 3859.1, + "total": 4048.6 + }, + "orphan_objects_count": 20, + "missing_objects_count": 20, + "size_mismatch_count": 5 + }, + "fresh_uploads_during_apply": { + "uploaded": 200, + "intact": 200 + }, + "in_use_attachments_intact": "200/200", + "message_bindings": { + "messages": 20, + "attachments": 200, + "unchanged": true + }, + "second_apply_idempotent": { + "fixed": { + "deleted_orphans": 0, + "marked_failed": 0 + }, + "orphan_objects_count": 0, + "missing_objects_count": 0 + }, + "marked_failed": [ + "object_missing=20", + "size_mismatch=5" + ] +} \ No newline at end of file diff --git a/evidence/recheck_2026-11-11/upload_memory.json b/evidence/recheck_2026-11-11/upload_memory.json new file mode 100644 index 00000000..dc178a7a --- /dev/null +++ b/evidence/recheck_2026-11-11/upload_memory.json @@ -0,0 +1,62 @@ +{ + "date": "2026-11-11 18:18:37", + "file_mib": 8.73, + "clients": 12, + "api_memory_limit": "256m", + "runs": [ + { + "UPLOAD_CONCURRENCY": 1, + "statuses": { + "201": 12 + }, + "wall_seconds": 1.31, + "peak_rss_mib": 99.2, + "resource_limits": { + "memory_bytes": 268435456, + "nano_cpus": 1000000000 + }, + "rss_before_mib": 93.3, + "rss_after_mib": 99.2, + "oom_killed": "false", + "accepted_files_intact": "12/12", + "p50_s": 0.83, + "max_s": 1.3 + }, + { + "UPLOAD_CONCURRENCY": 4, + "statuses": { + "201": 12 + }, + "wall_seconds": 1.18, + "peak_rss_mib": 119.0, + "resource_limits": { + "memory_bytes": 268435456, + "nano_cpus": 1000000000 + }, + "rss_before_mib": 93.5, + "rss_after_mib": 119.0, + "oom_killed": "false", + "accepted_files_intact": "12/12", + "p50_s": 0.87, + "max_s": 1.17 + }, + { + "UPLOAD_CONCURRENCY": 12, + "statuses": { + "201": 12 + }, + "wall_seconds": 1.14, + "peak_rss_mib": 121.2, + "resource_limits": { + "memory_bytes": 268435456, + "nano_cpus": 1000000000 + }, + "rss_before_mib": 93.4, + "rss_after_mib": 121.2, + "oom_killed": "false", + "accepted_files_intact": "12/12", + "p50_s": 0.94, + "max_s": 1.13 + } + ] +} \ No newline at end of file diff --git a/infra/haproxy/haproxy.cfg b/infra/haproxy/haproxy.cfg index 4be6130a..e446fe83 100644 --- a/infra/haproxy/haproxy.cfg +++ b/infra/haproxy/haproxy.cfg @@ -17,7 +17,8 @@ defaults timeout queue 5s retries 3 option redispatch 1 - retry-on conn-failure empty-response response-timeout 0rtt-rejected + # Only retry before a connection is established: upload POST has no idempotency key. + retry-on conn-failure # Docker DNS (127.0.0.11): адреса реплик API обновляются без перезапуска LB (scale up/down, пересоздание контейнеров). resolvers docker @@ -33,6 +34,9 @@ resolvers docker frontend public bind :8080 + # If the shared DB is down, live API processes still produce contract JSON, + # validate missing credentials, and serve /health/live independently of DB. + use_backend api_live if { nbsrv(api) eq 0 } default_backend api # Внутренний healthcheck самого LB (контейнерный HEALTHCHECK); наружу не публикуется. @@ -48,3 +52,11 @@ backend api http-check expect status 200 default-server check inter 1s fall 2 rise 2 resolvers docker init-addr none server-template api 1-8 api:8080 + +backend api_live + balance roundrobin + option httpchk + http-check send meth GET uri /health/live + http-check expect status 200 + default-server check inter 1s fall 2 rise 2 resolvers docker init-addr none + server-template api 1-8 api:8080 diff --git a/research/reconcile_bench.py b/research/reconcile_bench.py index c6e29bdc..4919447d 100644 --- a/research/reconcile_bench.py +++ b/research/reconcile_bench.py @@ -32,7 +32,7 @@ BASE = "http://127.0.0.1:8080" def sh(*args): - return subprocess.run(args, cwd=ROOT, capture_output=True, text=True, encoding="utf-8") + return subprocess.run(args, cwd=ROOT, capture_output=True, text=True, encoding="utf-8", check=True) def compose(*args): @@ -106,9 +106,32 @@ def keys_for(ids): return out +async def bind_to_messages(s, token, chat, ids): + """Create real message references, not just ready attachment metadata.""" + headers = {"Authorization": "Bearer " + token} + for start in range(0, len(ids), 10): + batch = ids[start:start + 10] + async with s.post("%s/api/v1/chats/%s/messages" % (BASE, chat), + json={"text": "reconciler keeper", "attachment_ids": batch}, + headers={**headers, "Idempotency-Key": str(uuid.uuid4())}) as r: + body = await r.json() + assert r.status == 201 and body["attachment_ids"] == batch, (r.status, body) + + +async def message_bindings(s, token, chat): + async with s.get("%s/api/v1/chats/%s/messages?limit=100" % (BASE, chat), + headers={"Authorization": "Bearer " + token}) as r: + r.raise_for_status() + body = await r.json() + return {m["id"]: m["attachment_ids"] for m in body["items"]} + + async def main(args): report = {"date": time.strftime("%Y-%m-%d %H:%M:%S"), "cost_of_scan": [], "args": vars(args)} - async with aiohttp.ClientSession(timeout=aiohttp.ClientTimeout(total=60), connector=aiohttp.TCPConnector(limit=32)) as s: + # Docker commands block the event loop longer than the server's keep-alive. + # Do not reuse idle HTTP sockets after a scan or fault-injection command. + async with aiohttp.ClientSession(timeout=aiohttp.ClientTimeout(total=60), + connector=aiohttp.TCPConnector(limit=32, force_close=True)) as s: token, chat = await register(s) base = reconcile("--grace", "0", "--apply") # нормализация: убираем следы прошлых прогонов base = reconcile("--grace", "0") @@ -127,6 +150,9 @@ async def main(args): missing_ids = [a for a, _ in sample[:20]] mismatch_ids = [a for a, _ in sample[20:25]] used_ids = [a for a, _ in random.sample([u for u in uploaded if u[0] not in set(missing_ids + mismatch_ids)], 200)] + await bind_to_messages(s, token, chat, used_ids) + bindings_before = await message_bindings(s, token, chat) + assert {a for ids in bindings_before.values() for a in ids} == set(used_ids) orphans = ["att/%s/original" % uuid.uuid4() for _ in range(20)] mkeys, xkeys = keys_for(missing_ids), keys_for(mismatch_ids) code = ("import asyncio\nfrom app import config\nfrom app.s3 import S3\nasync def m():\n s=S3(); await s.start()\n" @@ -152,6 +178,9 @@ async def main(args): report["apply"] = {k: applied[k] for k in ("fixed", "orphans_skipped_fresh", "timing_ms", "orphan_objects_count", "missing_objects_count", "size_mismatch_count")} report["fresh_uploads_during_apply"] = {"uploaded": len(fresh), "intact": await check_intact(s, token, fresh)} report["in_use_attachments_intact"] = "%d/%d" % (await check_intact(s, token, used_pairs), len(used_pairs)) + bindings_after = await message_bindings(s, token, chat) + report["message_bindings"] = {"messages": len(bindings_before), "attachments": len(used_ids), + "unchanged": bindings_after == bindings_before} again = reconcile("--grace", "5", "--apply") report["second_apply_idempotent"] = {"fixed": again["fixed"], "orphan_objects_count": again["orphan_objects_count"], "missing_objects_count": again["missing_objects_count"]} @@ -161,6 +190,14 @@ async def main(args): with open(os.path.join(args.out, "track2_reconcile.json"), "w", encoding="utf-8") as fh: json.dump(report, fh, ensure_ascii=False, indent=2) print(json.dumps({k: v for k, v in report.items() if k != "args"}, ensure_ascii=False, indent=2)) + assert len(uploaded) == 3 * (args.total // 3), "not all requested uploads succeeded" + assert report["dry_run_repeatable"] and report["dry_run_found_exactly_injected"], report["dry_run"] + assert dry1["fixed"] == dry2["fixed"] == {"deleted_orphans": 0, "marked_failed": 0} + assert applied["fixed"] == {"deleted_orphans": 20, "marked_failed": 25}, applied + assert report["fresh_uploads_during_apply"] == {"uploaded": 200, "intact": 200} + assert report["in_use_attachments_intact"] == "200/200" and report["message_bindings"]["unchanged"] + assert again["fixed"] == {"deleted_orphans": 0, "marked_failed": 0}, again + assert (again["orphan_objects_count"], again["missing_objects_count"], again["size_mismatch_count"]) == (0, 0, 0) if __name__ == "__main__": diff --git a/research/requirements.txt b/research/requirements.txt new file mode 100644 index 00000000..7504ccb6 --- /dev/null +++ b/research/requirements.txt @@ -0,0 +1,2 @@ +aiohttp==3.14.3 +Pillow==12.3.0 diff --git a/research/upload_memory.py b/research/upload_memory.py index 8adb3a96..ab3f337a 100644 --- a/research/upload_memory.py +++ b/research/upload_memory.py @@ -28,7 +28,8 @@ PROJECT = "mtusi-lab4" def sh(*args, env=None): - return subprocess.run(args, cwd=ROOT, capture_output=True, text=True, env=dict(os.environ, **(env or {}))).stdout.strip() + return subprocess.run(args, cwd=ROOT, capture_output=True, text=True, check=True, + env=dict(os.environ, **(env or {}))).stdout.strip() def noisy_png(side, seed): @@ -54,6 +55,8 @@ def set_api(concurrency, replicas): if len(ids) == replicas and all(sh("docker", "inspect", "-f", "{{.State.Health.Status}}", i) == "healthy" for i in ids): break time.sleep(1) + else: + raise RuntimeError("API replicas did not become healthy within 90 seconds") time.sleep(6) @@ -99,6 +102,9 @@ async def main(args): for conc in args.concurrency: set_api(conc, 1) cid = api_containers()[0] + limits = json.loads(sh("docker", "inspect", "-f", + '{"memory_bytes":{{.HostConfig.Memory}},"nano_cpus":{{.HostConfig.NanoCpus}}}', cid)) + assert limits == {"memory_bytes": 256 * 1024 * 1024, "nano_cpus": 1000000000}, limits async with aiohttp.ClientSession() as s: uid, token = await register(s) async with s.post(BASE + "/api/v1/chats", json={"title": "mem", "member_ids": [uid]}, headers={"Authorization": "Bearer " + token}) as r: @@ -120,6 +126,7 @@ async def main(args): intact += 1 oom = sh("docker", "inspect", "-f", "{{.State.OOMKilled}}", cid) entry = {"UPLOAD_CONCURRENCY": conc, "statuses": statuses, "wall_seconds": round(wall, 2), "peak_rss_mib": peak, + "resource_limits": limits, "rss_before_mib": baseline_hwm, "rss_after_mib": rss, "oom_killed": oom, "accepted_files_intact": "%d/%d" % (intact, statuses.get("201", 0)), "p50_s": round(ok_lat[len(ok_lat) // 2], 2) if ok_lat else None, "max_s": round(ok_lat[-1], 2) if ok_lat else None} @@ -128,6 +135,10 @@ async def main(args): set_api(4, 2) with open(os.path.join(args.out, "upload_memory.json"), "w", encoding="utf-8") as fh: json.dump(report, fh, ensure_ascii=False, indent=2) + for entry in report["runs"]: + assert entry["statuses"] == {"201": args.clients}, entry + assert entry["accepted_files_intact"] == "%d/%d" % (args.clients, args.clients), entry + assert entry["oom_killed"] == "false" and 0 < entry["peak_rss_mib"] < 256, entry if __name__ == "__main__": diff --git a/student-tests/README.md b/student-tests/README.md new file mode 100644 index 00000000..822498f0 --- /dev/null +++ b/student-tests/README.md @@ -0,0 +1,44 @@ +# Собственные проверки ЛР4 + +Сначала запустите стенд по [REPORT.md](../REPORT.md). Все команды выполняются из корня репозитория. В Windows задайте `$env:PYTHONUTF8='1'`. + +```sh +python -m unittest discover -s student-tests -p 'test_api.py' -v +python -m unittest discover -s student-tests -p 'test_idempotency.py' -v +python -m unittest discover -s student-tests -p 'test_attachments.py' -v +python -m unittest discover -s student-tests -p 'test_topology.py' -v +``` + +Это 38 тестов: API и аутентификация (12), идемпотентность между репликами (9), вложения и права доступа (11), топология (6). + +Следующие 8 тестов временно останавливают зависимости или пересоздают API с настройками отказа/коротким TTL. Запускайте их последовательно на учебном стенде; данные и volumes сохраняются, настройки восстанавливаются после проверки. + +```sh +python student-tests/test_s3_failures.py -v +python student-tests/test_expiry.py -v +python student-tests/test_dependencies.py -v +``` + +В проверке reconciler файл действительно прикреплён к сообщению: после очистки проверяются и файл, и ссылка сообщения. Свежий orphan проверяется с `--apply --grace 900`: он должен остаться; с `--grace 0` после завершения загрузок он удаляется. + +Повторяемость bootstrap и ограниченные права ключа API: + +```sh +docker compose --env-file .env run --rm -T s3-init +docker compose --env-file .env run --rm -T s3-init +``` + +Публичные проверки запускаются отдельно, без изменений: `make check`, `make validate`, `make test`, сценарии `tests/resilience.py` из отчёта. На Windows можно запустить соответствующие Python-команды из Makefile. После failover восстановите вторую реплику: `docker compose --env-file .env start api`. + +## Эксперименты + +Для исследовательских скриптов нужны `aiohttp` и `Pillow`: `python -m pip install -r research/requirements.txt`. Создайте каталог результата заранее. Эксперименты запускайте последовательно; `upload_memory.py` временно меняет число реплик и лимит параллельных загрузок, затем возвращает две реплики и лимит 4. + +```sh +python research/upload_memory.py --clients 12 --out evidence +python research/reconcile_bench.py --total 3000 --out evidence +``` + +`reconcile_bench.py` создаёт синтетические данные, внедряет 20 orphan, 20 missing и 5 size mismatch, сравнивает dry-run/apply/повтор, проверяет SHA-256 и сохранность 200 вложений в 20 сообщениях. Начальный запуск `--apply --grace 0` убирает следы прежних экспериментов; скрипт предназначен для отдельного учебного стенда без посторонних загрузок. + +Реальный повторный прогон: [checks_2026-11-11.txt](../evidence/checks_2026-11-11.txt), [результаты исследований](../evidence/recheck_2026-11-11/). diff --git a/student-tests/test_dependencies.py b/student-tests/test_dependencies.py index 7235777c..add07113 100644 --- a/student-tests/test_dependencies.py +++ b/student-tests/test_dependencies.py @@ -56,7 +56,9 @@ class DependencyTest(unittest.TestCase): actor = register("dep") self.assertEqual(call("GET", "/api/v1/users/me", token=actor["token"])[0], 200) # токен в кэше compose("stop", "postgres") - time.sleep(1) + # Wait past HAProxy's fall=2 health checks: cover the all-unready state, + # not just the short interval while the load balancer still routes normally. + time.sleep(5) for method, path, body, token in (("GET", "/api/v1/users/me", None, actor["token"]), ("GET", "/api/v1/chats", None, actor["token"]), ("POST", "/api/v1/chats", {"title": "x", "member_ids": [actor["user"]["id"]]}, actor["token"]), diff --git a/student-tests/test_s3_failures.py b/student-tests/test_s3_failures.py index 9b13b55e..ebaa1058 100644 --- a/student-tests/test_s3_failures.py +++ b/student-tests/test_s3_failures.py @@ -87,6 +87,9 @@ class S3FailureTest(unittest.TestCase): def test_orphan_left_by_failed_compensation_is_found_and_cleaned_safely(self): keeper = upload(self.a["token"], self.chat["id"], PNG)[2] # используемое вложение + path = "/api/v1/chats/%s/messages" % self.chat["id"] + sent = call("POST", path, {"text": "keeper", "attachment_ids": [keeper["id"]]}, self.a["token"]) + self.assertEqual(sent[0], 201, sent[2]) recreate_api({"FAULT_INJECTION": "db_after_put,s3_delete_fails"}) r = upload(self.a["token"], self.chat["id"], PNG) self.assertEqual(r[0], 500) @@ -94,6 +97,9 @@ class S3FailureTest(unittest.TestCase): fresh = reconcile("--grace", "900") # grace period: свежий объект не трогаем self.assertGreaterEqual(fresh["orphans_skipped_fresh"], 1) self.assertEqual(fresh["orphan_objects_count"], 0) + protected = reconcile("--grace", "900", "--apply") + self.assertGreaterEqual(protected["orphans_skipped_fresh"], 1) + self.assertEqual(protected["fixed"], {"deleted_orphans": 0, "marked_failed": 0}) dry = reconcile("--grace", "0") # dry-run находит, но не удаляет self.assertGreaterEqual(dry["orphan_objects_count"], 1) self.assertEqual(dry["fixed"], {"deleted_orphans": 0, "marked_failed": 0}) @@ -103,6 +109,10 @@ class S3FailureTest(unittest.TestCase): self.assertEqual(reconcile("--grace", "0")["orphan_objects_count"], 0) # повторный запуск идемпотентен self.assertEqual(download(self.a["token"], keeper["id"])[0], 200, "используемое вложение удалять нельзя") + messages = call("GET", path, token=self.a["token"])[2]["items"] + self.assertEqual(messages[0]["id"], sent[2]["id"]) + self.assertEqual(messages[0]["attachment_ids"], [keeper["id"]]) + def test_missing_object_is_reported_and_attachment_marked_failed(self): att = upload(self.a["token"], self.chat["id"], PNG)[2] key = psql("SELECT s3_key FROM attachments WHERE id = '%s'" % att["id"]) -- 2.54.0 From e83279ec7ff76958f4ea3a37a99133647ac6c128 Mon Sep 17 00:00:00 2001 From: kolya5544 Date: Wed, 11 Nov 2026 18:28:03 +0300 Subject: [PATCH 3/3] docs(lab4): link submission pull request --- REPORT.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/REPORT.md b/REPORT.md index 62fe4f95..5fad6648 100644 --- a/REPORT.md +++ b/REPORT.md @@ -2,7 +2,7 @@ - Автор, группа: Кушнаренко Николай Вячеславович, БПИ2302 - Целевая оценка; выбранный трек 5, если нужен: **5**, трек 2 «Согласованность двух хранилищ» -- Commit/PR: ветка `solution/bpi2302-kushnarenko` в [форке kolya](https://gitea.privcloud.tech/kolya/mtusi2026lab4); ссылка на PR добавляется после открытия +- Commit/PR: проверенное решение `0150b91`, ветка `solution/bpi2302-kushnarenko` в [форке kolya](https://gitea.privcloud.tech/kolya/mtusi2026lab4); [PR #101](https://gitea.privcloud.tech/mtusi2026/mtusi2026lab4/pulls/101) → `mtusi2026/mtusi2026lab4:main` - Использованные источники, библиотеки и помощь ИИ: Python 3.12, uvicorn, asyncpg, aiobotocore (S3), Pillow (проверка изображений), argon2-cffi; SeaweedFS 4.48 (S3); HAProxy; PostgreSQL; Valkey. Код lab3 перенесён. ИИ-ассистенты использовались для помощи с кодом, тестами и отчётом; Codex проверил подготовку к сдаче, усилил проверки исследования и выполнил реальные запуски 11.11.2026 ## Запуск из чистого clone -- 2.54.0