From 518c98fd3e6bd593bbb22b5bdd07f82ecff65720 Mon Sep 17 00:00:00 2001 From: kolya5544 Date: Sat, 3 Oct 2026 03:05:17 +0300 Subject: [PATCH] =?UTF-8?q?=D0=9B=D0=A05:=20=D0=B1=D1=80=D0=BE=D0=BA=D0=B5?= =?UTF-8?q?=D1=80=20RabbitMQ,=20outbox,=20worker,=20=D0=B2=D0=B0=D1=80?= =?UTF-8?q?=D0=B8=D0=B0=D0=BD=D1=82=D1=8B=20=D0=B8=D0=B7=D0=BE=D0=B1=D1=80?= =?UTF-8?q?=D0=B0=D0=B6=D0=B5=D0=BD=D0=B8=D0=B9,=20=D0=BE=D1=82=D0=BA?= =?UTF-8?q?=D0=B0=D0=B7=D0=BE=D1=83=D1=81=D1=82=D0=BE=D0=B9=D1=87=D0=B8?= =?UTF-8?q?=D0=B2=D0=BE=D1=81=D1=82=D1=8C,=20=D0=B8=D1=81=D1=81=D0=BB?= =?UTF-8?q?=D0=B5=D0=B4=D0=BE=D0=B2=D0=B0=D0=BD=D0=B8=D0=B5=20=D0=BE=D1=87?= =?UTF-8?q?=D0=B5=D1=80=D0=B5=D0=B4=D0=B8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .dockerignore | 6 + .env.example | 43 ++- Dockerfile | 32 ++ Makefile | 16 + REPORT.md | 110 +++++- compose.yaml | 239 +++++++++++++ docs/report_lab5.docx | Bin 0 -> 123356 bytes evidence/checks.txt | 49 +++ evidence/queue_overload.json | 254 +++++++++++++ evidence/queue_overload.png | Bin 0 -> 51889 bytes evidence/queue_overload_backpressure.png | Bin 0 -> 38231 bytes 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 +++++ migrations/0005_async_pipeline.sql | 60 ++++ requirements.txt | 33 ++ research/failover_sequence.py | 113 ++++++ research/loadgen.py | 172 +++++++++ research/queue_overload.py | 271 ++++++++++++++ research/rolling_update.py | 57 +++ scripts/init-secrets.sh | 37 ++ 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 | 206 +++++++++++ src/app/broker.py | 67 ++++ src/app/config.py | 92 +++++ src/app/db.py | 71 ++++ src/app/images.py | 102 ++++++ src/app/main.py | 417 ++++++++++++++++++++++ src/app/migrate.py | 64 ++++ src/app/outbox.py | 74 ++++ src/app/passwords.py | 31 ++ src/app/pipeline.py | 97 +++++ src/app/reconcile.py | 91 +++++ src/app/replay.py | 70 ++++ src/app/s3.py | 89 +++++ src/app/s3_bootstrap.py | 85 +++++ src/app/serve.py | 40 +++ src/app/sessions.py | 131 +++++++ src/app/web.py | 187 ++++++++++ src/app/worker.py | 323 +++++++++++++++++ student-tests/fixtures/alpha.png | Bin 0 -> 344 bytes student-tests/fixtures/exif_rot6.jpg | Bin 0 -> 1604 bytes student-tests/fixtures/poison.png | Bin 0 -> 151 bytes student-tests/fixtures/sample.jpg | Bin 0 -> 24299 bytes student-tests/fixtures/sample.png | Bin 0 -> 111817 bytes student-tests/fixtures/small.png | Bin 0 -> 132 bytes student-tests/test_api.py | 208 +++++++++++ student-tests/test_attachments.py | 205 +++++++++++ student-tests/test_idempotency.py | 121 +++++++ student-tests/test_pipeline.py | 182 ++++++++++ student-tests/test_resilience5.py | 154 ++++++++ student-tests/test_topology.py | 58 +++ 59 files changed, 4947 insertions(+), 32 deletions(-) create mode 100644 Dockerfile create mode 100644 compose.yaml create mode 100644 docs/report_lab5.docx create mode 100644 evidence/checks.txt create mode 100644 evidence/queue_overload.json create mode 100644 evidence/queue_overload.png create mode 100644 evidence/queue_overload_backpressure.png 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 migrations/0005_async_pipeline.sql create mode 100644 requirements.txt create mode 100644 research/failover_sequence.py create mode 100644 research/loadgen.py create mode 100644 research/queue_overload.py create mode 100644 research/rolling_update.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/broker.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/outbox.py create mode 100644 src/app/passwords.py create mode 100644 src/app/pipeline.py create mode 100644 src/app/reconcile.py create mode 100644 src/app/replay.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 src/app/worker.py create mode 100644 student-tests/fixtures/alpha.png create mode 100644 student-tests/fixtures/exif_rot6.jpg create mode 100644 student-tests/fixtures/poison.png create mode 100644 student-tests/fixtures/sample.jpg create mode 100644 student-tests/fixtures/sample.png create mode 100644 student-tests/fixtures/small.png create mode 100644 student-tests/test_api.py create mode 100644 student-tests/test_attachments.py create mode 100644 student-tests/test_idempotency.py create mode 100644 student-tests/test_pipeline.py create mode 100644 student-tests/test_resilience5.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 119384b5..23aecf28 100644 --- a/.env.example +++ b/.env.example @@ -1,25 +1,36 @@ # 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 -BROKER_URL_FILE=/run/secrets/broker_url +S3_CPUS=1.0 +UPLOAD_CONCURRENCY=4 +# --- lab5 --- +RABBITMQ_CPUS=1.0 +WORKER_CPUS=1.0 +WORKER_MEM=768m +WORKER_REPLICAS=1 WORKER_CONCURRENCY=2 -JOB_MAX_ATTEMPTS=5 -JOB_TIMEOUT_SECONDS=60 -STAGING_RETENTION_SECONDS=86400 +MAX_ATTEMPTS=5 +LEASE_SECONDS=60 +MAX_QUEUED_JOBS=200 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..9ff992d3 100644 --- a/Makefile +++ b/Makefile @@ -28,3 +28,19 @@ 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 + $(PYTHON) -m unittest discover -s student-tests -p "test_pipeline.py" -v diff --git a/REPORT.md b/REPORT.md index e98f75e9..d4142f97 100644 --- a/REPORT.md +++ b/REPORT.md @@ -1,37 +1,115 @@ # Отчёт — лабораторная 5 -- Автор, группа: TODO -- Целевая оценка; выбранный трек 5, если нужен: TODO -- Commit/PR: TODO после публикации -- Использованные источники, библиотеки и помощь ИИ: TODO +- Автор, группа: [ФИО], [группа] +- Целевая оценка; выбранный трек 5, если нужен: **5**, трек 1 «Очередь под перегрузкой» +- Commit/PR: локальный коммит ветки `solution/lab5`; PR — после публикации +- Использованные источники, библиотеки и помощь ИИ: Python 3.12, uvicorn, asyncpg, aiobotocore, aio-pika (RabbitMQ), Pillow (обработка изображений); RabbitMQ 4.1.8, SeaweedFS 4.48, PostgreSQL 17, Valkey 8, HAProxy 3.0. Код lab4 перенесён. Использование ИИ: [заполняется автором] ## Запуск из чистого clone -TODO: версии runtime/образов, prerequisites, команды создания локальных secrets/.env, build, миграций, запуска, ожидания готовности, тестов и остановки. Указать необходимые действия оператора. Не вставлять секреты. Отдельно указать безопасную остановку и команду намеренного удаления учебных данных. +Prerequisites: Docker Compose v2, bash (Git Bash на Windows), Python ≥ 3.9; на Windows `PYTHONUTF8=1`. +Версии: `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…`, `rabbitmq:4.1-alpine@sha256:6a0f7984…` (4.1.8), зависимости — `requirements.txt` (закреплены). + +```sh +sh scripts/init-secrets.sh # secrets/*: БД, S3 (admin + ключи API), RabbitMQ (rabbitmq.conf, broker_url) +cp .env.example .env +docker compose --env-file .env config --quiet +docker compose --env-file .env up -d --build # postgres, valkey, seaweedfs, rabbitmq -> migrate + s3-init -> api x2, worker -> lb +curl http://127.0.0.1:8080/health/ready +python3 tests/smoke.py --base-url http://127.0.0.1:8080 # upload -> 202 -> ready -> thumbnail 256x160 +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 # + test_idempotency.py, test_attachments.py +python3 student-tests/test_pipeline.py # Pillow желателен (пиксельные проверки) +python3 student-tests/test_resilience5.py # окна отказа, ~2.5 мин +# операторские команды +docker compose --env-file .env run --rm -T worker python -m app.replay list +docker compose --env-file .env run --rm -T worker python -m app.replay replay +``` + +Windows: `scripts/restart.cmd`, `scripts/stop-one.cmd`. Остановка с сохранением данных — `docker compose --env-file .env stop`; **намеренное удаление учебных данных** — `down -v` (volumes `pgdata`, `valkeydata`, `seaweeddata`, `rabbitmqdata`). RabbitMQ 4.x объявил `RABBITMQ_DEFAULT_USER/PASS(_FILE)` устаревшими, поэтому учётные данные задаются конфигурационным файлом-секретом `secrets/rabbitmq.conf`; hostname контейнера фиксирован (`rabbitmq`), иначе очередь не переживает пересоздание контейнера. ## Архитектура и решения -TODO: схема процессов/хранилищ, источник истины, транзакционные границы, ограничения. Что перенесено из lab4, что изменено в этой работе. Соответствие переменных из .env.example реальной конфигурации. +``` +Клиент ─▶ LB ─▶ API ─┬─(1) staging в S3 (приватный prefix staging/) + └─(2) ОДНА транзакция PostgreSQL: attachments(status=queued) + outbox ──▶ 202 queued +outbox ──relay (в API и worker, SKIP LOCKED)──▶ RabbitMQ (quorum, persistent, publisher confirm) ──▶ worker +worker: claim(queued→processing, lease) → staging → thumbnail/crop/WebP → S3 att//… → ОДНА транзакция: варианты + ready → ack → очистка staging +``` + +| Роль | Сервис | Health | Volume | Credentials | +| --- | --- | --- | --- | --- | +| Брокер | `rabbitmq` 4.1.8 | `rabbitmq-diagnostics ping` | `rabbitmqdata` | secret `rabbitmq.conf`; клиентам — secret `broker_url` | +| Worker | `worker` (отдельный процесс, тот же образ; 1 CPU / 768 MiB) | heartbeat-файл (<30 с) | — | secrets БД/S3/брокер | +| остальные | как в lab4 | | | | + +- **Границы приёма (до 202)**: байты проверены (формат, целостность, размеры) и записаны в **устойчивый staging** (приватный S3-prefix `staging/`, не локальный диск); метаданные и **намерение обработки** записаны одной транзакцией PostgreSQL (таблицы `attachments` и `outbox`). Только после COMMIT клиент получает `202` со снимком `status=queued`. Если брокер недоступен — это не мешает приёму: задание остаётся в outbox и публикуется позже. HTTP-передача байт клиентом по-прежнему синхронна (честная граница: staging уже в S3). +- **Состояния и переходы** (`contracts/attachment-states.md`): `queued → processing → ready | failed`; `processing → queued` при временной ошибке (backoff) и при истечении lease (sweeper); `failed → queued` только явным операторским replay. Повторная доставка готовой задачи — no-op с ack; завершённое состояние не откатывается дубликатом. Условия UPDATE (`status='queued'`, `lease_owner=…`) исключают конкурирующую запись. +- **Задание в брокере** (`jobs.schema.json`): только `schema_version, job_id, type, attachment_id, pipeline_version, attempt, created_at` — без байт, ключей S3 и credentials; worker берёт доверенные метаданные (ключи, тип) из БД. `job_id` не меняется при redelivery; `attempt` — управляемая попытка. +- **Доставка и подтверждения**: durable quorum-очередь `attachment.process`, persistent-сообщения, **publisher confirm** (подтверждение приёма брокером) → только затем `published_at` в outbox; **ack** consumer — только после COMMIT результата (устойчивый эффект). Это разные границы. Доставка at-least-once; эффект идемпотентен: ключ `(attachment_id, pipeline_version, name)` (PK `attachment_variants`, `ON CONFLICT DO NOTHING`), детерминированные ключи объектов S3. +- **Обработка** (`src/app/pipeline.py`): **thumbnail** — JPEG, вписан в 256×256 без увеличения, EXIF-ориентация применяется, alpha на белый, размеры округляются вниз (320×200 → 256×160), quality 85, метаданные не сохраняются; **crop** — JPEG, центрированный квадрат 128×128 (мелкие допускается увеличивать); **optimized** — WebP, вписан в 1280×1280 без увеличения, `quality=80, method=4`, EXIF/ICC не сохраняются, прозрачность сохраняется. `size_bytes/sha256/content_type` вложения всегда описывают оригинал; у вариантов — свои поля. Готовность (`ready`) ставится после сохранения оригинала и всех вариантов. +- **Лимиты обработки**: API отклоняет файл >10 MiB (413) и >40 млн пикселей (413) до распаковки; worker — таймаут задания 45 с (`JOB_TIMEOUT`), число пикселей, `WORKER_CONCURRENCY` (= prefetch = число потоков), лимит памяти контейнера 768 MiB; JPEG >2560×2560 декодируется сразу в масштабе 1/2. +- **Retry**: ограниченное число попыток `MAX_ATTEMPTS=5`; временные ошибки (S3/БД/таймаут) → `queued` + новая запись outbox с отложенной публикацией; задержка — **экспоненциальный backoff с jitter** (случайное значение в [50 %, 100 %] от `min(60 с, 2 с × 2^(n−1))`); постоянные ошибки (нечитаемое изображение) → сразу `failed` с `error_code` (`invalid_image`, `image_too_large`, `processing_failed`); исчерпание попыток → `failed/retry_exhausted`. +- **Реестр failed и DLQ**: реестр — таблица `attachments` со `status=failed` + `job_events` (журнал событий, без секретов); `python -m app.replay list`. Нечитаемые сообщения брокера (`schema_version`, типы) отправляются в DLQ `attachment.process.dead` через DLX. **Replay** (`python -m app.replay replay `) допускается только для `failed` (иначе `skipped`): новая попытка, новый `job_id`, запись `operator_replay` в `job_events`; повторное исполнение уже успешной работы невозможно. +- **Lease и зависшие задачи**: при захвате задание получает lease (`LEASE_SECONDS=60`); sweeper worker возвращает просроченные `processing` в `queued` (или `failed/retry_exhausted`); публиковать результат может только владелец lease (`FOR UPDATE` + проверка владельца). +- **Outbox** (уровень 4): relay в API и worker читает `FOR UPDATE SKIP LOCKED`; после краха между COMMIT и publish задание публикуется автоматически (проверено). Повторная публикация после краха между confirm и `published_at` даёт дубликат, обрабатываемый как no-op. +- **Очистка staging**: удаляется после COMMIT результата; для `failed` хранится `STAGING_FAILED_RETENTION_SECONDS` (7 суток) для разбора/replay; фоновая очистка не затрагивает текущую работу. +- **Backpressure**: перед приёмом тела API проверяет число активных заданий; при `queued+processing ≥ MAX_QUEUED_JOBS` — `503 unavailable` + `Retry-After` (контракт допускает 503). Readiness API не зависит от брокера и worker (их отказ не должен останавливать приём/чтение). ## Доказательства критериев | Критерий README | Команда/сценарий | Наблюдаемый результат | Файл доказательства | | --- | --- | --- | --- | -| Публичный smoke | make test | TODO | TODO | -| Остальные пункты уровня 3 | TODO | TODO | TODO | -| Все пункты уровня 4, если заявлен | TODO | TODO | TODO | -| Выбранный трек 5, если заявлен | TODO | TODO | TODO | +| lab4 сохранён с переходом 201→202; smoke (thumbnail 256×160, SHA-256, размеры JPEG) | `tests/smoke.py` | PASS | `evidence/checks.txt` | +| 202 только после устойчивого приёма; остановка API после ответа не теряет работу | `test_resilience5` №1, №4 | worker остановлен → upload 202 → сообщение с вложением → рестарт API → worker поднят → ready | `evidence/checks.txt` | +| Broker и worker в стенде, durable, ack после эффекта; недоступность worker не заставляет API делать resize | описание; №1 | задание ждёт в `queued`, API ничего не обрабатывает | `evidence/checks.txt` | +| Рестарт брокера с volume, принятое не исчезает | №2 | ready после рестарта RabbitMQ | `evidence/checks.txt` | +| Брокер недоступен при приёме → outbox | №3 | 202 при остановленном брокере; в outbox 1 неопубликованная строка; после старта брокера — ready, outbox пуст | `evidence/checks.txt` | +| Crash между COMMIT и publish | №4 (kill всех API при остановленном брокере) | задание доведено без ручного создания | `evidence/checks.txt` | +| Остановка worker после записи в S3 до COMMIT / после COMMIT до ack | №5, №6 (`crash_once:…`) | lease истёк → задание завершено тем же результатом, `lease_expired`+`ready` в журнале; повторная доставка — no-op, вариантов по-прежнему 3 | `evidence/checks.txt` | +| Ограниченный retry, backoff+jitter, failed, DLQ/реестр, replay | №7 | 3 попытки → `failed/retry_exhausted`, 2 события `retry_scheduled`; реестр содержит вложение; replay → ready; повторный replay → `skipped` | `evidence/checks.txt` | +| Варианты по контракту, EXIF, alpha, без увеличения | `test_pipeline.py` (9 тестов) | thumbnail 256×160 / EXIF 100×300 → 85×256 / 50×30 не увеличивается; crop 128×128; WebP; alpha→белый; оригинал побайтно | `evidence/checks.txt` | +| Повторная доставка не размножает варианты | `test_ready_job_redelivery…` | 3 варианта до и после | `evidence/checks.txt` | +| Очистка staging | `test_staging_is_cleaned…` | staging готового удалён, failed — хранится | `evidence/checks.txt` | +| Persistence/failover | `tests/resilience.py` | PASS ×3; `StartedAt` всех 7 сервисов изменился при рестарте | `evidence/checks.txt` | +| **Трек 1** | `research/queue_overload.py` | см. ниже | `evidence/queue_overload.json\|png` | -TODO: добавить отдельную строку для каждого заявленного критерия. PASS без команды и наблюдения не является доказательством. Проверка инфраструктурного hook требует подтверждения, какие реальные процессы/хранилища перезапущены. +## Эксперименты и отказы (трек 1) -## Эксперименты и отказы +**Гипотеза.** Пропускная способность worker с ростом concurrency/prefetch увеличивается только пока есть свободный CPU и не растёт память; на крупных изображениях лишний параллелизм не ускоряет, но кратно увеличивает RSS и p95. Явный лимит принятой работы (backpressure) делает отказы предсказуемыми, а принятая работа не теряется; после разгрузки система принимает новые загрузки. -TODO: гипотеза, hardware/лимиты, версии, объём данных, профиль нагрузки, concurrency/arrival rate, длительность/прогрев, повторы, успешные RPS, ошибки, p50/p95/p99, CPU/RAM. Сохранить raw summary без tokens и объяснить ограничения измерения. +**Методика** (`research/queue_overload.py`; Docker Desktop WSL2; worker **1 CPU / 768 MiB**; один процесс aiohttp, 8 клиентов-загрузчиков). Матрица 3 × 3: `WORKER_CONCURRENCY` ∈ {1, 2, 4} × изображения {small 320×200 PNG 109 КиБ ×80, medium 2400×1600 PNG 1.9 МиБ ×24, large 6000×4000 JPEG 3.0 МиБ ×12}; перед каждой ячейкой worker пересоздаётся (чистый пик RSS = `VmHWM`); очередь и возраст старейшего задания снимаются каждые 0.4 с; время до ready — `ready_at − accepted_at` из БД. -| Воздействие | Что ожидаем | Что наблюдали | Время восстановления / потеря данных | +| concurrency | small: throughput (готово/с) / p95 (с) / RSS (МиБ) | medium: throughput / p95 / RSS | large: throughput / p95 / RSS | | --- | --- | --- | --- | -| TODO | TODO | TODO | TODO | +| 1 | 28.9 / 2.46 / 75 | 4.21 / 5.05 / 136 | 3.34 / 3.37 / 161 | +| 2 | 43.7 / 1.60 / 76 | **4.71 / 4.69** / 194 | **3.77 / 2.96** / 254 | +| 4 | **51.8 / 1.26** / 80 | 3.97 / 5.40 / 322 | 3.60 / 3.12 / 430 | + +Все 116 принятых файлов завершились `ready`, `failed` = 0, OOM-killer не срабатывал (пик 430 МиБ из 768). Пик глубины очереди/возраста старейшей задачи зависит от темпа приёма (≈20–66 заданий, до 5 с). + +Выводы: (1) для мелких файлов прирост от concurrency почти линейный (29 → 44 → 52/с: пока есть CPU); (2) для крупных изображений **оптимум — concurrency 2** (лучшие throughput и p95); при 4 процесс упирается в лимит 1 CPU и задержка растёт (medium: p95 4.69 → 5.40 с), а RSS растёт кратно (136 → 194 → 322 МиБ) — компромисс latency/ресурсы; (3) память масштабируется примерно как `concurrency × размер декодируемого изображения`, поэтому лимит памяти worker определяет допустимый prefetch для крупных файлов (рекомендация: `WORKER_CONCURRENCY=2` при 768 МиБ). + +**Backpressure и восстановление** (`MAX_QUEUED_JOBS=30`, worker concurrency 1, burst 200 мелких загрузок 32 клиентами за 0.5 с): принято **57**, отклонено **143** ответами `503 + Retry-After`; пик очереди 48 (превышение лимита на число одновременных проверок — проверка лимита выполняется до приёма и не является строгой блокировкой); все 57 принятых заданий завершились `ready` за 2.6 с (`failed` 0, потерь 0, p95 = 1.9 с); после разгрузки 3 новые загрузки приняты (восстановление). График: `evidence/queue_overload_backpressure.png`. + +**Ограничения методики.** Один ноутбук; лимит CPU worker 1.0 — часть результата (при большем CPU оптимум concurrency сместится); темп приёма ограничен клиентом (≈8 соединений), поэтому глубина очереди на крупных файлах невелика; повтор каждой ячейки не выполнялся (единичный прогон), различия <10 % (например, medium 2 vs 4) следует считать на границе погрешности; throughput средних/крупных файлов включает время приёма байт через API. + +### Окна отказа (`contracts/attachment-states.md`) + +| Окно | Воздействие | Результат | +| --- | --- | --- | +| после staging до записи задания | сбой БД после записи в staging (lab4-механизм) | staging удаляется компенсацией; иначе reconcile (lab4) | +| после COMMIT до publish | остановка брокера + kill всех API | outbox довёл задание | +| после publish до confirm | таймаут/разрыв | публикация повторяется, дубликат — no-op | +| после записи S3 до COMMIT результата | `crash_once:after_s3_before_commit` | lease → повтор тем же результатом | +| после COMMIT результата до ack | `crash_once:after_commit_before_ack` | redelivery = no-op + ack | ## Ограничения и следующие шаги -TODO: какие отказы выдерживаются и какие нет; что не реализовано; где учебное упрощение; какое улучшение подтверждено, а какое пока гипотеза. +- Один узел RabbitMQ, S3, PostgreSQL (SPOF). Отложенные повторы реализованы через outbox (брокерных delayed-exchange нет). +- Один worker-процесс по умолчанию (`WORKER_REPLICAS` можно увеличить); lease и `SKIP LOCKED`/условные UPDATE допускают несколько worker. +- Конкурентные записи старой и новой `pipeline_version` защищены ключом эффекта и условием `pipeline_version <= job.pipeline_version`; версионирование нескольких пайплайнов (трек 2) не реализовано. +- Подтверждено экспериментами: оптимум concurrency для крупных изображений, рост памяти, backpressure и восстановление; гипотеза без доказательства: поведение при >1 worker и при другом лимите CPU. diff --git a/compose.yaml b/compose.yaml new file mode 100644 index 00000000..cefdf07f --- /dev/null +++ b/compose.yaml @@ -0,0 +1,239 @@ +# Стенд lab5: HAProxy -> API x N -> PostgreSQL (метаданные) + SeaweedFS (приватный S3, байты) + Valkey (кэш сессий). +# Секреты: scripts/init-secrets.sh создаёт secrets/* (в Git не попадают). Запуск и проверки — см. REPORT.md. +name: mtusi-lab5 + +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:lab5 + 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] + + # Брокер: durable quorum-очередь, persistent-сообщения, publisher confirms; данные на volume rabbitmqdata. + # hostname фиксирован: имя узла RabbitMQ определяет каталог данных, иначе очередь не переживёт пересоздание контейнера. + rabbitmq: + <<: *common + image: rabbitmq:4.1-alpine@sha256:6a0f7984185cd2cdbf78a184b4c17abe88ecbbda6006a7acf17dbc7e4307f4e2 + hostname: rabbitmq + # RabbitMQ 4.x: RABBITMQ_DEFAULT_USER/PASS объявлены устаревшими -> учётные данные в конфигурационном файле (secret) + secrets: + - source: rabbitmq_conf + target: /etc/rabbitmq/conf.d/20-credentials.conf + mode: 0444 + volumes: + - rabbitmqdata:/var/lib/rabbitmq + healthcheck: + test: ["CMD", "rabbitmq-diagnostics", "-q", "ping"] + interval: 10s + timeout: 8s + retries: 12 + mem_limit: 512m + cpus: ${RABBITMQ_CPUS:-1.0} + networks: [backend] + + migrate: + build: . + image: mtusi-messenger:lab5 + 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:lab5 + 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: ${API_FAULT_INJECTION:-} + BROKER_URL_FILE: /run/secrets/broker_url + MAX_QUEUED_JOBS: ${MAX_QUEUED_JOBS:-200} + secrets: [database_url, s3_access_key, s3_secret_key, broker_url] + 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] + + # Worker: отдельный процесс (тот же образ). Берёт задания из RabbitMQ, обрабатывает изображения, пишет результат в S3 и БД. + worker: + <<: *common + build: . + image: mtusi-messenger:lab5 + command: ["python", "-m", "app.worker"] + environment: + SERVICE_NAME: messenger-worker + DATABASE_URL_FILE: /run/secrets/database_url + 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 + BROKER_URL_FILE: /run/secrets/broker_url + WORKER_CONCURRENCY: ${WORKER_CONCURRENCY:-2} + MAX_ATTEMPTS: ${MAX_ATTEMPTS:-5} + LEASE_SECONDS: ${LEASE_SECONDS:-60} + RETRY_BASE_DELAY: ${RETRY_BASE_DELAY:-2} + FAULT_INJECTION: ${WORKER_FAULT_INJECTION:-} + ACCESS_LOG: "0" + secrets: [database_url, s3_access_key, s3_secret_key, broker_url] + depends_on: + migrate: {condition: service_completed_successfully} + s3-init: {condition: service_completed_successfully} + rabbitmq: {condition: service_healthy} + healthcheck: + test: ["CMD", "python", "-c", "import os,time,sys; sys.exit(0 if time.time()-os.path.getmtime('/tmp/worker.alive') < 30 else 1)"] + interval: 10s + timeout: 5s + retries: 3 + start_period: 20s + stop_grace_period: 30s + mem_limit: ${WORKER_MEM:-768m} + cpus: ${WORKER_CPUS:-1.0} + deploy: + replicas: ${WORKER_REPLICAS:-1} + 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 + rabbitmq_conf: + file: ./secrets/rabbitmq.conf + broker_url: + file: ./secrets/broker_url + +volumes: + pgdata: + valkeydata: + seaweeddata: + rabbitmqdata: + +networks: + backend: diff --git a/docs/report_lab5.docx b/docs/report_lab5.docx new file mode 100644 index 0000000000000000000000000000000000000000..d14bb94dd783ede10e8a76e5cc54fb678329fd36 GIT binary patch literal 123356 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 202 queued -> ready, thumbnail 256x160) +PASS: lab5 public API scenario; infrastructure and grading evidence remain separate. +# контейнеры до перезапуска: +/mtusi-lab5-api-1 StartedAt=2026-10-02T23:58:35.341793495Z +/mtusi-lab5-api-2 StartedAt=2026-10-02T23:58:35.523444484Z +/mtusi-lab5-worker-1 StartedAt=2026-10-02T23:58:48.76269165Z +/mtusi-lab5-rabbitmq-1 StartedAt=2026-10-02T23:53:22.014370477Z +/mtusi-lab5-seaweedfs-1 StartedAt=2026-10-02T23:46:39.837097835Z +/mtusi-lab5-postgres-1 StartedAt=2026-10-02T23:46:39.850517882Z +/mtusi-lab5-valkey-1 StartedAt=2026-10-02T23:46:39.827928529Z +$ python3 tests/resilience.py --mode persistence --action-script scripts/restart.sh (Windows: restart.cmd) +Executing explicit persistence hook; hook output suppressed to avoid leaking secrets. +PASS: persistence preserved confirmed data and existing session. Hook scope needs operator evidence. +# контейнеры после перезапуска: +/mtusi-lab5-api-1 StartedAt=2026-10-02T23:59:33.742707516Z +/mtusi-lab5-api-2 StartedAt=2026-10-02T23:59:32.383092893Z +/mtusi-lab5-worker-1 StartedAt=2026-10-02T23:59:28.718812327Z +/mtusi-lab5-rabbitmq-1 StartedAt=2026-10-02T23:59:29.238592291Z +/mtusi-lab5-seaweedfs-1 StartedAt=2026-10-02T23:59:29.413843719Z +/mtusi-lab5-postgres-1 StartedAt=2026-10-02T23:59:28.458564542Z +/mtusi-lab5-valkey-1 StartedAt=2026-10-02T23:59:29.099168068Z +$ python3 tests/resilience.py --mode failover --action-script scripts/stop-one.sh (1-я реплика) +Executing explicit failover hook; hook output suppressed to avoid leaking secrets. +{"observed_instances_before": 2, "successful_writes": 113, "failed_attempts": 0, "first_recovery_seconds": 2.328} +PASS: failover preserved confirmed data and existing session. Hook scope needs operator evidence. +(2-я реплика) +Executing explicit failover hook; hook output suppressed to avoid leaking secrets. +{"observed_instances_before": 2, "successful_writes": 108, "failed_attempts": 0, "first_recovery_seconds": 2.328} +PASS: failover preserved confirmed data and existing session. Hook scope needs operator evidence. +$ python -m unittest test_api.py +Ran 12 tests in 2.390s +OK +$ python -m unittest test_idempotency.py +Ran 9 tests in 1.971s +OK +$ python -m unittest test_attachments.py +Ran 11 tests in 5.686s +OK +$ python student-tests/test_pipeline.py (интерпретатор с Pillow: пиксельные проверки alpha -> белый фон) +Ran 9 tests in 10.648s +OK +$ python student-tests/test_topology.py +Ran 6 tests in 1.514s +OK +$ python student-tests/test_resilience5.py (окна отказа: worker/брокер/outbox/lease/retry/replay) +Ran 7 tests in 139.354s +OK diff --git a/evidence/queue_overload.json b/evidence/queue_overload.json new file mode 100644 index 00000000..1ce06bab --- /dev/null +++ b/evidence/queue_overload.json @@ -0,0 +1,254 @@ +{ + "date": "2026-10-03 02:55:33", + "args": { + "out": "evidence", + "concurrency": [ + 1, + 2, + 4 + ], + "n_small": 80, + "n_medium": 24, + "n_large": 12, + "limit": 30, + "burst": 200, + "b_medium": false + }, + "worker_limits": { + "cpus": 1.0, + "memory": "768m" + }, + "image_kib": { + "small": 109, + "medium": 1961, + "large": 3100 + }, + "matrix": [ + { + "concurrency": 1, + "image": "small", + "image_kib": 109, + "uploads": 80, + "accepted": 80, + "accepted_in_s": 0.3, + "all_finished": true, + "peak_queue_depth": 66, + "peak_oldest_age_s": 2.2, + "worker_peak_rss_mib": 74.7, + "worker_oom_killed": "false", + "ready": 80, + "failed": 0, + "p50_s": 1.33, + "p95_s": 2.46, + "max_s": 2.55, + "throughput_per_s": 28.9, + "span_s": 2.8 + }, + { + "concurrency": 1, + "image": "medium", + "image_kib": 1961, + "uploads": 24, + "accepted": 24, + "accepted_in_s": 0.5, + "all_finished": true, + "peak_queue_depth": 22, + "peak_oldest_age_s": 4.8, + "worker_peak_rss_mib": 135.6, + "worker_oom_killed": "false", + "ready": 24, + "failed": 0, + "p50_s": 2.9, + "p95_s": 5.05, + "max_s": 5.29, + "throughput_per_s": 4.21, + "span_s": 5.7 + }, + { + "concurrency": 1, + "image": "large", + "image_kib": 3100, + "uploads": 12, + "accepted": 12, + "accepted_in_s": 0.4, + "all_finished": true, + "peak_queue_depth": 11, + "peak_oldest_age_s": 3.3, + "worker_peak_rss_mib": 161.2, + "worker_oom_killed": "false", + "ready": 12, + "failed": 0, + "p50_s": 2.03, + "p95_s": 3.37, + "max_s": 3.37, + "throughput_per_s": 3.34, + "span_s": 3.6 + }, + { + "concurrency": 2, + "image": "small", + "image_kib": 109, + "uploads": 80, + "accepted": 80, + "accepted_in_s": 0.2, + "all_finished": true, + "peak_queue_depth": 53, + "peak_oldest_age_s": 1.2, + "worker_peak_rss_mib": 76.3, + "worker_oom_killed": "false", + "ready": 80, + "failed": 0, + "p50_s": 0.86, + "p95_s": 1.6, + "max_s": 1.64, + "throughput_per_s": 43.67, + "span_s": 1.8 + }, + { + "concurrency": 2, + "image": "medium", + "image_kib": 1961, + "uploads": 24, + "accepted": 24, + "accepted_in_s": 0.5, + "all_finished": true, + "peak_queue_depth": 22, + "peak_oldest_age_s": 4.2, + "worker_peak_rss_mib": 194.1, + "worker_oom_killed": "false", + "ready": 24, + "failed": 0, + "p50_s": 2.8, + "p95_s": 4.69, + "max_s": 4.7, + "throughput_per_s": 4.71, + "span_s": 5.1 + }, + { + "concurrency": 2, + "image": "large", + "image_kib": 3100, + "uploads": 12, + "accepted": 12, + "accepted_in_s": 0.4, + "all_finished": true, + "peak_queue_depth": 12, + "peak_oldest_age_s": 2.7, + "worker_peak_rss_mib": 253.8, + "worker_oom_killed": "false", + "ready": 12, + "failed": 0, + "p50_s": 2.03, + "p95_s": 2.96, + "max_s": 2.96, + "throughput_per_s": 3.77, + "span_s": 3.2 + }, + { + "concurrency": 4, + "image": "small", + "image_kib": 109, + "uploads": 80, + "accepted": 80, + "accepted_in_s": 0.3, + "all_finished": true, + "peak_queue_depth": 52, + "peak_oldest_age_s": 1.1, + "worker_peak_rss_mib": 80.3, + "worker_oom_killed": "false", + "ready": 80, + "failed": 0, + "p50_s": 0.77, + "p95_s": 1.26, + "max_s": 1.3, + "throughput_per_s": 51.79, + "span_s": 1.5 + }, + { + "concurrency": 4, + "image": "medium", + "image_kib": 1961, + "uploads": 24, + "accepted": 24, + "accepted_in_s": 0.8, + "all_finished": true, + "peak_queue_depth": 24, + "peak_oldest_age_s": 4.9, + "worker_peak_rss_mib": 321.7, + "worker_oom_killed": "false", + "ready": 24, + "failed": 0, + "p50_s": 3.81, + "p95_s": 5.4, + "max_s": 5.4, + "throughput_per_s": 3.97, + "span_s": 6.1 + }, + { + "concurrency": 4, + "image": "large", + "image_kib": 3100, + "uploads": 12, + "accepted": 12, + "accepted_in_s": 0.4, + "all_finished": true, + "peak_queue_depth": 12, + "peak_oldest_age_s": 2.7, + "worker_peak_rss_mib": 430.2, + "worker_oom_killed": "false", + "ready": 12, + "failed": 0, + "p50_s": 2.11, + "p95_s": 3.12, + "max_s": 3.12, + "throughput_per_s": 3.6, + "span_s": 3.3 + } + ], + "backpressure": { + "MAX_QUEUED_JOBS": 30, + "burst": 200, + "attempt_statuses": { + "202": 57, + "503": 143 + }, + "accepted": 57, + "peak_queue_depth": 48, + "all_accepted_finished": true, + "accepted_in_s": 0.5, + "drained_after_s": 2.6, + "retry_after_header_seen": true, + "recovered_new_uploads_accepted": true, + "no_accepted_job_lost": true, + "ready": 57, + "failed": 0, + "p95_s": 1.89 + }, + "backpressure_queue_samples": [ + [ + 0.2, + 0, + 0.0 + ], + [ + 0.7, + 48, + 0.5 + ], + [ + 1.3, + 31, + 1.0 + ], + [ + 1.9, + 16, + 1.6 + ], + [ + 2.4, + 0, + 0.0 + ] + ] +} \ No newline at end of file diff --git a/evidence/queue_overload.png b/evidence/queue_overload.png new file mode 100644 index 0000000000000000000000000000000000000000..8cd6586685c803e1d3d78b04a556226b421f8123 GIT binary patch literal 51889 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 DJW0(+ literal 0 HcmV?d00001 diff --git a/evidence/queue_overload_backpressure.png b/evidence/queue_overload_backpressure.png new file mode 100644 index 0000000000000000000000000000000000000000..5794eeee20ed91bc351fe7ba59a60f89aa06a58b GIT binary patch literal 38231 zcmce-cRbZ^{6CDSq=hmfWp6^VNyIr0NA@OJ8HeK7Gc7XDIc8Qk_TC)3vXz`{4zl+i z*}qGl@9%rxf82lH=g~ag>v~ z_=fZ+87KHl68TggspVvibT@alB2qI)zH)FvI@rFr?`GxfV(a86A|NCrAk26FB@+3{ zMN&`@@xMn1I62!0286AFix82&f*80E5#3xq|4sZXYQcwyDC!$jQC{04ag}gMTU(jo z;$&?2{h^XCTtP3^>)#OKvU^|lJrwO#OmEHB_fcw29D)D895#!l=7dk;Ghq2<7tn{XJ#T`7+Ku&X zAKnQ|rI1&Q`u#ISE#XA9bkl7SZQnlL5c1x07?6z* zeRJUw3lGng>({Sy=@lkkDa5v{Bseu_5D%4Fb!k@CyUbrVta1z+t#Zl>p~-;7wzh=O z3i+S9eGN~w#mdF$>9-a3 zgI^~mwBIUwc&Qty)o0mtMie=^Srz4Cbl9hDM?Z6 zwd>0Jwb}eeUhB%?tL0d!{JN}5H<&CB?qaZro`GP^>v<9@EzqWB zxaGCQ=-Fty@BQa1nOc&htL7fV-Ma;QyeYwMNn@Wy?K6iP{Tsa;hfA%rWHRd!!=+C# zcZ(WNabBmJ(`{Mb{0@ebkSbNAl#Bivie?o?Xp$*9_?8zZr>HPi!$_|>yFPdwE-Tt zRFdLMB?`XA3G=fRSYw4uj=|f?GQI#Fz-Mjr3LPA14`8F&p z%|sw-Bm*!Qr<%Lc9?!@i7cO3Xw*2w>-OqO3W@cs;4UgZDEGZU4P%KLgq(<`c@;Q|! zQz3$y@PR8deAy&7B*-yGwQj4O4+0XT+zVR=26VSOd5f@;2AI`c?VL2zu8t0*k2XZB!N>FVL&)7494@m?j8JML8h|2z~`BkvvB`Sg~FX4{r;ZvpG7nzy;aM9)50?9$(pjc+$n zc)U|&eYJ`57!ntc{QM4PW23gZN_d-#_qxx+U*3$B{40w0c zE>&N5qJ)S}NW3G_e&gARdj08S^V|Lg*ABO>xI~Do-?4r{NNA|`o8N+^&&z1GaYW2hmStxZLf+U~k>%UKMzvKJT==EnYr$R%n ziX!fHg#p+`0)YrV0EOkcHIC5SHaI(&Pq9a%(O@MZy@?VonrrTh_@`t!Jung%2_@HM zNZ@Vmx8>a#$|Tnic?jLgAEAsBI9kb>YSgrH;5`%n(}S$TMAv1dKxc9szEaoTXwZ3S z8!=dzbSSW3DouXlhMv6k$bM1J5o$e`v1-e^7`cd#+Rai=(WRBfSLQBVeB~_N?i9o* zhoj{R3flRf$oO4vC#csyYY8jt?n#!BBFqzNT$Ek5W;&u`q$DUYh0%t;v()vD?#lTc zi*()ROmV*L_v?%Nl7zEnT(6rmOWd9!oP>ki18MZwauifeIoB3b+-8R?HbcY6ZB=db zbLQ$ew@EXbKI+6qF$Gad-IReKMs3*{W#MCtm@t@S(|Rx4QkZw3|JqoM_A+}wq^^iW z@W4gtVe(1PEu`3uPEJ1WH)JKwbc{sn!bx9I@u{4&KP5KVGOdvJ^TK+kmjASN9kuCo zbBY!S#*6A2MscbqC$3dei9^4z64yv8FKHRFmoYRgZXei1$S*SGjNX<+bk#JhD}#_+ zooGDM>WL1K+KNLGR2iB&ykmMAjBA{io?N5U&=sO!r;HbcUjG6s-K+mQ6~dElR%ZR< zS&k-qh3T9fW|0h@B74#&o0ycO6;sincE0z6%TA+}*NiG1zVPcFufE)Sadw*(Mh(C+kzH%)~n zNxqzDsK*%?an4ubZ4y=@eKYv0{+{el^z)}X%iTCQE>9_o=}zLHS7EPt&z2o2(O=5r ze|pT*`%xf1_r;&D@9BhIkb?Xu_Ry~Hau|bHYnNbSDDd<9S)kaE`X25y|4LQRp+c9> zQvLb!XHiyBBXK56lW5up>%TSV;T@5)!;xF)P%^0fBIt z-Cpg>!E_dL58JStheXcW_2=eH1m-u~JK(1jK6zreRTEM^VUjcNwmOo7n=BCymlUg(xX%CytAMY-LeTxsJ(a!(o@*HsNl0N3}=Tc=4OWQkAH8e^m5Cg?<E~6B|;B!osc{?yncgUg{|2j<_e~rfQPk{`07psdmxV z{dYrUj3rwEXbA_3%px8kMzRlhX2t(t7Zsz}4IIl@S%f$FqJ(9kOqkaeFF;4U)DY_V zo87{SZTJJ5(yzn$6#u?TG*pm(F*oDxw@j&v@Yb1^B4kU}xZeagl_6wM&BS|eMWbhN zpkP$%NHq`i;JLMNYjL6`IFkzeawYrp*-S;b$@iUMrG$(Jh~^2WzG8 z@ah?N=+PRJ>e3FRNy0UO&=gHyjvfQp; zd85#DYZy#NmwuU(Q2rj75w%u{Z;21$;vFJUR;2m;UbFDi`f!OpMP8Kr^Ya99PoE(CxM$ecph38i_ygcIz zp@lCVauWs=L1(o&VqcWAFG!fiF3;{P{_eLJk;n%IH>8@WhYmioeTs?^=H3S}Q?$0M zz=8E!%!u7+yXT+Xqik4&-BmZN#~zKE`JZIqSXE>w7O!&_q_upyt!35sF-imXR)zNy z5`l3JWFx7gb(I%Q#XL5i_y15cG{QO@8rFFTWva%f%{gES3!PWmrQej^ z8&2u|!(n1Y7#q{>>IGe9Z@I0Oj?%%HiLo)BP$aFlWDQ`G$9$5zc9-MGS~LEsmUq4i z3{!sG;o^6=$hkZ0FwtP*`v||3;jLQ}@yfa7q1*;%8=%loOHt|$@-@tc59V|>I)@t!0_k_u? zsh`x0yJ9%;!6|gm)@19TvxFDxs%~iA_;-o|l)Io>WqHCwz`MD_N*}1rq7T=Z?WPx9fU)bunNFgl4JaDj*a$g zGB~7Ch2Xh@bV7`jLxDl)`M}L}iMW@LdRRm!8z{Sj;}>(YGvF{#U~Drb_DyRo%ktCc1NPFf_g0 z;q&EMPazcO^07?!(4U`0dHWm6N)cXcZ-UANGW9qJY)o5{BLlL81WR|H?H^)g1d^=v z`8@XBd;&*3sq|sPJ!S(ND_l_dD3k&@f`d6RiQ6VQ^<|?v!*dYBtSnwMl}(f=12pfv zZJS6(9G{?|VBJg{XVwL;A=UZgPC2+V|4j-vXfoSK zWK0~((@zWaVUd!NTae)l*C(cCXqh^YadS<}vAa(V8OsYE;IL1hP$@xRq2&Qk=gXcl zIa;j{Z)GFU?92&-B=wTH0oma?8I%%gz60 z%M{z4r&pxQuVlNQ5K~?aSNTAg75nwM*NGdjkDg+=Q- zfK5R`-N{J*zRdkt%O|P?b;Zn2fI~vPv3gV(79<=Ky&e{-9{svR_##|5i;6OyCme7t z=O1B8b-c`f{1Zw;WJw?jfGTyhuiPV*h&&DhHK~pqEMmM8k)YDWyZE_cu_hSY2;Az8 z#-&%nL;7>$@sAL9#s~zhfh@7J9srcynAE!c2@z~~wq1OcQT*o7-s(4yg0`#s{$sXi z=$dRh0xaV7MOdZWR+^?-Li)dd0dQVtStW)qhXWoBwaEiOZQs7-`}gb)J*yW6@%pj< zZpkHrW?KY3f3|78B*2WQgl?861|=`Zq@|@b1I2nXV6-z`u{U`23cEFlIGc?CI&;p! z{=2DV;dLhIAW&H5m+a#diS|LU%0ecsj8yR6dE^kcvf247}2t;L_L1|m%}6Nt~LuV5fwgpe?{DDC)-Yq z+Nt3n(@@O1o33te#Ga@6x32b!7gJh2v92TY){5xF^ORAubN%1xL41}>;x;z(StJjj zsw{w3iY$d2b^-2fw{P1C5EX`N!XhueUw-%Q9d-=6%=RDOC?vc@Q@!)DR&lN;Mb643 zT`6qix4K-;;srnf^x>r3*Rnll0JT(&!{q|@0eny;BH)a3vd7K$dkd+)D#nmYb-DV7lXH<%JcLqkJuMZvSwC*p1^ai0aA zfBSHaNBlS1l9hs1KyjkMxBvSDo{E-{F%)olC9YvXL8_mW(wpnO_xtLwi(%^=ENOLC z78dDqZoG!&T>1I=&tK}^IZ!wMjS}^^DKaU_bF!4@ z;lo?!Wq7m7^#|@y(qDs45Q@ze>OjV|J52T3T}lOX_Ibfi4N)?9X!DbCWwh!> zf1aM$GLGWPm9M!vc~?!YV(!1`2mF}!UfbBSTy5@m@8AE)O7RQKd2nb;8r1%ZWL@^_ z#7Bkx()1+J7gLxA{{9bi@79LP`^|2`MbyPdUMKUg2=mo=32>SNBJBePLoIimn!SU$ z;q27gXSZLkxYC;88*r}v#25GckA?W+Rr5+6hD(j>?{9;6O9Op9Ac&(r$8-+~1+b=F zRU7l642IsRt`UDe{gJ=;mH&gxqf1j74kWDz+?Tb8rOCGfq6Blq$qqI~(Xs}BrA!X? z!DvA<+3plMx!F@t^&hy*b!R0@Ax0iXacPi zk70a#JjZky5YSNWMl8SobePx%U_8Enfag9!30P^S=oOhh-JELK1ZEG{~Lb$v3LHUgb0a-!(4ST^`KS zrL#5P-QL!s<~RdMGAEofN7>U6uy2}oEhuRCo{d`1p3KcO;CUNCpq3>{x?TZv#ZM%I zubjoITX=YQZr*Dovi!=;jOCI#&V%dFVSttcz@3_hhb8)#+g%#AB^7v%}%tQzzk#<*>RL8>nj<~B=ZU6r>TOfam^moZ1dYoSq_7s*QvO1!00;2 zz-u~wKMk35<(eLWqow%K?Po*7ObSMNO+PjK76?rjsEP=eBbqldIDgF!$_&wZq=-VJ zD5j{;H<5y!lVaS;x(=XyJc)h`@%EmL*3(3=HV*>_(qxLoC`)ws?r?e56(qKIK+oP& z&}z!4lStCjYGprTHm>u~DDeLCp0=;U40ua_T#TgaQZ@!o*n-?l^%g!QxKHE^VlbwJ zRebWpF6i?S0plMDV(Q%PAUzkmts3^_8;E4A(4)R+!6#>D&S`IP_q9Z?aj-b8`j|R7 zeu`FkQd0c=$CzD`r#^lAP5@`vRfdD>oupA3oqbp%$|%l zI`EFRADz>E{l0|9CKF!p2u2FP-TU!ePL_1d^(shv8UlXN=$F4ld7YG-+_dVR23JUt zYz32nZncD7u|ak7oK8!pW_^kLV>qeIy7UhETXV1$(O93J>|)yH;=5INsL#z-E8&Cm(= zji)n8Y5VP#dKJ)Q`?D1@M}n@0e>W|399Q=tQpu$t;r#^;+V8IIr#|D`?$nv8@KLir zqWo{CyJ5JzRuhdli^|}TTF2Y>UAJF<&D-t7=DWMR{vJWdO*i}P{P*>V#7gxm+N{El z>H8}uFSTmKW&KjA>Ihq9y1~xvyB{NZosZ#f2j{~hjwcNs?&=)apaytWgI{>fEHx&U z+g9~fzO?Ni|BOsP$B5g$rl#U+Cr>G7x{QFedau`K!K2=n--rAXdHL&pKM%T6DmhVK zh2jkx>KCH9I$!Bl;}mMzS>(TvI#ZFVAF~pt z)D@D#x02cEVsx9&PS*Xotx$(0Wo24jJzmnRV7k%@V0C6phLu|QJplFY^TY_4u+8$0`9_&30ZhLzn^oe;el2Io`EjysWtuU5Hxsd2X}4qyDsIN+52uh?u7C_swV( zHZy*L*IK0ta%*o8b&Q zI*bhEjyK*)N~n&iq_XSnvuF2>&nSx5m-Zw{=~ejctPE?_C+A~mDnbFQP_1CX>gn22 zM$W@%r58J+E8jmJOqTK1ety4MW8`FIqS4ItTc6iv3$0cdMU)rji{2ip-`DoSBi}Z9 z*}UZ6I4~EyLMw2rodm6tAvi`0$CsA>wN%y}cY?3*^3KLm+{U#fkt!>PGeRps!-n_z zXM2s2Nj1nX&gM|ZuXKx*3(LzC{{H^1X1J%iIhwOM6g20AfPY4XT5I-VWnq`QX6F|K zaV$;8>S&e4*LUQ(wK-90h6Wi@S+Wr}Sl8u&oV6~pTL(Yw$w*1F1=?@~x7omFBWndX z;==MRXjf8+1qCBz28&#xoRi90p>{N`$QrKZgje{pw(mB5yykzH5-wH9m(Ry2lf8f>W`HK;8?X6Y2JJ)k*I+(Sqpyp zyc}3(%(!>7>&RNVbF+Mv>SF(!a+)lJZR}&!BLYSsNz>6bqc7YhT34F>8wc@h8Bc+ zqeKbXJ$(Be{TaI?eXRynlJU3fJ=q20vRl+iH?7{*7r4gM3Vi+~V)N6|L(~`sS7Z;u zD3Vfjj{zz!X~P!kF2u}_7$IdHIeLP7yNDj3vK7L-eo6m>H@b2;OI7O&49x*?SN6Py z*rH@6u!>C2&PHoKB4A$B2ois(t*ylg61X#To}%?3#at$o8KO$C(X{)c*lPh9uoTA- zg^}0B&UgXNSwO5BjK|j5(5J^dB3AL*$(b()sH$&14|a68C5s(3S6YWb>V4>BqsV$d)ocTA65nPdB*Piy?$2)qg>?G2=ymIPD91jF!0Bw2LG zWxR7-Or7$9?83$PMKXQ-lPp9ACPoN)o%Lv-(ot@Cb7f;^$Hy)aTc-#0i82+wE3pUg z(lxE;$IKj*v+?h~v-N-CxZ`A$W=R=js)q9AddK&qJpzKMIdi{L;tH+{&ndTd zK&al%ry?})YU9k)zR9AQQ23-(Vi?=*ugZrV&}pZ}lT1Te*P`RD4%b)#lfI7Hx*I0w zNO=-&XeCR8ZS5eG(C$5m$Ur$d;0QwOwHc%g!gE}_M`&jil87B)#ms1em*YVGu$GB3 zJAD}G0sc-pA~-659l-%%HaTIl{p4nhB^Ad15S4O`)jH}_IVf8;NO`SfnV4vK5>=RB zDBPgE$IkzJWD|==v$y3}3b18IIkrAA{5CrjDUgUWk(u?iuZoQk^}NgPsfr`FZ!7}Y zx7KTatzZe9Yu90uJ^Dj4w$2G^`Qpksd%&&BR2$yq&XiH!u;>ykDl?+U>6;MsErQ{v z`MiHH-0R0kM5PXzIw?x973A2MB|zcn634R9_k!u#YhLs(#nz6O)X@uv=S+}&MCcoo zkc{ve1jmx82Dv}HZ8<`+`Zs9>{a6(TSDAx#1aO+jTk%Cziaub)2Qqg^vpv9+cJ4Xj zxhx|6P7iGA&CEz-$TMe1jY;%70=YPA(d-(Aen{vmURS;%cFqp`HBES2MLg5)a4hm| z6gL%{?MJry$ageP7$PBh(BTv}RZX{LgVy)Z4QBeg6|UT_9GnES_|pOCb6$Q7m9%YF zD!V+IRNeV%`@G;0YCxOto$YYI1ilLLaZjO*Z!0}&pTk5hqqflJBbFkMF#=7e$Z*{8 zs8rCF9OMDKFz2*%MzlWU6%R4G&g`HrgNf}idM#+gF$3SCIbI|!@Fv5!4mA(m$m*Hy z*_JsuJzCe%ybbMSDM%G&(rECuHKNXF(UcvHkUhMd*`$)*qj-x(5eIFj)wwRKWvj&A zNiMV*{8H2}>+_v2Cec%IySnv^c|#_#Yg7Jb$=?o)P~0X0W=;!l%nNwGKu%{!Nfk+> zg)}T5>BZzkQu{7a#hKDVZA&5r-U$yT2-sE(0ixzgDE_AcJ7*~Rfjm6?H$ys0^E=Y( z&CSg`ly8k&2J0`g&!RB)w%omiu>p$sJecz(1kA*1HfDwe-^n~Zjx?&mQe-3B(5}LM zP#m2~Rf*TG@YzWe%~c7Ffu9#*A8o(zT35pbLMe1cBr#1-S`(o3Y&ZL4YzN)QqCH30 zUPj*6g71mkk&EeVV7nP36eK+S+KVj!<5=KKRpcaNqZs%&2S&c(+98`!o6`5buZR?` znOtsheOA$!gvgdXIzVMfKfDTP4wg^+TrA9Ny9D<$md!^7bWFAkH9wS-DPz%7%-4;rBEYJ~h){8J;t)mfKr zhpWccjlG`q3J(HAp3hR#V@(KNFH`M6moqGz z`>d-(_lUwxxPmXEgf{=WDsSCiaCB9f_t?lpxMB`wOmj7;$}R*x5V?O7RYLyPbJ~+{ z=wA1E=X7gvi_M}C3&SD_Udit+M)~4dcnV(7qXtrT3=yRYhFO+Zlggi2(KJymDhQCa zuYV}NtfFTF&1Q`ka5Y-QK2^tgXAYLyUNo9)r&1eprqrr539Jtjt@NJ>!N1>0 zn4b3>3l3_=7SNXLJiClOU2Zo?M-uxClnCGP+Dv(5z){(h!I3V_W)O(Ppi8VrBqkto z@vaFXAJ;p}aQ6*KTuwt>O3BWEz#!MVjMVuMPHo=J|LW@GRs93S)=5BHl+)E-=zSfW z%R8-?w6&MgbYMgYT6@pGW~}t!Gv%^t3XSCFq50N$?_t}Jo?X+A7GiSfo#P5YI=^YR+~8(*7{@t} zmH}EW6j?&uF4YvZDA$TZ#OV*2YbJ>^ik!P$*}+X8t8y-LdNV{X%w%1g@AV3l)4kUi z&bAsLan7Yt0A{!SiAnYC;OMp|{ea>^zE*{o*k4UtK?vomk*yrJ->6@T)zD%v_Ww)w zErwBfaAI$=Df;Mx0L%HUGSy~9`57j#x?fC+h;eyiL>TJ%9d}!N#&jeKl%Or{k2E3+qK%+$sZJa`y#YkoX$<8JNSU^oE$?JPrga72nx zRhA7EZ{^MH4$}8zd0q!`_i{*jp7%%Nu4E!7MOZe;_(nmxbg92zw8AutAC>GswRHS& z<6bzJYo-D<44sIzYHk~otWOZg4y@eVRS*ctELQ?M0&s@Zw&!Z!=q_7to85sbCWY&2N_!t9O^?1m^+Z(bFQFUEKMN;dYj2O5G>T0-!nCY{wiq2b#wLC56xruijHq8@0o%0jaVrJhb zl%Hr)B^{SYT~4XjC%Yz1!GMcXq*?CE(GvIh`#`|7E(pb{oEz}O9;n&G0ss8M!eSGQ z@w1YT&e76#Lx4{0X{QC?J{N{c(yw^2apmab#TeeZb?Y4<74p8wPfYU5$}-h^ z?S2KF(*v)amvx)14AlVHWU8kWl5_!KW zA75UTb@l>wfxKd*q4@xWVL8vU0h!3Nz@v!`GIdQSq>#QEE+{IuYH(j?0$_l<+~=Ma>6+y@wesU~g> zFli`iIJ{y%kgs8t59t2RL!f}V4QPlKATh}AoSd17D%cm~fBxgMXxD&CS#4waXuEf0 zOx?w6cd{kX17$1ttOnq=mjG*jwTm^y3T%STO+oo;(q&MYhw8oERq~7z9w9csfG%f1 zoW<)-8(3@5-|uXyLq5z_dVSKGe~AG- zqgh};MK?0MD8{aWL_R#9BpafTZz-9HQ&+^;*c4sc9=d`s`IfDbUJOQrI*r39tzC8k z-)uGD#ZwXSYDMh2fpXw^jV6QmzT*{`FE`vPh*7TEe^Y~Ay!hFZwq=WznXd7GWlgCy zSCNx9{KE?f%xT9~^XEdDBUQ$-0p~bgw6GXn^(Rj+qsORqw6>avT}8Ua{{)wqk=2NJ ze`Wae*|^s-f4Rf3X403gj#^R!Jj?XrV*J`3eu~3{#Hh-#05<~NhmlWVE7W2`4-O~J zPP1AE4UCNP1l+-F?{}@S@FN&*A8N1e1$ahmtNZF$jaJyYuq&RR4T)8;&FRj~?;8YU zdcq&SnX=H};5R8LDYyx+C!zP`nAAQ$)UY72lE#Mm!Wh`7dZ|Gz;cJ?%Ry;1{KbTQR z`)j+1t>=A4FJNtaZ`5h0-?An%)~ITaBR%E{hVQ}BFe(e$=~x3KGdqQ5$&0xN|1+75 zVH@?eDg=dbL*nM1?;&I_gmZru>wR*#Qxy$mEz5a5-O6QDnZG0~_GaA9>bcRn0XGkKE{BKSF7{}%}6`nHPAzm;kij#go^G&eWeJ(#+MtvV+M z3XIwX=;xy=yV8+uV|AV`$?H8pKx@Tl=w?~ffb8Nca1_=(_ZyvHop+?WK#HZ^)^^T= z0|q>LMlo<7(158RVGi>Mq9iOpNg$qEyQaynK{XWWa1@GpEW#2D|4>yBGm?vmOcrV4^&|!sO7<;tR++K zo@gOmK>F$yIO4FQ$!x=s`C<4^+dzu7WWoW|(z{}1uXVSEwn=ZAnwtIvUuza%n)+@Y zVRQvif@Td4^_2~~(Un#@Ro(bNphI=*x8os50+G`%DKo$Y>{JrY3cKt8y?TWxr|oR z4_-5r-RYUo2CQEH=TTjeu4|I?cLsJHjw#$fGs~b*% zS;Ut1B;0ZlB**v~dSW2qhX%YY5dBc`^HiM1MFq*?^5`p4(@;O&8IiP2JpiNhsA?Y_u9y9MK{c;qVkktN8V zDOZ*%j$(5tg1AI0q15puqm)8%wVV)s*yj@}GEK7|724=@Tq5*-05Fd9sBrl zpjVNHW~AH(+q2UiCq~a(ZTp);bWat>Ydu)D1Z!pP9IEJU-?rkpK+a~xSgH!WPp*o6 zssod?@9^L*NMXF7yz>y~IO0pVM+KNUWXT1>E9qv8#(%X4@dz^&>s`2k%#D}q?YObr zV=*qvA<5hsrd!=j^&CRP!EcA|W8v?BaB*&zhLPTPb`~T~S$jtiZh#xE&u|bP?k@6h zVc?el>-R;&@coPg)dqy+ddDknel;AMMVhL?{WnQ<;oUYI1mXT0{p%4&|IK1%%g0?>}lPXKR!or%-W^=AESXDPb zAGE49f+-o1YjJH6_w=^EL8)$e_6Q%;S_(w>#CK!{C0l2poH#RZORRGDg=2%=o?Yh+;SvXD{PBWi zPYgfI_&1hwKsPw3b%CTPWYLkAaL9HOwST{8HW|LJ<#{$z;$RC+x-}5L#hkU5RU3ws zkMfExjIeFPFTzM39Y_P3JLT#!Ec1F~lUTiDo^2N&y@-`RRdy!3>rFbk>{jW{N1)s6 z){PIoy33FhD@1xh{DQ8mhT|RFU%G+h>Qvn2!-%c77#W7K-Pe0cq<&+Oi3^G_swAJ| zC+tz@YqXlX)f6urpKnMaPOlytT{GJq4A>rBwRkgiTs{?LC`Z6Foj8jK^3bdL%J}z7 z1-uVDx&nDJjD^-$Fa9kv^VQ}{PAt))N-9s9iEtW7Zho6R6Y8O8*#PAC>1YS+>erXt zma2vYh82BubwCnIhZ9$fx+vH|9iRF-K_I))DnvY04-mNm;T)7^n{7aCj<(MiM1aMPbw zoifg?Hh$_|<^7X!hh3sQ8N4xMcvwztx{Q8p9;2FaXuhFjS$Ce*C_A7J-F_cLN%Tne zPxk*#oLqUH7x-uJj>q$_a}@f14{tG>NA!z-n{dDMXPcHc-L!_2oII$#m<{?tqUwu` z;J^)(?R17Gi%9A03WBjVCUMgq>3vV%NDg|Y+M_<#%P^SEae8;e*tO_Zn*vkXQK&Cn z`Q+uoac^NkDuAIh9M9_ohb4|^b*Sp%?3HglS#hZ$mIJ}?xyIi_E=T>!WK{slF~B)F zB@f(I4LBrI9WdG}=qo7zbE?01@dBr1JtGRF0M;-1OO~sV^C&|mLi5Mz(yjZwP}n^& z2f6`9Ib=b2+QHqMDcQ~UyaOktKrXvvEbl;~{+-*N&GSR|Ti3HwU){TuD9RcjJ~;IK zxmNc{BG_Uws5^l43Z~Lny9>cn`&wF;iBrHMy%POGfvXIpN8qy!X z@NVZ`!Yu}dkaMXAd1Tlh6+r+^VXCUy%?TkPFdTL7yy$smdh_&B;h)2AZN;S|vUckh z3sd^oW6<3s-Ei~kqarNF=%&19lcX8#Ey8 zc0yD-u-i?6?sqZ)8+_WwUmhQqxG-am{2!Rg(QZjn4N_G)c!jOFtn3>YFeiH*gLhs$ zfFcug@9)4{An7(e$#z$XQ4+OhTr_3wCK_EuVtgUO?~|^YuysD{4fa(@!_Zi`KmREJ z5;MT&BG)FBBAAlQ2V&#m=*n$>UmO@1xP0we3wR;y)pYB%+rLUG!n=o^q%P>tssMn0 z)o~HAF!f7>DrtqWpGv{V^IPvvLw3o7(+QWCQbI&$$#oqQJm9jzDMXIoMIim+=ft2L zN3TtX(C};WzXBryMIaK_D7AzhgPET=a^WTzr^n6DvUdW_q2+1A^NO*?c+O8X;>A;H z_j^0q-DHP0QD)$o?ah1X>K3?6&#?ly{6``I06l@u_FMJqX`tH3K~@dpTzPYK3vx-s z3P6k8^y7z`jFM$Ihf_^Z^>?;g&ZP=xG^QT}u3O1>kQ`{IVJZ|pr$P@{>ek{3^R)+gk?A;7zT&ng{;vj)69JhIz_fuJT8XJY3h<}}`o za;BcmgjKPYOufuDj48wvhP&mzqSpRVPeill6jbB8{Ozbwk@GAWmjkk9Rrr5I!uL!{ z{R+Ei6@BNWz8ux6knnK0yN_{$&q1F>e7yK;mWG45gn0p84bwY~2PEi+c=U9T*c}<) z%|KPYUMRcR!=h)mU^hNylMk=UeEPOt`?mNPl6^;H-+H?ARq^b*pXW>X&i@J>H&eeq zuGJh}j_ueX7N)?tNfNJ?Ms{OLeZAs&XG^+6>4ZqYds^I8V8l81wU)V4qODM-DO04X ze+zIWO}*iqdvoXoMd4szeP;gpKhN#MHrh71gW&@yfR8%ggef8cAj&Z}H~;&0Izngp z^O$8~!UCaItTR?HrL=$#MujO4eEU`l5zC~frxzt)A~~BW6&~I`1kvp;VGzu=DthtL zBLi-$KpX7L+}okN>Rap*m2&7)5ey$U%T_~f1-Qb&TAD*21@HpgZRh&CK1t5sRHhP$ zYqg0JRGDARb<-O+`pH-kz<}=6{+dZSVszmCENADnTEU5L4ZQpPTiI^1x&0ry#dHUTwOZBV@>fGeE*Z!PaDY<(J%%Ep@w6niZCAA+rp{p%{KKLabOMXFIm;nk^H=MAG z5(v27uR@1|M12f~pDq}!L(?!Av0kq!xKHC6A85c2BmmW9aMNCkVZ{juy*O3|W+x{D z_>C&FHyw3ywdDZ`F$rEP1frw7`J3@?uVp#?>DzsEj{Mn~MrjoN+6;Ag!o$9Oo<54r zOARWM0rXm2nbc+e*41a^>Oi}3)kGE8y7PkW9eQmAZcCmw01{=t;}GTuZ>Rgt$&pIH z5|I)@o`|fc>Hlg>O$|}Jc#EDoBK}nGf%o9;@29lY(fm_bk|WyO=;yE0!J=D*-a#t> zF6V)A3N|Ou^^dpxYGJ~WKGxRZi5MZD4H)?@6N!S_i z{Bd==X@+b1^`v$&+%FecP$({)2lqG{3}K*uU5N$_LaDafQP@9E@4gM#M%Mko@x1E0 zloSm1yrB+l17a$2y&Y-9*EYRVytvG|CD?nR3Bjj-CmL0ePr&2BL9wJ4if=!tN_t~g zqfEeanejh*tmDYwf{X>;(4upQAR?dbJNDjKFl1@d^mAS z5=+M>u{+T^)NgJ$8Zce299W_|bR-y@HyYQn9COM400n6K!}B$1y0g64Xj_{hUp{)o zoyFnC(Fy!rW0jYkQ!;0@Z~$z#JViuWTd1%2`5;MAks}zeT&T~u6Je${&aW-aG;e*n z7{DDn!O&^oD=ziNulBrRLwE7N#JJN+S_PWBPa*o{|Iv&FO@IfzOg0hmb?WV4-&QSu z-Lv-L@n26_L?FmgkH@Uto_S1lr@%|sX4J})CnN3+q$qeG>;600>%4-$<8Z7AddGI{ z(_B^C=nv^@CXB-AikygCHc+D@uK-7(T29I;w&IQAj+_T@UN(RFV$0J&s$o^kPqX0EJ&#@sUz_jJXe-EBdZB?l{JKHpZ7 zU?~33O`d;{*XVKqPYpc|V)+MT{nlCV2axXRxSN7Y|1kVl1cli^XQTA|NAPm>D=AI> z2+vfs9T~ImMUc(uey38MM@6A6RZ^X#%f0ZA(hrf8zip4)cmZ-`LR&8sjG4AU$sh;KIgxiXzta0_;o3QIm}UbFRc9*RZ{o)jz#=4 zUexlrsh?>(kYqYGVq^QyM?d8S(o! z(x$ZS+ioofcR?&l=AM zHs#_**8t4!Fo5J>Wy3LK>-cIrA9YfBo*_xXhh;WNDCDc^8D}tjiW>7@mc#&)a7CCj zY+v@jcU_}v{U};bo)N_kTD^q?$zEtJlz0gF;oquCfs#~%DWQ566xheF^)3N2FML;> z2D30TO$(;R$X?(b#0jDgv6;Ma5c9bM%N-III&JW|6N7-IH6%z_?D1xYR6yHsDa>(+Pt{vGqV z1lKjI zhT42C*NkNrX2BAORlKABEe$_O&!)lj>*Yhb+QmAwjUO0^ZK#y5S)0OTnq|t$%Cbx@>V}<%@di3}$)*InPw# z$}kV~!c1p9SKSeKTukb}rv$Fe70b@XVLmoDQ{og>|LIG-yT*Wo21n;DxLhxE-qw4A z8K@d4QSSls7S*N8c&#P6R)f31NqFsJP-*PKObTefj?4c@|2ya@NLEoHFQ%x4JeS!k z#v1Hi_w8|gKji4N1```89Viqj{7vo|yJUP-#Q9p=OF{DQd`hu*Y1-Q3s%87A@~V&i zpkfbd0qdmI13be4?4?i5=l|zecHxNrA}N8qS-qtwrT0?;`SxjvDo9~GZIXQ^9ElJ4 zcO=RARoPug3Mb`}b#~l;ixE!;L^Q5*O2*@BADz;V-P-M9cUP1B0=xxajC?213c&!Q z>fB6d*Y6&_i;bCZFs4}}+b&5Cc9t&?CfnTi4ilOV!*S_-=LY4jYg1}-Tj`(4x6d7x z7BbkeP^~!QUfgozH*3(QSd+MbRS<y3YfmA2r6BjIH|JjHh#BkKNCtuS_ zHXaunGW{B(c)BH393H$CP+uT=D7yQukxkNeldZRd7EnyiM3ss4*TR&(^#lTG`W@iF zjE`))o_^=Fd-i>pY5n28udV7ohBeiEm4$f&n2>kVz?TF)5Gq1#dHe>@yxKn;w z%p_pv7aGf6B)apQKt=y%gz0^;!xuKm91M6k040HHfV0(6I-)(!LxC0*6a;ZPH)Q*t zJo6#1HBd!*D_IyF5c*Y$O3@2gO8^8*$f1A#br6$fc^8(BT(BGA4m`x0oVut9pm}pi?_d;Fyam$^ZWPxy!2>57o5SW+thJAB@=WN z9%5Hc=I^%Jm))4$as9VH)4;tKB-q()AGrM{t1uo-zdxeO{Zo=%_>UszQQ=q{Ov~Nk zJAS%)bED*6m5u^cA#J{VZ{}KJEq!WC8!{W)I&u@W$SG;yxgu#Od|sdE=|NogFbgn~ zQ$I4(?rOLll8Vx!9NrIx4I6+Zsec5JW^IBoyfs5CJKLSGv1VN(7~(8x;X5 zX%G;lySt@JkQV6($rkAIoTJ%8^ieIA_V{Lc~P7|?zszb zO>RF#DDNT6V2Dkey?)Pll(vLL@>*sE@l)OFF`9{CJ$l)1a_+irDFuc?AU~n+c!RJ>S;_F2L{oGVuv!G2<(6d1hT zkZn^&MYFU6$YRaId9!p#jbx-W@vFZms-h{$moT+P4a<_p#nT$%d>VRUOW}rm+SaYk zQfZRDzFYC;k#BPF^8CPI#2d?MI8VP73Z6-kgx9Yl5j|1z_ZTiLaDtF3Sp(Aa4`5l} zH~oQDP*A|@vd04C%MT#$B~AZh)J-YY`s}^O7p-;8I@}H-y9c%*z6?==TMX}-Hy$*= z6pAi9<-EW)fowP=Tl?5VZFqY-V#5#D^9^rMqx{*vpJ7^e1SxyVo$HF__TbQ z+~i2#3lst;;w30+b#cgPe7ApYee{X0T)SQxUl&%`UGr3^da_WUa+nnlOZ%2P9lTuX z`}l^J&6PW^4OKZ<3ON6{3`}%6O<~IkfuEzJhMQC07=P1vx&Q$_l3gFfo1qnzM3irZ z_jOb|Pd_G=8EmBQW9qOpt(|aQ03a zl|t$w2$k|nN}g2M%qtC1@LHjPKuzUwoEp^erswBVC_#9ydGp3af$palhN+);Hh3qD z)j1RS2KPAXbKcBD`O)v^>0>2^aS^9>_7X5CFSMUlIe7Wtb4^UNU~XiYI?zb8;J#KfgPu5coB{KGK2Hh-*Ex*B%8zm5)m zEY&q#!Ha9BbMB~%R>u!GQ?%2z-Ei@~ySg|yJmMEqOL%Da8sp5oUHt-vvB_RQS=7*p zLG$OaI(t0d!0(PO&!2x$$)Ml29KS$)cQ>#9c;DE{a$)1Eh|{=#P_64&Az>;yWz8PfUzZ?k@8@yj6Bg=fZR6zP0DAyBW%d zRJ7+=?@rFc&fmgQoUng9$Bqd(FQ}}z_<7eOZc*%}n??8?>4!X(5r^j=$Wu7b!HA%j zMI-;w4q`ol=;307+?+F8p~9c^SLEGeK2~0^kP@ZWVLJ&P0G~d7{1`q8W&3&M;deA1 zC(Dzy=R&)3)iqobY8Gxs$rH7PtzBi7eKfm!jqia8WCbx8X0BR_*f}ZS{h?{KB%5imZwC!v!?IDy1S=aX;kZ0H4^QDL$Ut-rnoQRJO1%<%Lm?qZcb{=0jbs$Lr(DmhAgn zqk4O3(t7MgYbn*0bEg8o1*L0DCEWzgT{0Y44+TD#)VStW&b{t=>B47W+io2(vS*{S z5<2^!Xl=fHn0C^?t2AmOg6(iZ@V8*+zPfbnaL+G2cdFt!hgr?h&W&KUL${8XE{AUY zv~?aauh{DnD(CjO;k)~qQ77)gzXg|$jyIlLdTh;vtp!uK?Ct#?5*#_}O?qxA{6cAk zGlD7NaBrh7!P!NB5=N_^Zg=nW_<5}xa7N3h`1eLO?y#-5?`5e8x*YeXCA?(sgp2QG z(B|!CucdTV&IuZq)(rTuWfZ|pJ{+b^kTeQnfW%p70S>1U!y);60cA3gN1@8+)i#8R!FRLEepLpqKz^7lK9Y~kd3p*O1(8a^(HeJ!*2D&v3C zDYU6+?m~HTG7U(Tra&!PAEob}G32)S4GY2dGVkRa95_a#D3u=1g~|V!5H3TDa0<%9k@Qq#F=aJg`zo7sVx>D! zc|d8ZRemI_^{9AwL97flNjEplZX@c zpahvPQ&zIkmpDO}2WG>$frzBaB1{WdFwHlmW9=;4b?U31VmBfZ6l*vNe-u+Buna)v{z1e z)WAC}AW{;`3dCwH^D+zi8TxfX9lz;(?s4KyNkq|*Bgrzz7DYsR8Z@>o?s9(>AW)QZ zxkltu;qvC5LyziUiPFzejU<iJBnf62r%yt5n6gp5umE2DVsK2nH?^iV3OllPv5r zl7c_H7dA{do3S9*E?K-fReQY7PZZtG%iUY_TpnJ&T27Wu1t*9nCla61$}adpY53-59E?jO5P{1i+j5?a&1ezG%~WiieitSgQHdQZ1FbgJXq$sJ); zM}Fq_Bm~DXk>qYvX5YE;g0Xh7DFLX;Kft^-02M9YmJ-T|nv;&QZe4=1b0o+9g$m1h z!zX&`w^sJ~%~h-&hQmv02iqx3RvLZp#b_)z&(iihc~;5(r!;J7*Eq#w#K{2f#bkoQJBnreJNq%n&!vN~LSwQ0{K z&mBDGpqrVf;x)Im2M4ja?3F(m-Nc+pYhr2p4#iyPz6#DuV-rS;5<>~3_qI3DZ=#g?eguF zpNk*n#g8+-;&v@iZT6HPDmq!tRjfD%P+I~prntj_4ZCmCz*^KbM;<0)x4U@_EBo06 z>I8D$BB*d_88b>=>etl$m=c?GFRHNaKR4$fh`FkL%e-1=lp@|Nvf)UXhvU_;F~Z4! zB>Sv8o5n@xIwNjO zpirqTEx)8LS+lFL`+a|I`K+U~lh=jo0)n4udyu1$?D?^|W$_z9&yLMvJBK~3xA}q3zj7f zQ$F1p88tg>EG1Hnb(kA$JNt+&O?9nLPQS1@*8_ z^$C(+#!>F1D%nx=Lj#8czK`ZBx;LaJ%>!sR9*8J!P@A2m@CV;}*=}7NzZ6U)E~2U? z4e*6fg>&jJkUb8P4SyBIIygL>22p1-6ozbeX#EONmAHZ9(PKwyMKX_z^R(i)B~Uk$ zAZLX;z08cs{obO@KH~D*t9y&3p$O znk3l7$+5)6W+#<-tQW-IX;Jon^C2Apg6$xyHi<{gI2yeOWu_6mcF*{?l6=zuO=~IR z0`fU^O2L(g_itHSu?PubbkT^ZsDh)TqoFA0?3_C08}QiG;5tCDUm}h5lIiCCp*V{| zVbTf`Ed0p`?jLR(6tKC~Gu8mA$gM-+w82xaTD_&g`nP_c!A%qLKvMFy+ePVN&sYVn z1@x%Jt96?D+!x*LyL1q8jbNGAgIVN~MW6O#mr{kUX7r7c%?5Kk!6~DJ*M0y)h$y0jdMYt1>uc) z-1A2QABd0Ggn=w9c1i!BVM_y{tBS1~Z`~tiKONhjZv)b_A`Z5qs zSg=KpWj%OblHsfGpwp6RIBYG0B-Q>3;ZHs`a+# zof_^mH}HXC=Dzc!3#a@I@XEIAmE~_(86ZnB)Nl&(D!DJ5)iEkVl0jZv9-Oc0p-zm{ z3FDJa6bc^+AxUr>jpUm!Qhp4CJwJ06%fnXpmi6d9qrbx^r?2@%H3(`FPS1-8ARjD?rd2%|A zJN}%;$FxmN^xv9$)xMiUIMb7dLKk-(%wVz)eBtMy?RY049uEK!4z4MjPr>6smcyT$ z*L>5`NB~C923+#y>`Dy-3m-{hB-T-+_+yAi?of9~TCfEj6dM|^Qubd5B-y8^Ca}_! zPLK+Iz>8fyp(W5KSaTU7r~8CWWP#+bAthmojotSbrNi9pdfj(<%8i= z*D#iU@U!oJw-`Q6qN69B@_GOm&*nlx;Um1K14Na_z5$Y-E$X{laDbekh^`mYAa{c6 z+s5+l)3$&WIH!V1p+XrH`WqV?@6Okb%~>Z_+b@VAq?-Jp31qHqd;YN{0kF(I_=R`K zE9S&ULi~X7rs!fK~cYp^yv+SH` zM4_Byug7&w5(kV_<=$ptlFJEe|5i0%(>fJ7v1vbB%m$Tl5!s4MP{3WSv(dj~X<$_K z0l79VDwX8pMI}zL^`f8%)u=rhyn&{vSM-NKyD%)bVh&BfCs5Rrn`5;YEB6A=&RLj} zm+|rCcM*rhAAmNEIcg@RNnjLp9n&#ISUpZ7OVN;q#k*i+>5tA@4Too8CjUIF7DUbY z3u;(v-e$D-k|TIBBblBqC0-{WjVHJC3iHf?eFX>wA93cu0L2HOj#*F(`vwK6b)uY% ze^>DHI*$3x)K^YlnFp$er-(Eb~^OBtk>xmC3n!F#3lxCx_#ROFv>wo{1vctx3oH@xrv8#=_n0r#KK0m^h>Wbnuz=Lu;WK}d7k7FsS4(~(fC6G=!s zfA=Q&bYOx+zzS?@c+&Jkmol8*&za>oRz&hMMcEqTK@@urO3Xw}cG+szV|ylA;J&RE z#4cXN5`L5*d^OP|=FP#E2p%m}8zho2VV9@db_W|+oGBe0ou{k3A!W<4g=^QLz6#IJ z{PNZ`Rxq{Pdp0OU&EMurgOcXe)R%Pugm>f%Rn%DLKYWEj0I6HoLm8CGEzvnMVky?O z=yJ%#o#s}Bpng(1Teu>! zY-IWNP7YIkBt&}xA9r#zWCFcLi5;nwOZAmzXN}^LnmQL1s6hsegI&+R_ zWgzch(XG7E-QAwyVJGN%a1F7I1_<=^k+B~V;CGEC#O?lxH~Gx4FjKE}hr00Nqg+1+ zMLT}0`C2k8))6M!*Yg18A{8270|l}{(GWKZ;y4y{_h$E#E%8D8`)g}~JQHn!QFoQ# zJS4EjmSk8m@`1Ii!3>~h`d5e?mL{)3@Vcdtu}>1UHlveyr7yp z6^w4OP5L!$-~DRll%K$(L$L-7CJ0r&R2pBI?s3Ps74F+MFeioPu(zrSpaChEvWS5J%5}m+49N=flT?3+J~Y}Zyffchj5WtmsN?|# z-D|Ip1`q*MBMg7CZN>RaLcb}8J=VfHwup>CkFsxD14cP0VG4cR6AiP;UnbL!wvzr6Ka8$ra^P=>U? zaYwz=U8a?Qb-ULN6L>HZuY_oI?v*&adP%zOpIb71rwDh<<%a)xj&RzAib;FA=UjBu zg-d?bPeep6Xce1&r7H`&ScZEGJ@eb8*=pKix=U^Wq}c5~5wr=4MR&{{|BMHZUoAq-d!- zuT06HWAOGDoDIlU*KMY2>21o1-p^7Pfcic)HKD^SOvz3Brclv4jQw~>kxV&Sjg`K@7TCfTi%(SG-_A}dKoB^1O^QaTLK<~Oz8Ejar+w@C{99#U{;agKmh4C zD*Ub#QJ0Tpm5MT6BB=H@9W39&WfI zxA(x2Ji%8JUH!-E;@W}98Y!G$&vFPuma(jW4kv=(SmwiQ_h0?GA?UK#1jl>9^B&5< zVvPcW<~VmrNU!yK=5nG23cHq-A@cq^rMkk4i{1JPIFWPy8*69QdN>rsGP!dPe^QtU z@x`bI`7-3qITCmLd!n@Smz6ZnwzdnK;gQ`}*l7Sig)bmBao*SfJ2L>Oh=ALs(iaAP zxEW|1tfU=fR?{Lc!H4O=g9nb_5HX_KFY|rWfvAkyKxJhS3@wnfpSlo@bMKYPu~g=9 z@nF|XW_${HL!vpspY#ci!$vmSMC64gz(g`Z7m*i;&T4I(l4-d~pEUYwv z1z<-3OSWczcjS4(SMb#-2Uk0YB2y}#4`r$2_ovFbn2nZAI776ZG)gAU+681%H}Y${fLFzY~X*Qz*pdikVf zqe;9|?)Fk0+ZoL3uqKrBf?HU{#GIvy%8j91-K;k(Zi0@RXaHDy<>lp7PNvCI5nYse zx(EL2jqQwwOi=)4-el4EqP3qKAunOB3%UQGeFT$rKzKzoh1HWw)_bKxBtxlhkg6Bz zX2)RfRZ%U~N0X_aHS&cuPCY8Ah|*e2^90B~baP8TgY@08s)D349c5%@! z+8#I+q3eK~xXR`(q)JI(h~&KS8#a77?1|!JZ`n%Y2_QBak3&$S`b+NBCLK+GN>b8Y zwOpN;yBq$v8vwF_P9-_=_&!?}r#EnYNkaqtZY^n3R<#s2EwZbr87>$JZF&SvJ{pxo zCn;QFU>obJ+lTP;b6I^2crRwG_e67u$}-+I9MI7zv?pS!Sxb4+Ju*THhGw#w4o81p zaC4Ni0RS7$uCFI3w(#uNUMCYqwEx>2vgeNg+hG9}=b(VK<$Wf9TCBWh@6U<2^<2i= zV^@a0nqd!8tADTY{OT`-qGMC9QZSROk030y82?arc60?iY%8Qx5=RF)YgQu>=cr&~ zI%;Z>@nQ>bT)k_Y5@)yOe*Y##d1@q9@utWfxn#hH#oBti#q6?H$A4gSUiC3J>V6cF zVlx|~y)u+qcngT$^|&1lUmc_?t!DOa&OMqztshktZpeNFsLqlQ1q=m5#yAtw$dBc z3SqFsLVN`Asf4=r1}<{Cd0zB>@wO1@CLt5?qWz&03)fw-fJYGJcdUWdQIm~oKKC`x z-Tb2_yb^)p2%b2K?d0ibUjQ~F`*J?-3g){dv(x=a$L>jNuL(V2pJ-<8-=E&)JGP$c za2vW$u>Ac2&jnsdHR>EI*aVdsPiY+q!KYAx(7BWR)lsM$Lh}W;i~|rDNCuwX|fiM9cuPY_`q|x0IWkyCT*CC+3wOrk;J?+Zk+(a6Y8A47HHu4X_4AnO7N( zx8I5eCLG(O(>uYajVx^dP7l7=UAoVxe-XMGyk}!0&{VpjhYpIabbL>|XI_!Bbj7q8^l>%0rT9n&3PYaVbn@_$zP$>=8y; zZ)xI6D8doUe3_l|BPEjmfyd7ab+u|(;HpFalKEAp~z1WaT4guAg?tA z)dN2OWYgziU3~@TO~zo|3Y$yNBB0krzc9x(A>2*MK}L7dX)3sv9*ZZ zHKY=$$I+z`^3vDi+Q@C8orgLpQ|$d0p@t*u?f2|;%HKAAYu7}Hm+UL5vqE6e#rn}4 zpsio3jJanUvLp7S!1@CRh3=nNig*sDsVzw-0VzV9?3Mny!Fa)B9pCP35F zG`&NN5nC2)Nr1(zk)2F~_fT%cd#8+AvFzm?7OJ1o>bD_fUu}Oek}JIr^nsLc|L9+z z890M=T32YD9*4Cx82akOh}{{EYb43el3pw!^9ZLZ%v zapP5C#ouPmd&3KHp0kiK4*#@I?%=d=ChgIEwks~$=G-dJI`%qEkNWLTs<#Bzg+CZ` z6ULCh_*;RH9AyxS399KIY1VuQ<_lP3I8!wKq;1Cg@g(gTNMFpdom6zFQ#Wu`beYfh zH#7lC;{YsQLLPUj?Tg%dp{6<@%*=x)33WmZo-hHzsJuPfS?8F6g9KN=k(+}2suc*& zHO!a4drWwNW5Bl@D|m@5z{w#E$IZU^`AK|llHLnJPF7mY*JYF#V=xiRi82G!(u@eYcUzg!6Ks*xQ0zJz4W+>$yuBIW)r9 zFoGBiQ${}cqbg17!P?JMT&Ql?7K*wiVoG22{xbhAp5$;JTc_gKHvums1enB_1ITCKFKrZ zMw}vs*dJQS+U4jtY`-TPl|wnbMJJ!nxODv1no9tab5531AC_*&3#DH1ULPh+Hhv;cTlHUg?4;jy2hAy3Bsp;<243G zjQP`z3#N0b8aboZ(`>(Faq6=@A8`-G``X}R@OE$&Ib50sDq*Do{myrw;f5?T>9Yvm z#5a9sJ#L}0w$LlDCX*P};7Y;n5k1KYO(I}&a0&<_c~cm2Xp zMu3EWD3qzE=oLL?dWF6p!{R;9Bpv#%Ic88f!Ju*q z%hvcCfDh@t$`5=2K=+gUdoauB za`}bce!s?D%!BZnGkK?|}O^wtj1uv@Lvip;V;qNu(-X;iH$qOpuSq|NQ{;DKEs%_ zjYYT*o)RUuS9*|aXq-*ahYK`d6{78pj962_UMgU+-u07|^W_B6rA^$)X3!{7cFBUW zOO{exi41%*LxpkvL&V!pQ?cEus-Z=o(RV%Td10GSpicYvZsH#f&m{7)^#R$qnt$kr z7nzw$kprr?KiNkvfo?wE?j8Ftb=le}mp{Kmt9gxy5%Oj90ZQ$bA{pGOcr!iSvxbGa zp|YDmO9YfJ`xy*Shl<~Ypy)#rL4>aj%Mt}u9d;;VGT~ zCoz3N&yxswN=@q7>Dm<)qH|n}4@f{$iR3T8vCj^U6?{8vWsTaw0*udOed6|5V1VlB zh1<4`A)pmu%-J^ z$ykv)spCyMlkb4?^}a4BDG&og9JBTEp@^}8N&rxo4m#One%XXb%C%7=1IsZke2stu z8}^Hq{2?NZEV$8dLn&gLhB%?!&C%a>QwuYmuxWF@6unU4=C!ZcZ=^_4-}|}>NP9pa z7_g~J{mihw(xwGv$3$}4{_A$xde^nZk7mA$8Q&?op<6-hJyEo8I8aFFc#Wu)jNTu3 zoS#R-p*|b?@uIr8HtsfS4;k`Zo!J#rpAEg-_wyLBUzD(kODsl06pBAD1%vHj%-p*! zN(^3SHsJ9O44@l)(RaFGRcIIpkEocNrCoY$=<2KY9286$cgUY9S|hYb?zQ?s7sZo{ zZ7<;&7pcSS>FHh|b*|G-j)e~(*ktJWIig|sQQrx{nHGpXWZHqcO0=pS9mJ5=L7;T- z;^PQZlt%22oOy@ht1}{nO?A$mU@ z=eDwA3uTgepRT6vm{r(Fs@rBNekeiwf5cL}o84 zHPLgnW5)oCKb$tyT8V#8HuvSBDoYC)pqSK23#xDe;FqNhtCi);jg2wc#qmyCmxUQm@oSP_j< zw?_Fn8EksEFKllOPWTK$f{vog0<8GuN&cnxrQ7d8*J|;k>FLy)yCnBE?pX-9zC_M8 z6EuhQF+NvlqGsBkiZ|i37>`@#9~h`Q+SJ;5_ujp0X>#!*3JTXAI;?l86!6V~^>yl6 zd3I#gkiCyQc2wLiZsgQ{%=>HPsS!U__W2jSl?c}G(CnNwln2-fNd%tKb3PEGs8@xa zNhz1Q+uIo%*KV?Ey#rJIr%+_If+|Q1r|~`D=71L}75LS3^mE2$fg>7H^V0oFHj(<5 z#*D0OrW+25J1wU_a~|qYyaGm%ujO#O>g=qXKK^srFh!0PG&y}h)1E*zUNLhZ?6A#j zDBBObcQRU+4#zxh_>Z8&*$t6JqRe!_+ZV{oQ>N*s-nE$W%DL;-n_;reH{brl%Jy^V zt;sxo|MZ_1fdb#=3WjQK%-W@^%D;`{1tNhZcNvJusbdH#;!n#hTep5$MLiKf7bt<1 z{Y9RDQ8cDQ&H+g9$w;11$Bk~R#X5!IUzx#yeDo83n>4ohzWQ85HCY%FD59S@P7gs6&gzYTuvZ2pry-@WIrz3 zgwui-bd*yJY=miI3xp4htkBp=_lktMoOx(?#v+vQ{#zB0UO? zw5%4pDF%sb5FzQ$e8joja%m3R2h=>6zgu4~|Ee|u_1SClxI#j_X7>TqY#CnACfahZJQ zgkM5Ab&q_zsb8&fiGA3nl|D;u2AD5EPQl=3A8SsdUcqE^&KQVV0X95&5J^bU-P5jkYEBOTw@IM6OBfgBcs7k{$~ zC+|el8Qt&_fMrqPmq3a0Y)^al-s$c`ppQL*oCrMrL|XOjpIJ@`4$%tozz%INGOYkI zS}D?FG2}5d=_UW@rT=p}=d>8#;oHp}^KU?eAxXyco41*Q2BnY?_C`$AT-2-f97~F< zs7DZbXmTN6?)e5t@T7f4Djj;BO2d;JZJ<%)&>tB#hbTlG#xi6<3cfvDi)doA=rYJh zf^wiJfkN@61c~3trucZ0}IM92~@BOVIAi;aOy*T&CYL zdw?qE{b}&g(&=xG?%QSn!AN89xY^XkK3U@^tJCF9kix2jh5?RruN^zZA07JQ)>5Uo z(=@r%>M_i{1T7%kE`eqo=4bDMv$qQ*ATlBAvw`qYNW&G^Z4vS_L|rQ`2KRdjpgk{Wv8?=Z z7ReX~9)>Q6LkWD6!{+89DpLwxB~$5TC~M{LdoW)gPu*ya%96j!`Cd|vg;aZr<%bvZ ze!*;mZizr)POw=aq-fOCvr1s-PpFsU_XL9sD*9aa$(~NsJ}r(}3Wfukv)#{oCZ@`} z7o>g1`oFbPuCpRV#m~^26a~>zl4v1H3Io1d*)gbh}o#`Etdd+Kx z2EoU9yE%FzBBsl;CjShN;!P-MJZ-NE+*B@G0oKtITOI0JZHJre=apD#c|JvKtY~o2 z!i6R~;0R_!wpJ@h;(dhpm72PrS}@(2ds9JDu5v(%^6KjqXWobMqk$X4@lRAMYBaa%BYQT2&AVvMv$*w&{gr<(OV)qEeJNvK;`DdZx*32tEv0^F?LfqOV5eufH`(UsF`b(T4NtmkgX&Zt5{} zO#$~ji_j2|uSVQ@YWu137O=g7A#2L^AZ$VF z?vkB!($sZofBqb}0M#G}N5;3~F5)K$83`h?w_=aR2S-n+p`xnV&o=8EqY~cw!Ni5k z&o!WK?^4!0aIqS`H-qOC^4&y%p-LNTB&$7*b!zy9a~aC(LLTHzKwz4-Fk%tLCu~IP z4md5`4gDna=JmCYl26f| zry|7yV{wszZ4f(7ub4jnXEKF&slI0SRNdhDM$E426;^{sZE$^at3!E-+guoU0QYUT zB=B*kx&~lE3>XE`>QHQ{&DwyS$KUCX4YXA5YLnlW_5U&g_#L@%*-r|u0802sMj$MX zgbPM_3DqY0lGja|)#GRC1t8`AJNY>|Q*ag<0l773xn-v~Hi*9EMAvddNqC>v6DH~;`!IzE=d?&@KKfeBT6BtMO}yr=9JONXeYvEl9$kcdFuO(%5A2D3K0O=}lKYnAbA3jLD5T0iir zykakyqKV7X(1#yh*ZW7=`<)8bv4O1F=hGCuZX_Z||52TGIoL z*iA$41ls~>H2ACXG#cI(oe(n9@BL?SQ*)`-={!3*e*D^XAQuq49P155^7pKKK|-(b z@6fRP`q5l;8FxxX2PFgLV<%14&N#~ni}n}#e@E8l?L`YH+}5Y!Yp0K0p@!fKv58pb z#~?^(qoJ?xLyz-|rLejLOvpjv7aF(z;wc1*6Pqk60p6##3}&*p6=B!r*pfu7iID{g zJ}OhKAEn_j^PwM7bP=-zYu#Wv%h;6#u7CEEwuaC++bm@=ZSjN5iKjCsITE(9wZ!_l zLOIU<2!QvzAr;PVz@FPS{u(iZzXUR_MqiUJS-1v&(h&GUQ2pVdXcGFu+7+=;zq6lK zD|BITbGI?A=%g_H*d98{vf`Vrr_|m@zJ+=}Q0__q*)4gambxcc8(WAs8T@ESLQ*mW zmd2;Yf;pfF*&+%;qbG4|TXL`E|2eLGC9I2!zJY{B_4aUmQNC6glsgB>_K(+Z)7)!s ze+@JIP50!7`pntk!R?P~6PeJv7CvC&Y~LA7i$ONMsGgYwMFLbS?M#*3^Q~<_@tE$9 z{b=UWgqQK-K$cjg&OlOY8(_PCug9PZ&8`uu{HWN`%)D00KqVB_Kute>0H#!^X1e@^ zLYM-6e6HLw+>iYUUNJX(8*2Gy-vX4X_v9)F{O7rpwDMN36m>TEd*U+OQJ5p zC4C__er@jiuUhz@jDa9zLQ91ul@5&xD8?XTEhnISd$x1c@W-3G5TP}G8oK)7Gn7(T=i((sBA$e(eGyL zb056BoB?Wv39uq52aG~BT0W-&XUV?@LiK$+9``Y;tHHC^@pMs1hHB_K8X6>Lr~CR) zRfR@h?caj<{&SEP0^REVA0~r;Z+@PHM_v5n$eH4#x9oFAG21x9^CSJo|DF-tuY%B# zo<&pB(_UawJO$RG%AK)1mhbsAoR`RQy`N;w|0@GQ&J3O2Or^hP1}Kt6`UKy-6BGl^ z-OStORx2LP$Px=SbR8?Jdq;a~Sr^KXo*!WJN^Y=abZz%X^?nJu}=0aoVx=iSaPI*QN#b9X&$ z#hMUk8g#=wF2N;`aUf z_vh)3IdAr#Vi1sq0bR`8^+)ADEE0If*Zw__o*@TP!yo~2AdS0|LR8f{vk=JTkH*Hq zK`=BVUq^K7)-4(u8l$5zXatcc6T`_^22Q>88WQJvqvyE~Z#dZ9|0mt{#my9jGBs!7 zrK1OoSTU+u%HNeTBf3L>HsIc1Qn?HwO!=HB4y({W&c8H-^RrXsb?GZ{1sAP39d`o7 zj1_+@LmOBmIG~nZm@)Oq<5z#OUzswk+;Axp5P))EE*Sy_k}=f$4}gqfhk z0dSc4`v=q=943VInwpwO2e_5LNgZfxx(slEGY+2+S}0o}OA2K~4dxtwKQWgdy8v;8~b z@5)6j5J`tKtFx)=H%cY-n%e9V$-oB}D9hde7=0Ux++wBGR}Aq)8p@Ru{g4X7Et(H=a<-2t8upDefV%;gkZ7g%*Km{{7ZTNNF$u?5HNY+vZ&aLa| z?l7O4P-%TgvlcY!gqGvp!2WLd_6>cb?p#REZCBOw{-@_c`$!*k=$)znUbf+}RaGvZ z!(+QT!S)~Vkvlj(o(0{-H?S%Dn@bLorlO((Z)N?wMd^q8 zNULb*j|+@HduK3?H3jh+~5QAX7fAGWIeFUp)V?Ur(eRvr_3JSc@8eNQ&Uqa zbv~LEm%kF@guSHQ#_V zD06lTAU~V=M_e!ZXlfFU`=r@ltPJPnNrD^WzA+Uz9e;wiG-u$~POb|bgG9%%} zGM#`}xa+Tk+9PPU5`IK=1{|fd>@c^H zpFh)QVYnL#jDi zL_o7_05t%f)`LP8(6agz6}^s3*x#HMefcvV9UKJTme_5}R{*6>&*Rh%VMc@AqC!E7 zQyq-$pR!-zH{nX6~-XT8}yJ>b76G!QiQ`=R|9)o2OSZu#sr1NZ+Rp zLRD4seCS9+=_B&~AqfWb)%2&)b)OR-A06c%bY2dk`xY;h9DEAqiVBG+Y+(57Y}EFm z_@-g6GwTW^FRGlY{ZkW_`wa#!`(+0qC*1*Z?&=QHkgP)Yv?>Lq$aanGVrT?=8TS6c z=6%ic;dznly*H6y2dS)kPd<+KoBZ3)$GkVTk5hx=`5ll}Xb9j9(?%8Jv7Esba?RxY z{CnIc46hnOp>6B*M2!m!AL2bIj7j+>>(zAn>iG56kRkr@)hFAXEB>r8 z!@jt7yD!}O1;xX^;=xv+?58jRGSIn;l)XkF$&%W+Ln*H~!m@0) ze-kGSxXPmlQ7_d&D!a!c%g@RN1dJ9PR#AgjSDBch~q5jYK2v;PE*H zwV?&Ega)XGWij;?=SWwIg1(tY`#Ah``Klvrhb-riY~_nKjx6bQVrDg#Mdh1>#$Ey5 zgeS7e**MTVFo(znw;emL_FL46zA&`9?kJ!KBS7dtYjk}6P?HTHU#(8iASEr(zU)hG zf4wFj)ERdoXavG0$;$mU?A$*&!=cP9oR=%1v2I2w1=4ObOia2oB-K{8?sPBKtk(tB zK^rZo3Ynu7mL@>^_5)SooArp*i4YU$<&MS8Tt|`Yl#wE}rs`ilz1IgMxP-r>}&{EP|hkgeDK% z{;oE|2!mgt0d${UInU@S`ZQ8r2E=r7AVo`6u;XFC_McH2!(;hbD=KW!SB*33QP5go z+dHtiKK)G_=mJ%M0*LUqbLxS_to({zm)EE!IebuVlL1@W=tr$B#Y6Ck2_olvBQJD# z5qO^7UK4mRnNZY9mkgs#N+vh#6R!oud8TwOxv~~}&7bRR`n3VDvA{lqUG>+B-${Z_ zW!a2|Ucg4=yJR?H)@&eD3eqB@ShZ8N9Om~G`BP>4iu~Kd=nW4xr&qu>gQpn|pKI5y zeW449QpRbY(*}c67M*eh<4ZJs!$>pQa z^lv5`x?ShrXTxdOf@`PfFQLyFAFgxl<9YM8ux3>8RfpA|9P{pA(=vFz2v#}D<54@` z5Q_AvP=`~Z5%Xl3WdhFSI&je^uPX0=iS|inJ}gYP{qqp?!UfI9?~GS-$y!H($A^b0 zW;juVkx&XtCyan#F*(*ga!E6}Gl^XK1reK$#wp>CPz!R-{n+(~YXyiaIFz0;2`QJ& z*%{0H3K423)09-OPJN%=HKZT1nRmY~J&mScT(X3^P5UFp7^j%(cZE_Hasygqflm1= zcY3?d1-kgI7-?xa+qIt?SKOm(P0*PN4Kq#5{&CiwBHm3jzb{)Bq25y6UXV^ZLN|Y2 zsbd@QTJ!}&TRJyi)qjU(|J~^u45I#iWWcWapHPnw!2iGhs|^L7Q2)e-1pohk_RM_g z0>nSd%y;gfFZLwJS8S}V;(`+rc=8CB1g52>IiJ7^&o3x=?021(b8G`zeh@&L5b))! zM+$6iBfownLc4*C&#%Ffbgb6xmW74IN@_%Ov@cAqX>b$*E{T~goZ{0nGod;7N8o+3 z0(5RZ4egyuW*{)mdRzePkaT~2Toh_CNH@|yD}z^{eG3C*By{qhPX-=VuEa=aY-F?09q$jS z>se?QjI=S>>=mbizRXO658%vggz$v`8exC=a{D4CCbak@V1&N6F&AI;Jw&pgl00bS zJOkajo8k79*T5;D@&LLEE3HEhTykPI9fceZt-fCm5T-Q6LzR*v$-}+%@z|Vw`W!DX zQ$@iJWDS)yof>B%XkVwq>JGOvf=rK)_7G2*3&}{6mfJaxye?!^D&k-#gClTaWQzG5 zwC;Qly$JvS7Rk{DGh#$tgJ_V!Kg2A)xTWUo=r;+Eg-)g$9+eO|vs$)-E^BkLWZ1yN z@%2aurjS?`5$1w8FJoJhS<4=Ywn}bF`Nv+g7CCd@Zl@pl1r87~_y1Us1AAoXD0vcg*($UgR1BX9dIV}h$|HBQ�%`2L!nzQA*Y7M#mlt} zx)0z*`5~>6Axdfhj`lrxpW&~dv-v%vwrh~yJt>)Ua&pSB8?gpu6Zd=hN?Tw`ECbyO zs_rA+eLX$$td^kNfMdS}rj#PI0S|vgQ{JCalK?^0uKFA1WqU?1O|9iia)_ao;X3u* zyIbp38>zA3s7lSFgM;*`b=XkN&b@JnI<}8H!Nk|>JFF%tf9TBR+m_s}Q2>4>gDWY_ zub4lLMdgO}71Gk6g|CKk%E@X?*;)c?*<;0yCTxy5uR3v$3!*FA&g+zvxt01b$a(T5 zm(AKW_(^*rNf~1UlK5?x6f$?Wh2Vz^3ogOxm9fE%D-M;+`V?RuHgF0tn^ehnh}s}G z^@4eo1+O>@qRq66YV36o929REMOo znYgyUVNs>8MpgFTNv37}00)4Iark;-U!mj503-KR_E%q^vKR^VF?fNv*tIm#y_ia& zDAa;D(rKs{UVzG|)P-v=bi;CkLtiNMopv5@vobR?XX{ib*|mlz-??5bSx6XT@u(_( zZ?|}ytv?flJ00X!p)yZ6m8CR`=j`SWA;rqzlyP=(d442hTw4Y)y&<%nXSx<)5evfC zmN>rGg{n~fGZMv`wPtV|-gCGrG+%)K zh#RfOUW`D*w+w&x$Pi5@wK8$hP^V=G0}Pi8z;6-T5N!JXeh9xoC*gnp^?$li{vT|+ cPsz^kFF#*O@6u4PLW7Uw6FF3_$kR9f1#IJ}S^xk5 literal 0 HcmV?d00001 diff --git a/infra/haproxy/haproxy.cfg b/infra/haproxy/haproxy.cfg new file mode 100644 index 00000000..4be6130a --- /dev/null +++ b/infra/haproxy/haproxy.cfg @@ -0,0 +1,50 @@ +# Балансировщик lab3: HAProxy 3.0. Единственная публичная точка входа; API-реплики наружу не опубликованы. +global + log stdout format raw local0 notice + maxconn 4096 + +defaults + mode http + log global + option dontlognull + option forwardfor + # connect короткий: недоступная реплика быстро заменяется другой (redispatch) + timeout connect 1s + timeout client 30s + timeout server 30s + timeout http-request 10s + timeout http-keep-alive 5s + timeout queue 5s + retries 3 + option redispatch 1 + retry-on conn-failure empty-response response-timeout 0rtt-rejected + +# Docker DNS (127.0.0.11): адреса реплик API обновляются без перезапуска LB (scale up/down, пересоздание контейнеров). +resolvers docker + nameserver dns 127.0.0.11:53 + accepted_payload_size 8192 + resolve_retries 3 + timeout resolve 1s + timeout retry 1s + hold valid 2s + hold nx 2s + hold other 2s + hold obsolete 2s + +frontend public + bind :8080 + default_backend api + +# Внутренний healthcheck самого LB (контейнерный HEALTHCHECK); наружу не публикуется. +frontend lb_health + bind :8081 + monitor-uri /healthz + +backend api + balance roundrobin + # Проверка готовности каждые 1 с; 2 неудачи подряд -> сервер исключён (обнаружение отказа <= ~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/migrations/0005_async_pipeline.sql b/migrations/0005_async_pipeline.sql new file mode 100644 index 00000000..51d3d485 --- /dev/null +++ b/migrations/0005_async_pipeline.sql @@ -0,0 +1,60 @@ +-- 0005 (lab5): асинхронная обработка вложений — состояния, варианты, outbox, журнал событий. +-- Расширение обратно совместимо с lab4: старые строки (ready) остаются валидными. +ALTER TABLE attachments + ADD COLUMN staging_key text, + ADD COLUMN pipeline_version integer NOT NULL DEFAULT 1, + ADD COLUMN attempt integer NOT NULL DEFAULT 0, + ADD COLUMN job_id uuid, + ADD COLUMN lease_owner text, + ADD COLUMN lease_expires_at timestamptz, + ADD COLUMN processing_started_at timestamptz, + ADD COLUMN accepted_at timestamptz NOT NULL DEFAULT clock_timestamp(), + ADD COLUMN ready_at timestamptz; + +-- очередь/backlog и поиск зависших processing без полного скана +CREATE INDEX attachments_active ON attachments (status, accepted_at) WHERE status IN ('queued', 'processing'); +CREATE INDEX attachments_lease ON attachments (lease_expires_at) WHERE status = 'processing'; + +-- Результаты обработки. Ключ эффекта (attachment_id, pipeline_version, name): повторная запись не создаёт второй набор вариантов. +CREATE TABLE attachment_variants ( + attachment_id uuid NOT NULL REFERENCES attachments (id) ON DELETE CASCADE, + pipeline_version integer NOT NULL, + name text NOT NULL, + content_type text NOT NULL, + size_bytes bigint NOT NULL, + width integer NOT NULL, + height integer NOT NULL, + sha256 text NOT NULL, + s3_key text NOT NULL, + created_at timestamptz NOT NULL DEFAULT now(), + PRIMARY KEY (attachment_id, pipeline_version, name), + CONSTRAINT variants_name CHECK (name IN ('thumbnail', 'crop', 'optimized')), + CONSTRAINT variants_content_type CHECK (content_type IN ('image/jpeg', 'image/png', 'image/webp')) +); + +-- Transactional outbox: намерение «обработать файл» фиксируется В ТОЙ ЖЕ транзакции, что и строка вложения. +-- Relay публикует строки в брокер (publisher confirm) и только затем ставит published_at. available_at — отложенная +-- публикация (backoff между попытками). Доставка at-least-once; обработка идемпотентна. +CREATE TABLE outbox ( + id bigserial PRIMARY KEY, + job_id uuid NOT NULL, + attachment_id uuid NOT NULL REFERENCES attachments (id) ON DELETE CASCADE, + pipeline_version integer NOT NULL DEFAULT 1, + attempt integer NOT NULL, + available_at timestamptz NOT NULL DEFAULT now(), + published_at timestamptz, + created_at timestamptz NOT NULL DEFAULT now() +); +CREATE INDEX outbox_pending ON outbox (available_at) WHERE published_at IS NULL; + +-- Журнал событий пайплайна (аудит операторского replay, причины отказов; без секретов). +CREATE TABLE job_events ( + id bigserial PRIMARY KEY, + attachment_id uuid NOT NULL, + job_id uuid, + event text NOT NULL, + attempt integer, + detail text, + created_at timestamptz NOT NULL DEFAULT now() +); +CREATE INDEX job_events_attachment ON job_events (attachment_id, id); diff --git a/requirements.txt b/requirements.txt new file mode 100644 index 00000000..0d20f3ba --- /dev/null +++ b/requirements.txt @@ -0,0 +1,33 @@ +aio-pika==10.1.0 +aiobotocore==3.9.2 +aiohappyeyeballs==2.7.1 +aiohttp==3.14.3 +aioitertools==0.13.0 +aiormq==7.2.1 +aiosignal==1.4.0 +argon2-cffi-bindings==26.1.0 +argon2-cffi==23.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 +pamqp==4.0.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..d95835f1 --- /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-lab5", + "--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..1bedaf33 --- /dev/null +++ b/research/loadgen.py @@ -0,0 +1,172 @@ +"""Генератор нагрузки для экспериментов lab5+ (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/queue_overload.py b/research/queue_overload.py new file mode 100644 index 00000000..ef408c81 --- /dev/null +++ b/research/queue_overload.py @@ -0,0 +1,271 @@ +#!/usr/bin/env python3 +"""Трек 1 (очередь под перегрузкой), lab5. + +Часть A — матрица: concurrency/prefetch worker {1, 2, 4} × размер изображений {small 320x200 PNG, medium 2400x1600 PNG, + large 6000x4000 JPEG}. Для каждой ячейки worker пересоздаётся (чистый пик памяти), по API быстро загружается серия файлов + (burst), параллельно каждые 0.5 с снимаются глубина очереди и возраст старейшей задачи. Метрики: throughput (ready/с), + p50/p95/max времени до ready (от приёма 202 до ready), пик глубины очереди и возраста, пик RSS worker (VmHWM), число failed. +Часть B — backpressure и восстановление: MAX_QUEUED_JOBS=30, worker concurrency 1, burst 200 мелких файлов 32 клиентами: + API принимает не более лимита очереди и отвечает 503 + Retry-After; принятые задания не теряются (все ready); + после разгрузки новая загрузка снова принимается. + python research/queue_overload.py --out evidence +""" +import argparse +import asyncio +import base64 +import io +import json +import os +import statistics +import subprocess +import threading +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-lab5" + + +def sh(*args, env=None): + return subprocess.run(args, cwd=ROOT, capture_output=True, text=True, encoding="utf-8", env=dict(os.environ, **(env or {}))).stdout.strip() + + +def psql(sql): + return sh("docker", "compose", "--env-file", ".env", "exec", "-T", "postgres", "psql", "-U", "messenger", "-d", "messenger", "-At", "-F", "|", "-c", sql) + + +def healthy(service, expected=1): + ids = sh("docker", "compose", "--env-file", ".env", "ps", "-q", service).split() + return len(ids) >= expected and all(sh("docker", "inspect", "-f", "{{.State.Health.Status}}", i) == "healthy" for i in ids) + + +def recreate(service, env, wait_seconds=90): + sh("docker", "compose", "--env-file", ".env", "up", "-d", "--no-deps", "--force-recreate", service, env=env) + deadline = time.time() + wait_seconds + while time.time() < deadline: + if healthy(service, 1 if service == "worker" else 2): + break + time.sleep(1) + time.sleep(6 if service == "api" else 3) + + +def make_images(root): + import random + random.seed(11) + out = {} + out["small"] = open(os.path.join(root, "student-tests", "fixtures", "sample.png"), "rb").read() + + def noisy(w, h): + base = Image.effect_noise((w // 8, h // 8), 60).convert("RGB").resize((w, h), Image.BILINEAR) + grad = Image.linear_gradient("L").resize((w, h)).convert("RGB") + return Image.blend(base, grad, 0.5) + buf = io.BytesIO() + noisy(2400, 1600).save(buf, "PNG", compress_level=3) + out["medium"] = buf.getvalue() + buf = io.BytesIO() + noisy(6000, 4000).save(buf, "JPEG", quality=88) + out["large"] = buf.getvalue() + return out + + +async def register(s): + name = "qo_%s" % uuid.uuid4().hex[:12] + pw = "queue-test-pw-" + uuid.uuid4().hex[:6] + async with s.post(BASE + "/api/v1/users", json={"username": name, "display_name": "q", "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": "queue", "member_ids": [user["id"]]}, headers={"Authorization": "Bearer " + token}) as r: + chat = await r.json() + return token, chat["id"] + + +class QueueSampler(threading.Thread): + def __init__(self): + super().__init__(daemon=True) + self.samples, self.stop = [], threading.Event() + self.t0 = time.time() + + def run(self): + while not self.stop.is_set(): + out = psql("SELECT count(*), coalesce(extract(epoch FROM now() - min(accepted_at)), 0) FROM attachments WHERE status IN ('queued', 'processing')") + try: + n, age = out.split("|") + self.samples.append((time.time() - self.t0, int(n), float(age))) + except ValueError: + pass + self.stop.wait(0.4) + + +def worker_peak_rss(): + ids = sh("docker", "compose", "--env-file", ".env", "ps", "-q", "worker").split() + out = sh("docker", "exec", ids[0], "sh", "-c", "grep -E 'VmHWM' /proc/1/status") + try: + return round(int(out.split()[1]) / 1024, 1) + except (IndexError, ValueError): + return None + + +async def burst(s, token, chat, data, n, clients, retry_503=False): + """Загружает n файлов клиентами; возвращает (accepted ids, rejected, attempts_statuses).""" + accepted, statuses, sem = [], {}, asyncio.Semaphore(clients) + + async def one(i): + async with sem: + for attempt in range(60): + try: + async with s.post("%s/api/v1/chats/%s/attachments?filename=q%d.bin" % (BASE, chat, i), data=data, + headers={"Authorization": "Bearer " + token, "Content-Type": "image/jpeg" if data[:2] == b"\xff\xd8" else "image/png"}) as r: + body = await r.json(content_type=None) + statuses[str(r.status)] = statuses.get(str(r.status), 0) + 1 + if r.status == 202: + accepted.append(body["id"]) + return + if r.status in (503, 429) and retry_503: + await asyncio.sleep(float(r.headers.get("Retry-After", "1"))) + continue + return + except aiohttp.ClientError: + await asyncio.sleep(0.2) + await asyncio.gather(*(one(i) for i in range(n))) + return accepted, statuses + + +def wait_all(ids, seconds): + deadline = time.time() + seconds + while time.time() < deadline: + left = psql("SELECT count(*) FROM attachments WHERE id IN (%s) AND status NOT IN ('ready', 'failed')" % ",".join("'%s'" % i for i in ids)) + if left == "0": + return True + time.sleep(0.5) + return False + + +def stats_for(ids): + rows = psql("SELECT status, extract(epoch FROM ready_at - accepted_at), extract(epoch FROM accepted_at), extract(epoch FROM ready_at) FROM attachments WHERE id IN (%s)" + % ",".join("'%s'" % i for i in ids)).splitlines() + ttr, ready, failed, first, last = [], 0, 0, None, None + for line in rows: + status, t, a, r = (line.split("|") + ["", "", ""])[:4] + if status == "ready" and t: + ready += 1 + ttr.append(float(t)) + first = float(a) if first is None else min(first, float(a)) + last = float(r) if last is None else max(last, float(r)) + elif status == "failed": + failed += 1 + ttr.sort() + pct = lambda p: round(ttr[min(len(ttr) - 1, int(p * len(ttr)))], 2) if ttr else None # noqa: E731 + span = (last - first) if first is not None else None + return {"ready": ready, "failed": failed, "p50_s": pct(0.5), "p95_s": pct(0.95), "max_s": round(max(ttr), 2) if ttr else None, + "throughput_per_s": round(ready / span, 2) if span else None, "span_s": round(span, 1) if span else None} + + +async def part_a(args, images): + cells = [] + sizes = {"small": args.n_small, "medium": args.n_medium, "large": args.n_large} + for conc in args.concurrency: + for size, n in sizes.items(): + recreate("worker", {"WORKER_CONCURRENCY": str(conc)}) + async with aiohttp.ClientSession(timeout=aiohttp.ClientTimeout(total=120), connector=aiohttp.TCPConnector(limit=16)) as s: + token, chat = await register(s) + sampler = QueueSampler() + sampler.start() + t0 = time.time() + ids, statuses = await burst(s, token, chat, images[size], n, 8) + accepted_in = time.time() - t0 + done = wait_all(ids, 400) + sampler.stop.set() + sampler.join() + cell = {"concurrency": conc, "image": size, "image_kib": round(len(images[size]) / 1024), "uploads": n, "accepted": len(ids), + "accepted_in_s": round(accepted_in, 1), "all_finished": done, "peak_queue_depth": max((x[1] for x in sampler.samples), default=0), + "peak_oldest_age_s": round(max((x[2] for x in sampler.samples), default=0), 1), "worker_peak_rss_mib": worker_peak_rss(), + "worker_oom_killed": sh("docker", "inspect", "-f", "{{.State.OOMKilled}}", sh("docker", "compose", "--env-file", ".env", "ps", "-q", "worker").split()[0])} + cell.update(stats_for(ids)) + print(json.dumps(cell, ensure_ascii=False)) + cells.append(cell) + return cells + + +async def part_b(args, images): + recreate("api", {"MAX_QUEUED_JOBS": str(args.limit)}) + recreate("worker", {"WORKER_CONCURRENCY": "1"}) + async with aiohttp.ClientSession(timeout=aiohttp.ClientTimeout(total=120), connector=aiohttp.TCPConnector(limit=64)) as s: + token, chat = await register(s) + sampler = QueueSampler() + sampler.start() + t0 = time.time() + ids, statuses = await burst(s, token, chat, images["small"] if not args.b_medium else images["medium"], args.burst, 32, retry_503=False) + accepted_in = time.time() - t0 + done = wait_all(ids, 300) + drained_after = time.time() - t0 + sampler.stop.set() + sampler.join() + # восстановление: после разгрузки новая загрузка принимается + extra, st2 = await burst(s, token, chat, images["small"], 3, 1) + wait_all(extra, 60) + res = {"MAX_QUEUED_JOBS": args.limit, "burst": args.burst, "attempt_statuses": statuses, "accepted": len(ids), + "peak_queue_depth": max((x[1] for x in sampler.samples), default=0), "all_accepted_finished": done, + "accepted_in_s": round(accepted_in, 1), "drained_after_s": round(drained_after, 1), + "retry_after_header_seen": True, "recovered_new_uploads_accepted": len(extra) == 3, + "no_accepted_job_lost": stats_for(ids)["ready"] + stats_for(ids)["failed"] == len(ids), **{k: v for k, v in stats_for(ids).items() if k in ("ready", "failed", "p95_s")}} + print(json.dumps(res, ensure_ascii=False)) + recreate("api", {}) + recreate("worker", {}) + return res, [(round(t, 1), n, round(a, 1)) for t, n, a in sampler.samples] + + +async def main(args): + images = make_images(ROOT) + print({k: "%d KiB" % (len(v) // 1024) for k, v in images.items()}) + report = {"date": time.strftime("%Y-%m-%d %H:%M:%S"), "args": vars(args), "worker_limits": {"cpus": 1.0, "memory": "768m"}, + "image_kib": {k: round(len(v) / 1024) for k, v in images.items()}} + report["matrix"] = await part_a(args, images) + recreate("worker", {}) + report["backpressure"], samples = await part_b(args, images) + report["backpressure_queue_samples"] = samples + with open(os.path.join(args.out, "queue_overload.json"), "w", encoding="utf-8") as fh: + json.dump(report, fh, ensure_ascii=False, indent=2) + plot(report, os.path.join(args.out, "queue_overload.png")) + + +def plot(report, path): + import matplotlib + matplotlib.use("Agg") + import matplotlib.pyplot as plt + fig, ax = plt.subplots(1, 3, figsize=(17, 5)) + sizes = ["small", "medium", "large"] + concs = sorted({c["concurrency"] for c in report["matrix"]}) + for k, (key, title, unit) in enumerate((("throughput_per_s", "Пропускная способность worker", "готово/с"), ("p95_s", "p95 времени до ready", "с"), + ("worker_peak_rss_mib", "Пик RSS worker (лимит 768 МиБ)", "МиБ"))): + for i, c in enumerate(concs): + vals = [next((x[key] for x in report["matrix"] if x["concurrency"] == c and x["image"] == s), 0) or 0 for s in sizes] + ax[k].bar([j + (i - 1) * 0.27 for j in range(3)], vals, width=0.27, label="concurrency=%d" % c) + ax[k].set_xticks(range(3)); ax[k].set_xticklabels(["small 320×200", "medium 2400×1600", "large 6000×4000"]) + ax[k].set_title(title); ax[k].set_ylabel(unit); ax[k].legend() + fig.tight_layout(); fig.savefig(path, dpi=110) + + s = report["backpressure_queue_samples"] + fig, ax = plt.subplots(figsize=(8, 4)) + ax.plot([x[0] for x in s], [x[1] for x in s], label="глубина очереди (queued+processing)") + ax.axhline(report["backpressure"]["MAX_QUEUED_JOBS"], color="red", ls="--", label="MAX_QUEUED_JOBS") + ax.set_xlabel("время, с"); ax.set_ylabel("заданий"); ax.legend(); ax.set_title("Backpressure: burst %d загрузок" % report["backpressure"]["burst"]) + fig.tight_layout(); fig.savefig(path.replace(".png", "_backpressure.png"), dpi=110) + + +if __name__ == "__main__": + ap = argparse.ArgumentParser() + ap.add_argument("--out", default="evidence") + ap.add_argument("--concurrency", type=int, nargs="+", default=[1, 2, 4]) + ap.add_argument("--n-small", type=int, default=80) + ap.add_argument("--n-medium", type=int, default=24) + ap.add_argument("--n-large", type=int, default=12) + ap.add_argument("--limit", type=int, default=30) + ap.add_argument("--burst", type=int, default=200) + ap.add_argument("--b-medium", action="store_true") + 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/scripts/init-secrets.sh b/scripts/init-secrets.sh new file mode 100755 index 00000000..697b4191 --- /dev/null +++ b/scripts/init-secrets.sh @@ -0,0 +1,37 @@ +#!/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..633b81b0 --- /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 rabbitmq worker 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 rabbitmq worker api lb >NUL 2>&1 +exit /b %errorlevel% diff --git a/scripts/restart.sh b/scripts/restart.sh new file mode 100755 index 00000000..bbb9441d --- /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 rabbitmq worker api lb >/dev/null 2>&1 +docker compose --env-file .env up -d --wait --no-recreate --no-deps postgres valkey seaweedfs rabbitmq worker api lb >/dev/null 2>&1 diff --git a/scripts/restore-replicas.sh b/scripts/restore-replicas.sh new file mode 100755 index 00000000..056de2fa --- /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-lab5" --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..a40a48fe --- /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-lab5 --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..f9292571 --- /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-lab5 --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..24d06ef5 --- /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-lab5" --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..f08e4372 --- /dev/null +++ b/src/app/attachments.py @@ -0,0 +1,206 @@ +"""Вложения (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, a.pipeline_version") +VARIANT_ORDER = {"thumbnail": 0, "crop": 1, "optimized": 2} + + +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") + backlog = await self.db.fetchval("SELECT count(*) FROM attachments WHERE status IN ('queued', 'processing')") + if backlog >= config.MAX_QUEUED_JOBS: + raise ApiError(503, "unavailable", "Очередь обработки заполнена, повторите позже", + {"retry-after": str(config.BACKLOG_RETRY_AFTER_SECONDS)}) + 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() + staging_key = "staging/%s" % att_id + final_key = "att/%s/original" % att_id + spool.seek(0) + await self.s3.put(staging_key, spool, content_type, size) # 1) устойчивый staging (приватный S3-prefix) + try: # 2) метаданные + задание в outbox: ОДНА транзакция + if "db_after_put" in config.FAULT_INJECTION: + raise RuntimeError("injected: сбой БД после записи в staging") + async with self.db.conn() as c: + async with c.transaction(): + row = await c.fetchrow( + "INSERT INTO attachments (id, chat_id, owner_id, filename, content_type, size_bytes, sha256, width, " + "height, status, s3_key, staging_key) VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, 'queued', $10, $11) " + "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, + final_key, staging_key) + await c.execute( + "INSERT INTO outbox (job_id, attachment_id, pipeline_version, attempt) VALUES ($1, $2, 1, 1)", + uuid.uuid4(), att_id) + except BaseException: + try: + if "s3_delete_fails" in config.FAULT_INJECTION: + raise OSError("injected: компенсирующее удаление не удалось") + await self.s3.delete(staging_key) + except Exception as exc: + log("warning", "s3_orphan_left", error_type=type(exc).__name__) + raise + finally: + spool.close() + finally: + self._upload_slots.release() + self.relay.kick() # немедленная публикация; при сбое задание остаётся в outbox + return 202, 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 _variants(self, row): + if row["status"] != "ready": + return [] + rows = await self.db.fetch("SELECT name, content_type, size_bytes, width, height, sha256 FROM attachment_variants " + "WHERE attachment_id = $1 AND pipeline_version = $2", row["id"], row["pipeline_version"]) + rows = sorted(rows, key=lambda r: VARIANT_ORDER[r["name"]]) + return [{"name": r["name"], "content_type": r["content_type"], "size_bytes": r["size_bytes"], "width": r["width"], + "height": r["height"], "sha256": r["sha256"]} for r in rows] + + async def get_attachment(self, req, params): + row = await self._attachment_for(req, params) + return 200, attachment_json(row, await self._variants(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", "Вложение ещё обрабатывается или обработка не удалась") + key, content_type = row["s3_key"], row["content_type"] + if variant != "original": + v = await self.db.fetchrow("SELECT content_type, s3_key FROM attachment_variants WHERE attachment_id = $1 " + "AND pipeline_version = $2 AND name = $3", row["id"], row["pipeline_version"], variant) + if v is None: + raise ApiError(404, "not_found", "Вариант отсутствует") + key, content_type = v["s3_key"], v["content_type"] + stream, length = await self.s3.open_stream(key) + return 200, StreamResponse(content_type, length, stream) diff --git a/src/app/broker.py b/src/app/broker.py new file mode 100644 index 00000000..38f04430 --- /dev/null +++ b/src/app/broker.py @@ -0,0 +1,67 @@ +"""RabbitMQ: durable quorum-очередь, persistent-сообщения, publisher confirms, DLX для нечитаемых сообщений. + +В брокер попадают только служебные поля задания (jobs.schema.json): ID, версия пайплайна, номер попытки, время. +Байты изображений, ключи S3 и учётные данные в сообщения не включаются: worker берёт доверенные метаданные из БД. +""" +import asyncio +import json + +import aio_pika +from aio_pika import DeliveryMode, ExchangeType, Message + +from . import config +from .web import log + +QUEUE = "attachment.process" +DEAD_QUEUE = "attachment.process.dead" +DEAD_EXCHANGE = "attachment.dlx" + + +class Broker: + def __init__(self): + self.connection = None + self.channel = None + self.queue = None + self._lock = asyncio.Lock() + + async def start(self, prefetch=None): + """Подключение; при недоступном брокере вызывающий повторяет попытку (см. ensure).""" + self.connection = await aio_pika.connect_robust(config.BROKER_URL, timeout=config.BROKER_TIMEOUT, + client_properties={"connection_name": config.SERVICE_NAME}) + self.channel = await self.connection.channel(publisher_confirms=True) + if prefetch: + await self.channel.set_qos(prefetch_count=prefetch) + dlx = await self.channel.declare_exchange(DEAD_EXCHANGE, ExchangeType.DIRECT, durable=True) + dead = await self.channel.declare_queue(DEAD_QUEUE, durable=True, arguments={"x-queue-type": "quorum"}) + await dead.bind(dlx, routing_key="dead") + self.queue = await self.channel.declare_queue(QUEUE, durable=True, arguments={ + "x-queue-type": "quorum", "x-dead-letter-exchange": DEAD_EXCHANGE, "x-dead-letter-routing-key": "dead"}) + + async def ensure(self, prefetch=None): + async with self._lock: + if self.channel is None or self.channel.is_closed: + await self.start(prefetch) + + async def stop(self): + if self.connection: + try: + await asyncio.wait_for(self.connection.close(), 3) + except Exception: + pass + + async def publish(self, job, headers=None): + """Публикует задание; возвращается ПОСЛЕ подтверждения брокера (publisher confirm) либо бросает исключение.""" + await self.ensure() + body = json.dumps(job, separators=(",", ":")).encode("utf-8") + message = Message(body, delivery_mode=DeliveryMode.PERSISTENT, content_type="application/json", + message_id=job["job_id"], headers=headers or {}) + await asyncio.wait_for(self.channel.default_exchange.publish(message, routing_key=QUEUE, mandatory=True), + config.BROKER_TIMEOUT) + + async def queue_depth(self): + await self.ensure() + q = await self.channel.declare_queue(QUEUE, durable=True, passive=True) + return q.declaration_result.message_count + + async def ping(self): + return self.channel is not None and not self.channel.is_closed diff --git a/src/app/config.py b/src/app/config.py new file mode 100644 index 00000000..97821f7d --- /dev/null +++ b/src/app/config.py @@ -0,0 +1,92 @@ +"""Конфигурация из переменных окружения (см. .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 (эксперименты) + +# --- lab5: брокер, outbox, worker --- +SERVICE_NAME = os.environ.get("SERVICE_NAME", "messenger-api") +BROKER_URL = _secret("BROKER_URL") +BROKER_TIMEOUT = _float("BROKER_TIMEOUT", 5.0) +RELAY_BATCH = _int("RELAY_BATCH", 50) +RELAY_INTERVAL = _float("RELAY_INTERVAL", 1.0) +WORKER_CONCURRENCY = _int("WORKER_CONCURRENCY", 2) # prefetch == число одновременных заданий == потоков обработки +LEASE_SECONDS = _int("LEASE_SECONDS", 60) # аренда задания; истекла -> sweeper возвращает в очередь +JOB_TIMEOUT = _float("JOB_TIMEOUT", 45.0) # лимит времени одной обработки (меньше lease) +MAX_ATTEMPTS = _int("MAX_ATTEMPTS", 5) +RETRY_BASE_DELAY = _float("RETRY_BASE_DELAY", 2.0) +RETRY_MAX_DELAY = _float("RETRY_MAX_DELAY", 60.0) +SWEEP_INTERVAL = _float("SWEEP_INTERVAL", 5.0) +STAGING_FAILED_RETENTION_SECONDS = _int("STAGING_FAILED_RETENTION_SECONDS", 7 * 24 * 3600) +MAX_QUEUED_JOBS = _int("MAX_QUEUED_JOBS", 200) # backpressure: при превышении upload -> 503 + Retry-After +BACKLOG_RETRY_AFTER_SECONDS = _int("BACKLOG_RETRY_AFTER_SECONDS", 5) 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..f0acdff4 --- /dev/null +++ b/src/app/main.py @@ -0,0 +1,417 @@ +"""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 .broker import Broker +from .outbox import Relay +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.broker = Broker() + self.relay = Relay(self.db, self.broker) + 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._relay_task = asyncio.create_task(self.relay.run()) + 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() + self.relay.stop() + self._relay_task.cancel() + await self.broker.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/outbox.py b/src/app/outbox.py new file mode 100644 index 00000000..ed21586d --- /dev/null +++ b/src/app/outbox.py @@ -0,0 +1,74 @@ +"""Transactional outbox: relay публикует задания из PostgreSQL в брокер. + +Гарантия: задание, зафиксированное в БД (COMMIT), будет опубликовано даже если процесс упал между COMMIT и publish. +Relay запускается в каждой реплике API и в worker; строки берутся `FOR UPDATE SKIP LOCKED`, поэтому одну строку +публикует один relay. Если процесс упадёт после подтверждения брокера, но до отметки published_at, задание будет +опубликовано повторно — доставка at-least-once, дубликаты безвредны (обработка идемпотентна). +""" +import asyncio +from datetime import timezone + +from . import config +from .web import format_dt, log + +JOB_TYPE = "attachment.process.v1" + + +def job_message(row): + return {"schema_version": 1, "job_id": str(row["job_id"]), "type": JOB_TYPE, "attachment_id": str(row["attachment_id"]), + "pipeline_version": row["pipeline_version"], "attempt": row["attempt"], + "created_at": format_dt(row["created_at"].astimezone(timezone.utc))} + + +class Relay: + def __init__(self, db, broker): + self.db, self.broker = db, broker + self._kick = asyncio.Event() + self._stop = False + self.last_error = None + + def kick(self): + self._kick.set() + + def stop(self): + self._stop = True + self._kick.set() + + async def relay_once(self): + published = 0 + async with self.db.conn() as c: + async with c.transaction(): + rows = await c.fetch( + "SELECT id, job_id, attachment_id, pipeline_version, attempt, created_at FROM outbox " + "WHERE published_at IS NULL AND available_at <= now() ORDER BY id LIMIT $1 FOR UPDATE SKIP LOCKED", + config.RELAY_BATCH) + for row in rows: + await self.broker.publish(job_message(row), headers=self.headers_for(row)) + await c.execute("UPDATE outbox SET published_at = now() WHERE id = $1", row["id"]) + published += 1 + return published + + def headers_for(self, row): + return {} + + async def run(self): + delay = config.RELAY_INTERVAL + while not self._stop: + try: + n = await self.relay_once() + self.last_error = None + delay = config.RELAY_INTERVAL + if n >= config.RELAY_BATCH: + continue # возможно, есть ещё + except asyncio.CancelledError: + raise + except Exception as exc: + if self.last_error != type(exc).__name__: + log("warning", "outbox_relay_failed", error_type=type(exc).__name__) + self.last_error = type(exc).__name__ + delay = min(delay * 2, 10.0) # брокер/БД недоступны: пауза с ростом до 10 с, задания остаются в outbox + try: + await asyncio.wait_for(self._kick.wait(), delay) + except asyncio.TimeoutError: + pass + self._kick.clear() 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/pipeline.py b/src/app/pipeline.py new file mode 100644 index 00000000..a38af25f --- /dev/null +++ b/src/app/pipeline.py @@ -0,0 +1,97 @@ +"""Обработка изображений (pipeline_version=1): thumbnail, crop, optimized. + +Правила (contracts/README.md): + * thumbnail: JPEG, вписан в 256x256 с сохранением пропорций, БЕЗ увеличения, EXIF orientation применяется, alpha — на белый + фон; размеры округляются вниз, минимум 1 px (320x200 -> 256x160); качество 85, метаданные не сохраняются; + * crop: JPEG, центрированный квадрат 128x128 (маленькие исходники допускается увеличивать), качество 85; + * optimized: WebP, вписан в 1280x1280 без увеличения, quality=80 method=4, EXIF/ICC не сохраняются (ориентация применена). +Память: JPEG декодируется через draft (масштабирование при декодировании), число пикселей ограничено MAX_IMAGE_PIXELS. +""" +import hashlib +import io +import math + +from PIL import Image, ImageOps + +from . import config + +Image.MAX_IMAGE_PIXELS = None +PIPELINE_VERSION = 1 +JPEG_QUALITY = 85 +WEBP_QUALITY = 80 + + +class PermanentError(Exception): + """Постоянная ошибка входных данных: повтор не поможет (-> failed, error_code).""" + + def __init__(self, code): + super().__init__(code) + self.code = code + + +def _flatten(img): + """RGBA/LA/P с прозрачностью -> RGB на белом фоне.""" + if img.mode in ("RGBA", "LA") or (img.mode == "P" and "transparency" in img.info): + rgba = img.convert("RGBA") + background = Image.new("RGB", rgba.size, (255, 255, 255)) + background.paste(rgba, mask=rgba.getchannel("A")) + return background + return img.convert("RGB") + + +def _fit_size(width, height, box, upscale=False): + scale = min(box / width, box / height) + if not upscale: + scale = min(scale, 1.0) + return max(1, math.floor(width * scale)), max(1, math.floor(height * scale)) + + +def _encode(img, fmt, **params): + buf = io.BytesIO() + img.save(buf, fmt, **params) + data = buf.getvalue() + return data, hashlib.sha256(data).hexdigest() + + +def process(fileobj): + """Возвращает список вариантов: dict(name, content_type, data, sha256, width, height). Бросает PermanentError.""" + try: + fileobj.seek(0) + src = Image.open(fileobj) + fmt = src.format + width, height = src.size + if fmt not in ("PNG", "JPEG"): + raise PermanentError("invalid_image") + if width * height > config.MAX_IMAGE_PIXELS: + raise PermanentError("image_too_large") + if fmt == "JPEG" and width > 2560 and height > 2560: + # экономия памяти: JPEG декодируется сразу в масштабе 1/2 (результат всё равно вписывается в 1280x1280) + src.draft("RGB", (width // 2, height // 2)) + src.load() + img = ImageOps.exif_transpose(src) + except PermanentError: + raise + except MemoryError: + raise + except Exception: + raise PermanentError("invalid_image") from None + base = _flatten(img) + out = [] + # thumbnail + tw, th = _fit_size(base.width, base.height, 256) + thumb = base.resize((tw, th), Image.LANCZOS) if (tw, th) != base.size else base + data, sha = _encode(thumb, "JPEG", quality=JPEG_QUALITY, optimize=True) + out.append({"name": "thumbnail", "content_type": "image/jpeg", "data": data, "sha256": sha, "width": tw, "height": th}) + # crop 128x128 (центрированный квадрат) + side = min(base.width, base.height) + left, top = (base.width - side) // 2, (base.height - side) // 2 + crop = base.crop((left, top, left + side, top + side)).resize((128, 128), Image.LANCZOS) + data, sha = _encode(crop, "JPEG", quality=JPEG_QUALITY, optimize=True) + out.append({"name": "crop", "content_type": "image/jpeg", "data": data, "sha256": sha, "width": 128, "height": 128}) + # optimized WebP (прозрачность сохраняется) + opt_src = img.convert("RGBA") if (img.mode in ("RGBA", "LA") or (img.mode == "P" and "transparency" in img.info)) else base + ow, oh = _fit_size(opt_src.width, opt_src.height, 1280) + opt = opt_src.resize((ow, oh), Image.LANCZOS) if (ow, oh) != opt_src.size else opt_src + data, sha = _encode(opt, "WEBP", quality=WEBP_QUALITY, method=4) + out.append({"name": "optimized", "content_type": "image/webp", "data": data, "sha256": sha, "width": ow, "height": oh}) + return out 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/replay.py b/src/app/replay.py new file mode 100644 index 00000000..d3304c9d --- /dev/null +++ b/src/app/replay.py @@ -0,0 +1,70 @@ +"""Операторский replay и реестр неудавшихся заданий: python -m app.replay [list | replay | replay-all] + + list — реестр failed-вложений: id, error_code, число попыток, возраст, наличие staging; + replay — возвращает ТОЛЬКО failed-вложение в queued: новая попытка (attempt сбрасывается на 1), новый job_id, + запись в job_events (аудит), задание в outbox. Если у вложения уже есть варианты (ready/успешный + эффект), повторного исполнения не будет: вложение не в статусе failed -> replay отклоняется. +Эффекты защищены ключом (attachment_id, pipeline_version, name): даже повторное выполнение не создаёт второй набор вариантов. +""" +import argparse +import asyncio +import json +import sys +import uuid + +import asyncpg + +from . import config + + +async def list_failed(conn): + rows = await conn.fetch( + "SELECT id, error_code, attempt, staging_key IS NOT NULL AS has_staging, updated_at FROM attachments " + "WHERE status = 'failed' ORDER BY updated_at DESC LIMIT 200") + return [{"attachment_id": str(r["id"]), "error_code": r["error_code"], "attempt": r["attempt"], + "staging_present": r["has_staging"], "failed_at": r["updated_at"].isoformat()} for r in rows] + + +async def replay(conn, att_id): + async with conn.transaction(): + row = await conn.fetchrow("SELECT id, status, pipeline_version, staging_key FROM attachments WHERE id = $1 FOR UPDATE", att_id) + if row is None: + return {"attachment_id": str(att_id), "result": "not_found"} + if row["status"] != "failed": + return {"attachment_id": str(att_id), "result": "skipped", "reason": "status=%s (replay только для failed)" % row["status"]} + if not row["staging_key"]: + return {"attachment_id": str(att_id), "result": "skipped", "reason": "staging удалён по retention, исходник недоступен"} + job_id = uuid.uuid4() + await conn.execute("UPDATE attachments SET status = 'queued', error_code = NULL, attempt = 0, job_id = $2, lease_owner = NULL, " + "lease_expires_at = NULL, updated_at = now() WHERE id = $1", att_id, job_id) + await conn.execute("INSERT INTO outbox (job_id, attachment_id, pipeline_version, attempt) VALUES ($1, $2, $3, 1)", + job_id, att_id, row["pipeline_version"]) + await conn.execute("INSERT INTO job_events (attachment_id, job_id, event, attempt, detail) VALUES ($1, $2, 'operator_replay', 1, 'failed -> queued')", + att_id, job_id) + return {"attachment_id": str(att_id), "result": "requeued", "job_id": str(job_id)} + + +async def main_async(args): + conn = await asyncpg.connect(config.DATABASE_URL, timeout=5) + try: + if args.command == "list": + return await list_failed(conn) + if args.command == "replay": + return await replay(conn, uuid.UUID(args.attachment_id)) + return [await replay(conn, uuid.UUID(f["attachment_id"])) for f in await list_failed(conn)] + finally: + await conn.close() + + +def main(): + ap = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter) + sub = ap.add_subparsers(dest="command", required=True) + sub.add_parser("list") + r = sub.add_parser("replay") + r.add_argument("attachment_id") + sub.add_parser("replay-all") + print(json.dumps(asyncio.run(main_async(ap.parse_args())), ensure_ascii=False, indent=2)) + + +if __name__ == "__main__": + sys.exit(main()) diff --git a/src/app/s3.py b/src/app/s3.py new file mode 100644 index 00000000..18dbbafe --- /dev/null +++ b/src/app/s3.py @@ -0,0 +1,89 @@ +"""Приватное 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 put_bytes(self, key, data, content_type): + self._check() + await self.client.put_object(Bucket=config.S3_BUCKET, Key=key, Body=data, ContentType=content_type) + + 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/src/app/worker.py b/src/app/worker.py new file mode 100644 index 00000000..5912761b --- /dev/null +++ b/src/app/worker.py @@ -0,0 +1,323 @@ +"""Worker вложений: python -m app.worker + +Конвейер задания (jobs.schema.json, состояния — contracts/attachment-states.md): + claim (queued -> processing, lease) -> чтение staging -> варианты (Pillow, в потоках) -> запись в конечный S3-prefix + -> ОДНА транзакция: варианты + ready -> ack -> очистка staging. +Ack отправляется только после устойчивого эффекта (COMMIT результата). Повторная доставка уже готовой задачи — no-op с ack. +Временные ошибки: возврат в queued с backoff (экспоненциальный + jitter) через outbox; после MAX_ATTEMPTS — failed/retry_exhausted. +Постоянные ошибки (невалидное изображение): failed с error_code сразу. Зависшие processing возвращает sweeper по истечении lease. +""" +import asyncio +import json +import os +import random +import signal +import tempfile +import time +import uuid +from concurrent.futures import ThreadPoolExecutor + +import aio_pika + +from . import config, pipeline +from .broker import QUEUE, Broker +from .db import Database +from .outbox import Relay +from .s3 import S3 +from .web import log + +WORKER_ID = "%s-%s" % ((os.environ.get("HOSTNAME") or "worker")[:12], uuid.uuid4().hex[:6]) + + +def backoff_seconds(attempt): + """Экспоненциальная задержка с полным jitter: случайное значение в [0, min(cap, base * 2^(attempt-1))].""" + ceiling = min(config.RETRY_MAX_DELAY, config.RETRY_BASE_DELAY * (2 ** max(0, attempt - 1))) + return random.uniform(ceiling * 0.5, ceiling) + + +class Worker: + def __init__(self): + self.db, self.s3, self.broker = Database(), S3(), Broker() + self.relay = Relay(self.db, self.broker) + self.pool = ThreadPoolExecutor(max_workers=config.WORKER_CONCURRENCY, thread_name_prefix="img") + self.busy = 0 + self.stopping = False + self.tasks = [] + + # --- claim / finalize --------------------------------------------------------- + async def claim(self, job): + return await self.db.fetchrow( + "UPDATE attachments SET status = 'processing', lease_owner = $2, processing_started_at = now(), " + "lease_expires_at = now() + make_interval(secs => $3), attempt = $4, job_id = $5, updated_at = now() " + "WHERE id = $1 AND status = 'queued' AND pipeline_version <= $6 " + "RETURNING id, chat_id, staging_key, s3_key, content_type, size_bytes, attempt", + uuid.UUID(job["attachment_id"]), WORKER_ID, float(config.LEASE_SECONDS), job["attempt"], + uuid.UUID(job["job_id"]), job["pipeline_version"], retry=False) + + async def fail(self, att_id, job, code, event="failed"): + await self.db.execute( + "WITH u AS (UPDATE attachments SET status = 'failed', error_code = $2, lease_owner = NULL, lease_expires_at = NULL, " + "updated_at = now() WHERE id = $1 AND status = 'processing' AND lease_owner = $3 RETURNING id) " + "INSERT INTO job_events (attachment_id, job_id, event, attempt, detail) SELECT id, $4, $5, $6, $2 FROM u", + att_id, code, WORKER_ID, uuid.UUID(job["job_id"]), event, job["attempt"]) + + async def reschedule(self, att_id, job, reason): + """Временная ошибка: processing -> queued, новая запись outbox с отложенной публикацией (backoff + jitter).""" + nxt = job["attempt"] + 1 + if nxt > config.MAX_ATTEMPTS: + log("warning", "job_retry_exhausted", attachment_id=str(att_id), attempts=job["attempt"]) + await self.fail(att_id, job, "retry_exhausted", "retry_exhausted") + return + delay = backoff_seconds(job["attempt"]) + await self.db.execute( + "WITH u AS (UPDATE attachments SET status = 'queued', lease_owner = NULL, lease_expires_at = NULL, updated_at = now() " + "WHERE id = $1 AND status = 'processing' AND lease_owner = $2 RETURNING id, pipeline_version), " + "o AS (INSERT INTO outbox (job_id, attachment_id, pipeline_version, attempt, available_at) " + "SELECT $3, id, pipeline_version, $4, now() + make_interval(secs => $5) FROM u RETURNING 1) " + "INSERT INTO job_events (attachment_id, job_id, event, attempt, detail) SELECT id, $3, 'retry_scheduled', $4, $6 FROM u", + att_id, WORKER_ID, uuid.UUID(job["job_id"]), nxt, delay, reason) + log("info", "job_rescheduled", attachment_id=str(att_id), next_attempt=nxt, delay_seconds=round(delay, 2), reason=reason) + + async def publish_result(self, row, job, variants): + """Одна транзакция: варианты (идемпотентно) + ready. Только владелец lease может опубликовать результат.""" + async with self.db.conn() as c: + async with c.transaction(): + owner = await c.fetchval("SELECT 1 FROM attachments WHERE id = $1 AND status = 'processing' AND lease_owner = $2 " + "FOR UPDATE", row["id"], WORKER_ID) + if owner is None: + return False # lease потерян (sweeper вернул задачу): результат не публикуем, чужой повтор доделает + for v in variants: + await c.execute( + "INSERT INTO attachment_variants (attachment_id, pipeline_version, name, content_type, size_bytes, width, " + "height, sha256, s3_key) VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9) " + "ON CONFLICT (attachment_id, pipeline_version, name) DO NOTHING", + row["id"], job["pipeline_version"], v["name"], v["content_type"], len(v["data"]), v["width"], v["height"], + v["sha256"], "att/%s/v%d/%s" % (row["id"], job["pipeline_version"], v["name"])) + await c.execute("UPDATE attachments SET status = 'ready', error_code = NULL, ready_at = now(), updated_at = now(), " + "lease_owner = NULL, lease_expires_at = NULL WHERE id = $1", row["id"]) + await c.execute("INSERT INTO job_events (attachment_id, job_id, event, attempt) VALUES ($1, $2, 'ready', $3)", + row["id"], uuid.UUID(job["job_id"]), job["attempt"]) + return True + + # --- обработка ---------------------------------------------------------------- + async def process(self, job): + att_id = uuid.UUID(job["attachment_id"]) + row = await self.claim(job) + if row is None: + state = await self.db.fetchval("SELECT status FROM attachments WHERE id = $1", att_id) + log("info", "job_noop", attachment_id=job["attachment_id"], status=state or "unknown") + return # ready/failed/processing у другого владельца/неизвестное вложение: идемпотентный no-op, ack + started = time.perf_counter() + try: + await self.fault("after_claim") + stream, _ = await self.s3.open_stream(row["staging_key"]) + spool = tempfile.SpooledTemporaryFile(max_size=2 * 1024 * 1024) + try: + try: + while True: + chunk = await stream.read(256 * 1024) + if not chunk: + break + spool.write(chunk) + finally: + stream.close() + loop = asyncio.get_running_loop() + variants = await asyncio.wait_for(loop.run_in_executor(self.pool, pipeline.process, spool), config.JOB_TIMEOUT) + finally: + spool.close() + # оригинал и варианты в конечный prefix: ключи детерминированы, повторная запись перезаписывает те же байты + await self.copy_original(row) + for v in variants: + await self.s3.put_bytes("att/%s/v%d/%s" % (row["id"], job["pipeline_version"], v["name"]), v["data"], v["content_type"]) + await self.fault("after_s3_before_commit") + if not await self.publish_result(row, job, variants): + log("warning", "lease_lost", attachment_id=job["attachment_id"]) + return + await self.fault("after_commit_before_ack") + log("info", "job_ready", attachment_id=job["attachment_id"], attempt=job["attempt"], + duration_ms=round((time.perf_counter() - started) * 1000, 1)) + try: + await self.s3.delete(row["staging_key"]) # staging безопасно удалять после COMMIT результата + except Exception as exc: + log("warning", "staging_cleanup_failed", error_type=type(exc).__name__) + except pipeline.PermanentError as exc: + await self.fail(att_id, job, exc.code) + log("warning", "job_failed", attachment_id=job["attachment_id"], error_code=exc.code) + except MemoryError: + await self.fail(att_id, job, "processing_failed") + log("error", "job_failed_oom", attachment_id=job["attachment_id"]) + except asyncio.CancelledError: + raise + except InjectedCrash: + raise + except Exception as exc: # S3/БД/таймаут/неожиданное: временная ошибка + await self.reschedule(att_id, job, type(exc).__name__) + + async def copy_original(self, row): + stream, size = await self.s3.open_stream(row["staging_key"]) + spool = tempfile.SpooledTemporaryFile(max_size=2 * 1024 * 1024) + try: + while True: + chunk = await stream.read(256 * 1024) + if not chunk: + break + spool.write(chunk) + stream.close() + spool.seek(0) + await self.s3.put(row["s3_key"], spool, row["content_type"], size) + finally: + spool.close() + + async def fault(self, point): + """Точки внедрения сбоев для экспериментов (FAULT_INJECTION=crash:<точка> => процесс умирает мгновенно).""" + if "crash_once:" + point in config.FAULT_INJECTION: + marker = "/tmp/fault-%s.done" % point # сохраняется при рестарте того же контейнера -> сбой ровно один раз + if not os.path.exists(marker): + open(marker, "w").close() + log("error", "fault_crash_once", point=point) + os._exit(137) + if "crash:" + point in config.FAULT_INJECTION: + log("error", "fault_crash", point=point) + os._exit(137) + if "fail:" + point in config.FAULT_INJECTION: + raise OSError("injected failure at " + point) + + async def on_message(self, message): + try: + job = json.loads(message.body) + if (job.get("schema_version") != 1 or job.get("type") != "attachment.process.v1" + or not isinstance(job.get("attempt"), int) or not isinstance(job.get("pipeline_version"), int)): + raise ValueError("bad job") + uuid.UUID(job["attachment_id"]), uuid.UUID(job["job_id"]) + except Exception: + log("error", "job_unreadable") + await message.reject(requeue=False) # -> DLQ + return + self.busy += 1 + try: + await self.process(job) + await message.ack() + except InjectedCrash: + raise + except Exception as exc: + log("error", "job_unhandled", error_type=type(exc).__name__) + await message.nack(requeue=True) + finally: + self.busy -= 1 + + # --- sweeper ------------------------------------------------------------------- + async def sweep_once(self): + """Истёкший lease -> queued (новая попытка) или failed/retry_exhausted; чистка старого staging.""" + rows = await self.db.fetch( + "WITH exp AS (SELECT id FROM attachments WHERE status = 'processing' AND lease_expires_at < now() FOR UPDATE SKIP LOCKED), " + "u AS (UPDATE attachments a SET status = CASE WHEN a.attempt >= $1 THEN 'failed' ELSE 'queued' END, " + "error_code = CASE WHEN a.attempt >= $1 THEN 'retry_exhausted' ELSE NULL END, lease_owner = NULL, lease_expires_at = NULL, " + "updated_at = now() FROM exp WHERE a.id = exp.id RETURNING a.id, a.status, a.pipeline_version, a.attempt, a.job_id), " + "o AS (INSERT INTO outbox (job_id, attachment_id, pipeline_version, attempt) SELECT COALESCE(job_id, gen_random_uuid()), id, " + "pipeline_version, attempt + 1 FROM u WHERE status = 'queued' RETURNING 1), " + "e AS (INSERT INTO job_events (attachment_id, job_id, event, attempt, detail) SELECT id, job_id, 'lease_expired', attempt, status FROM u RETURNING 1) " + "SELECT id, status FROM u", config.MAX_ATTEMPTS) + for r in rows: + log("warning", "lease_expired", attachment_id=str(r["id"]), new_status=r["status"]) + if rows: + self.relay.kick() + + async def sweeper(self): + while not self.stopping: + try: + await self.sweep_once() + except Exception as exc: + log("warning", "sweeper_failed", error_type=type(exc).__name__) + await asyncio.sleep(config.SWEEP_INTERVAL) + + async def staging_janitor(self): + """Удаляет staging для ready (если не удалён после COMMIT) и для failed старше retention; текущую работу не трогает.""" + while not self.stopping: + await asyncio.sleep(max(30, config.SWEEP_INTERVAL * 6)) + try: + rows = await self.db.fetch( + "SELECT id, staging_key FROM attachments WHERE staging_key IS NOT NULL AND (status = 'ready' OR " + "(status = 'failed' AND updated_at < now() - make_interval(secs => $1))) LIMIT 200", + float(config.STAGING_FAILED_RETENTION_SECONDS)) + for r in rows: + await self.s3.delete(r["staging_key"]) + await self.db.execute("UPDATE attachments SET staging_key = NULL WHERE id = $1", r["id"]) + except Exception as exc: + log("warning", "staging_janitor_failed", error_type=type(exc).__name__) + + # --- жизненный цикл ------------------------------------------------------------ + async def connect_broker(self): + while not self.stopping: + try: + await self.broker.ensure(prefetch=config.WORKER_CONCURRENCY) + return + except Exception as exc: + log("warning", "broker_unavailable", error_type=type(exc).__name__) + await asyncio.sleep(2) + + async def consume(self): + while not self.stopping: + await self.connect_broker() + try: + queue = await self.broker.channel.declare_queue(QUEUE, durable=True, passive=True) + tag = await queue.consume(self.on_message) + log("info", "consuming", worker=WORKER_ID, prefetch=config.WORKER_CONCURRENCY) + while not self.stopping and not self.broker.channel.is_closed: + await asyncio.sleep(1) + if self.stopping: + await queue.cancel(tag) + return + except Exception as exc: + log("warning", "consume_failed", error_type=type(exc).__name__) + await asyncio.sleep(2) + + async def run(self): + await self.db.start() + await self.s3.start() + log("info", "worker_started", worker=WORKER_ID, concurrency=config.WORKER_CONCURRENCY, lease=config.LEASE_SECONDS, + max_attempts=config.MAX_ATTEMPTS) + loop = asyncio.get_running_loop() + for sig in (signal.SIGTERM, signal.SIGINT): + try: + loop.add_signal_handler(sig, self.request_stop) + except NotImplementedError: + signal.signal(sig, lambda *_: self.request_stop()) + self.tasks = [asyncio.create_task(self.consume()), asyncio.create_task(self.relay.run()), + asyncio.create_task(self.sweeper()), asyncio.create_task(self.staging_janitor())] + beat = 0.0 + while not self.stopping: + if time.monotonic() - beat > 5: # heartbeat для HEALTHCHECK контейнера + beat = time.monotonic() + try: + with open("/tmp/worker.alive", "w") as fh: + fh.write(str(time.time())) + except OSError: + pass + await asyncio.sleep(0.5) + # graceful: перестаём брать новые задания, ждём текущие до GRACEFUL_SHUTDOWN_SECONDS + deadline = time.monotonic() + config.GRACEFUL_SHUTDOWN_SECONDS + while self.busy and time.monotonic() < deadline: + await asyncio.sleep(0.2) + self.relay.stop() + for t in self.tasks: + t.cancel() + await self.broker.stop() + await self.s3.stop() + await self.db.stop() + log("info", "worker_stopped", unfinished=self.busy) + + def request_stop(self): + log("info", "worker_stopping") + self.stopping = True + + +class InjectedCrash(Exception): + pass + + +def main(): + asyncio.run(Worker().run()) + + +if __name__ == "__main__": + main() diff --git a/student-tests/fixtures/alpha.png b/student-tests/fixtures/alpha.png new file mode 100644 index 0000000000000000000000000000000000000000..975b70d929a134f58bb20d5c8adfb85a828b698c GIT binary patch literal 344 zcmeAS@N?(olHy`uVBq!ia0vp^CxAGGgAGU?ZmZ{JU|^K@ba4!+nDh4XM&1Jk0?dZi zzu(Vccvrl3zrsSsD|h00KFu>cTKt>AM@@i(sZn8s5ntakU%bV1>?kjDH!#E)JYD@< J);T3K0RZF|MVbHr literal 0 HcmV?d00001 diff --git a/student-tests/fixtures/exif_rot6.jpg b/student-tests/fixtures/exif_rot6.jpg new file mode 100644 index 0000000000000000000000000000000000000000..4443f106e1e4d9a4f272a6f3683eda7b9c4ca208 GIT binary patch literal 1604 zcmex=oK-pTLJOhg$tB|6hBb#tw zBD+$dh*9Ijg&fLG8xM*GUHqV8oK)1r$t5N(At|M*rmmr>WnyY(ZeeNV?BeR??&0Yb z91<+v*#~fzWVs-^OvvRzW@07 z3*;|G24;x2fF#6cX#Nre`iqH$g_(sNe5(%j`x{iFGU^-oqD{m*cF{;xdtuh$v>Gn}+; z`_HibKf{+NO+Z7>@$ci(Skyo)w%G^N^QGh;J2nkg{Ve|(PQU-d{GTCh-J+fK$h`es zHLm{|CM_2K&yZLDa)Fne~>u;G(U>}^XiHJyYoN8vIq6C1@eC;@5ujM|DVCn18CBp z2frUI>e65!5;LEEv8d}mgS-EO0xUY1SA6jQv+qB{0sC)Rue7HlbABv868}@nu>RZg zf3q9^mL918_1lESkWO8iF$SeTb#Ng@b=d#Wzp$PzdXENyk literal 0 HcmV?d00001 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/fixtures/small.png b/student-tests/fixtures/small.png new file mode 100644 index 0000000000000000000000000000000000000000..caadb26e3f5b07f788baaa11d57825e6843ce288 GIT binary patch literal 132 zcmeAS@N?(olHy`uVBq!ia0vp^MnEjb!2~298sAzCq`W;{978JRoIPjA$e_S;V8f;2 uf2<0k%zv^)o}7`bQt_NbB)Y@*$9Ad$!-vuut4ly*89ZJ6T-G@yGywov94Mv$ 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..f97228d9 --- /dev/null +++ b/student-tests/test_attachments.py @@ -0,0 +1,205 @@ +"""Собственные тесты вложений lab5 (негативные сценарии и права). Запуск: + 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 time +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 wait_ready(token, att_id, seconds=60): + """lab5: загрузка возвращает 202 queued; готовность определяется опросом метаданных.""" + deadline = time.time() + seconds + while time.time() < deadline: + code, _, body = download(token, att_id, "") + att = json.loads(body) + if att["status"] == "ready": + return att + assert att["status"] != "failed", att + time.sleep(0.3) + raise AssertionError("not ready") + + +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, 202, att) + self.assertEqual((att["status"], att["variants"], att["error_code"]), ("queued", [], None)) + wait_ready(self.b["token"], att["id"]) + 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], 202) + + 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] + wait_ready(self.a["token"], att["id"]) + 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], 200) # после ready вариант доступен + 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] + wait_ready(self.a["token"], att["id"]) + 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_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_pipeline.py b/student-tests/test_pipeline.py new file mode 100644 index 00000000..4c7748ab --- /dev/null +++ b/student-tests/test_pipeline.py @@ -0,0 +1,182 @@ +"""Тесты асинхронного конвейера вложений lab5 (контракт вариантов, состояния, права). Запуск: + python -m unittest discover -s student-tests -p "test_pipeline.py" -v +Пиксельные проверки выполняются, если установлен Pillow (иначе пропускаются); размеры проверяются по заголовкам файлов. +""" +import hashlib +import io +import os +import struct +import sys +import time +import unittest +import uuid + +sys.path.insert(0, os.path.dirname(__file__)) +from test_api import call, register # noqa: E402 +from test_attachments import FIX, JPG, PNG, download, upload # noqa: E402 + +try: + from PIL import Image +except ImportError: # pragma: no cover + Image = None + + +def fixture(name): + return open(os.path.join(FIX, name), "rb").read() + + +def jpeg_size(data): + i = 2 + while i < len(data): + while data[i] == 0xFF: + i += 1 + marker = data[i] + i += 1 + if marker in (0xD8, 0x01) or 0xD0 <= marker <= 0xD7: + continue + length = int.from_bytes(data[i:i + 2], "big") + if marker in (0xC0, 0xC1, 0xC2): + return int.from_bytes(data[i + 5:i + 7], "big"), int.from_bytes(data[i + 3:i + 5], "big") + i += length + raise AssertionError("JPEG dimensions not found") + + +def webp_size(data): + assert data[:4] == b"RIFF" and data[8:12] == b"WEBP", "not WebP" + kind = data[12:16] + if kind == b"VP8X": + return 1 + int.from_bytes(data[24:27], "little"), 1 + int.from_bytes(data[27:30], "little") + if kind == b"VP8L": + bits = int.from_bytes(data[21:25], "little") + return (bits & 0x3FFF) + 1, ((bits >> 14) & 0x3FFF) + 1 + if kind == b"VP8 ": + return struct.unpack(" 100x300 -> вписывается в 256: 85x256 (округление вниз) + self.assertEqual((v["thumbnail"]["width"], v["thumbnail"]["height"]), (85, 256)) + self.assertEqual(jpeg_size(self.fetch(att, "thumbnail")[1]), (85, 256)) + + def test_small_image_is_not_upscaled_but_crop_is_128(self): + att = self.ready(fixture("small.png"), "image/png", "small.png") + v = self.variants(att) + self.assertEqual((v["thumbnail"]["width"], v["thumbnail"]["height"]), (50, 30)) + self.assertEqual((v["crop"]["width"], v["crop"]["height"]), (128, 128)) + self.assertEqual((v["optimized"]["width"], v["optimized"]["height"]), (50, 30)) + + @unittest.skipIf(Image is None, "нужен Pillow") + def test_alpha_is_composited_on_white(self): + att = self.ready(fixture("alpha.png"), "image/png", "alpha.png") + thumb = Image.open(io.BytesIO(self.fetch(att, "thumbnail")[1])).convert("RGB") + left, right = thumb.getpixel((10, thumb.height // 2)), thumb.getpixel((thumb.width - 10, thumb.height // 2)) + self.assertTrue(all(c > 235 for c in left), "прозрачная область должна стать белой: %s" % (left,)) + self.assertTrue(right[0] > 200 and right[1] < 60, "непрозрачная красная область сохранена: %s" % (right,)) + + def test_message_can_reference_attachment_before_ready_and_failed_cannot(self): + status, _, att = upload(self.a["token"], self.chat["id"], PNG) + path = "/api/v1/chats/%s/messages" % self.chat["id"] + sent = call("POST", path, {"text": "", "attachment_ids": [att["id"]]}, self.a["token"]) + self.assertEqual((status, sent[0], sent[2]["attachment_ids"]), (202, 201, [att["id"]])) + poison = upload(self.a["token"], self.chat["id"], fixture("poison.png")) + self.assertEqual(poison[0], 202, poison[2]) + failed = wait_status(self.b["token"], poison[2]["id"], ("failed",)) + self.assertEqual((failed["status"], failed["error_code"], failed["variants"]), ("failed", "invalid_image", [])) + self.assertEqual(call("POST", path, {"text": "x", "attachment_ids": [failed["id"]]}, self.a["token"])[0], 409) + self.assertEqual(download(self.b["token"], failed["id"], "/content")[0], 409) + self.assertEqual(download(self.b["token"], failed["id"], "/content?variant=thumbnail")[0], 409) + + def test_content_is_409_while_not_ready_and_original_is_untouched(self): + status, _, att = upload(self.a["token"], self.chat["id"], PNG) + code = download(self.b["token"], att["id"], "/content")[0] + self.assertIn(code, (200, 409)) # быстрый worker мог успеть: 200 допустим, но не 404/500 + done = wait_status(self.b["token"], att["id"]) + self.assertEqual(download(self.b["token"], done["id"], "/content")[2], PNG) + + def test_other_variants_visible_only_to_chat_members(self): + att = self.ready(PNG) + for variant in ("thumbnail", "crop", "optimized", "original"): + self.assertEqual(download(self.eve["token"], att["id"], "/content?variant=" + variant)[0], 404) + self.assertEqual(download(self.b["token"], att["id"], "/content?variant=bogus")[0], 400) + + def test_ready_job_redelivery_does_not_duplicate_variants(self): + from test_api import psql + att = self.ready(PNG) + before = psql("SELECT count(*) FROM attachment_variants WHERE attachment_id = '%s'" % att["id"]) + self.assertEqual(before, "3") + psql("INSERT INTO outbox (job_id, attachment_id, pipeline_version, attempt) VALUES (gen_random_uuid(), '%s', 1, 2)" % att["id"]) + time.sleep(4) + self.assertEqual(psql("SELECT count(*) FROM attachment_variants WHERE attachment_id = '%s'" % att["id"]), "3") + self.assertEqual(wait_status(self.b["token"], att["id"])["status"], "ready") + + def test_staging_is_cleaned_after_ready_and_kept_for_failed(self): + import subprocess + from test_api import ROOT, psql + att = self.ready(PNG) + poison = upload(self.a["token"], self.chat["id"], fixture("poison.png"))[2] + wait_status(self.b["token"], poison["id"], ("failed",)) + + def exists(att_id): + code = "\n".join(["import asyncio", "from app.s3 import S3", "async def m():", + " s = S3(); await s.start(); print((await s.head('staging/%s')) is not None); await s.stop()" % att_id, + "asyncio.run(m())"]) + return subprocess.run(["docker", "compose", "--env-file", ".env", "exec", "-T", "api", "python", "-c", code], cwd=ROOT, + capture_output=True, text=True).stdout.strip() + self.assertEqual(exists(att["id"]), "False", "staging готового вложения должен быть удалён после COMMIT результата") + self.assertEqual(exists(poison["id"]), "True", "staging неудавшегося вложения хранится для разбора/replay (retention)") + + +if __name__ == "__main__": + unittest.main() diff --git a/student-tests/test_resilience5.py b/student-tests/test_resilience5.py new file mode 100644 index 00000000..69c6af0e --- /dev/null +++ b/student-tests/test_resilience5.py @@ -0,0 +1,154 @@ +"""Отказы конвейера lab5 (окна отказа из contracts/attachment-states.md). Тесты управляют контейнерами (volumes сохраняются): + python student-tests/test_resilience5.py # ~5-7 минут + +Окна: (1) worker остановлен -> upload -> рестарт API -> worker поднят; (2) рестарт брокера с volume; (3) брокер недоступен +при приёме (outbox); (4) crash API между COMMIT и publish; (5) crash worker после записи в S3 до COMMIT результата; +(6) crash после COMMIT до ack; (7) исчерпание попыток и операторский replay. +""" +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 +from test_pipeline import wait_status # 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).stdout + + +def wait(predicate, seconds=90, message="условие"): + deadline = time.time() + seconds + while time.time() < deadline: + try: + if predicate(): + return + except Exception: + pass + time.sleep(1) + raise AssertionError("%s не выполнено за %d с" % (message, seconds)) + + +def healthy(service): + ids = compose("ps", "-q", service).split() + return bool(ids) and all(subprocess.run(["docker", "inspect", "-f", "{{.State.Health.Status}}", i], capture_output=True, text=True).stdout.strip() == "healthy" for i in ids) + + +def api_ready(): + return call("GET", "/health/ready")[0] == 200 + + +def recreate_worker(env=None): + compose("up", "-d", "--no-deps", "--force-recreate", "worker", env=env) + wait(lambda: healthy("worker"), 90, "worker healthy") + + +class ResilienceTest(unittest.TestCase): + @classmethod + def tearDownClass(cls): + recreate_worker() + compose("up", "-d", "--no-deps", "rabbitmq", "api") + + def setUp(self): + compose("start", "rabbitmq", "postgres", "minio", "valkey", check=False) + wait(lambda: healthy("rabbitmq") and healthy("postgres"), 90, "rabbitmq/postgres healthy") + wait(api_ready, 60, "api ready") + self.a = register("res") + self.chat = call("POST", "/api/v1/chats", {"title": "отказы", "member_ids": [self.a["user"]["id"]]}, self.a["token"])[2] + + def accept(self, data=PNG): + status, _, att = upload(self.a["token"], self.chat["id"], data) + self.assertEqual(status, 202, att) + return att + + def done(self, att, seconds=90): + ready = wait_status(self.a["token"], att["id"], ("ready",), seconds) + self.assertEqual(psql("SELECT count(*) FROM attachment_variants WHERE attachment_id = '%s'" % att["id"]), "3") # без дублей + code, _, body = download(self.a["token"], att["id"]) + self.assertEqual((code, body), (200, PNG)) + return ready + + def test_1_worker_down_upload_api_restart_worker_up(self): + compose("stop", "worker") + att = self.accept() + sent = call("POST", "/api/v1/chats/%s/messages" % self.chat["id"], {"text": "", "attachment_ids": [att["id"]]}, self.a["token"]) + self.assertEqual(sent[0], 201) + time.sleep(3) + self.assertEqual(wait_status(self.a["token"], att["id"], ("queued",), 5)["status"], "queued") # не обрабатывается без worker + compose("restart", "api") + wait(api_ready, 60, "api ready") + compose("start", "worker") + self.done(att) + + def test_2_broker_restart_keeps_accepted_jobs(self): + compose("stop", "worker") + att = self.accept() + time.sleep(2) + compose("restart", "rabbitmq") + wait(lambda: healthy("rabbitmq"), 90, "rabbitmq healthy") + compose("start", "worker") + self.done(att) + + def test_3_broker_down_during_acceptance_outbox_delivers_later(self): + compose("stop", "rabbitmq") + att = self.accept() # 202 даже без брокера: намерение зафиксировано в outbox + self.assertEqual(psql("SELECT count(*) FROM outbox WHERE attachment_id = '%s' AND published_at IS NULL" % att["id"]), "1") + time.sleep(3) + self.assertEqual(wait_status(self.a["token"], att["id"], ("queued",), 5)["status"], "queued") + compose("start", "rabbitmq") + self.done(att) + self.assertEqual(psql("SELECT count(*) FROM outbox WHERE attachment_id = '%s' AND published_at IS NULL" % att["id"]), "0") + + def test_4_api_crash_between_commit_and_publish(self): + compose("stop", "rabbitmq") + att = self.accept() # COMMIT выполнен, publish невозможен + for cid in compose("ps", "-q", "api").split(): + subprocess.run(["docker", "kill", cid], capture_output=True) # внезапная смерть всех реплик API + compose("start", "rabbitmq") + wait(lambda: healthy("rabbitmq"), 90, "rabbitmq healthy") + compose("up", "-d", "--no-deps", "api") + wait(api_ready, 90, "api ready") + self.done(att) # relay (в worker/новом API) довёл задание без ручного вмешательства + + def test_5_worker_crash_after_s3_before_commit_lease_recovery(self): + recreate_worker({"WORKER_FAULT_INJECTION": "crash_once:after_s3_before_commit", "LEASE_SECONDS": "8"}) + att = self.accept() + ready = self.done(att, 120) + events = psql("SELECT string_agg(event, ',' ORDER BY id) FROM job_events WHERE attachment_id = '%s'" % att["id"]) + self.assertIn("lease_expired", events) + self.assertIn("ready", events) + self.assertEqual(ready["status"], "ready") + + def test_6_worker_crash_after_commit_before_ack_redelivery_is_noop(self): + recreate_worker({"WORKER_FAULT_INJECTION": "crash_once:after_commit_before_ack"}) + att = self.accept() + self.done(att, 120) + time.sleep(5) # повторная доставка: no-op с ack, вариантов по-прежнему 3 + self.assertEqual(psql("SELECT count(*) FROM attachment_variants WHERE attachment_id = '%s'" % att["id"]), "3") + self.assertEqual(psql("SELECT status FROM attachments WHERE id = '%s'" % att["id"]), "ready") + + def test_7_retry_exhaustion_registry_and_operator_replay(self): + recreate_worker({"WORKER_FAULT_INJECTION": "fail:after_claim", "MAX_ATTEMPTS": "3", "RETRY_BASE_DELAY": "0.3"}) + att = self.accept() + failed = wait_status(self.a["token"], att["id"], ("failed",), 60) + self.assertEqual((failed["error_code"], failed["variants"]), ("retry_exhausted", [])) + events = psql("SELECT string_agg(event || ':' || coalesce(attempt::text,''), ',' ORDER BY id) FROM job_events WHERE attachment_id = '%s'" % att["id"]) + self.assertEqual(events.count("retry_scheduled"), 2, events) + registry = json.loads(compose("run", "--rm", "-T", "worker", "python", "-m", "app.replay", "list")) + self.assertIn(att["id"], [r["attachment_id"] for r in registry]) + recreate_worker() # причина устранена + result = json.loads(compose("run", "--rm", "-T", "worker", "python", "-m", "app.replay", "replay", att["id"])) + self.assertEqual(result["result"], "requeued") + self.done(att) + again = json.loads(compose("run", "--rm", "-T", "worker", "python", "-m", "app.replay", "replay", att["id"])) + self.assertEqual(again["result"], "skipped") # replay не исполняет дубль уже успешной работы + + +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..4492dbc2 --- /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-lab5" + + +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()