Compare commits
3
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
9696ad71a4 | ||
|
|
c43d3490a0 | ||
|
|
5c9b3e206a |
+11
-20
@@ -1,20 +1,11 @@
|
||||
.git
|
||||
.github
|
||||
.env
|
||||
.env.*
|
||||
!.env.example
|
||||
secrets
|
||||
certs
|
||||
volumes
|
||||
data
|
||||
backups
|
||||
*.key
|
||||
*.pem
|
||||
*.p12
|
||||
*.pfx
|
||||
*.jks
|
||||
.venv
|
||||
__pycache__
|
||||
node_modules
|
||||
evidence
|
||||
.DS_Store
|
||||
*
|
||||
!Dockerfile
|
||||
!requirements.txt
|
||||
!src/
|
||||
!src/**
|
||||
!migrations/
|
||||
!migrations/**
|
||||
!research/
|
||||
!research/**
|
||||
**/__pycache__/
|
||||
**/*.py[cod]
|
||||
|
||||
+4
-2
@@ -3,11 +3,12 @@
|
||||
APP_HOST=0.0.0.0
|
||||
APP_PORT=8080
|
||||
APP_ENV=lab
|
||||
HOST_PORT=8080
|
||||
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:
|
||||
SESSION_STORE=postgres
|
||||
# Shared sessions carried over from lab3 use Valkey.
|
||||
SESSION_STORE=valkey
|
||||
CACHE_URL_FILE=/run/secrets/cache_url
|
||||
API_REPLICAS=2
|
||||
IDEMPOTENCY_TTL_SECONDS=86400
|
||||
@@ -18,3 +19,4 @@ 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
|
||||
UPLOAD_CLEANUP_GRACE_SECONDS=3600
|
||||
|
||||
@@ -0,0 +1,24 @@
|
||||
name: Application
|
||||
on: [push, pull_request]
|
||||
permissions:
|
||||
contents: read
|
||||
|
||||
jobs:
|
||||
docker:
|
||||
runs-on: ubuntu-latest
|
||||
timeout-minutes: 20
|
||||
steps:
|
||||
- uses: actions/checkout@v4
|
||||
- uses: actions/setup-python@v5
|
||||
with:
|
||||
python-version: '3.11'
|
||||
- run: python -m venv .venv
|
||||
- run: .venv/bin/python -m pip install -r requirements.txt
|
||||
- run: ./scripts/check-docker.sh
|
||||
- uses: actions/upload-artifact@v4
|
||||
if: always()
|
||||
with:
|
||||
name: lab4-evidence
|
||||
path: |
|
||||
evidence/lab4-checks.txt
|
||||
evidence/lab4-checks.json
|
||||
+28
@@ -0,0 +1,28 @@
|
||||
FROM python:3.11.15-slim-bookworm@sha256:d29f48a31a8b408ed19272ca1e7b10ebae13b240a27e862d3d4217c528e2e0c3
|
||||
|
||||
ENV PYTHONDONTWRITEBYTECODE=1 \
|
||||
PYTHONUNBUFFERED=1 \
|
||||
APP_HOST=0.0.0.0 \
|
||||
APP_PORT=8080
|
||||
|
||||
WORKDIR /app
|
||||
|
||||
COPY requirements.txt .
|
||||
RUN python -m pip install --no-cache-dir -r requirements.txt \
|
||||
&& python -m pip check
|
||||
|
||||
RUN groupadd --gid 10001 app \
|
||||
&& useradd --uid 10001 --gid app --no-create-home app
|
||||
|
||||
COPY src/ ./src/
|
||||
COPY migrations/ ./migrations/
|
||||
COPY research/ ./research/
|
||||
|
||||
USER 10001:10001
|
||||
EXPOSE 8080
|
||||
STOPSIGNAL SIGTERM
|
||||
|
||||
HEALTHCHECK --interval=2s --timeout=3s --start-period=5s --retries=3 \
|
||||
CMD ["python", "-m", "src.healthcheck"]
|
||||
|
||||
CMD ["python", "-m", "src"]
|
||||
+202
@@ -0,0 +1,202 @@
|
||||
# Отчёт — лабораторная 2
|
||||
|
||||
- Автор, группа: Савельев Иван БВТ2304
|
||||
- Целевая оценка: **5**, уровень 3 + весь уровень 4 + **трек 2 «План запроса и восстановление»**.
|
||||
- Commit/PR: TODO после публикации. Сохранённые проверки относятся к рабочим изменениям поверх коммита, указанного в evidence.
|
||||
- Стек: Python 3.11.15 в образе, FastAPI 0.142.4, Uvicorn 0.54.0, Pydantic 2.13.5, Psycopg 3.3.6, PostgreSQL 17.6, Valkey 8.1.3, Argon2id. Прямые и транзитивные зависимости приложения закреплены в requirements.txt.
|
||||
|
||||
## Запуск из чистого clone
|
||||
|
||||
Нужны Docker Engine с Compose v2, Python 3.11, Bash и make. Для demo.sh также нужны curl и jq. Все компоненты запускаются из этого репозитория. Команды выполнять из корня:
|
||||
|
||||
```sh
|
||||
python3 -m venv .venv
|
||||
.venv/bin/python -m pip install -r requirements.txt
|
||||
./scripts/start.sh
|
||||
./scripts/check.sh
|
||||
./scripts/demo.sh
|
||||
```
|
||||
|
||||
start.sh создаёт .env и secrets через scripts/init_local.py, собирает API, запускает PostgreSQL и Valkey, затем ждёт готовности API. Пустая БД мигрируется при старте приложения. POST /users теперь требует password; бизнес-запросы принимают Authorization: Bearer. Адрес по умолчанию — http://localhost:8080.
|
||||
|
||||
Локальный пароль PostgreSQL создаётся случайно и сохраняется в secrets/postgres_password; URL соединений — в secrets/database_url и secrets/cache_url. Значения не печатаются. Существующие файлы не перезаписываются. Каталог secrets имеет права 0700; файлы 0444, чтобы непривилегированный пользователь контейнера мог читать примонтированные secrets. Содержимое каталога исключено из Git. .env содержит настройки и пути к secrets. Его и .venv в образе нет.
|
||||
|
||||
| Настройка | Использование |
|
||||
| --- | --- |
|
||||
| APP_HOST, APP_PORT | Адрес Uvicorn; внутри контейнера оставить 0.0.0.0:8080 |
|
||||
| HOST_PORT | Порт публикации на 127.0.0.1 компьютера |
|
||||
| SESSION_TTL_SECONDS | Срок новой сессии; по умолчанию 3600 секунд |
|
||||
| SESSION_STORE | В этой реализации valkey |
|
||||
| DATABASE_URL_FILE | Файл с PostgreSQL DSN |
|
||||
| CACHE_URL_FILE | Файл с URL Valkey, который хранит сессии |
|
||||
| APP_ENV | Метка учебного окружения; поведение API не переключает |
|
||||
|
||||
Другой внешний порт и команды управления:
|
||||
|
||||
```sh
|
||||
HOST_PORT=8081 ./scripts/start.sh
|
||||
BASE_URL=http://localhost:8081 ./scripts/check.sh
|
||||
BASE_URL=http://localhost:8081 ./scripts/demo.sh
|
||||
|
||||
docker compose logs --tail 30 api
|
||||
./scripts/migrate.sh # повторное применение безопасно
|
||||
./scripts/restart.sh # перезапускает API, PostgreSQL и Valkey
|
||||
./scripts/stop.sh # удаляет контейнеры и сеть, сохраняет volumes
|
||||
```
|
||||
|
||||
Для рестарта с нестандартным внешним портом передать то же HOST_PORT или записать его в .env. Команда `docker compose down --volumes` намеренно удаляет учебные данные текущего Compose project, включая сессии; для обычной остановки она не нужна. scripts/run-local.sh вызывает start.sh: локальный стенд lab2 включает все три сервиса.
|
||||
|
||||
PostgreSQL и Valkey не публикуют порты на хост. API запускается от UID/GID 10001 и является PID 1. Лимиты: API — 1 CPU / 256 MiB, PostgreSQL — 1 CPU / 512 MiB, Valkey — 0.5 CPU / 128 MiB. Именованные volumes: postgres_data и valkey_data. Секреты API примонтированы файлами, состояние в API-контейнере не хранится.
|
||||
|
||||
## Архитектура и транзакции
|
||||
|
||||
Сохранены обработчики и модель пользователей/чатов/сообщений из lab1, строгая валидация, единые ошибки, X-Request-Id, пагинация и проверки доступа. Вместо словарей используется PostgreSQL, вместо X-User-Id — Bearer. Контракт, публичные tests, README и COURSE второй работы не изменялись.
|
||||
|
||||
Схема спроектирована перед SQL-реализацией в [docs/schema.md](docs/schema.md). Миграция — migrations/001_initial.sql:
|
||||
|
||||
| Таблица | Содержимое и ограничения |
|
||||
| --- | --- |
|
||||
| users | UUID PK, username UNIQUE, display_name, password_hash, created_at |
|
||||
| chats | UUID PK, title, created_at |
|
||||
| chat_members | PK (chat_id, user_id); FK на пользователей и чаты |
|
||||
| messages | UUID PK; chat_id; sender_id; text; created_at; составной FK на участника чата |
|
||||
| schema_migrations | Версия, SHA-256 и время применения миграции |
|
||||
|
||||
Одна функция записи в storage.py — одна транзакция. Контекст соединения делает COMMIT при успехе и ROLLBACK при исключении. Ответ 201 формируется после выхода из транзакции. Уникальность username гарантирует ограничение PostgreSQL. Создание чата сначала вставляет чат, затем всех участников: FK violation откатывает и чат, и уже вставленных участников. Проверка доступа и запись сообщения находятся в одной транзакции; составной FK дополнительно требует членства отправителя.
|
||||
|
||||
Все значения клиента передаются параметрами `%s`, без подстановки в SQL. Динамические имена индексов в исследовании выбираются только из фиксированных вариантов программы. Пул API: от 1 до 5 соединений, не более 20 ожидающих; ожидание пула — 2 с, connect_timeout — 2 с, statement_timeout — 3 с, lock_timeout — 2 с, idle_in_transaction_session_timeout — 5 с. При недоступности PostgreSQL возвращается общий 503.
|
||||
|
||||
Миграции выполняются в транзакции под advisory lock. Повторная версия пропускается, checksum обнаруживает редактирование уже применённого SQL. Повторный запуск не создаёт новые пользовательские данные. Новое изменение схемы оформляется следующим SQL-файлом.
|
||||
|
||||
## Пароли и сессии
|
||||
|
||||
password имеет длину 12–128 Unicode code points и не возвращается в User. В БД сохраняется Argon2id с собственной случайной солью: memory_cost=19456 KiB, time_cost=2, parallelism=1. Это конфигурация 19 MiB / 2 / 1 из [OWASP Password Storage](https://cheatsheetseries.owasp.org/cheatsheets/Password_Storage_Cheat_Sheet.html). Не более двух вычислений хеша одновременно ограничивают расход памяти.
|
||||
|
||||
POST /api/v1/auth/sessions принимает только Basic без тела. Пароль декодируется как UTF-8; разделение по первому двоеточию позволяет использовать двоеточие в пароле. Неверный пароль и неизвестное имя дают одинаковый 401 с WWW-Authenticate: Basic. Бизнес-запросы требуют Bearer и при 401 возвращают WWW-Authenticate: Bearer. X-User-Id игнорируется и сам по себе доступа не даёт.
|
||||
|
||||
Токен содержит 32 случайных байта, представленных непрозрачной строкой. Valkey хранит session:SHA256(token) → user_id и expires_at с TTL. Токен не является username/UUID; его исходное значение не сохраняется в ключе. Чтение сессии не продлевает срок. Абсолютный expires_at дополнительно проверяется приложением. DELETE /auth/sessions/current удаляет только текущую сессию, возвращает пустой 204; повторное использование — 401.
|
||||
|
||||
Valkey — источник истины для сессий. Включены AOF, appendfsync always, постоянный volume и noeviction. Поэтому обычный рестарт не сбрасывает ещё действующие сессии. При недоступности Valkey возвращается 503, перехода на доверие к X-User-Id или анонимному запросу нет. Ошибка подключения ограничена таймаутом 0.5 с, автоматические повторы отключены. Истечение TTL и logout не требуют инвалидации отдельного кэша.
|
||||
|
||||
/health/live показывает доступность процесса; /health/ready проверяет PostgreSQL и Valkey. Docker healthcheck проверяет HTTP 200 и JSON status=ok. При остановке зависимости live остаётся 200, ready возвращает 503.
|
||||
|
||||
## Пагинация и индекс истории
|
||||
|
||||
Запрос истории выбирает из БД только `limit + 1` записей после пары `(created_at, id)`, упорядоченных по той же паре. Индекс messages_history_idx(chat_id, created_at, id) соответствует равенству по чату и диапазону по ключу. Наличие опорной записи курсора проверяется отдельным индексным запросом; полная история в Python не загружается.
|
||||
|
||||
Курсор содержит scope, время и UUID в Base64. Scope привязан к чату или списку чатов пользователя. Чужой, повреждённый или несуществующий anchor даёт 400. limit — 1..100, по умолчанию 50; изменение limit при продолжении допустимо. Неучастник и отсутствующий чат возвращают одинаковый 404.
|
||||
|
||||
Каждая страница отражает отдельное чтение. Общего snapshot между HTTP-запросами нет. Неизменная история обходится без повторов; конкурентная запись с ключом меньше уже выданного курсора может не попасть на следующие страницы. Время берётся из часов PostgreSQL, поэтому остаётся ограничение при переводе системных часов назад.
|
||||
|
||||
## Проверки уровней 3 и 4
|
||||
|
||||
```sh
|
||||
# На работающем стенде: структура, публичный smoke и 23 собственных теста
|
||||
./scripts/check.sh
|
||||
|
||||
# Явный persistence-тест с прежним токеном; сохраняет volumes
|
||||
make test-persistence PYTHON=.venv/bin/python ACTION_SCRIPT=scripts/restart.sh
|
||||
|
||||
# Полный прогон в отдельном временном Compose project, включая отказы и короткий TTL
|
||||
./scripts/check-docker.sh
|
||||
|
||||
# Полная валидация исходного OpenAPI
|
||||
.venv/bin/python -m pip install -r requirements-dev.txt
|
||||
make validate PYTHON=.venv/bin/python
|
||||
```
|
||||
|
||||
check-docker.sh собирает образ и запускает student-tests/docker_lifecycle.py. Проверка использует случайный порт и свой Compose project; в конце удаляет только его контейнеры и тестовые volumes. Пользовательский стенд не перезапускается. Вывод автоматически сохраняется в evidence/docker-checks.txt; вывод сборки остаётся в терминале.
|
||||
|
||||
| Критерий | Наблюдение | Доказательство |
|
||||
| --- | --- | --- |
|
||||
| API lab2 и объявленный переход от lab1 | Публичный smoke прошёл; Basic/Bearer, Unicode, доступ и ошибки проверены | evidence/docker-checks.txt |
|
||||
| Собственные отрицательные тесты и пагинация | 23 теста прошли, включая неверный JSON, поля, страницы и чужой cursor | evidence/docker-checks.txt |
|
||||
| Конкурентная запись | 10 клиентов × 10 сообщений; ровно 100 уникальных подтверждённых записей | evidence/docker-checks.txt |
|
||||
| Гонка регистрации | Одинаковый username: одна 201, девять 409 | test_concurrency.py, evidence/docker-checks.txt |
|
||||
| Откат составной операции | После FK violation нет строки chats с проверяемым title | evidence/docker-checks.txt |
|
||||
| Миграции с нуля и повторно | Пустой volume; повторный запуск дважды, одна версия и прежнее число сообщений | evidence/docker-checks.txt |
|
||||
| Полный рестарт с прежней сессией | Публичный persistence прошёл; StartedAt изменился у всех трёх сервисов | evidence/docker-checks.txt |
|
||||
| Срок сессии, logout, неверный пароль | 2-секундная сессия истекла; отзыв одной сессии не затронул другую; Basic с неверным паролем — 401 | test_sessions.py, evidence/docker-checks.txt |
|
||||
| Недоступность Valkey и PostgreSQL | Доверенный запрос — 503, анонимный — 401, live 200 / ready 503; после восстановления прежний токен работает | evidence/docker-checks.txt |
|
||||
| Индекс истории на ≥10000 сообщений | EXPLAIN на 100000: Index Scan по составному индексу, без полного сканирования каждой страницы | evidence/query-plans.json |
|
||||
| Условия Docker из lab1 | non-root, PID 1, healthcheck, логи без паролей/токенов/сообщений; завершение по SIGTERM <10 с | evidence/docker-checks.txt |
|
||||
|
||||
SIGTERM проверяется с незавершённым HTTP-запросом. Новые соединения должны перестать приниматься до выхода процесса. Uvicorn ждёт текущие запросы до 5 с; весь тест требует <10 с. Конкретные времена сохранены в evidence и зависят от машины.
|
||||
|
||||
## Трек 5: план запроса и восстановление
|
||||
|
||||
**Гипотеза.** Индекс только по chat_id не обеспечивает порядок истории: PostgreSQL приходится отбирать и сортировать множество записей. Индекс (chat_id, created_at, id) позволяет сразу перейти к anchor и прочитать небольшую страницу; ожидаем выигрыш чтения ценой большего индекса и дополнительных затрат записи.
|
||||
|
||||
Повторить весь эксперимент:
|
||||
|
||||
```sh
|
||||
./scripts/research.sh
|
||||
```
|
||||
|
||||
Никакой соседний репозиторий и подготовленная БД не требуются. Скрипт создаёт отдельный Compose project с двумя PostgreSQL-контейнерами и разными новыми volumes. Основной стенд и его данные не используются. SQL-измерения выполняет research/benchmark.py внутри API-образа; управление контейнерами, backup и restore — research/run.py. Прямой запуск benchmark требует специальной отметки из драйвера и пустой БД.
|
||||
|
||||
Методика:
|
||||
|
||||
1. Создать схему из миграции, 10 синтетических пользователей, 4 чата и 100000 сообщений с распределением **70000 / 20000 / 9000 / 1000**. Данные и UUID детерминированы; хеш пароля синтетических аккаунтов создаётся Argon2id, пароль не выводится.
|
||||
2. Сравнить индекс A `(chat_id)` и индекс B `(chat_id, created_at, id)`. PK сообщений и остальные ограничения одинаковы. В каждом из трёх повторов таблица сообщений очищается только в исследовательской БД, затем индекс создаётся до записи. Порядок A/B чередуется.
|
||||
3. Измерить один INSERT SELECT на 100000 строк с COMMIT, объём WAL и размер исследуемого индекса. Генерация UUID, текстов и проверки FK входят в стоимость записи обоих вариантов.
|
||||
4. После VACUUM ANALYZE для каждого чата прочитать страницы около 10%, 50% и 90% истории. На каждый случай — один прогрев и пять измерений; страница 51 строка, как API для limit=50 с проверкой продолжения. Всего 180 измерений на вариант. SQL параметризован, OFFSET в исследуемом запросе нет.
|
||||
5. Сохранить EXPLAIN (ANALYZE, BUFFERS, FORMAT JSON) для 24 случаев первого повтора и времена остальных повторов.
|
||||
6. Сделать pg_dump в custom format. После завершения dump записать ещё одно сообщение в источник. Восстановить backup через pg_restore --exit-on-error --single-transaction в другой контейнер с новым volume.
|
||||
7. Сравнить счётчики всех таблиц, 12 выбранных сообщений и SHA-256 всех полей всех 100000 сообщений в порядке UUID. Подтвердить отсутствие записи, сделанной после backup.
|
||||
|
||||
### Результаты реального прогона
|
||||
|
||||
Проверено 22.10.2026: macOS arm64, Docker Engine 29.0.1, Linux/aarch64, PostgreSQL 17.6. Docker VM: 10 CPU, 8217448448 байт RAM. Для каждой БД установлен одинаковый лимит 1 CPU / 512 MiB, для Python-клиента — 1 CPU / 256 MiB. Нагрузка — последовательные SQL-запросы с concurrency=1 и прогретыми страницами. Ошибок измеряемых запросов — 0.
|
||||
|
||||
| Метрика | Только chat_id | chat_id, created_at, id |
|
||||
| --- | ---: | ---: |
|
||||
| p50 чтения, мс | 1.685 | 0.226 |
|
||||
| p95 чтения, мс | 7.566 | 0.297 |
|
||||
| p99 чтения, мс | 46.402 | 0.338 |
|
||||
| Медиана записи 100000, мс | 1386.76 | 1404.49 |
|
||||
| Размер индекса, байт | 671744 | 7315456 |
|
||||
| Медиана WAL записи, байт | 38822560 | 43108512 |
|
||||
| Успешных последовательных SQL/с | 282.0 | 4322.8 |
|
||||
|
||||
Медиана чтения уменьшилась примерно в 7.45 раза. Время массовой записи отличается на 1.28% в этом прогоне; трёх повторов недостаточно для универсального вывода о стоимости записи. Составной индекс заметно больше, и WAL записи также увеличился.
|
||||
|
||||
Для чата на 70000 сообщений около середины истории план A использовал Parallel Seq Scan и сортировку, 2443 shared hit blocks; план B — Index Scan messages_history_idx, 6 shared hit blocks. Время EXPLAIN было 7.042 мс против 0.019 мс. Это отдельный пример плана, а не медиана всех измерений.
|
||||
|
||||
В research.json сохранён снимок docker stats после SQL-измерений: PostgreSQL занимал около 63.24 MiB из 512 MiB. Это посленагрузочный снимок, не измерение пикового потребления. p50/p95/p99 объединяют страницы разных размеров чатов и позиций; подробные значения сохранены отдельно. successful_sql_rps вычислен по сумме времени успешных последовательных SQL-запросов, без прогревов и EXPLAIN: это не HTTP throughput и не предел производительности системы.
|
||||
|
||||
### Backup и восстановление
|
||||
|
||||
Custom dump размером 3067615 байт создан за 0.54 с. pg_restore завершился за 0.68 с; запуск проверки восстановленных данных и сверка заняли ещё 2.34 с. Весь сценарий, включая создание исследовательских контейнеров и SQL-измерения, до cleanup занял 22.90 с.
|
||||
|
||||
Источник и приёмник имели разные container ID и разные volume, что записано в research.json. Восстановлены 10 пользователей, 4 чата, 8 участников, 100000 сообщений и одна миграция. Совпали все счётчики, все поля 12 образцов и SHA-256 всей истории. В источнике после backup было 100001 сообщение; дополнительная запись отсутствует в восстановленной БД, как и ожидается для снимка.
|
||||
|
||||
Граница потери данных: pg_dump сохраняет согласованный снимок на момент начала backup. Записи после этого снимка без WAL-архива/репликации не восстанавливаются. Показанная потеря одной последующей записи — явный пример этой границы. COMMIT и стандартные fsync/synchronous_commit PostgreSQL обеспечивают локальную фиксацию в пределах гарантий диска и Docker VM; один host не даёт защиты от потери самого host.
|
||||
|
||||
Измеренное время pg_restore относится к уже работающему пустому PostgreSQL. Полный RTO включает также создание среды, проверки и переключение API. Переключение рабочего API на восстановленную БД в эксперименте не выполнялось. Сессии находятся в отдельном Valkey AOF-volume и не входят в SQL dump; для полного аварийного восстановления сервиса их резервирование требуется отдельно. Проверка обычного рестарта Valkey с сохранённым volume выполнена в основном прогоне.
|
||||
|
||||
### Файлы доказательств и повторяемость
|
||||
|
||||
- evidence/docker-checks.txt — автоматически перезаписывается check-docker.sh; публичные и собственные тесты, рестарты, отказы, TTL и SIGTERM.
|
||||
- evidence/research.txt — краткий реальный stdout исследования, автоматически перезаписывается research.sh.
|
||||
- evidence/research.json — все повторы, латентности, стоимость записи, счётчики, SHA-256, ID контейнеров/volumes и времена backup/restore.
|
||||
- evidence/query-plans.json — реальные JSON-планы PostgreSQL.
|
||||
- backups/*.dump — локальные dump-файлы, исключённые из Git; содержат только синтетическую исследовательскую БД. Контейнеры и volumes временного research project удаляются в finally. Рабочие volumes обычного стенда сохраняются.
|
||||
|
||||
При повторе числа могут измениться. PostgreSQL работает в Docker VM, исследуются прогретые данные на одной машине. Холодный старт диска, сетевые задержки между машинами, высокая конкуренция и другие распределения данных не измерялись. Гипотеза подтверждена для проверенных страниц и распределения, универсального ускорения для любых запросов не заявляется.
|
||||
|
||||
## CI и дальнейшее развитие
|
||||
|
||||
Исходный workflow contracts.yml проверяет контракт. application.yml собирает приложение, выполняет check-docker.sh и research.sh, затем сохраняет evidence как артефакт. Локальные команды выполнены; успешный удалённый запуск CI не заявлен без отдельного результата GitHub Actions.
|
||||
|
||||
Код остаётся разделён по назначению: app.py — HTTP, models.py — поля, storage.py — SQL, db.py — пул, auth.py — сессии, passwords.py — Argon2id, pagination.py — курсор, migrate.py — миграции. Исследование находится отдельно в research/. HTTP-контракт и публичные проверки не ослаблялись.
|
||||
|
||||
Ограничения: одна API-реплика, один PostgreSQL и один Valkey без HA; нет лимита количества сообщений; сессии теряются при намеренном удалении их volume; сроки жизни зависят от системных часов. Для следующих лабораторных можно сохранить SQL-хранилище, сессии и API, добавляя требуемые контрактом возможности.
|
||||
|
||||
## Источники
|
||||
|
||||
- [Пул и транзакции Psycopg](https://www.psycopg.org/psycopg3/docs/advanced/pool.html).
|
||||
- [Составные индексы PostgreSQL](https://www.postgresql.org/docs/17/indexes-multicolumn.html).
|
||||
- [Согласованный SQL dump и восстановление PostgreSQL](https://www.postgresql.org/docs/17/backup-dump.html).
|
||||
- [Valkey persistence](https://valkey.io/topics/persistence/) и [TTL](https://valkey.io/commands/expire/).
|
||||
- [Argon2-cffi](https://argon2-cffi.readthedocs.io/en/stable/howto.html) и [параметры password KDF OWASP](https://cheatsheetseries.owasp.org/cheatsheets/Password_Storage_Cheat_Sheet.html).
|
||||
+181
@@ -0,0 +1,181 @@
|
||||
# Отчёт — лабораторная 3
|
||||
|
||||
- Автор, группа: Савельев Иван, БВТ2304.
|
||||
- Целевая оценка: **4**, весь уровень 3 и все пункты уровня 4. Треки оценки 5 не заявлены.
|
||||
- Решение: Docker Compose + HAProxy, две реплики FastAPI, общий PostgreSQL и Valkey.
|
||||
- Commit/PR: после публикации. Локальные проверки относятся к рабочим изменениям поверх `source_commit` из `evidence/lab3-checks.json`.
|
||||
|
||||
|
||||
## Запуск из чистого clone
|
||||
|
||||
Нужны Docker Engine с Compose v2, Python 3.11, Bash и make. Для демонстрации `demo.sh` также нужны curl и jq. Проверено на Docker Engine 29.0.1, Compose 2.40.3, macOS arm64. Команды выполнять из корня репозитория:
|
||||
|
||||
```sh
|
||||
python3 -m venv .venv
|
||||
.venv/bin/python -m pip install -r requirements.txt -r requirements-dev.txt
|
||||
./scripts/start.sh
|
||||
./scripts/check.sh
|
||||
./scripts/demo.sh
|
||||
```
|
||||
|
||||
`start.sh` создаёт локальные `.env` и `secrets/`, собирает образ, поднимает PostgreSQL и Valkey, выполняет отдельный сервис `migrate`, запускает две API-реплики и HAProxy. API ожидают успешного завершения миграций. Скрипт возвращает управление после проверки обеих реплик через LB. Основной адрес — `http://localhost:8080`.
|
||||
|
||||
Пароль PostgreSQL генерируется случайно в `secrets/postgres_password`; DSN и URL Valkey находятся в `secrets/database_url` и `secrets/cache_url`. Существующие значения не перезаписываются. Каталог имеет права 0700, файлы — 0444 для чтения пользователем контейнера 10001. `.env`, `secrets/`, `.venv` исключены из Git и Docker build context. `.env.example` содержит настройки и пути, без значений секретов.
|
||||
|
||||
| Переменная | Использование |
|
||||
| --- | --- |
|
||||
| APP_HOST, APP_PORT | Адрес API внутри контейнера: 0.0.0.0:8080 |
|
||||
| HOST_PORT | Порт единственного публичного входа HAProxy на 127.0.0.1, по умолчанию 8080 |
|
||||
| API_REPLICAS | Количество реплик сервиса api, по умолчанию 2; конфигурация LB содержит 10 мест |
|
||||
| SESSION_STORE | valkey, общее хранилище серверных сессий |
|
||||
| SESSION_TTL_SECONDS | TTL новой сессии, по умолчанию 3600; рестарт TTL не продлевает |
|
||||
| DATABASE_URL_FILE, CACHE_URL_FILE | Пути к Docker secrets |
|
||||
| IDEMPOTENCY_TTL_SECONDS | Срок результата повтора, по умолчанию 86400, меньше 24 часов запрещено |
|
||||
| APP_ENV | Учебная метка окружения; поведение приложения не переключает |
|
||||
|
||||
Если порт занят, например стендом lab2:
|
||||
|
||||
```sh
|
||||
HOST_PORT=8081 ./scripts/start.sh
|
||||
BASE_URL=http://localhost:8081 ./scripts/check.sh
|
||||
```
|
||||
|
||||
Для дальнейших команд с нестандартным портом сохранить `HOST_PORT=8081` в `.env` или передавать его в окружении. Для HTTP-проверок передавать соответствующий `BASE_URL`.
|
||||
|
||||
```sh
|
||||
docker compose ps -a
|
||||
docker compose logs --tail 30 api lb
|
||||
./scripts/restart.sh # API, PostgreSQL, Valkey и LB; volumes сохраняются
|
||||
./scripts/stop.sh # удаление контейнеров и сети с сохранением volumes
|
||||
|
||||
# Только для намеренного удаления учебных данных текущего Compose project:
|
||||
docker compose down --volumes
|
||||
```
|
||||
|
||||
Compose project `mtusi-lab3` отделён от lab2. Тестовый сценарий использует своё случайное имя и порт; в конце удаляет только свои тестовые контейнеры и volumes.
|
||||
|
||||
## Архитектура и перенос из lab2
|
||||
|
||||
```text
|
||||
Клиент → HAProxy :8080 → api × 2 → PostgreSQL (данные и результаты повторов)
|
||||
↘ Valkey (общие Bearer-сессии)
|
||||
Отдельный migrate → PostgreSQL; завершается до первого запуска API
|
||||
```
|
||||
|
||||
Сохранены пользователи, Argon2id, Basic-вход, Bearer-сессии с TTL и отзывом, чаты, проверки доступа, сообщения, единые ошибки, X-Request-Id и keyset-пагинация. PostgreSQL остаётся источником истины для данных. Valkey хранит SHA-256 токена → пользователя и время окончания, с AOF `appendfsync always`, `noeviction` и постоянным volume. Подтверждённые данные и действующие сессии переживают обычный рестарт. Локального состояния, от которого зависит корректность, в API нет.
|
||||
|
||||
Добавлены `X-Instance-Id`, общая идемпотентность, LB и управление репликами. `X-Instance-Id` равен hostname контейнера и стабилен в течение жизни процесса. В доказательствах он сопоставлен с настоящим container ID; заголовок не подменяется балансировщиком. Любой ответ, сформированный API, включая health и ошибки, содержит оба служебных заголовка.
|
||||
|
||||
HAProxy использует round robin без sticky session. `server-template` получает адреса масштабируемого сервиса `api` из Docker DNS `127.0.0.11`; записи переопрашиваются, устаревшие адреса удаляются. `hold valid/obsolete=1s`, повтор разрешения — 1s. Новые IP после пересоздания обнаруживаются без рестарта LB. `wait-ready.sh` проверяет Docker health всех работающих API и наблюдает каждую через LB.
|
||||
|
||||
API не публикуют порты на хост, работают от UID/GID 10001, без volumes данных и без `container_name`. Только LB публикует порт. Секрет PostgreSQL доступен БД; DSN — API и мигратору; URL Valkey — только API. LB не получает секреты. PostgreSQL и Valkey используют отдельные именованные volumes.
|
||||
|
||||
| Контейнер | CPU | RAM |
|
||||
| --- | ---: | ---: |
|
||||
| Каждый API | 1 | 256 MiB |
|
||||
| HAProxy | 0.5 | 64 MiB |
|
||||
| PostgreSQL | 1 | 512 MiB |
|
||||
| Valkey | 0.5 | 128 MiB |
|
||||
| Одноразовый migrate | 1 | 256 MiB |
|
||||
|
||||
## Готовность, таймауты и SIGTERM
|
||||
|
||||
`/health/live` проверяет жизнь процесса. `/health/ready` проверяет PostgreSQL и Valkey: обе зависимости критичны для обязательного синхронного пути. При отказе любой зависимости live остаётся 200, ready становится 503. При старте API также проверяет наличие и checksum всех миграций, не выполняя DDL.
|
||||
|
||||
HAProxy проверяет `/health/ready` каждую 1 секунду. Два последовательных неуспеха исключают backend (`fall 2`), два успеха возвращают (`rise 2`). Таймаут подключения — 1s, ответа healthcheck — 1s. Консервативная верхняя оценка обнаружения отказа по этим настройкам — **6 секунд**: ожидание ближайшей проверки, два подключения/ответа и интервал между ними; задержки планирования ОС в оценку не входят. Отказ с немедленным connection refused обычно обнаруживается быстрее. Это укладывается в требование восстановления за 10 секунд.
|
||||
|
||||
Остальные таймауты HAProxy: server 8s, client 10s, чтение HTTP-заголовков 5s. `retries 1` относится к установлению backend-соединения; повторов уже отправленных HTTP POST по статусам не включено. Клиент повторяет неопределённый POST сообщения с исходным ключом.
|
||||
|
||||
API является PID 1. При SIGTERM Uvicorn прекращает приём новых соединений, даёт текущим запросам до 5 секунд и закрывает пул. Docker даёт 8 секунд до принудительного завершения. Проверка с незавершённым телом POST измеряет отказ новых соединений и выход до 8 секунд; проверяется `Application shutdown complete`, exit code 0 и отсутствие OOM. Переходные ошибки до исключения backend из LB учитываются в нагрузочном сценарии.
|
||||
|
||||
## Общая идемпотентность
|
||||
|
||||
Для POST сообщения требуется ровно один `Idempotency-Key` по шаблону `[A-Za-z0-9._:-]{1,128}`. Отсутствие и неверный формат дают 400. Область ключа — пользователь, POST, путь конкретного чата, ключ. Метод и тип пути фиксированы единственным обработчиком; таблица хранит `(user_id, chat_id, key)` как первичный ключ.
|
||||
|
||||
В одной транзакции PostgreSQL:
|
||||
|
||||
1. Проверяется членство в чате; сессия повторно проверяется middleware при каждом запросе.
|
||||
2. Берётся транзакционная advisory lock для области ключа. Она общая для всех реплик; возможная коллизия хеша лишь сериализует независимые запросы.
|
||||
3. При действующем результате сравнивается значение `text`, а не исходные JSON-байты. Совпадение возвращает прежний 201 и Message; другой текст даёт 409.
|
||||
4. Для нового или истёкшего ключа создаются сообщение и строка результата с TTL, затем выполняется COMMIT. Ответ отправляется после COMMIT.
|
||||
|
||||
Порядок/пробелы JSON и Unicode escaping не меняют результат. В контракте lab3 поле сообщения только `text`; вложения появляются с lab4. Ключи разных пользователей и чатов независимы. 5xx не сохраняется как результат; откат убирает и сообщение, и строку идемпотентности. При обрыве после COMMIT повтор на другой реплике читает прежнее сообщение. Результаты хранятся минимум 24 часа, переживают рестарт и замену API. Истёкшая строка заменяется при следующем использовании того же ключа; сообщения остаются в истории.
|
||||
|
||||
## Миграции и поочерёдная замена
|
||||
|
||||
`migrate` — один отдельный Compose-service, выполняющий SQL под общей advisory lock и сохраняющий SHA-256 версий. API только проверяют схему. Ручная команда — `./scripts/migrate.sh`; повтор безопасен и не создаёт повторных данных.
|
||||
|
||||
Миграция `001_initial.sql` не изменялась. `002_message_idempotency.sql` только добавляет таблицу и не изменяет существующие поля. Она совместима с уже работающей версией приложения. При последующих изменениях разрешены только обратно совместимые добавления перед rolling update; удаление/переименование полей потребует отдельного перехода или окна обслуживания. Автоматическая совместимость произвольных миграций не заявляется.
|
||||
|
||||
```sh
|
||||
./scripts/rolling-update.sh
|
||||
```
|
||||
|
||||
Скрипт сначала собирает образ и запускает миграции, затем для каждого исходного API-контейнера: проверяет наличие другой здоровой реплики, останавливает и удаляет выбранный контейнер, создаёт только недостающую реплику через `up --no-deps --no-recreate --scale`, ждёт её готовности через LB и переходит к следующей. PostgreSQL, Valkey и HAProxy не перезапускаются. Это поочерёдная замена с сохранением хотя бы одной готовой реплики; краткие переходные ошибки измеряются, нулевые ошибки не обещаются.
|
||||
|
||||
## Команды проверки и доказательства
|
||||
|
||||
```sh
|
||||
make check validate PYTHON=.venv/bin/python
|
||||
./scripts/check.sh
|
||||
make test-persistence PYTHON=.venv/bin/python ACTION_SCRIPT=scripts/restart.sh
|
||||
make test-failover PYTHON=.venv/bin/python ACTION_SCRIPT=scripts/stop-one.sh
|
||||
docker compose start api
|
||||
./scripts/wait-ready.sh
|
||||
|
||||
# Полный воспроизводимый прогон в отдельном тестовом стенде:
|
||||
./scripts/check-docker.sh
|
||||
```
|
||||
|
||||
Для ручной остановки конкретной реплики задать `TARGET_INSTANCE_ID` из её `X-Instance-Id` и вызвать `./scripts/stop-one.sh`. Скрипт сопоставляет hostname контейнерам только текущего Compose project, требует минимум две работающие реплики, останавливает ровно выбранную и оставляет её остановленной. `docker compose ps -a` показывает фактическое состояние. Восстановление — `docker compose start api` и `./scripts/wait-ready.sh`. Полный сценарий последовательно повторяет отказ для каждой из двух реплик, восстанавливая предыдущую.
|
||||
|
||||
| Критерий ТЗ | Проверка | Доказательство |
|
||||
| --- | --- | --- |
|
||||
| Воспроизводимый стенд, две реальные API-реплики и единый вход | start.sh, Docker inspect, общий Compose-service api | compose.yaml; containers в lab3-checks.json |
|
||||
| Общая сессия, запросы через разные реплики | 20 параллельных повторов с одним Bearer-токеном | test_parallel_replay_across_replicas; lab3-checks.txt |
|
||||
| Публичный контракт, включая ошибки и идемпотентность | make test, 28 собственных тестов | lab3-checks.txt |
|
||||
| Рестарт всех компонентов, прежняя сессия и сообщения | make test-persistence, StartedAt до/после; повтор ключа после рестарта | persistence в lab3-checks.json |
|
||||
| Публичный отказ одной выбранной реплики, восстановление ≤10s | make test-failover, реально остановленный container ID | public_failover; lab3-checks.txt |
|
||||
| Отказ каждой API-реплики, чтения и записи под нагрузкой | Два отдельных load_action, восстановление предыдущей между ними | failovers в lab3-checks.json |
|
||||
| Параллельная общая идемпотентность, нет дублей | 20 одновременных запросов через ≥2 реплики; сверка истории после отказов | test_idempotency.py; duplicate_messages=0 |
|
||||
| Readiness, таймауты и SIGTERM | Отказ PostgreSQL/Valkey; незавершённый запрос + TERM | dependency_readiness и sigterm |
|
||||
| CPU/RAM-лимиты, отсутствие обхода LB и container_name | Проверки Docker inspect для всех контейнеров | containers; compose.yaml |
|
||||
| Поочерёдная замена под нагрузкой | rolling-update.sh, новые ID обоих API; неизменный StartedAt остальных | rolling_update в lab3-checks.json |
|
||||
| Отдельные согласованные миграции | Одноразовый сервис, повторный запуск дважды без изменения данных | lab3-checks.txt; миграции 001/002 |
|
||||
|
||||
Файлы текущего прогона: [evidence/lab3-checks.txt](evidence/lab3-checks.txt) и [evidence/lab3-checks.json](evidence/lab3-checks.json). Идентификаторы контейнеров, ресурсы, времена, ошибки и посекундные исходные счётчики сохранены без паролей и токенов. `evidence/docker-checks.txt`, `research.*`, `query-plans.json` и `REPORT.lab2.md` относятся ко второй лабораторной.
|
||||
|
||||
## Измерения
|
||||
|
||||
Дата прогона — 29.10.2026. Среда: macOS arm64, Docker VM Linux aarch64, 10 CPU, 8217448448 байт RAM. Лимиты контейнеров приведены выше. Профиль — четыре закрытых клиента: POST сообщения и GET истории с существующими сессиями, пауза 50ms между парами запросов. Для неопределённого POST сохраняются прежние ключ и тело. При отказе нагрузка длится 15 секунд после начала воздействия; при замене — весь action и минимум 3 секунды после. Перед воздействием есть 1 секунда прогрева, которая входит в общие счётчики.
|
||||
|
||||
Численные результаты последнего успешного прогона приведены ниже.
|
||||
|
||||
| Воздействие | Длительность, с | Успешные HTTP/с | Ошибки | Макс. пауза POST / GET, с | Потеря подтверждённых / дубли |
|
||||
| --- | ---: | ---: | ---: | --- | --- |
|
||||
| Остановка 7f6a80b69e32 | 16.009 | 98.44 | 4 | 1.957 / 2.004 | 0 / 0 |
|
||||
| Остановка f973eaec4d52 | 16.015 | 98.28 | 4 | 2.006 / 2.006 | 0 / 0 |
|
||||
| Поочерёдная замена обоих API | 23.774 | 89.64 | 11 | 1.059 / 2.034 | 0 / 0 |
|
||||
|
||||
SIGTERM с незавершённым POST: новые соединения перестали приниматься за 0.167 с, выход за 5.393 с, exit code 0, OOM отсутствует. При остановке Valkey и PostgreSQL по отдельности подтверждены API live=200, API ready=503 и LB ready=503; после восстановления прежний токен продолжил работать.
|
||||
|
||||
RPS считается по всем успешным HTTP-запросам чтения и записи за полную длительность сценария; ошибки считаются отдельно. «Первый успех» показывает продолжение обслуживания после начала action, а максимальный промежуток между успешными запросами дополнительно показывает паузы во всём сценарии. После каждого воздействия проверяются все подтверждённые сообщения, исходное сообщение до отказа, отсутствие повторяющихся ID/текстов и работа прежней сессии.
|
||||
|
||||
Это короткие проверки отказоустойчивости для оценки 4. Нагрузка закрытая, присутствует coordinated omission; p50/p95 относятся только к успешным ответам. Предельная производительность и масштабирование 1/2/4 здесь не исследуются.
|
||||
|
||||
## Ограничения
|
||||
|
||||
Выдерживается отказ одной API-реплики при работающей другой. PostgreSQL, Valkey, HAProxy и сам хост остаются точками отказа; отказ узла и HA хранилищ не заявлены. Остановка БД или Valkey делает обязательный API неготовым. При полном рестарте допустимо окно недоступности, данные и действующие сессии сохраняются в volumes. Удаление volumes намеренно уничтожает данные.
|
||||
|
||||
Нет автоматического TTL-удаления всех давно неиспользуемых ключей идемпотентности: они удаляются при повторном использовании ключа. Срок сессий зависит от часов; keyset-пагинация сохраняет ограничения lab2 при конкурентных записях и переводе часов. Поочерёдная замена останавливается при отсутствии здоровой резервной реплики, автоматический rollback образа не реализован.
|
||||
|
||||
## Источники
|
||||
|
||||
- [Docker Compose services, replicas, secrets и depends_on](https://docs.docker.com/reference/compose-file/services/).
|
||||
- [Compose up: scale и no-recreate](https://docs.docker.com/reference/cli/docker/compose/up/).
|
||||
- [HAProxy: DNS и server-template](https://www.haproxy.com/documentation/haproxy-configuration-tutorials/proxying-essentials/dns-resolution/).
|
||||
- [HAProxy: active health checks, inter/fall/rise](https://www.haproxy.com/documentation/haproxy-configuration-tutorials/reliability/health-checks/).
|
||||
- [PostgreSQL: advisory locks](https://www.postgresql.org/docs/17/explicit-locking.html#ADVISORY-LOCKS).
|
||||
- [Uvicorn: graceful shutdown timeout](https://uvicorn.dev/settings/#timeouts).
|
||||
|
||||
Стек приложения и закреплённые зависимости перенесены из lab2 (`requirements.txt`): Python 3.11.15, FastAPI 0.142.4, Uvicorn 0.54.0, Psycopg 3.3.6, PostgreSQL 17.6, Valkey 8.1.3; добавлен HAProxy 3.2.6-alpine. README задания, OpenAPI и публичные tests не изменялись. CI запускает контрактные и Docker-проверки; успешный удалённый запуск GitHub Actions без отдельного результата не заявлен.
|
||||
@@ -1,37 +1,218 @@
|
||||
# Отчёт — лабораторная 4
|
||||
|
||||
- Автор, группа: TODO
|
||||
- Целевая оценка; выбранный трек 5, если нужен: TODO
|
||||
- Commit/PR: TODO после публикации
|
||||
- Использованные источники, библиотеки и помощь ИИ: TODO
|
||||
- Автор, группа: Савельев Иван, БВТ2304.
|
||||
- Целевая оценка: **4** — все требования уровней 3 и 4. Исследовательские треки оценки 5 не заявлены.
|
||||
- Стенд: Docker Compose, HAProxy, две реплики FastAPI, PostgreSQL, Valkey, SeaweedFS с приватным S3 bucket.
|
||||
- Commit/PR: после публикации. Evidence содержит source_commit и working_tree=true: проверялась рабочая версия поверх этого commit.
|
||||
- Источники и помощь: официальные материалы перечислены в конце; код и проверки подготовлены с помощью Codex, результаты получены запуском Docker-стенда.
|
||||
|
||||
## Запуск из чистого clone
|
||||
|
||||
TODO: версии runtime/образов, prerequisites, команды создания локальных secrets/.env, build, миграций, запуска, ожидания готовности, тестов и остановки. Указать необходимые действия оператора. Не вставлять секреты. Отдельно указать безопасную остановку и команду намеренного удаления учебных данных.
|
||||
Нужны Docker Engine с Compose v2, Python 3.11, Bash и make; для demo.sh — curl и jq. Проверенная среда записана в evidence/lab4-checks.json. Все команды выполняются из корня этого репозитория, внешние установленные БД или S3 не нужны.
|
||||
|
||||
## Архитектура и решения
|
||||
```sh
|
||||
python3 -m venv .venv
|
||||
.venv/bin/python -m pip install -r requirements.txt -r requirements-dev.txt
|
||||
make check validate PYTHON=.venv/bin/python
|
||||
./scripts/start.sh
|
||||
./scripts/check.sh
|
||||
```
|
||||
|
||||
TODO: схема процессов/хранилищ, источник истины, транзакционные границы, ограничения. Что перенесено из lab3, что изменено в этой работе. Соответствие переменных из .env.example реальной конфигурации.
|
||||
Адрес API: http://localhost:8080. start.sh генерирует локальные .env и secrets/, собирает образ, поднимает хранилища, выполняет миграции и bootstrap bucket, запускает API, LB и cleaner. Возврат из скрипта означает готовность обеих API-реплик через LB. Существующие пароли и настройки не перезаписываются. Локальный IAM-конфиг S3 собирается из тех же secret-файлов. Каталог secrets имеет права 0700; файлы 0444 позволяют UID 10001 контейнера читать смонтированные Docker secrets. .env, secrets и .venv игнорируются Git; Docker build context содержит только необходимые исходники.
|
||||
|
||||
## Доказательства критериев
|
||||
Если 8080 занят другим стендом, сохраните HOST_PORT=8081 в .env и используйте BASE_URL=http://localhost:8081 для HTTP-проверок. Либо передайте HOST_PORT=8081 в окружении start.sh. Compose project mtusi-lab4 и его volumes отделены от lab3.
|
||||
|
||||
| Критерий README | Команда/сценарий | Наблюдаемый результат | Файл доказательства |
|
||||
| --- | --- | --- | --- |
|
||||
| Публичный smoke | make test | TODO | TODO |
|
||||
| Остальные пункты уровня 3 | TODO | TODO | TODO |
|
||||
| Все пункты уровня 4, если заявлен | TODO | TODO | TODO |
|
||||
| Выбранный трек 5, если заявлен | TODO | TODO | TODO |
|
||||
```sh
|
||||
docker compose ps -a
|
||||
./scripts/demo.sh
|
||||
./scripts/restart.sh # перезапуск всех постоянных процессов; volumes сохраняются
|
||||
./scripts/stop.sh # удаление контейнеров/сетей; volumes сохраняются
|
||||
./scripts/start.sh # повторный запуск с прежними данными
|
||||
|
||||
TODO: добавить отдельную строку для каждого заявленного критерия. PASS без команды и наблюдения не является доказательством. Проверка инфраструктурного hook требует подтверждения, какие реальные процессы/хранилища перезапущены.
|
||||
# Только для намеренного удаления учебных данных текущего Compose project:
|
||||
docker compose down --volumes
|
||||
```
|
||||
|
||||
## Эксперименты и отказы
|
||||
Закреплены Python 3.11.15-slim-bookworm с digest в Dockerfile, PostgreSQL 17.6-bookworm, Valkey 8.1.3, HAProxy 3.2.6-alpine, SeaweedFS 3.85 с digest sha256:49312939c00c01e5ee6afbd7d728b18027821d3764c35a797a72acd4fdf3296a. Версии Python-библиотек зафиксированы в requirements.txt; добавлены MinIO Python SDK 7.2.20 и Pillow 13.0.0. SDK работает с S3 API SeaweedFS; сервер MinIO не требуется.
|
||||
|
||||
TODO: гипотеза, hardware/лимиты, версии, объём данных, профиль нагрузки, concurrency/arrival rate, длительность/прогрев, повторы, успешные RPS, ошибки, p50/p95/p99, CPU/RAM. Сохранить raw summary без tokens и объяснить ограничения измерения.
|
||||
## Архитектура и перенос из lab3
|
||||
|
||||
| Воздействие | Что ожидаем | Что наблюдали | Время восстановления / потеря данных |
|
||||
| --- | --- | --- | --- |
|
||||
| TODO | TODO | TODO | TODO |
|
||||
```text
|
||||
Клиент → HAProxy :8080 → API × 2 → PostgreSQL (метаданные, сообщения, идемпотентность)
|
||||
→ Valkey (серверные Bearer-сессии)
|
||||
→ S3 gateway :9000 → SeaweedFS storage → s3_data
|
||||
Одноразовые migrate → PostgreSQL; s3-bootstrap → приватный bucket
|
||||
Постоянный cleanup → журнал PostgreSQL + DELETE незавершённых объектов S3
|
||||
```
|
||||
|
||||
Из lab3 сохранены пользователи, Argon2id, Basic-вход и Bearer-сессии, ACL чатов, текстовые сообщения, keyset-пагинация, X-Request-Id/X-Instance-Id, общая идемпотентность, миграции, LB, ограничения ресурсов и скрипты отказа/замены реплик. Предыдущие отчёты — REPORT.lab2.md и REPORT.lab3.md. Архивные evidence/lab3-* относятся к прежней работе.
|
||||
|
||||
Добавлена миграция 003: attachments, message_attachments, attachment_uploads и request_attachment_ids в таблице идемпотентности. Миграции 001/002 не изменены. Старые сообщения читаются с attachment_ids=[]. Новый POST сообщения принимает до 10 уникальных attachment_ids; чужой/неизвестный ID или ID другого чата даёт 404. Весь список проверяется до вставки сообщения в одной транзакции. Пустой/пробельный text допустим только при наличии вложений. Любой участник может использовать вложение своего чата. Порядок списка сохраняется; при повторе ключа сравниваются text и список UUID. Пропущенный список и [] равнозначны.
|
||||
|
||||
Бинарного содержимого в PostgreSQL нет. Случайный object_key вида attachments/<UUID> назначает сервер; filename используется только для отображения и Content-Disposition. В API нет endpoint удаления/изменения вложения. Ready-метаданные и связи сообщений постоянны, локальный файл API для чтения оригинала не нужен. Детали FK, индексов и транзакций — в docs/schema.md.
|
||||
|
||||
| Настройка .env.example | Реальное использование |
|
||||
| --- | --- |
|
||||
| APP_HOST, APP_PORT | 0.0.0.0:8080 внутри API |
|
||||
| HOST_PORT | Публичный порт LB на 127.0.0.1 |
|
||||
| APP_ENV | Учебная метка, не переключает поведение |
|
||||
| SESSION_STORE, SESSION_TTL_SECONDS | Valkey; TTL сессии, по умолчанию 3600 s |
|
||||
| DATABASE_URL_FILE, CACHE_URL_FILE | Пути Docker secrets PostgreSQL и Valkey |
|
||||
| API_REPLICAS | Две реплики по умолчанию; LB рассчитан на 10 |
|
||||
| IDEMPOTENCY_TTL_SECONDS | Не меньше 86400 s; одинаковый ответ при повторе |
|
||||
| S3_ENDPOINT, S3_REGION, S3_BUCKET | http://s3:9000, us-east-1, messenger-attachments |
|
||||
| S3_ACCESS_KEY_ID_FILE, S3_SECRET_ACCESS_KEY_FILE | Только ограниченные credentials приложения |
|
||||
| MAX_UPLOAD_BYTES, MAX_IMAGE_PIXELS | 10485760 bytes, 40000000 pixels; повышение выше контракта запрещено |
|
||||
| UPLOAD_CLEANUP_GRACE_SECONDS | 3600 s, минимум 60 s; защита свежих/незавершённых загрузок |
|
||||
|
||||
## Приватный bucket и bootstrap
|
||||
|
||||
Выбран один S3-совместимый сервер — SeaweedFS. Два сервиса одного продукта разделяют его S3 gateway и внутренние master/volume/filer. s3-storage и его административные HTTP/gRPC-интерфейсы находятся только в закрытой сети s3-internal; API к ней не подключены. Только S3 gateway соединяет эту сеть с сетью приложения. Наружу опубликован лишь LB: ни 9000, ни UI, ни внутренние API-порты не опубликованы.
|
||||
|
||||
init_local.py создаёт отдельные случайные root и application credentials. S3 загружает статическую IAM-конфигурацию из secret s3_config, без anonymous identity. Администратор используется только одноразовым s3-bootstrap; тот проверяет наличие bucket и создаёт его при отсутствии. Повторный bootstrap сохраняет bucket и объекты. Root secrets/IAM-файл не монтируются в API или cleaner.
|
||||
|
||||
Приложению разрешены Read и List только своего bucket и Write только prefix attachments/*. В терминах SeaweedFS Write включает PUT/DELETE объектов; административных действий и записи вне prefix нет. Тест напрямую, вне API приложения, проверяет anonymous GET=403, запрет создания другого bucket и записи вне prefix, недоступность административных портов и изоляцию storage-сети. Приватность S3 дополняется ACL приложения: запрос без Bearer даёт 401, посторонний участнику чата пользователь — 404 как для metadata, так и для content.
|
||||
|
||||
## Приём, проверка и скачивание
|
||||
|
||||
POST /api/v1/chats/{id}/attachments?filename=... принимает сырые bytes PNG/JPEG. Сначала выполняются аутентификация и проверка чата, затем валидация имени и MIME. Запрещены slash, backslash, NUL, управляющие символы, пустое/пробельное имя и длина более 255 code points.
|
||||
|
||||
Content-Length свыше лимита отклоняется до чтения тела. Независимо от заголовка, включая chunked upload, счётчик проверяется при каждом полученном фрагменте до записи в TemporaryFile: больше 10 MiB — 413. Тело не собирается через request.body(). Временный файл закрывается и удаляется при успехе, ошибке, прерывании клиента и завершении процесса; он не является постоянным хранилищем оригинала.
|
||||
|
||||
Pillow открывает только PNG/JPEG, проверяет реальный формат и число пикселей до load(), затем verify() и полное декодирование обнаруживают повреждения. Подмена MIME/чужой формат/повреждённое изображение — 415; превышение pixels — 413. DecompressionBombWarning считается ошибкой. Оригинал не перекодируется, SHA-256 считается по исходному потоку.
|
||||
|
||||
На одну API-реплику приходится одна активная загрузка/декодирование; остальные запросы ждут слот до 20 s с обратным давлением ASGI, далее получают 503. Приём тела ограничен 30 s. S3 имеет connect timeout 1 s, read timeout 3 s и отключённые автоматические повторы. Один оригинал ≤10 MiB отправляется одним PUT, без multipart и его незавершённых частей. SDK может держать до 10 MiB для PUT; декодирование ограничено 40 млн pixels и одним изображением. Каждый API имеет лимит 384 MiB и 1 CPU; количество загрузок не умножает число полных декодирований на реплике.
|
||||
|
||||
201 ready отправляется только после сохранения S3 и COMMIT metadata. variants=[], error_code=null. GET metadata/content снова проверяет членство в чате. Content идёт через API без redirect, порциями 64 KiB с истинным Content-Type, Content-Length, безопасным Content-Disposition и nosniff. Файл не читается целиком в RAM при скачивании; S3-соединение закрывается в finally. SHA-256 и size_bytes описывают исходные bytes.
|
||||
|
||||
/health/ready проверяет PostgreSQL, Valkey и существование S3 bucket подписанным HEAD. /health/live проверяет процесс. При отказе S3 обязательные upload/download получают 503; LB исключает неготовые API. После отправки части download последующий сетевой обрыв означает неполный HTTP download: статус уже не заменяется, клиент может повторить безопасный GET.
|
||||
|
||||
### Пауза PostgreSQL и клиентский таймаут
|
||||
|
||||
Помимо connect_timeout=2 s, ожидания пула 2 s и серверного statement_timeout=3 s, каждое ожидание PostgreSQL I/O ограничено на стороне приложения двумя секундами. TimedConnection использует timeout метода wait() закреплённой версии Psycopg 3.3.6. Это распространяется на проверку соединения из пула, выполнение SQL, COMMIT и ROLLBACK, даже когда процесс PostgreSQL приостановлен и серверный таймер не работает.
|
||||
|
||||
При OperationalError соединение закрывается до выхода из контекста транзакции. API возвращает 503 unavailable в обычном формате, не ожидая отмены запроса или ROLLBACK от приостановленного сервера. Зависших потоков и выданных навсегда соединений не остаётся; пул создаёт замену. После docker compose unpause postgres readiness и запросы с прежними сессиями восстанавливаются без перезапуска API.
|
||||
|
||||
Регрессионная проверка получает соединение до pause и отключает серверный statement_timeout, чтобы отдельно проверить клиентское ограничение SQL. Затем держит настоящую PostgreSQL на pause не менее 12 s, проверяет прямой /health/ready, 10 параллельных повторов и /health/live внутри API-контейнера, минуя LB. После unpause сверяются неизменные ID/StartedAt API, действующая сессия и сохранённое сообщение. Сценарий включён в check-docker.sh; отдельно запускается в своём временном стенде:
|
||||
|
||||
```sh
|
||||
./scripts/build.sh
|
||||
.venv/bin/python student-tests/postgres_pause.py
|
||||
```
|
||||
|
||||
Результат отдельного запуска: [evidence/postgres-pause.json](evidence/postgres-pause.json). Полный прогон сохраняет этот сценарий в поле postgres_pause файла lab4-checks.json.
|
||||
|
||||
Фактическая проверка 06.11.2026: SQL без серверного таймера прерван за 2.001 s, соединение закрыто; прямой readiness вернул 503 за 2.012 s. Все 10 параллельных readiness-запросов вернули 503, максимум 2.299 s. PostgreSQL оставалась на pause 12.565 s; live отвечал 200. После unpause действующая сессия и сообщение доступны через LB за 2.874 s, без restart API.
|
||||
|
||||
## Согласованность S3 и PostgreSQL на уровне 4
|
||||
|
||||
1. После приёма и проверки файла отдельный COMMIT сохраняет attachment_uploads с ID и object_key.
|
||||
2. Следующая транзакция берёт advisory lock object_key, выполняет S3 PUT, вставляет attachments и удаляет журнал. Только после COMMIT отправляется 201.
|
||||
3. При обрыве клиентского тела до проверки S3/журнал ещё не затрагиваются. При ошибке PUT или отказе БД после PUT сохраняется долговечное намерение. Если исход COMMIT неизвестен, немедленного DELETE нет: ready-метаданные могли сохраниться.
|
||||
4. Cleaner каждые 30 s выбирает до 100 записей старше grace period, пробует ту же advisory lock и повторно проверяет возраст и наличие ready-метаданных. Активный lock означает пропуск. Если ready существует, очищается только журнал. Иначе выполняются идемпотентный S3 DELETE и удаление журнала.
|
||||
5. Ошибка S3/БД откладывает проход. Если DELETE уже прошёл, а COMMIT удаления журнала нет, повторный DELETE безопасен. При восстановлении зависимостей worker продолжает работу.
|
||||
|
||||
По умолчанию grace=1 час существенно больше таймаутов загрузки; минимальное значение — 60 s. Транзакция записи имеет idle timeout 30 s. Свежие и активные загрузки защищены возрастом и блокировкой, ready-объекты не удаляются даже без привязки к сообщению. После восстановления сервисов журнал не остаётся без обработчика.
|
||||
|
||||
```sh
|
||||
# Ручной дополнительный проход; постоянный cleanup-service уже работает:
|
||||
docker compose run --rm --no-deps cleanup python -m src.cleanup --once
|
||||
```
|
||||
|
||||
Это ограниченная компенсация операций приложения. Полный reconciler, presigned upload, варианты изображений и фоновая обработка из следующих лабораторных не добавлялись.
|
||||
|
||||
## Команды проверки и доказательства критериев
|
||||
|
||||
```sh
|
||||
make check validate PYTHON=.venv/bin/python
|
||||
./scripts/check.sh
|
||||
make test-persistence PYTHON=.venv/bin/python ACTION_SCRIPT=scripts/restart.sh
|
||||
make test-failover PYTHON=.venv/bin/python ACTION_SCRIPT=scripts/stop-one.sh
|
||||
docker compose start api
|
||||
./scripts/wait-ready.sh
|
||||
|
||||
# Полный повторяемый прогон уровня 4 в отдельном временном Compose project:
|
||||
./scripts/check-docker.sh
|
||||
```
|
||||
|
||||
check-docker.sh выбирает отдельное имя lab4-check-<random> и свободный порт, создаёт только синтетические данные. В finally удаляет только свои контейнеры и volumes; обычный mtusi-lab4 остаётся доступным. Моделирование отказа БД использует временный trigger в тестовой БД; trigger удаляется в finally. Рабочий API не содержит fault-injection endpoint или специального заголовка.
|
||||
|
||||
| Критерий README | Команда/сценарий | Наблюдение и evidence |
|
||||
| --- | --- | --- |
|
||||
| Сохранены возможности lab3, две реплики, общая сессия/идемпотентность | check.sh, повтор ключа через реплики, повтор после рестарта, SIGTERM, rolling update под нагрузкой | api_tests, persistence, sigterm, failovers, rolling_update |
|
||||
| S3 в общем стенде; metadata в PostgreSQL, bytes в приватном bucket | Docker inspect, прямой S3 GET, проверки прав | containers, attachments.private_bucket |
|
||||
| 201 ready, Message с attachment_ids, SHA-256 и побайтный download | Публичный smoke и test_attachments | lab4-checks.txt; api_tests |
|
||||
| Реальные PNG/JPEG, MIME, 10 MiB и 40 MP, опасные filename | test_png_and_jpeg_originals, corruption_and_mime_spoof, pixel_limit_before_decode, filename_rejected_before_storage | 39 собственных тестов; lab4-checks.txt |
|
||||
| Upload → остановка загрузившей реплики → download другой | Сопоставление X-Instance-Id и Docker ID, реальная stop-one | attachments.upload_replica_failover |
|
||||
| Restart сохраняет metadata/bytes/действующую сессию | Публичный persistence, StartedAt всех процессов до/после | persistence |
|
||||
| Слишком большой файл, повреждение, подмена MIME, чужой ID/другой чат не дают 500 | Отдельные негативные HTTP-тесты, включая chunked без Content-Length | test_attachments; lab4-checks.txt |
|
||||
| Прерывание загрузки и сбой между S3/БД не оставляют вечные неучтённые объекты | Обрыв сокета; trigger отказывает после PUT; затем ручной и автоматический cleaner | attachments.interrupted_body, compensation |
|
||||
| Безопасный grace period, защита активных/готовых объектов, повторная очистка | Свежий журнал, backdate, удержание advisory lock, ready-ссылка, повтор DELETE | compensation.fresh_kept/active_locked_kept/ready_kept/repeat_safe/automatic_worker |
|
||||
| Ограничены RAM/таймауты; ≥10 одновременных загрузок с замером памяти | Barrier на 10 клиентах, настоящие PNG 1600×1200, cgroup каждые 20 ms, SHA-256 всех downloads | attachments.parallel_uploads |
|
||||
| Идемпотентный bootstrap и ограниченные S3 credentials; закрытая администрация | Два bootstrap, запрещённые S3 операции, TCP-пробы из API | attachments.private_bucket |
|
||||
| Недоступность S3 и восстановление | Остановка настоящего s3-service, запросы внутри API в обход исключившего backend LB | attachments.s3_outage; dependency_readiness |
|
||||
| PostgreSQL на pause: ограниченный прямой readiness и восстановление без restart API | postgres_pause.py: SQL без серверного таймера, pause ≥12 s, 10 параллельных запросов, unpause | postgres_pause; evidence/postgres-pause.json |
|
||||
|
||||
Все актуальные результаты — [evidence/lab4-checks.txt](evidence/lab4-checks.txt) и [evidence/lab4-checks.json](evidence/lab4-checks.json). Токены, пароли и исходные тела запросов туда не сохраняются. PASS публичного smoke сам по себе не считается доказательством всех критериев.
|
||||
|
||||
## Эксперимент памяти и отказы
|
||||
|
||||
Гипотеза: десять одновременных загрузок не вызывают десять полных декодирований на API; слот и лимиты удерживают RAM ниже контейнерного лимита, оригиналы сохраняются без изменений. Методика: один случайный несжимаемый RGB PNG 1600×1200 (~5.5 MiB), десять потоков с общим barrier, две API-реплики; после каждого 201 второй участник скачивает оригинал, проверяется SHA-256. Монитор в каждой API читает cgroup v2 memory.current каждые 20 ms. Сохраняются исходные временные ряды, memory.peak за всю жизнь контейнера и лимит, duration, successful RPS, p50/p95, число ошибок и OOMKilled. Файл генерируется заново при каждом запуске; его точный размер/checksum записаны в JSON.
|
||||
|
||||
Замер включает Python-процесс монитора и файловый cache cgroup; это консервативная оценка контейнерной памяти, а не чистый RSS приложения. Пик выборки может пропустить события короче 20 ms; memory.peak дополнительно показывает пик за жизнь контейнера. Это один ограниченный учебный прогон с 10 клиентами, без поиска предельной производительности. p50/p95 относятся к успешным HTTP upload; coordinated omission и влияние клиента остаются ограничениями.
|
||||
|
||||
### Результат фактического прогона 06.11.2026
|
||||
|
||||
Среда: Darwin arm64; Docker 29.0.1 aarch64 CPUs=10 RAM=8217448448; Compose 2.40.3-desktop.1. Две API-реплики, по 1 CPU и 384 MiB. Прогрев — полный smoke и 39 тестов до эксперимента; накопившаяся память отражена в baseline. Временный project: lab4-check-5aad8e0065.
|
||||
|
||||
| Показатель | Наблюдение |
|
||||
| --- | --- |
|
||||
| Параллельные uploads | 10 из 10, ошибок 0 |
|
||||
| Один PNG | 5769335 bytes, 1600×1200 RGB |
|
||||
| Длительность / успешные upload/s | 0.914 s / 10.939 |
|
||||
| p50 / p95 HTTP upload | 610.113 / 904.09 ms |
|
||||
| Оригиналы | 10 download, все SHA-256 совпали |
|
||||
| OOM | Нет |
|
||||
|
||||
| API instance | Baseline cgroup, MiB | Пик выборки во время uploads, MiB | Пик cgroup за жизнь контейнера, MiB | Лимит, MiB |
|
||||
| --- | ---: | ---: | ---: | ---: |
|
||||
| 19a474c69210 | 190.10 | 205.22 | 261.53 | 384 |
|
||||
| ca1f62dfc015 | 64.43 | 98.59 | 100.28 | 384 |
|
||||
|
||||
Различие baseline между репликами возникло после предыдущих проверок и аллокаций; сравнение не трактуется как чистое измерение стоимости одного декодирования. Пик за жизнь контейнера включает более ранние тесты. Гипотеза о соблюдении лимита в этом профиле подтверждена; универсальная производительность или поведение при произвольном числе клиентов не выводятся.
|
||||
|
||||
| Воздействие | Наблюдение | Восстановление / потеря подтверждённых данных |
|
||||
| --- | --- | --- |
|
||||
| Остановлена загрузившая API-реплика ca1f62dfc015 | Download обслужила 19a474c69210; исходный SHA-256 совпал | 3.535 s от начала stop; потерь нет |
|
||||
| Прервано HTTP-тело | Metadata и журнал не созданы; S3 PUT не начинался | Очистка временного файла; ready-объектов не затрагивает |
|
||||
| БД отказала после S3 PUT | HTTP 503; объект существует вместе с журналом; ready-metadata отсутствует | Свежий/активный объект сохранён; после искусственного старения безопасно удалён; worker проверен отдельно |
|
||||
| S3 service остановлен | live=200, ready/upload/download=503 в едином формате API | После старта прежний токен и оригинал работают; downtime отдельно не измерялся |
|
||||
| PostgreSQL на pause 14.572 s | Прямой ready=503 за 2.013 s; 10 повторов, максимум 2.107 s; live=200 | После unpause 1.975 s; API не перезапущены, сессия и сообщение сохранены |
|
||||
| Restart всего стенда с volumes | StartedAt всех постоянных процессов изменились; сессия, metadata, bytes и повтор сообщения сохранены | Уложилось в бюджет ожидания 90 s; потерь нет |
|
||||
| SIGTERM с незавершённым POST | Новые соединения прекращены за 0.185 s; exit code 0, без OOM | Выход за 5.523 s, меньше 8 s |
|
||||
|
||||
Дополнительно сохранены результаты отказа каждой реплики и поочерёдной замены под нагрузкой:
|
||||
|
||||
| Сценарий | Длительность, s | Успешные HTTP/s | Переходные ошибки | Макс. пауза POST / GET, s | Потери / дубли |
|
||||
| --- | ---: | ---: | ---: | --- | --- |
|
||||
| stop 19a474c69210 | 16.012 | 88.68 | 4 | 2.002 / 1.995 | 0 / 0 |
|
||||
| stop ca1f62dfc015 | 16.008 | 91.58 | 4 | 2.002 / 1.999 | 0 / 0 |
|
||||
| sequential API replacement | 24.869 | 90.63 | 8 | 1.04 / 1.04 | 0 / 0 |
|
||||
|
||||
Этот профиль из lab3 использует четыре закрытых клиента: POST сообщения и GET истории, пауза 50 ms. При неопределённом POST повторяется тот же ключ/тело. Длительность включает 1 s прогрева и воздействие; исходные посекундные счётчики есть в JSON. Это проверка восстановления и отсутствия потерь, а не поиск предельного RPS.
|
||||
|
||||
## Ограничения и следующие шаги
|
||||
|
||||
TODO: какие отказы выдерживаются и какие нет; что не реализовано; где учебное упрощение; какое улучшение подтверждено, а какое пока гипотеза.
|
||||
Гарантируется сохранность при проверенном обычном restart с volumes и отказе одной API-реплики при доступных зависимостях. PostgreSQL, Valkey, S3 и LB остаются отдельными точками отказа; HA хранилищ, отказ хоста/электропитания и backup этой работы не заявлены. HEAD bucket в readiness не является тестом записи каждого объекта. Потеря или удаление volumes уничтожает соответствующие данные.
|
||||
|
||||
После 201 данные доступны всем участникам через любую готовую реплику. Неопределённый ответ upload может привести к ещё одному готовому вложению при повторе: идемпотентность upload контрактом не предусмотрена. Cleaner удаляет только незавершённые журналируемые операции; потеря одновременно БД/журнала или ручная запись посторонних объектов требует работы оператора. При длительной недоступности S3/БД очистка откладывается до восстановления.
|
||||
|
||||
Слоты и ресурсные лимиты ограничивают память, но не обещают отсутствие 503 при произвольной нагрузке. Временный spool хранится на ephemeral disk API только во время запроса. Для удалённого стенда нужен TLS; текущий HTTP привязан к localhost и использует синтетические учебные данные.
|
||||
|
||||
## Первичные источники
|
||||
|
||||
- [SeaweedFS 3.85: команды сервера](https://github.com/seaweedfs/seaweedfs/blob/3.85/weed/command/server.go).
|
||||
- [SeaweedFS 3.85: IAM и ограничения действий](https://github.com/seaweedfs/seaweedfs/blob/3.85/weed/s3api/auth_credentials.go).
|
||||
- [MinIO Python SDK](https://minio-py.min.io/).
|
||||
- [Pillow Image: open, verify, load и лимиты](https://pillow.readthedocs.io/en/stable/reference/Image.html).
|
||||
- [Psycopg 3.3.6: клиентский timeout ожидания I/O](https://github.com/psycopg/psycopg/blob/3.3.6/psycopg/psycopg/connection.py).
|
||||
|
||||
+165
@@ -0,0 +1,165 @@
|
||||
name: mtusi-lab4
|
||||
|
||||
x-application: &application
|
||||
image: mtusi-messenger:lab4
|
||||
env_file: .env
|
||||
cpus: 1
|
||||
mem_limit: 384m
|
||||
|
||||
x-postgres: &postgres
|
||||
image: postgres:17.6-bookworm
|
||||
environment:
|
||||
POSTGRES_USER: messenger
|
||||
POSTGRES_DB: messenger
|
||||
POSTGRES_PASSWORD_FILE: /run/secrets/postgres_password
|
||||
secrets: [postgres_password]
|
||||
cpus: 1
|
||||
mem_limit: 512m
|
||||
healthcheck:
|
||||
test: ["CMD-SHELL", "pg_isready -U messenger -d messenger"]
|
||||
interval: 2s
|
||||
timeout: 3s
|
||||
retries: 30
|
||||
|
||||
services:
|
||||
postgres:
|
||||
<<: *postgres
|
||||
volumes: [postgres_data:/var/lib/postgresql/data]
|
||||
|
||||
valkey:
|
||||
image: valkey/valkey:8.1.3
|
||||
command: ["valkey-server", "--appendonly", "yes", "--appendfsync", "always", "--save", "", "--maxmemory", "64mb", "--maxmemory-policy", "noeviction"]
|
||||
volumes: [valkey_data:/data]
|
||||
cpus: 0.5
|
||||
mem_limit: 128m
|
||||
healthcheck:
|
||||
test: ["CMD", "valkey-cli", "ping"]
|
||||
interval: 2s
|
||||
timeout: 3s
|
||||
retries: 30
|
||||
|
||||
api:
|
||||
<<: *application
|
||||
build: .
|
||||
deploy:
|
||||
replicas: ${API_REPLICAS:-2}
|
||||
environment:
|
||||
SESSION_TTL_SECONDS: ${SESSION_TTL_SECONDS:-3600}
|
||||
secrets: [database_url, cache_url, s3_access_key_id, s3_secret_access_key]
|
||||
depends_on:
|
||||
postgres: {condition: service_healthy}
|
||||
valkey: {condition: service_healthy}
|
||||
migrate: {condition: service_completed_successfully}
|
||||
s3: {condition: service_healthy}
|
||||
s3-bootstrap: {condition: service_completed_successfully}
|
||||
stop_grace_period: 8s
|
||||
|
||||
migrate:
|
||||
<<: *application
|
||||
command: ["python", "-m", "src.migrate"]
|
||||
secrets: [database_url]
|
||||
healthcheck:
|
||||
disable: true
|
||||
depends_on:
|
||||
postgres: {condition: service_healthy}
|
||||
|
||||
s3:
|
||||
image: chrislusf/seaweedfs:3.85@sha256:49312939c00c01e5ee6afbd7d728b18027821d3764c35a797a72acd4fdf3296a
|
||||
command: ["s3", "-filer=s3-storage:8888", "-ip.bind=0.0.0.0", "-port=9000", "-config=/run/secrets/s3_config"]
|
||||
secrets: [s3_config]
|
||||
networks: [default, s3-internal]
|
||||
depends_on:
|
||||
s3-storage: {condition: service_healthy}
|
||||
cpus: 0.5
|
||||
mem_limit: 256m
|
||||
healthcheck:
|
||||
test: ["CMD", "nc", "-z", "127.0.0.1", "9000"]
|
||||
interval: 2s
|
||||
timeout: 2s
|
||||
retries: 30
|
||||
|
||||
s3-storage:
|
||||
image: chrislusf/seaweedfs:3.85@sha256:49312939c00c01e5ee6afbd7d728b18027821d3764c35a797a72acd4fdf3296a
|
||||
command: ["server", "-dir=/data", "-ip=s3-storage", "-ip.bind=0.0.0.0", "-filer", "-master.volumeSizeLimitMB=64", "-volume.max=64", "-volume.preStopSeconds=0"]
|
||||
volumes: [s3_data:/data]
|
||||
networks: [s3-internal]
|
||||
cpus: 1
|
||||
mem_limit: 512m
|
||||
healthcheck:
|
||||
test: ["CMD", "wget", "-q", "-O", "/dev/null", "http://127.0.0.1:8888/"]
|
||||
interval: 2s
|
||||
timeout: 2s
|
||||
retries: 30
|
||||
|
||||
s3-bootstrap:
|
||||
<<: *application
|
||||
command: ["python", "-m", "src.bootstrap_s3"]
|
||||
environment:
|
||||
S3_ROOT_USER_FILE: /run/secrets/s3_root_user
|
||||
S3_ROOT_PASSWORD_FILE: /run/secrets/s3_root_password
|
||||
secrets: [s3_root_user, s3_root_password]
|
||||
cpus: 0.5
|
||||
mem_limit: 128m
|
||||
healthcheck:
|
||||
disable: true
|
||||
depends_on:
|
||||
s3: {condition: service_healthy}
|
||||
|
||||
cleanup:
|
||||
<<: *application
|
||||
command: ["python", "-m", "src.cleanup"]
|
||||
secrets: [database_url, s3_access_key_id, s3_secret_access_key]
|
||||
restart: unless-stopped
|
||||
healthcheck:
|
||||
disable: true
|
||||
depends_on:
|
||||
migrate: {condition: service_completed_successfully}
|
||||
s3-bootstrap: {condition: service_completed_successfully}
|
||||
|
||||
lb:
|
||||
image: haproxy:3.2.6-alpine
|
||||
ports: ["127.0.0.1:${HOST_PORT:-8080}:8080"]
|
||||
volumes: [./infra/haproxy.cfg:/usr/local/etc/haproxy/haproxy.cfg:ro]
|
||||
cpus: 0.5
|
||||
mem_limit: 64m
|
||||
depends_on:
|
||||
api: {condition: service_healthy}
|
||||
stop_grace_period: 10s
|
||||
healthcheck:
|
||||
test: ["CMD", "wget", "-q", "-O", "/dev/null", "http://127.0.0.1:8080/health/ready"]
|
||||
interval: 2s
|
||||
timeout: 2s
|
||||
retries: 3
|
||||
|
||||
postgres-restore:
|
||||
<<: *postgres
|
||||
profiles: [research]
|
||||
volumes: [restore_data:/var/lib/postgresql/data]
|
||||
|
||||
volumes:
|
||||
postgres_data:
|
||||
valkey_data:
|
||||
restore_data:
|
||||
s3_data:
|
||||
|
||||
networks:
|
||||
s3-internal:
|
||||
internal: true
|
||||
|
||||
secrets:
|
||||
postgres_password:
|
||||
file: ./secrets/postgres_password
|
||||
database_url:
|
||||
file: ./secrets/database_url
|
||||
cache_url:
|
||||
file: ./secrets/cache_url
|
||||
s3_root_user:
|
||||
file: ./secrets/s3_root_user
|
||||
s3_root_password:
|
||||
file: ./secrets/s3_root_password
|
||||
s3_access_key_id:
|
||||
file: ./secrets/s3_access_key_id
|
||||
s3_secret_access_key:
|
||||
file: ./secrets/s3_secret_access_key
|
||||
s3_config:
|
||||
file: ./secrets/s3_config
|
||||
@@ -0,0 +1,33 @@
|
||||
# Схема и транзакции
|
||||
|
||||
Лабораторная 4, оценка 4: клиент → HAProxy → FastAPI × 2 → PostgreSQL + Valkey + приватный S3 (SeaweedFS).
|
||||
|
||||
| Таблица PostgreSQL | Назначение и ограничения |
|
||||
| --- | --- |
|
||||
| users | UUID PK; username UNIQUE; password_hash Argon2id; display_name; created_at |
|
||||
| chats | UUID PK; title; created_at |
|
||||
| chat_members | PK (chat_id, user_id); FK на chats и users |
|
||||
| messages | UUID PK; FK на чат и членство отправителя; text до 4000 code points; created_at |
|
||||
| message_attachments | FK на messages и attachments; до 10 позиций; UNIQUE(message_id, position); PK(message_id, attachment_id) |
|
||||
| attachments | UUID PK; FK chat_id и (chat_id, owner_id); UNIQUE object_key; filename, content_type, size_bytes, sha256, created_at |
|
||||
| attachment_uploads | UUID PK, UNIQUE object_key, created_at; долговечный журнал незавершённых PUT |
|
||||
| message_idempotency | PK (user_id, chat_id, key); request_text, request_attachment_ids, message_id FK, expires_at |
|
||||
| schema_migrations | Имя и SHA-256 применённой миграции; applied_at |
|
||||
|
||||
В PostgreSQL нет bytes оригинала. `object_key=attachments/<случайный UUID>` назначает сервер; filename не участвует в ключе. В таблицу attachments попадают только ready-объекты; status=ready, variants=[], error_code=null формируются API. updated_at совпадает с created_at, поскольку API lab4 не изменяет вложения.
|
||||
|
||||
Индексы: UNIQUE users(username); chat_members(user_id, chat_id); messages(chat_id, created_at, id); attachments(chat_id); attachment_uploads(created_at). Первичные/уникальные ключи индексируют поиск ID и object_key.
|
||||
|
||||
Создание чата и его участников атомарно. Неизвестный участник откатывает весь чат. Сообщение проверяет членство и все attachment_ids в том же чате, затем одной транзакцией записывает messages, message_attachments и результат идемпотентности. Составной FK дополнительно запрещает отправителя вне чата. Пустой/пробельный text разрешён только с вложением: это проверяет модель запроса; FK таблицы message_attachments запрещают несуществующие ссылки. Удаления вложений в HTTP API нет.
|
||||
|
||||
Общая advisory transaction lock сериализует область пользователь + POST + путь чата + Idempotency-Key. Сравниваются text и упорядоченный нормализованный список UUID; отсутствие attachment_ids эквивалентно []. Совпадение возвращает исходный 201 и Message, отличие — 409. TTL не меньше 24 часов. Чтение истории использует keyset (created_at,id), без кэша; на следующем запросе видны COMMIT любой реплики. При конкурентных вставках snapshot между страницами нет; запись с более ранними часами может оказаться до уже пройденного cursor.
|
||||
|
||||
Upload сначала полностью принимает ограниченный поток во временный файл и проверяет PNG/JPEG. Затем отдельной транзакцией фиксирует attachment_uploads. В следующей транзакции берётся advisory lock object_key, выполняется S3 PUT, вставляются ready-метаданные и удаляется журнал. 201 отправляется после COMMIT. S3 и PostgreSQL не образуют распределённую транзакцию.
|
||||
|
||||
Если PUT прошёл, а COMMIT нет, остаётся журнал. Если исход COMMIT неизвестен, немедленного удаления нет: ready-метаданные могли сохраниться. Cleaner раз в 30 секунд берёт до 100 записей старше grace period (по умолчанию 3600 s, минимум 60 s), пробует ту же advisory lock и повторно проверяет запись. Активная загрузка пропускается; при наличии ready-метаданных удаляется только запись журнала; иначе удаляется S3 object и затем журнал. DELETE объекта идемпотентен. Сбой S3/БД откладывает обработку; следующий проход повторяет её. Это компенсация журналируемых загрузок уровня 4, без полного обхода bucket.
|
||||
|
||||
Миграции 001 и 002 сохранены. Миграция 003 добавляет вложения, связи, журнал и список вложений в ключе повтора; старые сообщения имеют пустой список. DDL выполняет один migrate-service под общей advisory lock; API проверяют версии и checksum.
|
||||
|
||||
Valkey хранит только серверные сессии: session:SHA256(token) → user_id, expires_at, TTL. Включены AOF appendfsync always и постоянный volume. Сырой токен не записывается в evidence. PostgreSQL, Valkey и S3 bucket проверяются /health/ready; /health/live не обращается к зависимостям.
|
||||
|
||||
Исходные отчёты и результаты lab2/lab3 сохранены отдельно. Актуальные команды, измерения и ограничения — в [REPORT.md](../REPORT.md).
|
||||
@@ -0,0 +1,66 @@
|
||||
UTC: 2026-10-22T11:17:22.562634+00:00
|
||||
Host: Darwin arm64 Python 3.11.9
|
||||
Docker: 29.0.1 aarch64 CPUs=10 RAM=8217448448
|
||||
Commit: 9961362 + working tree
|
||||
Command: ./scripts/check-docker.sh; project: lab2-check-ae280d00db
|
||||
PASS: start.sh built and started the stack, readiness reached
|
||||
api image=sha256:0b3dc5056cced642eea5ade11d235dce9f69f0d9e6d63956ce9479f2deaa10a0 started=2026-10-22T11:17:27.057932632Z memory=268435456 nano_cpus=1000000000
|
||||
postgres image=sha256:f3bd19c606e442c3d7bdfa8002e03fe260a1023351e0ea4598032022b68dd6e3 started=2026-10-22T11:17:24.411773881Z memory=536870912 nano_cpus=1000000000
|
||||
valkey image=sha256:fea8b3e67b15729d4bb70589eb03367bab9ad1ee89c876f54327fc7c6e618571 started=2026-10-22T11:17:24.406509756Z memory=134217728 nano_cpus=500000000
|
||||
PASS: non-root UID 10001; Python PID 1; healthcheck; named volumes; no API data volume
|
||||
Проверяем сервер: http://127.0.0.1:61900
|
||||
/Users/vanek/Desktop/VNPlabs/VNPlab2/mtusi2026lab2/.venv/bin/python scripts/check_contract.py
|
||||
PASS: offline skeleton structure, local refs and Python syntax; application NOT tested.
|
||||
/Users/vanek/Desktop/VNPlabs/VNPlab2/mtusi2026lab2/.venv/bin/python tests/smoke.py --base-url "http://127.0.0.1:61900"
|
||||
PASS: lab2 public API scenario; infrastructure and grading evidence remain separate.
|
||||
test_chat_access (test_api.ApiTests.test_chat_access) ... ok
|
||||
test_chat_pagination_and_cursor_owner (test_api.ApiTests.test_chat_pagination_and_cursor_owner) ... ok
|
||||
test_cursor_cannot_be_used_for_another_chat_or_changed (test_api.ApiTests.test_cursor_cannot_be_used_for_another_chat_or_changed) ... ok
|
||||
test_default_page_size (test_api.ApiTests.test_default_page_size) ... ok
|
||||
test_duplicate_username (test_api.ApiTests.test_duplicate_username) ... ok
|
||||
test_framework_errors_and_request_ids (test_api.ApiTests.test_framework_errors_and_request_ids) ... ok
|
||||
test_identification_and_authentication_order (test_api.ApiTests.test_identification_and_authentication_order) ... ok
|
||||
test_invalid_chat_members (test_api.ApiTests.test_invalid_chat_members) ... ok
|
||||
test_invalid_chat_title (test_api.ApiTests.test_invalid_chat_title) ... ok
|
||||
test_invalid_limits_and_cursors (test_api.ApiTests.test_invalid_limits_and_cursors) ... ok
|
||||
test_invalid_message_fields (test_api.ApiTests.test_invalid_message_fields) ... ok
|
||||
test_invalid_user_fields (test_api.ApiTests.test_invalid_user_fields) ... ok
|
||||
test_malformed_json_and_encoding (test_api.ApiTests.test_malformed_json_and_encoding) ... ok
|
||||
test_message_pagination_and_changing_limit (test_api.ApiTests.test_message_pagination_and_changing_limit) ... ok
|
||||
test_unicode_and_text_preservation (test_api.ApiTests.test_unicode_and_text_preservation) ... ok
|
||||
test_wrong_content_type (test_api.ApiTests.test_wrong_content_type) ... ok
|
||||
test_simultaneous_registration_of_one_username (test_concurrency.ConcurrencyTests.test_simultaneous_registration_of_one_username) ... ok
|
||||
test_ten_clients_send_one_hundred_messages (test_concurrency.ConcurrencyTests.test_ten_clients_send_one_hundred_messages) ... ok
|
||||
test_logout_revokes_only_one_session (test_sessions.SessionTests.test_logout_revokes_only_one_session) ... ok
|
||||
test_password_validation (test_sessions.SessionTests.test_password_validation) ... ok
|
||||
test_sql_like_message_is_plain_text (test_sessions.SessionTests.test_sql_like_message_is_plain_text) ... ok
|
||||
test_unicode_password_with_colon_and_private_response (test_sessions.SessionTests.test_unicode_password_with_colon_and_private_response) ... ok
|
||||
test_wrong_password_and_basic_only_for_login (test_sessions.SessionTests.test_wrong_password_and_basic_only_for_login) ... ok
|
||||
|
||||
----------------------------------------------------------------------
|
||||
Ran 23 tests in 5.743s
|
||||
|
||||
OK
|
||||
PASS: 10 clients sent 100 messages; history contains exactly 100 unique messages.
|
||||
PASS: demo.sh registered users, logged in and read two messages
|
||||
PASS: Argon2id in PostgreSQL; logs do not contain message text, passwords or session tokens
|
||||
PASS: failed membership insert rolled back chat; migrations run twice without duplicate data
|
||||
/Users/vanek/Desktop/VNPlabs/VNPlab2/mtusi2026lab2/.venv/bin/python tests/resilience.py --mode persistence --action-script "scripts/restart.sh" --base-url "http://127.0.0.1:61900"
|
||||
Executing explicit persistence hook; hook output suppressed to avoid leaking secrets.
|
||||
PASS: persistence preserved confirmed data and existing session. Hook scope needs operator evidence.
|
||||
Restart api 2026-10-22T11:17:27.057932632Z -> 2026-10-22T11:17:45.460071626Z
|
||||
Restart postgres 2026-10-22T11:17:24.411773881Z -> 2026-10-22T11:17:44.637353001Z
|
||||
Restart valkey 2026-10-22T11:17:24.406509756Z -> 2026-10-22T11:17:44.670095293Z
|
||||
PASS: API, PostgreSQL and Valkey really restarted; previous token still works
|
||||
PASS: valkey unavailable -> 503 in 0.11s; anonymous -> 401; readiness 503, liveness 200
|
||||
API ready
|
||||
PASS: valkey recovered without a new login
|
||||
PASS: postgres unavailable -> 503 in 2.01s; anonymous -> 401; readiness 503, liveness 200
|
||||
API ready
|
||||
PASS: postgres recovered without a new login
|
||||
API ready
|
||||
PASS: SESSION_TTL_SECONDS=2; valid token expires without logout
|
||||
PASS: SIGTERM with unfinished request: 5.54s; new requests refused after 0.16s; exit=0; OOM=false
|
||||
PASS: all lab2 Docker checks completed
|
||||
PASS: stop.sh removed containers and preserved named volumes
|
||||
Removed only temporary Compose project and its test volumes: lab2-check-ae280d00db
|
||||
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,403 @@
|
||||
Command: ./scripts/check-docker.sh; project: lab3-check-a31f544685
|
||||
Docker: 29.0.1 aarch64 CPUs=10 RAM=8217448448
|
||||
Local .env and secrets are ready; values are not printed
|
||||
#1 [internal] load local bake definitions
|
||||
#1 reading from stdin 1.05kB done
|
||||
#1 DONE 0.0s
|
||||
|
||||
#2 [migrate internal] load build definition from Dockerfile
|
||||
#2 transferring dockerfile: 733B done
|
||||
#2 DONE 0.0s
|
||||
|
||||
#3 [api internal] load metadata for docker.io/library/python:3.11.15-slim-bookworm@sha256:d29f48a31a8b408ed19272ca1e7b10ebae13b240a27e862d3d4217c528e2e0c3
|
||||
#3 DONE 0.0s
|
||||
|
||||
#4 [api internal] load .dockerignore
|
||||
#4 transferring context: 167B done
|
||||
#4 DONE 0.0s
|
||||
|
||||
#5 [migrate internal] load build context
|
||||
#5 transferring context: 809B done
|
||||
#5 DONE 0.0s
|
||||
|
||||
#6 [migrate 1/8] FROM docker.io/library/python:3.11.15-slim-bookworm@sha256:d29f48a31a8b408ed19272ca1e7b10ebae13b240a27e862d3d4217c528e2e0c3
|
||||
#6 resolve docker.io/library/python:3.11.15-slim-bookworm@sha256:d29f48a31a8b408ed19272ca1e7b10ebae13b240a27e862d3d4217c528e2e0c3 done
|
||||
#6 DONE 0.0s
|
||||
|
||||
#7 [migrate 2/8] WORKDIR /app
|
||||
#7 CACHED
|
||||
|
||||
#8 [migrate 3/8] COPY requirements.txt .
|
||||
#8 CACHED
|
||||
|
||||
#9 [migrate 4/8] RUN python -m pip install --no-cache-dir -r requirements.txt && python -m pip check
|
||||
#9 CACHED
|
||||
|
||||
#10 [migrate 6/8] COPY src/ ./src/
|
||||
#10 CACHED
|
||||
|
||||
#11 [migrate 7/8] COPY migrations/ ./migrations/
|
||||
#11 CACHED
|
||||
|
||||
#12 [migrate 5/8] RUN groupadd --gid 10001 app && useradd --uid 10001 --gid app --no-create-home app
|
||||
#12 CACHED
|
||||
|
||||
#13 [migrate 8/8] COPY research/ ./research/
|
||||
#13 CACHED
|
||||
|
||||
#14 [api] exporting to image
|
||||
#14 exporting layers done
|
||||
#14 exporting manifest sha256:06163e45d3676c7cf4f7a1c7bfe108ed3b98559ebb485c7a09d1e87e6f418d17 done
|
||||
#14 exporting config sha256:3fed7460e9510eef7b2928f8d600d06d5d65329f74d820beac13809476b11398 done
|
||||
#14 exporting attestation manifest sha256:352319cde788733f2f237a2a78204630c542e7ca906cff14c902046e8c1d2e5b 0.0s done
|
||||
#14 exporting manifest list sha256:848e0c76f1678f35dd1b483e7c54552466999551ba7e77c0062bf346671e2902 done
|
||||
#14 naming to docker.io/library/mtusi-messenger:lab3 done
|
||||
#14 unpacking to docker.io/library/mtusi-messenger:lab3 done
|
||||
#14 DONE 0.1s
|
||||
|
||||
#15 [migrate] exporting to image
|
||||
#15 exporting layers done
|
||||
#15 exporting manifest sha256:a59568d34e2c5e8b4d23308342601fdaf8c07e78ec3065878679a067c082e952 done
|
||||
#15 exporting config sha256:b67b805ba1b7dd90f0a3e8444455488fe8c7f4118f14d671501dd63e85b59c97 done
|
||||
#15 exporting attestation manifest sha256:b1853c07ddac46c4b398b475052f334aa2753c2fe971e0e4fb2517b0e3e13656 0.0s done
|
||||
#15 exporting manifest list sha256:eff1abdd662eb60e2741e6ce6b8f364467d2817dafeef9754518247124a780eb done
|
||||
#15 naming to docker.io/library/mtusi-messenger:lab3 done
|
||||
#15 unpacking to docker.io/library/mtusi-messenger:lab3 done
|
||||
#15 DONE 0.1s
|
||||
|
||||
#16 [api] resolving provenance for metadata file
|
||||
#16 DONE 0.0s
|
||||
|
||||
#17 [migrate] resolving provenance for metadata file
|
||||
#17 DONE 0.0s
|
||||
mtusi-messenger:lab3 Built
|
||||
mtusi-messenger:lab3 Built
|
||||
Network lab3-check-a31f544685_default Creating
|
||||
Network lab3-check-a31f544685_default Created
|
||||
Volume lab3-check-a31f544685_postgres_data Creating
|
||||
Volume lab3-check-a31f544685_postgres_data Created
|
||||
Volume lab3-check-a31f544685_valkey_data Creating
|
||||
Volume lab3-check-a31f544685_valkey_data Created
|
||||
Container lab3-check-a31f544685-valkey-1 Creating
|
||||
Container lab3-check-a31f544685-postgres-1 Creating
|
||||
Container lab3-check-a31f544685-valkey-1 Created
|
||||
Container lab3-check-a31f544685-postgres-1 Created
|
||||
Container lab3-check-a31f544685-migrate-1 Creating
|
||||
Container lab3-check-a31f544685-migrate-1 Created
|
||||
Container lab3-check-a31f544685-api-2 Creating
|
||||
Container lab3-check-a31f544685-api-1 Creating
|
||||
Container lab3-check-a31f544685-api-1 Created
|
||||
Container lab3-check-a31f544685-api-2 Created
|
||||
Container lab3-check-a31f544685-lb-1 Creating
|
||||
Container lab3-check-a31f544685-lb-1 Created
|
||||
Container lab3-check-a31f544685-valkey-1 Starting
|
||||
Container lab3-check-a31f544685-postgres-1 Starting
|
||||
Container lab3-check-a31f544685-valkey-1 Started
|
||||
Container lab3-check-a31f544685-postgres-1 Started
|
||||
Container lab3-check-a31f544685-postgres-1 Waiting
|
||||
Container lab3-check-a31f544685-postgres-1 Healthy
|
||||
Container lab3-check-a31f544685-migrate-1 Starting
|
||||
Container lab3-check-a31f544685-migrate-1 Started
|
||||
Container lab3-check-a31f544685-migrate-1 Waiting
|
||||
Container lab3-check-a31f544685-postgres-1 Waiting
|
||||
Container lab3-check-a31f544685-valkey-1 Waiting
|
||||
Container lab3-check-a31f544685-valkey-1 Healthy
|
||||
Container lab3-check-a31f544685-postgres-1 Healthy
|
||||
Container lab3-check-a31f544685-migrate-1 Exited
|
||||
Container lab3-check-a31f544685-api-2 Starting
|
||||
Container lab3-check-a31f544685-api-2 Started
|
||||
Container lab3-check-a31f544685-api-1 Starting
|
||||
Container lab3-check-a31f544685-api-1 Started
|
||||
Container lab3-check-a31f544685-api-2 Waiting
|
||||
Container lab3-check-a31f544685-api-1 Waiting
|
||||
Container lab3-check-a31f544685-api-2 Healthy
|
||||
Container lab3-check-a31f544685-api-1 Healthy
|
||||
Container lab3-check-a31f544685-lb-1 Starting
|
||||
Container lab3-check-a31f544685-lb-1 Started
|
||||
API ready through LB: 7f6a80b69e32, f973eaec4d52
|
||||
PASS: 2 real API containers, CPU/RAM limits, API non-root and no public ports; only LB published
|
||||
Проверяем сервер: http://127.0.0.1:58474
|
||||
/Users/vanek/Desktop/VNPlabs/VNPlab3/mtusi2026lab3/.venv/bin/python scripts/check_contract.py
|
||||
PASS: offline skeleton structure, local refs and Python syntax; application NOT tested.
|
||||
/Users/vanek/Desktop/VNPlabs/VNPlab3/mtusi2026lab3/.venv/bin/python tests/smoke.py --base-url "http://127.0.0.1:58474"
|
||||
PASS: lab3 public API scenario; infrastructure and grading evidence remain separate.
|
||||
test_chat_access (test_api.ApiTests.test_chat_access) ... ok
|
||||
test_chat_pagination_and_cursor_owner (test_api.ApiTests.test_chat_pagination_and_cursor_owner) ... ok
|
||||
test_cursor_cannot_be_used_for_another_chat_or_changed (test_api.ApiTests.test_cursor_cannot_be_used_for_another_chat_or_changed) ... ok
|
||||
test_default_page_size (test_api.ApiTests.test_default_page_size) ... ok
|
||||
test_duplicate_username (test_api.ApiTests.test_duplicate_username) ... ok
|
||||
test_framework_errors_and_request_ids (test_api.ApiTests.test_framework_errors_and_request_ids) ... ok
|
||||
test_identification_and_authentication_order (test_api.ApiTests.test_identification_and_authentication_order) ... ok
|
||||
test_invalid_chat_members (test_api.ApiTests.test_invalid_chat_members) ... ok
|
||||
test_invalid_chat_title (test_api.ApiTests.test_invalid_chat_title) ... ok
|
||||
test_invalid_limits_and_cursors (test_api.ApiTests.test_invalid_limits_and_cursors) ... ok
|
||||
test_invalid_message_fields (test_api.ApiTests.test_invalid_message_fields) ... ok
|
||||
test_invalid_user_fields (test_api.ApiTests.test_invalid_user_fields) ... ok
|
||||
test_malformed_json_and_encoding (test_api.ApiTests.test_malformed_json_and_encoding) ... ok
|
||||
test_message_pagination_and_changing_limit (test_api.ApiTests.test_message_pagination_and_changing_limit) ... ok
|
||||
test_unicode_and_text_preservation (test_api.ApiTests.test_unicode_and_text_preservation) ... ok
|
||||
test_wrong_content_type (test_api.ApiTests.test_wrong_content_type) ... ok
|
||||
test_simultaneous_registration_of_one_username (test_concurrency.ConcurrencyTests.test_simultaneous_registration_of_one_username) ... ok
|
||||
test_ten_clients_send_one_hundred_messages (test_concurrency.ConcurrencyTests.test_ten_clients_send_one_hundred_messages) ... ok
|
||||
test_conflict_and_semantic_json_replay (test_idempotency.IdempotencyTests.test_conflict_and_semantic_json_replay) ... ok
|
||||
test_key_format_and_missing_key (test_idempotency.IdempotencyTests.test_key_format_and_missing_key) ... ok
|
||||
test_parallel_replay_across_replicas (test_idempotency.IdempotencyTests.test_parallel_replay_across_replicas) ... ok
|
||||
test_replay_rechecks_session_and_access (test_idempotency.IdempotencyTests.test_replay_rechecks_session_and_access) ... ok
|
||||
test_scope_is_user_and_chat (test_idempotency.IdempotencyTests.test_scope_is_user_and_chat) ... ok
|
||||
test_logout_revokes_only_one_session (test_sessions.SessionTests.test_logout_revokes_only_one_session) ... ok
|
||||
test_password_validation (test_sessions.SessionTests.test_password_validation) ... ok
|
||||
test_sql_like_message_is_plain_text (test_sessions.SessionTests.test_sql_like_message_is_plain_text) ... ok
|
||||
test_unicode_password_with_colon_and_private_response (test_sessions.SessionTests.test_unicode_password_with_colon_and_private_response) ... ok
|
||||
test_wrong_password_and_basic_only_for_login (test_sessions.SessionTests.test_wrong_password_and_basic_only_for_login) ... ok
|
||||
|
||||
----------------------------------------------------------------------
|
||||
Ran 28 tests in 6.783s
|
||||
|
||||
OK
|
||||
PASS: 10 clients sent 100 messages; history contains exactly 100 unique messages.
|
||||
Container lab3-check-a31f544685-postgres-1 Running
|
||||
Container lab3-check-a31f544685-postgres-1 Running
|
||||
PASS: migrations only in one-shot service; repeated execution preserves data
|
||||
/Users/vanek/Desktop/VNPlabs/VNPlab3/mtusi2026lab3/.venv/bin/python tests/resilience.py --mode persistence --action-script "scripts/restart.sh" --base-url "http://127.0.0.1:58474"
|
||||
Executing explicit persistence hook; hook output suppressed to avoid leaking secrets.
|
||||
PASS: persistence preserved confirmed data and existing session. Hook scope needs operator evidence.
|
||||
PASS: both API, LB, PostgreSQL, Valkey actually restarted; session and confirmed data preserved
|
||||
PASS: SIGTERM with unfinished request: {"instance": "7f6a80b69e32", "unfinished_request": true, "shutdown_seconds": 5.393, "new_connections_refused_seconds": 0.167, "exit_code": 0, "oom_killed": false}
|
||||
Container lab3-check-a31f544685-postgres-1 Waiting
|
||||
Container lab3-check-a31f544685-postgres-1 Healthy
|
||||
Container lab3-check-a31f544685-migrate-1 Starting
|
||||
Container lab3-check-a31f544685-migrate-1 Started
|
||||
Container lab3-check-a31f544685-valkey-1 Waiting
|
||||
Container lab3-check-a31f544685-migrate-1 Waiting
|
||||
Container lab3-check-a31f544685-postgres-1 Waiting
|
||||
Container lab3-check-a31f544685-valkey-1 Healthy
|
||||
Container lab3-check-a31f544685-postgres-1 Healthy
|
||||
Container lab3-check-a31f544685-migrate-1 Exited
|
||||
Container lab3-check-a31f544685-api-1 Starting
|
||||
Container lab3-check-a31f544685-api-1 Started
|
||||
API ready through LB: 7f6a80b69e32, f973eaec4d52
|
||||
Container lab3-check-a31f544685-valkey-1 Stopping
|
||||
Container lab3-check-a31f544685-valkey-1 Stopped
|
||||
PASS: valkey outage: API live=200, ready=503, LB ready=503
|
||||
Container lab3-check-a31f544685-valkey-1 Starting
|
||||
Container lab3-check-a31f544685-valkey-1 Started
|
||||
API ready through LB: 7f6a80b69e32, f973eaec4d52
|
||||
Container lab3-check-a31f544685-postgres-1 Stopping
|
||||
Container lab3-check-a31f544685-postgres-1 Stopped
|
||||
PASS: postgres outage: API live=200, ready=503, LB ready=503
|
||||
Container lab3-check-a31f544685-postgres-1 Starting
|
||||
Container lab3-check-a31f544685-postgres-1 Started
|
||||
API ready through LB: 7f6a80b69e32, f973eaec4d52
|
||||
/Users/vanek/Desktop/VNPlabs/VNPlab3/mtusi2026lab3/.venv/bin/python tests/resilience.py --mode failover --action-script "scripts/stop-one.sh" --base-url "http://127.0.0.1:58474"
|
||||
Executing explicit failover hook; hook output suppressed to avoid leaking secrets.
|
||||
{"observed_instances_before": 2, "successful_writes": 113, "failed_attempts": 1, "first_recovery_seconds": 2.452}
|
||||
PASS: failover preserved confirmed data and existing session. Hook scope needs operator evidence.
|
||||
Container lab3-check-a31f544685-postgres-1 Waiting
|
||||
Container lab3-check-a31f544685-postgres-1 Healthy
|
||||
Container lab3-check-a31f544685-migrate-1 Starting
|
||||
Container lab3-check-a31f544685-migrate-1 Started
|
||||
Container lab3-check-a31f544685-postgres-1 Waiting
|
||||
Container lab3-check-a31f544685-valkey-1 Waiting
|
||||
Container lab3-check-a31f544685-migrate-1 Waiting
|
||||
Container lab3-check-a31f544685-postgres-1 Healthy
|
||||
Container lab3-check-a31f544685-valkey-1 Healthy
|
||||
Container lab3-check-a31f544685-migrate-1 Exited
|
||||
Container lab3-check-a31f544685-api-1 Starting
|
||||
Container lab3-check-a31f544685-api-1 Started
|
||||
API ready through LB: 7f6a80b69e32, f973eaec4d52
|
||||
Stopped API: 7f6a80b69e32 container=7f6a80b69e3297a4de72e756a6c9d867a108930c1ca0e57922b3821c26fd03e6
|
||||
{"label": "stop 7f6a80b69e32", "duration_seconds": 16.009, "successful_requests": 1576, "successful_writes": 788, "errors": 4, "successful_rps": 98.44, "first_success_after_action_seconds": {"POST": 0.014, "GET": 0.007}, "maximum_success_gap_seconds": {"POST": 1.957, "GET": 2.004}, "action_start_seconds": 1.003, "action_end_seconds": 1.666, "p50_ms": 7.813, "p95_ms": 16.393, "confirmed_data_preserved": true, "duplicate_messages": 0, "instances": ["7f6a80b69e32", "f973eaec4d52"]}
|
||||
Container lab3-check-a31f544685-postgres-1 Waiting
|
||||
Container lab3-check-a31f544685-postgres-1 Healthy
|
||||
Container lab3-check-a31f544685-migrate-1 Starting
|
||||
Container lab3-check-a31f544685-migrate-1 Started
|
||||
Container lab3-check-a31f544685-postgres-1 Waiting
|
||||
Container lab3-check-a31f544685-valkey-1 Waiting
|
||||
Container lab3-check-a31f544685-migrate-1 Waiting
|
||||
Container lab3-check-a31f544685-valkey-1 Healthy
|
||||
Container lab3-check-a31f544685-postgres-1 Healthy
|
||||
Container lab3-check-a31f544685-migrate-1 Exited
|
||||
Container lab3-check-a31f544685-api-1 Starting
|
||||
Container lab3-check-a31f544685-api-1 Started
|
||||
API ready through LB: 7f6a80b69e32, f973eaec4d52
|
||||
Stopped API: f973eaec4d52 container=f973eaec4d5290eb73cd96949877ccb8df1213523fce0ec05c6b40c1136bb31b
|
||||
{"label": "stop f973eaec4d52", "duration_seconds": 16.015, "successful_requests": 1574, "successful_writes": 786, "errors": 4, "successful_rps": 98.28, "first_success_after_action_seconds": {"POST": 0.002, "GET": 0.008}, "maximum_success_gap_seconds": {"POST": 2.006, "GET": 2.006}, "action_start_seconds": 1.005, "action_end_seconds": 1.713, "p50_ms": 7.98, "p95_ms": 17.217, "confirmed_data_preserved": true, "duplicate_messages": 0, "instances": ["7f6a80b69e32", "f973eaec4d52"]}
|
||||
Container lab3-check-a31f544685-postgres-1 Waiting
|
||||
Container lab3-check-a31f544685-postgres-1 Healthy
|
||||
Container lab3-check-a31f544685-migrate-1 Starting
|
||||
Container lab3-check-a31f544685-migrate-1 Started
|
||||
Container lab3-check-a31f544685-postgres-1 Waiting
|
||||
Container lab3-check-a31f544685-valkey-1 Waiting
|
||||
Container lab3-check-a31f544685-migrate-1 Waiting
|
||||
Container lab3-check-a31f544685-valkey-1 Healthy
|
||||
Container lab3-check-a31f544685-postgres-1 Healthy
|
||||
Container lab3-check-a31f544685-migrate-1 Exited
|
||||
Container lab3-check-a31f544685-api-2 Starting
|
||||
Container lab3-check-a31f544685-api-2 Started
|
||||
API ready through LB: 7f6a80b69e32, f973eaec4d52
|
||||
Local .env and secrets are ready; values are not printed
|
||||
#1 [internal] load local bake definitions
|
||||
#1 reading from stdin 1.03kB done
|
||||
#1 DONE 0.0s
|
||||
|
||||
#2 [internal] load build definition from Dockerfile
|
||||
#2 transferring dockerfile: 733B done
|
||||
#2 DONE 0.0s
|
||||
|
||||
#3 [internal] load metadata for docker.io/library/python:3.11.15-slim-bookworm@sha256:d29f48a31a8b408ed19272ca1e7b10ebae13b240a27e862d3d4217c528e2e0c3
|
||||
#3 DONE 0.0s
|
||||
|
||||
#4 [internal] load .dockerignore
|
||||
#4 transferring context: 167B done
|
||||
#4 DONE 0.0s
|
||||
|
||||
#5 [internal] load build context
|
||||
#5 transferring context: 809B done
|
||||
#5 DONE 0.0s
|
||||
|
||||
#6 [1/8] FROM docker.io/library/python:3.11.15-slim-bookworm@sha256:d29f48a31a8b408ed19272ca1e7b10ebae13b240a27e862d3d4217c528e2e0c3
|
||||
#6 resolve docker.io/library/python:3.11.15-slim-bookworm@sha256:d29f48a31a8b408ed19272ca1e7b10ebae13b240a27e862d3d4217c528e2e0c3 0.0s done
|
||||
#6 DONE 0.0s
|
||||
|
||||
#7 [4/8] RUN python -m pip install --no-cache-dir -r requirements.txt && python -m pip check
|
||||
#7 CACHED
|
||||
|
||||
#8 [3/8] COPY requirements.txt .
|
||||
#8 CACHED
|
||||
|
||||
#9 [5/8] RUN groupadd --gid 10001 app && useradd --uid 10001 --gid app --no-create-home app
|
||||
#9 CACHED
|
||||
|
||||
#10 [6/8] COPY src/ ./src/
|
||||
#10 CACHED
|
||||
|
||||
#11 [2/8] WORKDIR /app
|
||||
#11 CACHED
|
||||
|
||||
#12 [7/8] COPY migrations/ ./migrations/
|
||||
#12 CACHED
|
||||
|
||||
#13 [8/8] COPY research/ ./research/
|
||||
#13 CACHED
|
||||
|
||||
#14 exporting to image
|
||||
#14 exporting layers done
|
||||
#14 exporting manifest sha256:06163e45d3676c7cf4f7a1c7bfe108ed3b98559ebb485c7a09d1e87e6f418d17 done
|
||||
#14 exporting config sha256:3fed7460e9510eef7b2928f8d600d06d5d65329f74d820beac13809476b11398 done
|
||||
#14 exporting attestation manifest sha256:3a88ce0975ddcbab53c3ecb185da08ef114e818e9db952983e997cd47add67bf done
|
||||
#14 exporting manifest list sha256:433a8a3293202a92f092574052b474e8373c0d58649cbcf1c7ebc1af17933d3c done
|
||||
#14 naming to docker.io/library/mtusi-messenger:lab3 done
|
||||
#14 unpacking to docker.io/library/mtusi-messenger:lab3 done
|
||||
#14 DONE 0.1s
|
||||
|
||||
#15 resolving provenance for metadata file
|
||||
#15 DONE 0.0s
|
||||
mtusi-messenger:lab3 Built
|
||||
Local .env and secrets are ready; values are not printed
|
||||
Container lab3-check-a31f544685-postgres-1 Running
|
||||
#1 [internal] load local bake definitions
|
||||
#1 reading from stdin 576B done
|
||||
#1 DONE 0.0s
|
||||
|
||||
#2 [internal] load build definition from Dockerfile
|
||||
#2 transferring dockerfile: 733B done
|
||||
#2 DONE 0.0s
|
||||
|
||||
#3 [internal] load metadata for docker.io/library/python:3.11.15-slim-bookworm@sha256:d29f48a31a8b408ed19272ca1e7b10ebae13b240a27e862d3d4217c528e2e0c3
|
||||
#3 DONE 0.0s
|
||||
|
||||
#4 [internal] load .dockerignore
|
||||
#4 transferring context: 167B done
|
||||
#4 DONE 0.0s
|
||||
|
||||
#5 [internal] load build context
|
||||
#5 transferring context: 809B done
|
||||
#5 DONE 0.0s
|
||||
|
||||
#6 [1/8] FROM docker.io/library/python:3.11.15-slim-bookworm@sha256:d29f48a31a8b408ed19272ca1e7b10ebae13b240a27e862d3d4217c528e2e0c3
|
||||
#6 resolve docker.io/library/python:3.11.15-slim-bookworm@sha256:d29f48a31a8b408ed19272ca1e7b10ebae13b240a27e862d3d4217c528e2e0c3 done
|
||||
#6 DONE 0.0s
|
||||
|
||||
#7 [3/8] COPY requirements.txt .
|
||||
#7 CACHED
|
||||
|
||||
#8 [4/8] RUN python -m pip install --no-cache-dir -r requirements.txt && python -m pip check
|
||||
#8 CACHED
|
||||
|
||||
#9 [5/8] RUN groupadd --gid 10001 app && useradd --uid 10001 --gid app --no-create-home app
|
||||
#9 CACHED
|
||||
|
||||
#10 [6/8] COPY src/ ./src/
|
||||
#10 CACHED
|
||||
|
||||
#11 [7/8] COPY migrations/ ./migrations/
|
||||
#11 CACHED
|
||||
|
||||
#12 [2/8] WORKDIR /app
|
||||
#12 CACHED
|
||||
|
||||
#13 [8/8] COPY research/ ./research/
|
||||
#13 CACHED
|
||||
|
||||
#14 exporting to image
|
||||
#14 exporting layers done
|
||||
#14 exporting manifest sha256:a59568d34e2c5e8b4d23308342601fdaf8c07e78ec3065878679a067c082e952 done
|
||||
#14 exporting config sha256:b67b805ba1b7dd90f0a3e8444455488fe8c7f4118f14d671501dd63e85b59c97 done
|
||||
#14 exporting attestation manifest sha256:25ff7934ca5161da9b6c345af61b6a10b452580e4d349b35939d32feb66664ea done
|
||||
#14 exporting manifest list sha256:3e102cd9a2c1e81e95aed4a0d4de1ac94352370595fced350257813f7a07bef8 done
|
||||
#14 naming to docker.io/library/mtusi-messenger:lab3 done
|
||||
#14 unpacking to docker.io/library/mtusi-messenger:lab3 done
|
||||
#14 DONE 0.0s
|
||||
|
||||
#15 resolving provenance for metadata file
|
||||
#15 DONE 0.0s
|
||||
Migrations: already applied
|
||||
API ready through LB: 7f6a80b69e32, f973eaec4d52
|
||||
Replacing API: 7f6a80b69e32
|
||||
Container lab3-check-a31f544685-api-2 Running
|
||||
Container lab3-check-a31f544685-api-3 Creating
|
||||
Container lab3-check-a31f544685-api-3 Created
|
||||
Container lab3-check-a31f544685-api-3 Starting
|
||||
Container lab3-check-a31f544685-api-3 Started
|
||||
API ready through LB: ca9c7a52da66, f973eaec4d52
|
||||
Replacing API: f973eaec4d52
|
||||
Container lab3-check-a31f544685-api-3 Running
|
||||
Container lab3-check-a31f544685-api-4 Creating
|
||||
Container lab3-check-a31f544685-api-4 Created
|
||||
Container lab3-check-a31f544685-api-4 Starting
|
||||
Container lab3-check-a31f544685-api-4 Started
|
||||
API ready through LB: 244bf0b910eb, ca9c7a52da66
|
||||
PASS: all API containers replaced sequentially; stores and LB kept running
|
||||
{"label": "sequential API replacement", "duration_seconds": 23.774, "successful_requests": 2131, "successful_writes": 1063, "errors": 11, "successful_rps": 89.64, "first_success_after_action_seconds": {"POST": 0.018, "GET": 0.004}, "maximum_success_gap_seconds": {"POST": 1.059, "GET": 2.034}, "action_start_seconds": 1.005, "action_end_seconds": 19.63, "p50_ms": 7.723, "p95_ms": 13.565, "confirmed_data_preserved": true, "duplicate_messages": 0, "instances": ["244bf0b910eb", "7f6a80b69e32", "ca9c7a52da66", "f973eaec4d52"]}
|
||||
PASS: all lab3 grade-4 checks completed
|
||||
Container lab3-check-a31f544685-lb-1 Stopping
|
||||
Container lab3-check-a31f544685-lb-1 Stopped
|
||||
Container lab3-check-a31f544685-lb-1 Removing
|
||||
Container lab3-check-a31f544685-lb-1 Removed
|
||||
Container lab3-check-a31f544685-api-3 Stopping
|
||||
Container lab3-check-a31f544685-api-4 Stopping
|
||||
Container lab3-check-a31f544685-api-4 Stopped
|
||||
Container lab3-check-a31f544685-api-4 Removing
|
||||
Container lab3-check-a31f544685-api-4 Removed
|
||||
Container lab3-check-a31f544685-api-3 Stopped
|
||||
Container lab3-check-a31f544685-api-3 Removing
|
||||
Container lab3-check-a31f544685-api-3 Removed
|
||||
Container lab3-check-a31f544685-migrate-1 Stopping
|
||||
Container lab3-check-a31f544685-valkey-1 Stopping
|
||||
Container lab3-check-a31f544685-migrate-1 Stopped
|
||||
Container lab3-check-a31f544685-migrate-1 Removing
|
||||
Container lab3-check-a31f544685-migrate-1 Removed
|
||||
Container lab3-check-a31f544685-postgres-1 Stopping
|
||||
Container lab3-check-a31f544685-valkey-1 Stopped
|
||||
Container lab3-check-a31f544685-valkey-1 Removing
|
||||
Container lab3-check-a31f544685-valkey-1 Removed
|
||||
Container lab3-check-a31f544685-postgres-1 Stopped
|
||||
Container lab3-check-a31f544685-postgres-1 Removing
|
||||
Container lab3-check-a31f544685-postgres-1 Removed
|
||||
Volume lab3-check-a31f544685_valkey_data Removing
|
||||
Network lab3-check-a31f544685_default Removing
|
||||
Volume lab3-check-a31f544685_postgres_data Removing
|
||||
Volume lab3-check-a31f544685_valkey_data Removed
|
||||
Volume lab3-check-a31f544685_postgres_data Removed
|
||||
Network lab3-check-a31f544685_default Removed
|
||||
Removed only temporary test containers and volumes: lab3-check-a31f544685
|
||||
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,533 @@
|
||||
Command: ./scripts/check-docker.sh; project: lab4-check-5aad8e0065
|
||||
Docker: 29.0.1 aarch64 CPUs=10 RAM=8217448448
|
||||
Local .env and secrets are ready; values are not printed
|
||||
#1 [internal] load local bake definitions
|
||||
#1 reading from stdin 564B done
|
||||
#1 DONE 0.0s
|
||||
|
||||
#2 [internal] load build definition from Dockerfile
|
||||
#2 transferring dockerfile: 733B done
|
||||
#2 DONE 0.0s
|
||||
|
||||
#3 [internal] load metadata for docker.io/library/python:3.11.15-slim-bookworm@sha256:d29f48a31a8b408ed19272ca1e7b10ebae13b240a27e862d3d4217c528e2e0c3
|
||||
#3 DONE 0.0s
|
||||
|
||||
#4 [internal] load .dockerignore
|
||||
#4 transferring context: 167B done
|
||||
#4 DONE 0.0s
|
||||
|
||||
#5 [internal] load build context
|
||||
#5 transferring context: 1.01kB done
|
||||
#5 DONE 0.0s
|
||||
|
||||
#6 [1/8] FROM docker.io/library/python:3.11.15-slim-bookworm@sha256:d29f48a31a8b408ed19272ca1e7b10ebae13b240a27e862d3d4217c528e2e0c3
|
||||
#6 resolve docker.io/library/python:3.11.15-slim-bookworm@sha256:d29f48a31a8b408ed19272ca1e7b10ebae13b240a27e862d3d4217c528e2e0c3 done
|
||||
#6 DONE 0.0s
|
||||
|
||||
#7 [4/8] RUN python -m pip install --no-cache-dir -r requirements.txt && python -m pip check
|
||||
#7 CACHED
|
||||
|
||||
#8 [7/8] COPY migrations/ ./migrations/
|
||||
#8 CACHED
|
||||
|
||||
#9 [2/8] WORKDIR /app
|
||||
#9 CACHED
|
||||
|
||||
#10 [6/8] COPY src/ ./src/
|
||||
#10 CACHED
|
||||
|
||||
#11 [3/8] COPY requirements.txt .
|
||||
#11 CACHED
|
||||
|
||||
#12 [5/8] RUN groupadd --gid 10001 app && useradd --uid 10001 --gid app --no-create-home app
|
||||
#12 CACHED
|
||||
|
||||
#13 [8/8] COPY research/ ./research/
|
||||
#13 CACHED
|
||||
|
||||
#14 exporting to image
|
||||
#14 exporting layers done
|
||||
#14 exporting manifest sha256:644f5d408505f5982b75f18404860de692ee837b2b2e18f5c92b0b057081b7ec done
|
||||
#14 exporting config sha256:726011343b32f5b6277348f2f8b38f95b8c31754ae0d21336375124a18aa2e0e done
|
||||
#14 exporting attestation manifest sha256:1146b210a20471d58663fb48a3a24ba22986971d0cce8777f912886768f43306 done
|
||||
#14 exporting manifest list sha256:a04b1bfe2aea8391c8f92dd952499559d766cc4b34091963fe57bcbaf6ec015d done
|
||||
#14 naming to docker.io/library/mtusi-messenger:lab4 done
|
||||
#14 unpacking to docker.io/library/mtusi-messenger:lab4 done
|
||||
#14 DONE 0.1s
|
||||
|
||||
#15 resolving provenance for metadata file
|
||||
#15 DONE 0.0s
|
||||
mtusi-messenger:lab4 Built
|
||||
Network lab4-check-5aad8e0065_default Creating
|
||||
Network lab4-check-5aad8e0065_default Created
|
||||
Network lab4-check-5aad8e0065_s3-internal Creating
|
||||
Network lab4-check-5aad8e0065_s3-internal Created
|
||||
Volume lab4-check-5aad8e0065_valkey_data Creating
|
||||
Volume lab4-check-5aad8e0065_valkey_data Created
|
||||
Volume lab4-check-5aad8e0065_postgres_data Creating
|
||||
Volume lab4-check-5aad8e0065_postgres_data Created
|
||||
Volume lab4-check-5aad8e0065_s3_data Creating
|
||||
Volume lab4-check-5aad8e0065_s3_data Created
|
||||
Container lab4-check-5aad8e0065-s3-storage-1 Creating
|
||||
Container lab4-check-5aad8e0065-valkey-1 Creating
|
||||
Container lab4-check-5aad8e0065-postgres-1 Creating
|
||||
Container lab4-check-5aad8e0065-valkey-1 Created
|
||||
Container lab4-check-5aad8e0065-s3-storage-1 Created
|
||||
Container lab4-check-5aad8e0065-s3-1 Creating
|
||||
Container lab4-check-5aad8e0065-postgres-1 Created
|
||||
Container lab4-check-5aad8e0065-migrate-1 Creating
|
||||
Container lab4-check-5aad8e0065-s3-1 Created
|
||||
Container lab4-check-5aad8e0065-s3-bootstrap-1 Creating
|
||||
Container lab4-check-5aad8e0065-migrate-1 Created
|
||||
Container lab4-check-5aad8e0065-s3-bootstrap-1 Created
|
||||
Container lab4-check-5aad8e0065-api-2 Creating
|
||||
Container lab4-check-5aad8e0065-api-1 Creating
|
||||
Container lab4-check-5aad8e0065-cleanup-1 Creating
|
||||
Container lab4-check-5aad8e0065-api-1 Created
|
||||
Container lab4-check-5aad8e0065-cleanup-1 Created
|
||||
Container lab4-check-5aad8e0065-api-2 Created
|
||||
Container lab4-check-5aad8e0065-lb-1 Creating
|
||||
Container lab4-check-5aad8e0065-lb-1 Created
|
||||
Container lab4-check-5aad8e0065-postgres-1 Starting
|
||||
Container lab4-check-5aad8e0065-valkey-1 Starting
|
||||
Container lab4-check-5aad8e0065-s3-storage-1 Starting
|
||||
Container lab4-check-5aad8e0065-s3-storage-1 Started
|
||||
Container lab4-check-5aad8e0065-s3-storage-1 Waiting
|
||||
Container lab4-check-5aad8e0065-valkey-1 Started
|
||||
Container lab4-check-5aad8e0065-postgres-1 Started
|
||||
Container lab4-check-5aad8e0065-postgres-1 Waiting
|
||||
Container lab4-check-5aad8e0065-postgres-1 Healthy
|
||||
Container lab4-check-5aad8e0065-migrate-1 Starting
|
||||
Container lab4-check-5aad8e0065-migrate-1 Started
|
||||
Container lab4-check-5aad8e0065-s3-storage-1 Healthy
|
||||
Container lab4-check-5aad8e0065-s3-1 Starting
|
||||
Container lab4-check-5aad8e0065-s3-1 Started
|
||||
Container lab4-check-5aad8e0065-s3-1 Waiting
|
||||
Container lab4-check-5aad8e0065-s3-1 Healthy
|
||||
Container lab4-check-5aad8e0065-s3-bootstrap-1 Starting
|
||||
Container lab4-check-5aad8e0065-s3-bootstrap-1 Started
|
||||
Container lab4-check-5aad8e0065-migrate-1 Waiting
|
||||
Container lab4-check-5aad8e0065-s3-bootstrap-1 Waiting
|
||||
Container lab4-check-5aad8e0065-valkey-1 Waiting
|
||||
Container lab4-check-5aad8e0065-migrate-1 Waiting
|
||||
Container lab4-check-5aad8e0065-s3-1 Waiting
|
||||
Container lab4-check-5aad8e0065-s3-bootstrap-1 Waiting
|
||||
Container lab4-check-5aad8e0065-postgres-1 Waiting
|
||||
Container lab4-check-5aad8e0065-s3-1 Healthy
|
||||
Container lab4-check-5aad8e0065-migrate-1 Exited
|
||||
Container lab4-check-5aad8e0065-postgres-1 Healthy
|
||||
Container lab4-check-5aad8e0065-migrate-1 Exited
|
||||
Container lab4-check-5aad8e0065-valkey-1 Healthy
|
||||
Container lab4-check-5aad8e0065-s3-bootstrap-1 Exited
|
||||
Container lab4-check-5aad8e0065-api-2 Starting
|
||||
Container lab4-check-5aad8e0065-s3-bootstrap-1 Exited
|
||||
Container lab4-check-5aad8e0065-cleanup-1 Starting
|
||||
Container lab4-check-5aad8e0065-cleanup-1 Started
|
||||
Container lab4-check-5aad8e0065-api-2 Started
|
||||
Container lab4-check-5aad8e0065-api-1 Starting
|
||||
Container lab4-check-5aad8e0065-api-1 Started
|
||||
Container lab4-check-5aad8e0065-api-2 Waiting
|
||||
Container lab4-check-5aad8e0065-api-1 Waiting
|
||||
Container lab4-check-5aad8e0065-api-2 Healthy
|
||||
Container lab4-check-5aad8e0065-api-1 Healthy
|
||||
Container lab4-check-5aad8e0065-lb-1 Starting
|
||||
Container lab4-check-5aad8e0065-lb-1 Started
|
||||
API ready through LB: 19a474c69210, ca1f62dfc015
|
||||
PASS: 2 real API containers, CPU/RAM limits, API non-root and no public ports; only LB published
|
||||
Проверяем сервер: http://127.0.0.1:57722
|
||||
/Users/vanek/Desktop/VNPlabs/VNPlab4/mtusi2026lab4/.venv/bin/python scripts/check_contract.py
|
||||
PASS: offline skeleton structure, local refs and Python syntax; application NOT tested.
|
||||
/Users/vanek/Desktop/VNPlabs/VNPlab4/mtusi2026lab4/.venv/bin/python tests/smoke.py --base-url "http://127.0.0.1:57722"
|
||||
PASS: lab4 public API scenario; infrastructure and grading evidence remain separate.
|
||||
test_chat_access (test_api.ApiTests.test_chat_access) ... ok
|
||||
test_chat_pagination_and_cursor_owner (test_api.ApiTests.test_chat_pagination_and_cursor_owner) ... ok
|
||||
test_cursor_cannot_be_used_for_another_chat_or_changed (test_api.ApiTests.test_cursor_cannot_be_used_for_another_chat_or_changed) ... ok
|
||||
test_default_page_size (test_api.ApiTests.test_default_page_size) ... ok
|
||||
test_duplicate_username (test_api.ApiTests.test_duplicate_username) ... ok
|
||||
test_framework_errors_and_request_ids (test_api.ApiTests.test_framework_errors_and_request_ids) ... ok
|
||||
test_identification_and_authentication_order (test_api.ApiTests.test_identification_and_authentication_order) ... ok
|
||||
test_invalid_chat_members (test_api.ApiTests.test_invalid_chat_members) ... ok
|
||||
test_invalid_chat_title (test_api.ApiTests.test_invalid_chat_title) ... ok
|
||||
test_invalid_limits_and_cursors (test_api.ApiTests.test_invalid_limits_and_cursors) ... ok
|
||||
test_invalid_message_fields (test_api.ApiTests.test_invalid_message_fields) ... ok
|
||||
test_invalid_user_fields (test_api.ApiTests.test_invalid_user_fields) ... ok
|
||||
test_malformed_json_and_encoding (test_api.ApiTests.test_malformed_json_and_encoding) ... ok
|
||||
test_message_pagination_and_changing_limit (test_api.ApiTests.test_message_pagination_and_changing_limit) ... ok
|
||||
test_unicode_and_text_preservation (test_api.ApiTests.test_unicode_and_text_preservation) ... ok
|
||||
test_wrong_content_type (test_api.ApiTests.test_wrong_content_type) ... ok
|
||||
test_access_and_authentication (test_attachments.AttachmentTests.test_access_and_authentication) ... ok
|
||||
test_attachment_only_message_and_other_member (test_attachments.AttachmentTests.test_attachment_only_message_and_other_member) ... ok
|
||||
test_chunked_limit_without_content_length (test_attachments.AttachmentTests.test_chunked_limit_without_content_length) ... ok
|
||||
test_content_length_limit_before_body (test_attachments.AttachmentTests.test_content_length_limit_before_body) ... ok
|
||||
test_corruption_and_mime_spoof (test_attachments.AttachmentTests.test_corruption_and_mime_spoof) ... ok
|
||||
test_filename_rejected_before_storage (test_attachments.AttachmentTests.test_filename_rejected_before_storage) ... ok
|
||||
test_foreign_and_unknown_attachment_ids (test_attachments.AttachmentTests.test_foreign_and_unknown_attachment_ids) ... ok
|
||||
test_idempotency_includes_ordered_attachment_ids (test_attachments.AttachmentTests.test_idempotency_includes_ordered_attachment_ids) ... ok
|
||||
test_invalid_attachment_lists (test_attachments.AttachmentTests.test_invalid_attachment_lists) ... ok
|
||||
test_pixel_limit_before_decode (test_attachments.AttachmentTests.test_pixel_limit_before_decode) ... ok
|
||||
test_png_and_jpeg_originals (test_attachments.AttachmentTests.test_png_and_jpeg_originals) ... ok
|
||||
test_simultaneous_registration_of_one_username (test_concurrency.ConcurrencyTests.test_simultaneous_registration_of_one_username) ... ok
|
||||
test_ten_clients_send_one_hundred_messages (test_concurrency.ConcurrencyTests.test_ten_clients_send_one_hundred_messages) ... ok
|
||||
test_conflict_and_semantic_json_replay (test_idempotency.IdempotencyTests.test_conflict_and_semantic_json_replay) ... ok
|
||||
test_key_format_and_missing_key (test_idempotency.IdempotencyTests.test_key_format_and_missing_key) ... ok
|
||||
test_parallel_replay_across_replicas (test_idempotency.IdempotencyTests.test_parallel_replay_across_replicas) ... ok
|
||||
test_replay_rechecks_session_and_access (test_idempotency.IdempotencyTests.test_replay_rechecks_session_and_access) ... ok
|
||||
test_scope_is_user_and_chat (test_idempotency.IdempotencyTests.test_scope_is_user_and_chat) ... ok
|
||||
test_logout_revokes_only_one_session (test_sessions.SessionTests.test_logout_revokes_only_one_session) ... ok
|
||||
test_password_validation (test_sessions.SessionTests.test_password_validation) ... ok
|
||||
test_sql_like_message_is_plain_text (test_sessions.SessionTests.test_sql_like_message_is_plain_text) ... ok
|
||||
test_unicode_password_with_colon_and_private_response (test_sessions.SessionTests.test_unicode_password_with_colon_and_private_response) ... ok
|
||||
test_wrong_password_and_basic_only_for_login (test_sessions.SessionTests.test_wrong_password_and_basic_only_for_login) ... ok
|
||||
|
||||
----------------------------------------------------------------------
|
||||
Ran 39 tests in 9.593s
|
||||
|
||||
OK
|
||||
PASS: 10 clients sent 100 messages; history contains exactly 100 unique messages.
|
||||
Container lab4-check-5aad8e0065-postgres-1 Running
|
||||
Container lab4-check-5aad8e0065-postgres-1 Running
|
||||
PASS: migrations only in one-shot service; repeated execution preserves data
|
||||
Container lab4-check-5aad8e0065-cleanup-1 Stopping
|
||||
Container lab4-check-5aad8e0065-cleanup-1 Stopped
|
||||
Container lab4-check-5aad8e0065-s3-storage-1 Running
|
||||
Container lab4-check-5aad8e0065-s3-1 Running
|
||||
Container lab4-check-5aad8e0065-s3-storage-1 Waiting
|
||||
Container lab4-check-5aad8e0065-s3-storage-1 Healthy
|
||||
Container lab4-check-5aad8e0065-s3-storage-1 Running
|
||||
Container lab4-check-5aad8e0065-s3-1 Running
|
||||
Container lab4-check-5aad8e0065-s3-storage-1 Waiting
|
||||
Container lab4-check-5aad8e0065-s3-storage-1 Healthy
|
||||
PASS: private S3, limited credentials, isolated administration, repeated bootstrap
|
||||
Stopped API: ca1f62dfc015 container=ca1f62dfc0156fc235dbcd2f52b58eec2282e6ba8d3e056de11ca92758c69df0
|
||||
API ready through LB: 19a474c69210
|
||||
Container lab4-check-5aad8e0065-postgres-1 Waiting
|
||||
Container lab4-check-5aad8e0065-s3-storage-1 Waiting
|
||||
Container lab4-check-5aad8e0065-postgres-1 Healthy
|
||||
Container lab4-check-5aad8e0065-s3-storage-1 Healthy
|
||||
Container lab4-check-5aad8e0065-migrate-1 Starting
|
||||
Container lab4-check-5aad8e0065-s3-1 Waiting
|
||||
Container lab4-check-5aad8e0065-migrate-1 Started
|
||||
Container lab4-check-5aad8e0065-s3-1 Healthy
|
||||
Container lab4-check-5aad8e0065-s3-bootstrap-1 Starting
|
||||
Container lab4-check-5aad8e0065-s3-bootstrap-1 Started
|
||||
Container lab4-check-5aad8e0065-s3-1 Waiting
|
||||
Container lab4-check-5aad8e0065-s3-bootstrap-1 Waiting
|
||||
Container lab4-check-5aad8e0065-postgres-1 Waiting
|
||||
Container lab4-check-5aad8e0065-valkey-1 Waiting
|
||||
Container lab4-check-5aad8e0065-migrate-1 Waiting
|
||||
Container lab4-check-5aad8e0065-migrate-1 Exited
|
||||
Container lab4-check-5aad8e0065-valkey-1 Healthy
|
||||
Container lab4-check-5aad8e0065-postgres-1 Healthy
|
||||
Container lab4-check-5aad8e0065-s3-1 Healthy
|
||||
Container lab4-check-5aad8e0065-s3-bootstrap-1 Exited
|
||||
Container lab4-check-5aad8e0065-api-2 Starting
|
||||
Container lab4-check-5aad8e0065-api-2 Started
|
||||
API ready through LB: 19a474c69210, ca1f62dfc015
|
||||
PASS: original downloaded through another replica after stopping uploader
|
||||
PASS: post-PUT DB failure recorded; cleanup protects fresh, active and ready uploads
|
||||
Container lab4-check-5aad8e0065-s3-1 Stopping
|
||||
Container lab4-check-5aad8e0065-s3-1 Stopped
|
||||
Container lab4-check-5aad8e0065-s3-storage-1 Waiting
|
||||
Container lab4-check-5aad8e0065-s3-storage-1 Healthy
|
||||
Container lab4-check-5aad8e0065-s3-1 Starting
|
||||
Container lab4-check-5aad8e0065-s3-1 Started
|
||||
API ready through LB: 19a474c69210, ca1f62dfc015
|
||||
PASS: S3 outage gives API 503; recovery preserves original and session
|
||||
Container lab4-check-5aad8e0065-postgres-1 Waiting
|
||||
Container lab4-check-5aad8e0065-s3-storage-1 Waiting
|
||||
Container lab4-check-5aad8e0065-s3-storage-1 Healthy
|
||||
Container lab4-check-5aad8e0065-postgres-1 Healthy
|
||||
Container lab4-check-5aad8e0065-migrate-1 Starting
|
||||
Container lab4-check-5aad8e0065-s3-1 Waiting
|
||||
Container lab4-check-5aad8e0065-migrate-1 Started
|
||||
Container lab4-check-5aad8e0065-s3-1 Healthy
|
||||
Container lab4-check-5aad8e0065-s3-bootstrap-1 Starting
|
||||
Container lab4-check-5aad8e0065-s3-bootstrap-1 Started
|
||||
Container lab4-check-5aad8e0065-migrate-1 Waiting
|
||||
Container lab4-check-5aad8e0065-s3-bootstrap-1 Waiting
|
||||
Container lab4-check-5aad8e0065-migrate-1 Exited
|
||||
Container lab4-check-5aad8e0065-s3-bootstrap-1 Exited
|
||||
Container lab4-check-5aad8e0065-cleanup-1 Starting
|
||||
Container lab4-check-5aad8e0065-cleanup-1 Started
|
||||
PASS: 10 concurrent real PNG uploads; all checksums match; memory peaks: [215191552, 103378944]
|
||||
Container lab4-check-5aad8e0065-postgres-1 Waiting
|
||||
Container lab4-check-5aad8e0065-s3-storage-1 Waiting
|
||||
Container lab4-check-5aad8e0065-postgres-1 Healthy
|
||||
Container lab4-check-5aad8e0065-s3-storage-1 Healthy
|
||||
Container lab4-check-5aad8e0065-migrate-1 Starting
|
||||
Container lab4-check-5aad8e0065-s3-1 Waiting
|
||||
Container lab4-check-5aad8e0065-migrate-1 Started
|
||||
Container lab4-check-5aad8e0065-s3-1 Healthy
|
||||
Container lab4-check-5aad8e0065-s3-bootstrap-1 Starting
|
||||
Container lab4-check-5aad8e0065-s3-bootstrap-1 Started
|
||||
Container lab4-check-5aad8e0065-valkey-1 Waiting
|
||||
Container lab4-check-5aad8e0065-migrate-1 Waiting
|
||||
Container lab4-check-5aad8e0065-migrate-1 Waiting
|
||||
Container lab4-check-5aad8e0065-s3-1 Waiting
|
||||
Container lab4-check-5aad8e0065-s3-bootstrap-1 Waiting
|
||||
Container lab4-check-5aad8e0065-s3-bootstrap-1 Waiting
|
||||
Container lab4-check-5aad8e0065-postgres-1 Waiting
|
||||
Container lab4-check-5aad8e0065-migrate-1 Exited
|
||||
Container lab4-check-5aad8e0065-valkey-1 Healthy
|
||||
Container lab4-check-5aad8e0065-migrate-1 Exited
|
||||
Container lab4-check-5aad8e0065-s3-1 Healthy
|
||||
Container lab4-check-5aad8e0065-postgres-1 Healthy
|
||||
Container lab4-check-5aad8e0065-s3-bootstrap-1 Exited
|
||||
Container lab4-check-5aad8e0065-s3-bootstrap-1 Exited
|
||||
/Users/vanek/Desktop/VNPlabs/VNPlab4/mtusi2026lab4/.venv/bin/python tests/resilience.py --mode persistence --action-script "scripts/restart.sh" --base-url "http://127.0.0.1:57722"
|
||||
Executing explicit persistence hook; hook output suppressed to avoid leaking secrets.
|
||||
PASS: persistence preserved confirmed data and existing session. Hook scope needs operator evidence.
|
||||
PASS: both API, LB, PostgreSQL, Valkey, S3 and cleaner actually restarted; data and session preserved
|
||||
PASS: SIGTERM with unfinished request: {"instance": "19a474c69210", "unfinished_request": true, "shutdown_seconds": 5.523, "new_connections_refused_seconds": 0.185, "exit_code": 0, "oom_killed": false}
|
||||
Container lab4-check-5aad8e0065-s3-storage-1 Waiting
|
||||
Container lab4-check-5aad8e0065-postgres-1 Waiting
|
||||
Container lab4-check-5aad8e0065-postgres-1 Healthy
|
||||
Container lab4-check-5aad8e0065-s3-storage-1 Healthy
|
||||
Container lab4-check-5aad8e0065-migrate-1 Starting
|
||||
Container lab4-check-5aad8e0065-s3-1 Waiting
|
||||
Container lab4-check-5aad8e0065-migrate-1 Started
|
||||
Container lab4-check-5aad8e0065-s3-1 Healthy
|
||||
Container lab4-check-5aad8e0065-s3-bootstrap-1 Starting
|
||||
Container lab4-check-5aad8e0065-s3-bootstrap-1 Started
|
||||
Container lab4-check-5aad8e0065-postgres-1 Waiting
|
||||
Container lab4-check-5aad8e0065-valkey-1 Waiting
|
||||
Container lab4-check-5aad8e0065-migrate-1 Waiting
|
||||
Container lab4-check-5aad8e0065-s3-1 Waiting
|
||||
Container lab4-check-5aad8e0065-s3-bootstrap-1 Waiting
|
||||
Container lab4-check-5aad8e0065-valkey-1 Healthy
|
||||
Container lab4-check-5aad8e0065-migrate-1 Exited
|
||||
Container lab4-check-5aad8e0065-s3-1 Healthy
|
||||
Container lab4-check-5aad8e0065-postgres-1 Healthy
|
||||
Container lab4-check-5aad8e0065-s3-bootstrap-1 Exited
|
||||
Container lab4-check-5aad8e0065-api-1 Starting
|
||||
Container lab4-check-5aad8e0065-api-1 Started
|
||||
API ready through LB: 19a474c69210, ca1f62dfc015
|
||||
Container lab4-check-5aad8e0065-valkey-1 Stopping
|
||||
Container lab4-check-5aad8e0065-valkey-1 Stopped
|
||||
PASS: valkey outage: API live=200, ready=503, LB ready=503
|
||||
Container lab4-check-5aad8e0065-valkey-1 Starting
|
||||
Container lab4-check-5aad8e0065-valkey-1 Started
|
||||
API ready through LB: 19a474c69210, ca1f62dfc015
|
||||
Container lab4-check-5aad8e0065-postgres-1 Stopping
|
||||
Container lab4-check-5aad8e0065-postgres-1 Stopped
|
||||
PASS: postgres outage: API live=200, ready=503, LB ready=503
|
||||
Container lab4-check-5aad8e0065-postgres-1 Starting
|
||||
Container lab4-check-5aad8e0065-postgres-1 Started
|
||||
API ready through LB: 19a474c69210, ca1f62dfc015
|
||||
Container lab4-check-5aad8e0065-s3-1 Stopping
|
||||
Container lab4-check-5aad8e0065-s3-1 Stopped
|
||||
PASS: s3 outage: API live=200, ready=503, LB ready=503
|
||||
Container lab4-check-5aad8e0065-s3-storage-1 Waiting
|
||||
Container lab4-check-5aad8e0065-s3-storage-1 Healthy
|
||||
Container lab4-check-5aad8e0065-s3-1 Starting
|
||||
Container lab4-check-5aad8e0065-s3-1 Started
|
||||
API ready through LB: 19a474c69210, ca1f62dfc015
|
||||
Container lab4-check-5aad8e0065-postgres-1 Paused
|
||||
Container lab4-check-5aad8e0065-postgres-1 Unpaused
|
||||
PASS: paused PostgreSQL: SQL and direct readiness bounded; live works; unpause restores API without restart
|
||||
/Users/vanek/Desktop/VNPlabs/VNPlab4/mtusi2026lab4/.venv/bin/python tests/resilience.py --mode failover --action-script "scripts/stop-one.sh" --base-url "http://127.0.0.1:57722"
|
||||
Executing explicit failover hook; hook output suppressed to avoid leaking secrets.
|
||||
{"observed_instances_before": 2, "successful_writes": 110, "failed_attempts": 1, "first_recovery_seconds": 2.467}
|
||||
PASS: failover preserved confirmed data and existing session. Hook scope needs operator evidence.
|
||||
Container lab4-check-5aad8e0065-s3-storage-1 Waiting
|
||||
Container lab4-check-5aad8e0065-postgres-1 Waiting
|
||||
Container lab4-check-5aad8e0065-s3-storage-1 Healthy
|
||||
Container lab4-check-5aad8e0065-s3-1 Waiting
|
||||
Container lab4-check-5aad8e0065-postgres-1 Healthy
|
||||
Container lab4-check-5aad8e0065-migrate-1 Starting
|
||||
Container lab4-check-5aad8e0065-migrate-1 Started
|
||||
Container lab4-check-5aad8e0065-s3-1 Healthy
|
||||
Container lab4-check-5aad8e0065-s3-bootstrap-1 Starting
|
||||
Container lab4-check-5aad8e0065-s3-bootstrap-1 Started
|
||||
Container lab4-check-5aad8e0065-postgres-1 Waiting
|
||||
Container lab4-check-5aad8e0065-valkey-1 Waiting
|
||||
Container lab4-check-5aad8e0065-migrate-1 Waiting
|
||||
Container lab4-check-5aad8e0065-s3-1 Waiting
|
||||
Container lab4-check-5aad8e0065-s3-bootstrap-1 Waiting
|
||||
Container lab4-check-5aad8e0065-valkey-1 Healthy
|
||||
Container lab4-check-5aad8e0065-migrate-1 Exited
|
||||
Container lab4-check-5aad8e0065-postgres-1 Healthy
|
||||
Container lab4-check-5aad8e0065-s3-1 Healthy
|
||||
Container lab4-check-5aad8e0065-s3-bootstrap-1 Exited
|
||||
Container lab4-check-5aad8e0065-api-1 Starting
|
||||
Container lab4-check-5aad8e0065-api-1 Started
|
||||
API ready through LB: 19a474c69210, ca1f62dfc015
|
||||
Stopped API: 19a474c69210 container=19a474c69210a7be1c6631830e8fa7f251cf6dd3890c7407843090383543ee75
|
||||
{"label": "stop 19a474c69210", "duration_seconds": 16.012, "successful_requests": 1420, "successful_writes": 709, "errors": 4, "successful_rps": 88.68, "first_success_after_action_seconds": {"POST": 0.051, "GET": 0.004}, "maximum_success_gap_seconds": {"POST": 2.002, "GET": 1.995}, "action_start_seconds": 1.006, "action_end_seconds": 1.77, "p50_ms": 10.62, "p95_ms": 24.67, "confirmed_data_preserved": true, "duplicate_messages": 0, "instances": ["19a474c69210", "ca1f62dfc015"]}
|
||||
Container lab4-check-5aad8e0065-postgres-1 Waiting
|
||||
Container lab4-check-5aad8e0065-s3-storage-1 Waiting
|
||||
Container lab4-check-5aad8e0065-s3-storage-1 Healthy
|
||||
Container lab4-check-5aad8e0065-postgres-1 Healthy
|
||||
Container lab4-check-5aad8e0065-s3-1 Waiting
|
||||
Container lab4-check-5aad8e0065-migrate-1 Starting
|
||||
Container lab4-check-5aad8e0065-migrate-1 Started
|
||||
Container lab4-check-5aad8e0065-s3-1 Healthy
|
||||
Container lab4-check-5aad8e0065-s3-bootstrap-1 Starting
|
||||
Container lab4-check-5aad8e0065-s3-bootstrap-1 Started
|
||||
Container lab4-check-5aad8e0065-s3-1 Waiting
|
||||
Container lab4-check-5aad8e0065-s3-bootstrap-1 Waiting
|
||||
Container lab4-check-5aad8e0065-postgres-1 Waiting
|
||||
Container lab4-check-5aad8e0065-valkey-1 Waiting
|
||||
Container lab4-check-5aad8e0065-migrate-1 Waiting
|
||||
Container lab4-check-5aad8e0065-valkey-1 Healthy
|
||||
Container lab4-check-5aad8e0065-postgres-1 Healthy
|
||||
Container lab4-check-5aad8e0065-migrate-1 Exited
|
||||
Container lab4-check-5aad8e0065-s3-1 Healthy
|
||||
Container lab4-check-5aad8e0065-s3-bootstrap-1 Exited
|
||||
Container lab4-check-5aad8e0065-api-1 Starting
|
||||
Container lab4-check-5aad8e0065-api-1 Started
|
||||
API ready through LB: 19a474c69210, ca1f62dfc015
|
||||
Stopped API: ca1f62dfc015 container=ca1f62dfc0156fc235dbcd2f52b58eec2282e6ba8d3e056de11ca92758c69df0
|
||||
{"label": "stop ca1f62dfc015", "duration_seconds": 16.008, "successful_requests": 1466, "successful_writes": 732, "errors": 4, "successful_rps": 91.58, "first_success_after_action_seconds": {"POST": 0.018, "GET": 0.028}, "maximum_success_gap_seconds": {"POST": 2.002, "GET": 1.999}, "action_start_seconds": 1.002, "action_end_seconds": 1.832, "p50_ms": 9.397, "p95_ms": 18.616, "confirmed_data_preserved": true, "duplicate_messages": 0, "instances": ["19a474c69210", "ca1f62dfc015"]}
|
||||
Container lab4-check-5aad8e0065-s3-storage-1 Waiting
|
||||
Container lab4-check-5aad8e0065-postgres-1 Waiting
|
||||
Container lab4-check-5aad8e0065-postgres-1 Healthy
|
||||
Container lab4-check-5aad8e0065-s3-storage-1 Healthy
|
||||
Container lab4-check-5aad8e0065-migrate-1 Starting
|
||||
Container lab4-check-5aad8e0065-s3-1 Waiting
|
||||
Container lab4-check-5aad8e0065-migrate-1 Started
|
||||
Container lab4-check-5aad8e0065-s3-1 Healthy
|
||||
Container lab4-check-5aad8e0065-s3-bootstrap-1 Starting
|
||||
Container lab4-check-5aad8e0065-s3-bootstrap-1 Started
|
||||
Container lab4-check-5aad8e0065-postgres-1 Waiting
|
||||
Container lab4-check-5aad8e0065-valkey-1 Waiting
|
||||
Container lab4-check-5aad8e0065-migrate-1 Waiting
|
||||
Container lab4-check-5aad8e0065-s3-1 Waiting
|
||||
Container lab4-check-5aad8e0065-s3-bootstrap-1 Waiting
|
||||
Container lab4-check-5aad8e0065-valkey-1 Healthy
|
||||
Container lab4-check-5aad8e0065-postgres-1 Healthy
|
||||
Container lab4-check-5aad8e0065-s3-1 Healthy
|
||||
Container lab4-check-5aad8e0065-migrate-1 Exited
|
||||
Container lab4-check-5aad8e0065-s3-bootstrap-1 Exited
|
||||
Container lab4-check-5aad8e0065-api-2 Starting
|
||||
Container lab4-check-5aad8e0065-api-2 Started
|
||||
API ready through LB: 19a474c69210, ca1f62dfc015
|
||||
Local .env and secrets are ready; values are not printed
|
||||
#1 [internal] load local bake definitions
|
||||
#1 reading from stdin 564B done
|
||||
#1 DONE 0.0s
|
||||
|
||||
#2 [internal] load build definition from Dockerfile
|
||||
#2 transferring dockerfile: 733B done
|
||||
#2 DONE 0.0s
|
||||
|
||||
#3 [internal] load metadata for docker.io/library/python:3.11.15-slim-bookworm@sha256:d29f48a31a8b408ed19272ca1e7b10ebae13b240a27e862d3d4217c528e2e0c3
|
||||
#3 DONE 0.0s
|
||||
|
||||
#4 [internal] load .dockerignore
|
||||
#4 transferring context: 167B done
|
||||
#4 DONE 0.0s
|
||||
|
||||
#5 [internal] load build context
|
||||
#5 transferring context: 1.01kB done
|
||||
#5 DONE 0.0s
|
||||
|
||||
#6 [1/8] FROM docker.io/library/python:3.11.15-slim-bookworm@sha256:d29f48a31a8b408ed19272ca1e7b10ebae13b240a27e862d3d4217c528e2e0c3
|
||||
#6 resolve docker.io/library/python:3.11.15-slim-bookworm@sha256:d29f48a31a8b408ed19272ca1e7b10ebae13b240a27e862d3d4217c528e2e0c3 0.0s done
|
||||
#6 DONE 0.0s
|
||||
|
||||
#7 [3/8] COPY requirements.txt .
|
||||
#7 CACHED
|
||||
|
||||
#8 [6/8] COPY src/ ./src/
|
||||
#8 CACHED
|
||||
|
||||
#9 [2/8] WORKDIR /app
|
||||
#9 CACHED
|
||||
|
||||
#10 [7/8] COPY migrations/ ./migrations/
|
||||
#10 CACHED
|
||||
|
||||
#11 [5/8] RUN groupadd --gid 10001 app && useradd --uid 10001 --gid app --no-create-home app
|
||||
#11 CACHED
|
||||
|
||||
#12 [4/8] RUN python -m pip install --no-cache-dir -r requirements.txt && python -m pip check
|
||||
#12 CACHED
|
||||
|
||||
#13 [8/8] COPY research/ ./research/
|
||||
#13 CACHED
|
||||
|
||||
#14 exporting to image
|
||||
#14 exporting layers done
|
||||
#14 exporting manifest sha256:644f5d408505f5982b75f18404860de692ee837b2b2e18f5c92b0b057081b7ec done
|
||||
#14 exporting config sha256:726011343b32f5b6277348f2f8b38f95b8c31754ae0d21336375124a18aa2e0e done
|
||||
#14 exporting attestation manifest sha256:f4a5559518ea1ef0e3747d6084c8ad8dbc8b16dc41cb00062303d0f895b9a235 0.0s done
|
||||
#14 exporting manifest list sha256:93c838d55d79a0001346ecab28f72621d9540ba5c52eaeb1ca6020286dd05fd6 done
|
||||
#14 naming to docker.io/library/mtusi-messenger:lab4 done
|
||||
#14 unpacking to docker.io/library/mtusi-messenger:lab4 done
|
||||
#14 DONE 0.1s
|
||||
|
||||
#15 resolving provenance for metadata file
|
||||
#15 DONE 0.0s
|
||||
mtusi-messenger:lab4 Built
|
||||
Container lab4-check-5aad8e0065-postgres-1 Running
|
||||
Migrations: already applied
|
||||
API ready through LB: 19a474c69210, ca1f62dfc015
|
||||
Replacing API: 19a474c69210
|
||||
Container lab4-check-5aad8e0065-api-2 Running
|
||||
Container lab4-check-5aad8e0065-api-3 Creating
|
||||
Container lab4-check-5aad8e0065-api-3 Created
|
||||
Container lab4-check-5aad8e0065-api-3 Starting
|
||||
Container lab4-check-5aad8e0065-api-3 Started
|
||||
API ready through LB: ca1f62dfc015, ed4f3c64a9f6
|
||||
Replacing API: ca1f62dfc015
|
||||
Container lab4-check-5aad8e0065-api-3 Running
|
||||
Container lab4-check-5aad8e0065-api-4 Creating
|
||||
Container lab4-check-5aad8e0065-api-4 Created
|
||||
Container lab4-check-5aad8e0065-api-4 Starting
|
||||
Container lab4-check-5aad8e0065-api-4 Started
|
||||
API ready through LB: 63549c0d63ba, ed4f3c64a9f6
|
||||
PASS: all API containers replaced sequentially; stores and LB kept running
|
||||
{"label": "sequential API replacement", "duration_seconds": 24.869, "successful_requests": 2254, "successful_writes": 1128, "errors": 8, "successful_rps": 90.63, "first_success_after_action_seconds": {"POST": 0.01, "GET": 0.021}, "maximum_success_gap_seconds": {"POST": 1.04, "GET": 1.04}, "action_start_seconds": 1.009, "action_end_seconds": 21.862, "p50_ms": 8.907, "p95_ms": 16.321, "confirmed_data_preserved": true, "duplicate_messages": 0, "instances": ["19a474c69210", "63549c0d63ba", "ca1f62dfc015", "ed4f3c64a9f6"]}
|
||||
PASS: all lab4 grade-4 checks completed
|
||||
Container lab4-check-5aad8e0065-lb-1 Stopping
|
||||
Container lab4-check-5aad8e0065-cleanup-1 Stopping
|
||||
Container lab4-check-5aad8e0065-lb-1 Stopped
|
||||
Container lab4-check-5aad8e0065-lb-1 Removing
|
||||
Container lab4-check-5aad8e0065-lb-1 Removed
|
||||
Container lab4-check-5aad8e0065-api-3 Stopping
|
||||
Container lab4-check-5aad8e0065-api-4 Stopping
|
||||
Container lab4-check-5aad8e0065-api-3 Stopped
|
||||
Container lab4-check-5aad8e0065-api-3 Removing
|
||||
Container lab4-check-5aad8e0065-api-3 Removed
|
||||
Container lab4-check-5aad8e0065-api-4 Stopped
|
||||
Container lab4-check-5aad8e0065-api-4 Removing
|
||||
Container lab4-check-5aad8e0065-api-4 Removed
|
||||
Container lab4-check-5aad8e0065-valkey-1 Stopping
|
||||
Container lab4-check-5aad8e0065-valkey-1 Stopped
|
||||
Container lab4-check-5aad8e0065-valkey-1 Removing
|
||||
Container lab4-check-5aad8e0065-valkey-1 Removed
|
||||
Container lab4-check-5aad8e0065-cleanup-1 Stopped
|
||||
Container lab4-check-5aad8e0065-cleanup-1 Removing
|
||||
Container lab4-check-5aad8e0065-cleanup-1 Removed
|
||||
Container lab4-check-5aad8e0065-s3-bootstrap-1 Stopping
|
||||
Container lab4-check-5aad8e0065-migrate-1 Stopping
|
||||
Container lab4-check-5aad8e0065-migrate-1 Stopped
|
||||
Container lab4-check-5aad8e0065-migrate-1 Removing
|
||||
Container lab4-check-5aad8e0065-s3-bootstrap-1 Stopped
|
||||
Container lab4-check-5aad8e0065-s3-bootstrap-1 Removing
|
||||
Container lab4-check-5aad8e0065-s3-bootstrap-1 Removed
|
||||
Container lab4-check-5aad8e0065-s3-1 Stopping
|
||||
Container lab4-check-5aad8e0065-migrate-1 Removed
|
||||
Container lab4-check-5aad8e0065-postgres-1 Stopping
|
||||
Container lab4-check-5aad8e0065-postgres-1 Stopped
|
||||
Container lab4-check-5aad8e0065-postgres-1 Removing
|
||||
Container lab4-check-5aad8e0065-postgres-1 Removed
|
||||
Container lab4-check-5aad8e0065-s3-1 Stopped
|
||||
Container lab4-check-5aad8e0065-s3-1 Removing
|
||||
Container lab4-check-5aad8e0065-s3-1 Removed
|
||||
Container lab4-check-5aad8e0065-s3-storage-1 Stopping
|
||||
Container lab4-check-5aad8e0065-s3-storage-1 Stopped
|
||||
Container lab4-check-5aad8e0065-s3-storage-1 Removing
|
||||
Container lab4-check-5aad8e0065-s3-storage-1 Removed
|
||||
Volume lab4-check-5aad8e0065_valkey_data Removing
|
||||
Network lab4-check-5aad8e0065_s3-internal Removing
|
||||
Volume lab4-check-5aad8e0065_postgres_data Removing
|
||||
Volume lab4-check-5aad8e0065_s3_data Removing
|
||||
Network lab4-check-5aad8e0065_default Removing
|
||||
Volume lab4-check-5aad8e0065_valkey_data Removed
|
||||
Volume lab4-check-5aad8e0065_s3_data Removed
|
||||
Volume lab4-check-5aad8e0065_postgres_data Removed
|
||||
Network lab4-check-5aad8e0065_s3-internal Removed
|
||||
Network lab4-check-5aad8e0065_default Removed
|
||||
Removed only temporary test containers and volumes: lab4-check-5aad8e0065
|
||||
@@ -0,0 +1,76 @@
|
||||
{
|
||||
"utc": "2026-11-06T07:27:40.514878+00:00",
|
||||
"project": "lab4-pg-pause-30f1d978ce",
|
||||
"command": ".venv/bin/python student-tests/postgres_pause.py",
|
||||
"passed": true,
|
||||
"sql_without_server_timeout": {
|
||||
"elapsed_seconds": 2.001,
|
||||
"connection_closed": true
|
||||
},
|
||||
"direct_ready": {
|
||||
"status": 503,
|
||||
"elapsed_seconds": 2.012
|
||||
},
|
||||
"direct_live": {
|
||||
"status": 200,
|
||||
"elapsed_seconds": 0.006
|
||||
},
|
||||
"repeated_ready": [
|
||||
{
|
||||
"status": 503,
|
||||
"elapsed_seconds": 2.11
|
||||
},
|
||||
{
|
||||
"status": 503,
|
||||
"elapsed_seconds": 2.011
|
||||
},
|
||||
{
|
||||
"status": 503,
|
||||
"elapsed_seconds": 2.014
|
||||
},
|
||||
{
|
||||
"status": 503,
|
||||
"elapsed_seconds": 2.097
|
||||
},
|
||||
{
|
||||
"status": 503,
|
||||
"elapsed_seconds": 2.194
|
||||
},
|
||||
{
|
||||
"status": 503,
|
||||
"elapsed_seconds": 2.013
|
||||
},
|
||||
{
|
||||
"status": 503,
|
||||
"elapsed_seconds": 2.299
|
||||
},
|
||||
{
|
||||
"status": 503,
|
||||
"elapsed_seconds": 2.203
|
||||
},
|
||||
{
|
||||
"status": 503,
|
||||
"elapsed_seconds": 2.013
|
||||
},
|
||||
{
|
||||
"status": 503,
|
||||
"elapsed_seconds": 2.094
|
||||
}
|
||||
],
|
||||
"ready_after_12_seconds": {
|
||||
"status": 503,
|
||||
"elapsed_seconds": 0.009
|
||||
},
|
||||
"live_after_repeated_requests": {
|
||||
"status": 200,
|
||||
"elapsed_seconds": 0.006
|
||||
},
|
||||
"paused_seconds": 12.565,
|
||||
"recovered_ready": {
|
||||
"status": 200,
|
||||
"elapsed_seconds": 0.009
|
||||
},
|
||||
"recovery_seconds": 2.874,
|
||||
"api_not_restarted": true,
|
||||
"existing_session_and_message_preserved": true
|
||||
}
|
||||
File diff suppressed because it is too large
Load Diff
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,32 @@
|
||||
Research project: lab2-research-85021a09d9
|
||||
Measuring two indexes on the same 100000 messages, three repeats...
|
||||
{
|
||||
"chat_only": {
|
||||
"insert_100000_median_ms": 1386.7587500000127,
|
||||
"index_bytes": 671744,
|
||||
"wal_bytes_median": 38822560,
|
||||
"queries": 180,
|
||||
"errors": 0,
|
||||
"concurrency": 1,
|
||||
"p50_ms": 1.6852079999978287,
|
||||
"p95_ms": 7.566457999985232,
|
||||
"p99_ms": 46.40233399999261,
|
||||
"successful_sql_rps": 282.01364182715855
|
||||
},
|
||||
"history": {
|
||||
"insert_100000_median_ms": 1404.4910420000178,
|
||||
"index_bytes": 7315456,
|
||||
"wal_bytes_median": 43108512,
|
||||
"queries": 180,
|
||||
"errors": 0,
|
||||
"concurrency": 1,
|
||||
"p50_ms": 0.22610399997802233,
|
||||
"p95_ms": 0.29704099995342403,
|
||||
"p99_ms": 0.3384169999662845,
|
||||
"successful_sql_rps": 4322.810483886352
|
||||
}
|
||||
}
|
||||
PASS: backup 0.54s; restore 0.68s; 100000 messages, all hashes and 12 samples match
|
||||
PASS: restored into a different container and fresh volume; one post-backup commit is absent as expected
|
||||
Results: evidence/research.json, evidence/query-plans.json; dump stays outside Git in backups/
|
||||
Removed only temporary research project: lab2-research-85021a09d9
|
||||
@@ -0,0 +1,40 @@
|
||||
global
|
||||
log stdout format raw local0
|
||||
maxconn 256
|
||||
|
||||
defaults
|
||||
mode http
|
||||
log global
|
||||
option dontlognull
|
||||
option http-server-close
|
||||
timeout connect 1s
|
||||
timeout client 40s
|
||||
timeout server 60s
|
||||
timeout http-request 5s
|
||||
timeout check 1s
|
||||
retries 1
|
||||
|
||||
resolvers docker
|
||||
nameserver dns 127.0.0.11:53
|
||||
accepted_payload_size 8192
|
||||
resolve_retries 3
|
||||
timeout resolve 1s
|
||||
timeout retry 1s
|
||||
hold valid 1s
|
||||
hold obsolete 1s
|
||||
hold nx 1s
|
||||
hold timeout 1s
|
||||
hold refused 1s
|
||||
hold other 1s
|
||||
|
||||
frontend public
|
||||
bind :8080
|
||||
default_backend api
|
||||
|
||||
backend api
|
||||
balance roundrobin
|
||||
option httpchk
|
||||
http-check send meth GET uri /health/ready ver HTTP/1.1 hdr Host localhost
|
||||
http-check expect status 200
|
||||
default-server inter 1s fastinter 1s downinter 1s fall 2 rise 2
|
||||
server-template replica 10 api:8080 check resolvers docker resolve-prefer ipv4 init-addr none
|
||||
@@ -0,0 +1,30 @@
|
||||
CREATE TABLE users (
|
||||
id uuid PRIMARY KEY,
|
||||
username varchar(32) NOT NULL UNIQUE CHECK (username ~ '^[a-z0-9_]{3,32}$'),
|
||||
display_name varchar(100) NOT NULL CHECK (char_length(display_name) >= 1),
|
||||
password_hash text NOT NULL,
|
||||
created_at timestamptz NOT NULL DEFAULT clock_timestamp()
|
||||
);
|
||||
|
||||
CREATE TABLE chats (
|
||||
id uuid PRIMARY KEY,
|
||||
title varchar(100) NOT NULL CHECK (char_length(title) >= 1),
|
||||
created_at timestamptz NOT NULL DEFAULT clock_timestamp()
|
||||
);
|
||||
|
||||
CREATE TABLE chat_members (
|
||||
chat_id uuid NOT NULL REFERENCES chats(id) ON DELETE CASCADE,
|
||||
user_id uuid NOT NULL REFERENCES users(id),
|
||||
PRIMARY KEY (chat_id, user_id)
|
||||
);
|
||||
CREATE INDEX chat_members_user_idx ON chat_members (user_id, 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,
|
||||
text text NOT NULL CHECK (char_length(text) BETWEEN 1 AND 4000 AND text !~ '^\s*$'),
|
||||
created_at timestamptz NOT NULL DEFAULT clock_timestamp(),
|
||||
FOREIGN KEY (chat_id, sender_id) REFERENCES chat_members(chat_id, user_id)
|
||||
);
|
||||
CREATE INDEX messages_history_idx ON messages (chat_id, created_at, id);
|
||||
@@ -0,0 +1,10 @@
|
||||
-- Добавочная миграция: существующие данные и таблицы lab2 сохраняются.
|
||||
CREATE TABLE message_idempotency (
|
||||
user_id uuid NOT NULL REFERENCES users(id),
|
||||
chat_id uuid NOT NULL REFERENCES chats(id) ON DELETE CASCADE,
|
||||
key varchar(128) NOT NULL CHECK (key ~ '^[A-Za-z0-9._:-]{1,128}$'),
|
||||
request_text text NOT NULL,
|
||||
message_id uuid NOT NULL REFERENCES messages(id) ON DELETE CASCADE,
|
||||
expires_at timestamptz NOT NULL,
|
||||
PRIMARY KEY (user_id, chat_id, key)
|
||||
);
|
||||
@@ -0,0 +1,34 @@
|
||||
-- Только добавления к lab3; старые сообщения и ключи сохраняются.
|
||||
CREATE TABLE attachments (
|
||||
id uuid PRIMARY KEY,
|
||||
chat_id uuid NOT NULL REFERENCES chats(id),
|
||||
owner_id uuid NOT NULL,
|
||||
object_key text NOT NULL UNIQUE,
|
||||
filename varchar(255) NOT NULL,
|
||||
content_type text NOT NULL CHECK (content_type IN ('image/png', 'image/jpeg')),
|
||||
size_bytes integer NOT NULL CHECK (size_bytes BETWEEN 1 AND 10485760),
|
||||
sha256 char(64) NOT NULL CHECK (sha256 ~ '^[a-f0-9]{64}$'),
|
||||
created_at timestamptz NOT NULL DEFAULT clock_timestamp(),
|
||||
FOREIGN KEY (chat_id, owner_id) REFERENCES chat_members(chat_id, user_id)
|
||||
);
|
||||
CREATE INDEX attachments_chat_idx ON attachments(chat_id);
|
||||
|
||||
ALTER TABLE messages DROP CONSTRAINT messages_text_check;
|
||||
ALTER TABLE messages ADD CONSTRAINT messages_text_check CHECK (char_length(text) <= 4000);
|
||||
CREATE TABLE message_attachments (
|
||||
message_id uuid NOT NULL REFERENCES messages(id) ON DELETE CASCADE,
|
||||
attachment_id uuid NOT NULL REFERENCES attachments(id),
|
||||
position integer NOT NULL CHECK (position BETWEEN 0 AND 9),
|
||||
PRIMARY KEY (message_id, attachment_id),
|
||||
UNIQUE (message_id, position)
|
||||
);
|
||||
ALTER TABLE message_idempotency
|
||||
ADD COLUMN request_attachment_ids uuid[] NOT NULL DEFAULT '{}';
|
||||
|
||||
-- Фиксируется ДО S3 PUT. После COMMIT ready-метаданных удаляется атомарно с ними.
|
||||
CREATE TABLE attachment_uploads (
|
||||
id uuid PRIMARY KEY,
|
||||
object_key text NOT NULL UNIQUE,
|
||||
created_at timestamptz NOT NULL DEFAULT clock_timestamp()
|
||||
);
|
||||
CREATE INDEX attachment_uploads_created_idx ON attachment_uploads(created_at);
|
||||
@@ -0,0 +1,36 @@
|
||||
# Основные библиотеки
|
||||
fastapi==0.142.4
|
||||
uvicorn==0.54.0
|
||||
pydantic==2.13.5
|
||||
|
||||
# Их зависимости
|
||||
annotated-doc==0.0.5
|
||||
annotated-types==0.8.0
|
||||
anyio==4.15.1
|
||||
click==8.5.0
|
||||
h11==0.16.0
|
||||
idna==3.20
|
||||
opentelemetry-api==1.45.1
|
||||
pydantic-core==2.46.5
|
||||
starlette==1.7.0
|
||||
typing-extensions==4.16.0
|
||||
typing-inspection==0.4.4
|
||||
|
||||
# PostgreSQL, сессии и Argon2id
|
||||
psycopg[binary,pool]==3.3.6
|
||||
redis==8.1.0
|
||||
argon2-cffi==25.1.0
|
||||
|
||||
# Транзитивные зависимости новых библиотек
|
||||
psycopg-binary==3.3.6
|
||||
psycopg-pool==3.3.3
|
||||
argon2-cffi-bindings==26.1.0
|
||||
cffi==2.1.1
|
||||
pycparser==3.11
|
||||
|
||||
# S3 и проверка настоящих PNG/JPEG (без изменения оригинала)
|
||||
minio==7.2.20
|
||||
Pillow==13.0.0
|
||||
certifi==2026.10.23
|
||||
pycryptodome==4.3.0
|
||||
urllib3==2.8.0
|
||||
@@ -0,0 +1,12 @@
|
||||
# Трек 2 на оценку 5
|
||||
|
||||
Запуск из корня: `./scripts/research.sh`. Нужны Docker Compose, Python 3 и интернет для первой сборки. Скрипт собирает API-образ и использует отдельный Compose project с новыми volumes. Текущий стенд не участвует.
|
||||
|
||||
- run.py управляет контейнерами, pg_dump, pg_restore, файлами evidence и cleanup.
|
||||
- benchmark.py выполняет SQL и сверку внутри API-образа. Перед заполнением требует пустую БД. Исследовательский флаг устанавливает только драйвер.
|
||||
|
||||
Датасет: 100000 сообщений в 4 чатах (70000/20000/9000/1000). Сравниваются индекс chat_id и индекс (chat_id,created_at,id), по 3 повтора с одинаковыми ограничениями и записями. На каждый чат — страницы около 10/50/90%, один прогрев и пять измерений, 51 строка. Измеряется INSERT SELECT с COMMIT, WAL и размер индекса. EXPLAIN и основные цифры сохраняются в evidence.
|
||||
|
||||
После dump создаётся ещё одно сообщение. Backup восстанавливается в другой контейнер и свежий volume. Сравниваются все счётчики, 12 полных записей и SHA-256 всех сообщений. Последующая запись ожидаемо отсутствует в восстановленном снимке.
|
||||
|
||||
Файлы research.json, query-plans.json и research.txt обновляются автоматически. Dump остаётся в игнорируемом backups/. Временные исследовательские volumes удаляются после проверки. Методика, фактические результаты и ограничения лабораторной 2 описаны в [REPORT.lab2.md](../REPORT.lab2.md).
|
||||
@@ -0,0 +1,168 @@
|
||||
"""SQL-эксперимент запускается только в отдельном research Compose project."""
|
||||
from datetime import datetime, timedelta, timezone
|
||||
import hashlib
|
||||
import json
|
||||
import os
|
||||
import secrets
|
||||
import statistics
|
||||
import sys
|
||||
import time
|
||||
from uuid import UUID
|
||||
|
||||
import psycopg
|
||||
from psycopg.conninfo import make_conninfo
|
||||
from psycopg.rows import dict_row
|
||||
|
||||
from src import db, migrate, passwords
|
||||
from src.config import secret
|
||||
|
||||
|
||||
SIZES = [70000, 20000, 9000, 1000]
|
||||
START = datetime(2026, 1, 1, tzinfo=timezone.utc)
|
||||
QUERY = """SELECT * FROM messages WHERE chat_id=%s AND (created_at, id)>(%s, %s)
|
||||
ORDER BY created_at, id LIMIT %s"""
|
||||
|
||||
|
||||
def identifier(value):
|
||||
return UUID(hashlib.md5(value.encode(), usedforsecurity=False).hexdigest())
|
||||
|
||||
|
||||
def connect(restored=False):
|
||||
url = secret("DATABASE_URL")
|
||||
if restored:
|
||||
url = make_conninfo(url, host="postgres-restore")
|
||||
return psycopg.connect(url, autocommit=True, row_factory=dict_row,
|
||||
options="-c timezone=UTC -c statement_timeout=120000")
|
||||
|
||||
|
||||
def snapshot(conn):
|
||||
counts = {}
|
||||
for table in ("users", "chats", "chat_members", "messages", "schema_migrations"):
|
||||
# Имена таблиц — фиксированный список выше, не входные данные клиента.
|
||||
counts[table] = conn.execute("SELECT count(*) AS n FROM " + table).fetchone()["n"]
|
||||
digest = hashlib.sha256()
|
||||
for row in conn.execute("SELECT * FROM messages ORDER BY id"):
|
||||
digest.update((json.dumps(row, default=str, sort_keys=True, ensure_ascii=False) + "\n").encode())
|
||||
samples = []
|
||||
offset = 0
|
||||
for size in SIZES:
|
||||
for number in (offset + 1, offset + size // 2, offset + size):
|
||||
row = conn.execute("SELECT * FROM messages WHERE id=%s", (identifier(f"message:{number}"),)).fetchone()
|
||||
samples.append(json.loads(json.dumps(row, default=str, sort_keys=True, ensure_ascii=False)))
|
||||
offset += size
|
||||
return {"counts": counts, "messages_sha256": digest.hexdigest(), "samples": samples}
|
||||
|
||||
|
||||
def benchmark():
|
||||
db.pool.open(wait=True, timeout=15)
|
||||
try:
|
||||
migrate.apply()
|
||||
finally:
|
||||
db.pool.close()
|
||||
results, plans = [], []
|
||||
with connect() as conn:
|
||||
assert conn.execute("SELECT count(*) AS n FROM users").fetchone()["n"] == 0, "Research requires an empty database"
|
||||
encoded = passwords.hash_password(secrets.token_urlsafe(24))
|
||||
for n in range(1, 11):
|
||||
conn.execute("INSERT INTO users(id,username,display_name,password_hash) VALUES(%s,%s,%s,%s)",
|
||||
(identifier(f"user:{n}"), f"research_{n}", "Synthetic research user", encoded))
|
||||
for n in range(4):
|
||||
chat = identifier(f"chat:{n}")
|
||||
conn.execute("INSERT INTO chats(id,title) VALUES(%s,%s)", (chat, f"Research chat {n}"))
|
||||
for user in (1, 2):
|
||||
conn.execute("INSERT INTO chat_members(chat_id,user_id) VALUES(%s,%s)", (chat, identifier(f"user:{user}")))
|
||||
variants = [("chat_only", "chat_id"), ("history", "chat_id, created_at, id")]
|
||||
for repeat in range(3):
|
||||
order = variants if repeat % 2 == 0 else variants[::-1]
|
||||
for variant, columns in order:
|
||||
conn.execute("TRUNCATE messages")
|
||||
conn.execute("DROP INDEX IF EXISTS messages_history_idx")
|
||||
conn.execute("DROP INDEX IF EXISTS messages_chat_idx")
|
||||
index = "messages_history_idx" if variant == "history" else "messages_chat_idx"
|
||||
conn.execute("CREATE INDEX " + index + " ON messages (" + columns + ")")
|
||||
lsn = conn.execute("SELECT pg_current_wal_insert_lsn() AS lsn").fetchone()["lsn"]
|
||||
started = time.perf_counter()
|
||||
conn.execute("""INSERT INTO messages(id,chat_id,sender_id,text,created_at)
|
||||
SELECT md5('message:'||n)::uuid,
|
||||
md5('chat:'||(CASE WHEN n<=70000 THEN 0 WHEN n<=90000 THEN 1 WHEN n<=99000 THEN 2 ELSE 3 END))::uuid,
|
||||
md5('user:'||(1+n%2))::uuid,
|
||||
'Synthetic message '||n||' '||repeat('x',80),
|
||||
timestamptz '2026-01-01 00:00:00+00' + n*interval '1 microsecond'
|
||||
FROM generate_series(1,100000) AS n""")
|
||||
insert_ms = (time.perf_counter() - started) * 1000
|
||||
wal = conn.execute("SELECT pg_wal_lsn_diff(pg_current_wal_insert_lsn(), %s) AS bytes", (lsn,)).fetchone()["bytes"]
|
||||
conn.execute("VACUUM (ANALYZE) messages")
|
||||
index_bytes = conn.execute("SELECT pg_relation_size(%s::regclass) AS bytes", (index,)).fetchone()["bytes"]
|
||||
result = {"variant": variant, "repeat": repeat + 1, "insert_100000_ms": insert_ms,
|
||||
"wal_bytes": int(wal), "index_bytes": index_bytes, "queries": []}
|
||||
offset = 0
|
||||
for chat, size in enumerate(SIZES):
|
||||
for fraction in (0.1, 0.5, 0.9):
|
||||
number = offset + int(size * fraction)
|
||||
params = (identifier(f"chat:{chat}"), START + timedelta(microseconds=number), identifier(f"message:{number}"), 51)
|
||||
conn.execute(QUERY, params).fetchall() # один прогрев именно этой страницы
|
||||
times = []
|
||||
for _ in range(5):
|
||||
started = time.perf_counter()
|
||||
rows = conn.execute(QUERY, params).fetchall()
|
||||
times.append((time.perf_counter() - started) * 1000)
|
||||
assert len(rows) == 51
|
||||
plan = conn.execute("EXPLAIN (ANALYZE, BUFFERS, FORMAT JSON) " + QUERY, params).fetchone()["QUERY PLAN"][0]
|
||||
result["queries"].append({"chat_size": size, "position": fraction, "latency_ms": times,
|
||||
"explain_execution_ms": plan["Execution Time"]})
|
||||
if repeat == 0:
|
||||
plans.append({"variant": variant, "chat_size": size, "position": fraction, "plan": plan})
|
||||
offset += size
|
||||
results.append(result)
|
||||
# Последняя итерация заканчивается production-индексом history.
|
||||
assert conn.execute("SELECT to_regclass('messages_history_idx') AS name").fetchone()["name"]
|
||||
baseline = snapshot(conn)
|
||||
assert baseline["counts"]["messages"] == 100000
|
||||
summary = {}
|
||||
for variant, _ in variants:
|
||||
trials = [row for row in results if row["variant"] == variant]
|
||||
latencies = sorted(t for row in trials for q in row["queries"] for t in q["latency_ms"])
|
||||
summary[variant] = {
|
||||
"insert_100000_median_ms": statistics.median(row["insert_100000_ms"] for row in trials),
|
||||
"index_bytes": trials[-1]["index_bytes"],
|
||||
"wal_bytes_median": statistics.median(row["wal_bytes"] for row in trials),
|
||||
"queries": len(latencies), "errors": 0, "concurrency": 1,
|
||||
"p50_ms": statistics.median(latencies),
|
||||
"p95_ms": latencies[int(0.95 * (len(latencies) - 1))],
|
||||
"p99_ms": latencies[int(0.99 * (len(latencies) - 1))],
|
||||
"successful_sql_rps": len(latencies) / (sum(latencies) / 1000),
|
||||
}
|
||||
return {"postgres": conn.execute("SELECT version() AS version").fetchone()["version"],
|
||||
"messages": 100000, "chat_sizes": SIZES, "repeats": 3, "warmup_per_case": 1,
|
||||
"measurements_per_case": 5, "page_size": 51, "query": QUERY,
|
||||
"summary": summary, "trials": results, "plans": plans, "snapshot": baseline}
|
||||
|
||||
|
||||
def after_backup():
|
||||
with connect() as conn:
|
||||
message_id = identifier("after-backup")
|
||||
conn.execute("INSERT INTO messages(id,chat_id,sender_id,text) VALUES(%s,%s,%s,%s)",
|
||||
(message_id, identifier("chat:0"), identifier("user:1"), "Committed AFTER backup"))
|
||||
return {"id": str(message_id), "source_messages": conn.execute("SELECT count(*) AS n FROM messages").fetchone()["n"]}
|
||||
|
||||
|
||||
def verify():
|
||||
expected = json.load(sys.stdin)
|
||||
with connect(restored=True) as restored, connect() as source:
|
||||
actual = snapshot(restored)
|
||||
assert actual == expected, "Restored data differs from the snapshot"
|
||||
marker = (identifier("after-backup"),)
|
||||
assert restored.execute("SELECT 1 FROM messages WHERE id=%s", marker).fetchone() is None
|
||||
assert source.execute("SELECT 1 FROM messages WHERE id=%s", marker).fetchone() is not None
|
||||
return {"counts": actual["counts"], "messages_sha256": actual["messages_sha256"],
|
||||
"samples_verified": len(actual["samples"]), "all_messages_match": True,
|
||||
"after_backup_message_missing_in_restore": True,
|
||||
"source_messages": source.execute("SELECT count(*) AS n FROM messages").fetchone()["n"]}
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
if os.environ.get("LAB2_RESEARCH") != "1":
|
||||
raise SystemExit("Use ./scripts/research.sh: an isolated research database is required")
|
||||
operation = sys.argv[1] if len(sys.argv) > 1 else "benchmark"
|
||||
result = {"benchmark": benchmark, "after-backup": after_backup, "verify": verify}[operation]()
|
||||
print(json.dumps(result, ensure_ascii=False, default=str))
|
||||
@@ -0,0 +1,99 @@
|
||||
"""Создаёт изолированный стенд, измеряет SQL, делает dump и restore; пишет реальные результаты."""
|
||||
from datetime import datetime, timezone
|
||||
import json
|
||||
import os
|
||||
from pathlib import Path
|
||||
import platform
|
||||
import subprocess
|
||||
import sys
|
||||
import time
|
||||
from uuid import uuid4
|
||||
|
||||
|
||||
ROOT = Path(__file__).resolve().parents[1]
|
||||
project = "lab2-research-" + uuid4().hex[:10]
|
||||
env = dict(os.environ, COMPOSE_PROJECT_NAME=project)
|
||||
command = ["docker", "compose", "--profile", "research"]
|
||||
|
||||
|
||||
def compose(*args, stdin=None, stdout=subprocess.PIPE):
|
||||
return subprocess.run([*command, *args], cwd=ROOT, env=env, input=stdin,
|
||||
stdout=stdout, stderr=subprocess.PIPE, check=True, timeout=600)
|
||||
|
||||
|
||||
def run_module(operation, stdin=None):
|
||||
result = compose("run", "--rm", "--no-deps", "-T", "-e", "LAB2_RESEARCH=1", "api", "python", "-m", "research.benchmark", operation, stdin=stdin)
|
||||
return json.loads(result.stdout)
|
||||
|
||||
|
||||
def wait_database(service):
|
||||
for _ in range(60):
|
||||
cid = compose("ps", "-q", service).stdout.decode().strip()
|
||||
state = subprocess.run(["docker", "inspect", "--format", "{{.State.Health.Status}}", cid], capture_output=True, text=True, check=True)
|
||||
if state.stdout.strip() == "healthy":
|
||||
return
|
||||
time.sleep(1)
|
||||
raise RuntimeError(service + " did not become healthy")
|
||||
|
||||
|
||||
def main():
|
||||
evidence = ROOT / "evidence"
|
||||
evidence.mkdir(exist_ok=True)
|
||||
backups = ROOT / "backups"
|
||||
backups.mkdir(exist_ok=True)
|
||||
dump = backups / (project + ".dump")
|
||||
metadata = {"utc": datetime.now(timezone.utc).isoformat(), "project": project,
|
||||
"command": "./scripts/research.sh", "host": platform.system() + " " + platform.machine(),
|
||||
"commit": subprocess.run(["git", "rev-parse", "--short", "HEAD"], cwd=ROOT, capture_output=True, text=True).stdout.strip() + " + working tree",
|
||||
"postgres_limits": {"cpus": 1, "memory_mib": 512}, "api_runner_limits": {"cpus": 1, "memory_mib": 256}}
|
||||
started = time.perf_counter()
|
||||
try:
|
||||
print("Research project:", project, flush=True)
|
||||
compose("up", "-d", "postgres", "postgres-restore")
|
||||
wait_database("postgres")
|
||||
wait_database("postgres-restore")
|
||||
print("Measuring two indexes on the same 100000 messages, three repeats...", flush=True)
|
||||
result = run_module("benchmark")
|
||||
plans = result.pop("plans")
|
||||
(evidence / "query-plans.json").write_text(json.dumps(plans, ensure_ascii=False, indent=2))
|
||||
source_id = compose("ps", "-q", "postgres").stdout.decode().strip()
|
||||
restore_id = compose("ps", "-q", "postgres-restore").stdout.decode().strip()
|
||||
assert source_id != restore_id
|
||||
for label, cid in (("source", source_id), ("restored", restore_id)):
|
||||
inspected = json.loads(subprocess.run(["docker", "inspect", cid], capture_output=True, check=True).stdout)[0]
|
||||
metadata[label] = {"container": cid, "image": inspected["Image"],
|
||||
"volumes": [m["Name"] for m in inspected["Mounts"] if m["Type"] == "volume"]}
|
||||
assert metadata["source"]["volumes"] != metadata["restored"]["volumes"]
|
||||
metadata["docker"] = subprocess.run(["docker", "info", "--format", "{{.ServerVersion}} {{.Architecture}} CPUs={{.NCPU}} RAM={{.MemTotal}}"], capture_output=True, text=True, check=True).stdout.strip()
|
||||
metadata["stats_after_queries"] = subprocess.run(["docker", "stats", "--no-stream", "--format", "{{json .}}", source_id], capture_output=True, text=True, check=True).stdout.strip()
|
||||
backup_started = time.perf_counter()
|
||||
with dump.open("wb") as output:
|
||||
compose("exec", "-T", "postgres", "pg_dump", "-U", "messenger", "-d", "messenger", "--format=custom", stdout=output)
|
||||
backup_seconds = time.perf_counter() - backup_started
|
||||
marker = run_module("after-backup")
|
||||
restore_started = time.perf_counter()
|
||||
# Dump подаётся через stdin, без вывода данных или credentials в журнал.
|
||||
with dump.open("rb") as input_file:
|
||||
subprocess.run([*command, "exec", "-T", "postgres-restore", "pg_restore", "-U", "messenger", "-d", "messenger",
|
||||
"--exit-on-error", "--single-transaction", "--no-owner"], cwd=ROOT, env=env, stdin=input_file,
|
||||
stdout=subprocess.DEVNULL, stderr=subprocess.PIPE, check=True, timeout=300)
|
||||
restore_seconds = time.perf_counter() - restore_started
|
||||
verification_started = time.perf_counter()
|
||||
verification = run_module("verify", stdin=json.dumps(result["snapshot"]).encode())
|
||||
result.update(metadata)
|
||||
result["backup"] = {"file": "backups/" + dump.name, "bytes": dump.stat().st_size, "seconds": backup_seconds}
|
||||
result["restore"] = {"seconds": restore_seconds, "verification_seconds": time.perf_counter() - verification_started,
|
||||
"verification": verification, "post_backup_insert": marker}
|
||||
result["total_seconds"] = time.perf_counter() - started
|
||||
(evidence / "research.json").write_text(json.dumps(result, ensure_ascii=False, indent=2))
|
||||
print(json.dumps(result["summary"], ensure_ascii=False, indent=2), flush=True)
|
||||
print(f"PASS: backup {backup_seconds:.2f}s; restore {restore_seconds:.2f}s; 100000 messages, all hashes and 12 samples match", flush=True)
|
||||
print("PASS: restored into a different container and fresh volume; one post-backup commit is absent as expected", flush=True)
|
||||
print("Results: evidence/research.json, evidence/query-plans.json; dump stays outside Git in backups/", flush=True)
|
||||
finally:
|
||||
compose("down", "--volumes", "--timeout", "10")
|
||||
print("Removed only temporary research project:", project, flush=True)
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
main()
|
||||
Executable
+6
@@ -0,0 +1,6 @@
|
||||
#!/usr/bin/env bash
|
||||
set -euo pipefail
|
||||
project_dir="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")/.." && pwd)"
|
||||
cd "$project_dir"
|
||||
python3 scripts/init_local.py
|
||||
docker compose build "$@" api
|
||||
Executable
+11
@@ -0,0 +1,11 @@
|
||||
#!/usr/bin/env bash
|
||||
set -euo pipefail
|
||||
project_dir="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")/.." && pwd)"
|
||||
cd "$project_dir"
|
||||
if [[ ! -x .venv/bin/python ]]; then
|
||||
echo "Создай .venv и установи requirements.txt по REPORT.md" >&2
|
||||
exit 1
|
||||
fi
|
||||
./scripts/build.sh
|
||||
mkdir -p evidence
|
||||
.venv/bin/python -u student-tests/docker_lifecycle.py 2>&1 | sed -E 's/[[:blank:]]+$//' | tee evidence/lab4-checks.txt
|
||||
Executable
+17
@@ -0,0 +1,17 @@
|
||||
#!/usr/bin/env bash
|
||||
set -euo pipefail
|
||||
|
||||
project_dir="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")/.." && pwd)"
|
||||
cd "$project_dir"
|
||||
|
||||
if [[ ! -x .venv/bin/python ]]; then
|
||||
echo "Не хватает .venv" >&2
|
||||
echo "python3 -m venv .venv" >&2
|
||||
echo ".venv/bin/python -m pip install -r requirements.txt" >&2
|
||||
exit 1
|
||||
fi
|
||||
|
||||
export BASE_URL="${BASE_URL:-http://localhost:8080}"
|
||||
echo "Проверяем сервер: $BASE_URL"
|
||||
make check test PYTHON="$project_dir/.venv/bin/python" BASE_URL="$BASE_URL"
|
||||
.venv/bin/python -m unittest discover -s student-tests -v
|
||||
Executable
+28
@@ -0,0 +1,28 @@
|
||||
#!/usr/bin/env bash
|
||||
set -euo pipefail
|
||||
base_url="${BASE_URL:-http://localhost:8080}"
|
||||
suffix="$(date +%s)_$RANDOM"
|
||||
# Только синтетические пароли; токены остаются в памяти shell и не выводятся.
|
||||
password="Demo-password-$suffix"
|
||||
register() {
|
||||
local username="$1" display_name="$2"
|
||||
jq -nc --arg u "$username" --arg d "$display_name" --arg p "$password" \
|
||||
'{username:$u, display_name:$d, password:$p}' |
|
||||
curl -fsS -H 'Content-Type: application/json' --data-binary @- "$base_url/api/v1/users" | jq -er '.id'
|
||||
}
|
||||
login() {
|
||||
curl -fsS -X POST -u "$1:$password" "$base_url/api/v1/auth/sessions" | jq -er '.token'
|
||||
}
|
||||
alice_id="$(register "alice_$suffix" Алиса)"
|
||||
bob_id="$(register "bob_$suffix" Боб)"
|
||||
alice_token="$(login "alice_$suffix")"
|
||||
bob_token="$(login "bob_$suffix")"
|
||||
chat_id="$(jq -nc --arg a "$alice_id" --arg b "$bob_id" '{title:"Учебный чат",member_ids:[$a,$b]}' |
|
||||
curl -fsS -H "Authorization: Bearer $alice_token" -H 'Content-Type: application/json' \
|
||||
--data-binary @- "$base_url/api/v1/chats" | jq -er '.id')"
|
||||
for token in "$alice_token" "$bob_token"; do
|
||||
curl -fsS -H "Authorization: Bearer $token" -H 'Content-Type: application/json' \
|
||||
-H "Idempotency-Key: demo-$RANDOM-$RANDOM" \
|
||||
-d '{"text":"Привет из lab3! 👋"}' "$base_url/api/v1/chats/$chat_id/messages" | jq .
|
||||
done
|
||||
curl -fsS -H "Authorization: Bearer $bob_token" "$base_url/api/v1/chats/$chat_id/messages" | jq .
|
||||
@@ -0,0 +1,57 @@
|
||||
"""Создаёт локальное окружение и secrets; существующие значения сохраняет."""
|
||||
from pathlib import Path
|
||||
import json
|
||||
import os
|
||||
import re
|
||||
import secrets
|
||||
import shutil
|
||||
from urllib.parse import quote
|
||||
|
||||
|
||||
root = Path(__file__).resolve().parents[1]
|
||||
if not (root / ".env").exists():
|
||||
shutil.copyfile(root / ".env.example", root / ".env")
|
||||
directory = root / "secrets"
|
||||
directory.mkdir(exist_ok=True, mode=0o700)
|
||||
directory.chmod(0o700)
|
||||
password_file = directory / "postgres_password"
|
||||
if not password_file.exists():
|
||||
password_file.write_text(secrets.token_hex(24))
|
||||
password = password_file.read_text().strip()
|
||||
values = {
|
||||
"database_url": f"postgresql://messenger:{quote(password, safe='')}@postgres:5432/messenger",
|
||||
"cache_url": "redis://valkey:6379/0",
|
||||
"s3_root_user": "root-" + secrets.token_hex(8),
|
||||
"s3_root_password": secrets.token_urlsafe(32),
|
||||
"s3_access_key_id": "api-" + secrets.token_hex(8),
|
||||
"s3_secret_access_key": secrets.token_urlsafe(32),
|
||||
}
|
||||
for name, value in values.items():
|
||||
path = directory / name
|
||||
if not path.exists():
|
||||
path.write_text(value)
|
||||
dotenv = dict(line.split("=", 1) for line in (root / ".env").read_text().splitlines()
|
||||
if line.strip() and not line.lstrip().startswith("#") and "=" in line)
|
||||
bucket = os.environ.get("S3_BUCKET", dotenv.get("S3_BUCKET", "messenger-attachments"))
|
||||
if re.fullmatch(r"[a-z0-9][a-z0-9.-]{1,61}[a-z0-9]", bucket) is None:
|
||||
raise ValueError("Недопустимое имя S3 bucket")
|
||||
def local_secret(name):
|
||||
return (directory / name).read_text().strip()
|
||||
config = {"accounts": [{"id": "messenger-api", "displayName": "messenger-api"}], "identities": [
|
||||
{"name": "bootstrap", "credentials": [{"accessKey": local_secret("s3_root_user"),
|
||||
"secretKey": local_secret("s3_root_password")}], "actions": ["Admin"]},
|
||||
{"name": "messenger-api", "account": {"id": "messenger-api", "displayName": "messenger-api"},
|
||||
"credentials": [{"accessKey": local_secret("s3_access_key_id"), "secretKey": local_secret("s3_secret_access_key")}],
|
||||
"actions": ["Read:" + bucket, "List:" + bucket, "Write:" + bucket + "/attachments/*"]},
|
||||
]}
|
||||
config_file = directory / "s3_config"
|
||||
encoded_config = json.dumps(config)
|
||||
if not config_file.exists() or config_file.read_text() != encoded_config:
|
||||
temporary = directory / "s3_config.tmp"
|
||||
temporary.write_text(encoded_config)
|
||||
temporary.chmod(0o444)
|
||||
temporary.replace(config_file)
|
||||
# Каталог 0700 защищает файлы на хосте; 0444 позволяет USER 10001 читать bind-mounted secret.
|
||||
for name in ("postgres_password", "s3_config", *values):
|
||||
(directory / name).chmod(0o444)
|
||||
print("Local .env and secrets are ready; values are not printed")
|
||||
Executable
+6
@@ -0,0 +1,6 @@
|
||||
#!/usr/bin/env bash
|
||||
set -euo pipefail
|
||||
project_dir="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")/.." && pwd)"
|
||||
cd "$project_dir"
|
||||
./scripts/build.sh
|
||||
docker compose run --rm migrate
|
||||
@@ -0,0 +1,90 @@
|
||||
"""Управление репликами только текущего Compose project через Docker CLI."""
|
||||
import argparse
|
||||
import json
|
||||
import os
|
||||
from pathlib import Path
|
||||
import subprocess
|
||||
import time
|
||||
from urllib.request import urlopen
|
||||
|
||||
ROOT = Path(__file__).resolve().parents[1]
|
||||
|
||||
|
||||
def command(*args):
|
||||
return subprocess.check_output(args, cwd=ROOT, text=True, timeout=120).strip()
|
||||
|
||||
|
||||
def replicas():
|
||||
ids = command("docker", "compose", "ps", "-q", "api").split()
|
||||
return json.loads(command("docker", "inspect", *ids)) if ids else []
|
||||
|
||||
|
||||
def base_url():
|
||||
config = json.loads(command("docker", "compose", "config", "--format", "json"))
|
||||
port = config["services"]["lb"]["ports"][0]["published"]
|
||||
return os.environ.get("BASE_URL", "http://127.0.0.1:" + str(port)).rstrip("/")
|
||||
|
||||
|
||||
def wait_ready():
|
||||
url = base_url() + "/health/ready"
|
||||
deadline = time.monotonic() + 90
|
||||
seen = set()
|
||||
while time.monotonic() < deadline:
|
||||
current = replicas()
|
||||
expected = {info["Config"]["Hostname"] for info in current}
|
||||
if expected and all(info["State"].get("Health", {}).get("Status") == "healthy" for info in current):
|
||||
try:
|
||||
with urlopen(url, timeout=2) as response:
|
||||
if response.status == 200:
|
||||
seen.add(response.headers.get("X-Instance-Id"))
|
||||
if expected <= seen:
|
||||
print("API ready through LB:", ", ".join(sorted(expected)), flush=True)
|
||||
return
|
||||
except OSError:
|
||||
pass
|
||||
time.sleep(0.2)
|
||||
raise RuntimeError("Не все работающие API-реплики готовы через LB за 90 секунд")
|
||||
|
||||
|
||||
def stop_one():
|
||||
target = os.environ.get("TARGET_INSTANCE_ID")
|
||||
if not target:
|
||||
raise RuntimeError("Задайте TARGET_INSTANCE_ID из X-Instance-Id")
|
||||
current = replicas()
|
||||
matches = [info for info in current if info["Config"]["Hostname"] == target]
|
||||
if len(current) < 2 or len(matches) != 1:
|
||||
raise RuntimeError("Нужны минимум две работающие реплики и ровно одна выбранная")
|
||||
selected = matches[0]
|
||||
command("docker", "stop", "--time", "8", selected["Id"])
|
||||
print("Stopped API:", target, "container=" + selected["Id"], flush=True)
|
||||
|
||||
|
||||
def rolling():
|
||||
wait_ready()
|
||||
originals = replicas()
|
||||
count = len(originals)
|
||||
if count < 2:
|
||||
raise RuntimeError("Для поочерёдной замены нужны минимум две API-реплики")
|
||||
for old in originals:
|
||||
active = replicas()
|
||||
healthy = [info for info in active if info["Id"] != old["Id"]
|
||||
and info["State"].get("Health", {}).get("Status") == "healthy"]
|
||||
if not healthy:
|
||||
raise RuntimeError("Нет готовой реплики, которая продолжит обслуживать запросы")
|
||||
print("Replacing API:", old["Config"]["Hostname"], flush=True)
|
||||
command("docker", "stop", "--time", "8", old["Id"])
|
||||
command("docker", "rm", old["Id"])
|
||||
# --no-recreate сохраняет остальные процессы; Compose создаёт только недостающий.
|
||||
command("docker", "compose", "up", "-d", "--no-deps", "--no-recreate", "--scale", f"api={count}", "api")
|
||||
wait_ready()
|
||||
assert len(replicas()) == count
|
||||
final = replicas()
|
||||
assert not ({info["Id"] for info in originals} & {info["Id"] for info in final})
|
||||
print("PASS: all API containers replaced sequentially; stores and LB kept running", flush=True)
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
parser = argparse.ArgumentParser(description=__doc__)
|
||||
parser.add_argument("action", choices=["wait", "stop", "rolling"])
|
||||
action = parser.parse_args().action
|
||||
{"wait": wait_ready, "stop": stop_one, "rolling": rolling}[action]()
|
||||
Executable
+7
@@ -0,0 +1,7 @@
|
||||
#!/usr/bin/env bash
|
||||
set -euo pipefail
|
||||
project_dir="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")/.." && pwd)"
|
||||
cd "$project_dir"
|
||||
./scripts/build.sh
|
||||
mkdir -p evidence
|
||||
python3 -u research/run.py 2>&1 | tee evidence/research.txt
|
||||
Executable
+6
@@ -0,0 +1,6 @@
|
||||
#!/usr/bin/env bash
|
||||
set -euo pipefail
|
||||
project_dir="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")/.." && pwd)"
|
||||
cd "$project_dir"
|
||||
docker compose restart --timeout 8 postgres valkey s3-storage s3 api lb cleanup
|
||||
./scripts/wait-ready.sh
|
||||
Executable
+7
@@ -0,0 +1,7 @@
|
||||
#!/usr/bin/env bash
|
||||
set -euo pipefail
|
||||
project_dir="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")/.." && pwd)"
|
||||
cd "$project_dir"
|
||||
# Сначала собираем образ и применяем только обратно совместимые миграции.
|
||||
./scripts/migrate.sh
|
||||
exec python3 scripts/replicas.py rolling
|
||||
Executable
+5
@@ -0,0 +1,5 @@
|
||||
#!/usr/bin/env bash
|
||||
set -euo pipefail
|
||||
# Локальный стенд: HAProxy, две API-реплики, PostgreSQL и Valkey.
|
||||
project_dir="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")/.." && pwd)"
|
||||
exec "$project_dir/scripts/start.sh"
|
||||
Executable
+7
@@ -0,0 +1,7 @@
|
||||
#!/usr/bin/env bash
|
||||
set -euo pipefail
|
||||
project_dir="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")/.." && pwd)"
|
||||
cd "$project_dir"
|
||||
python3 scripts/init_local.py
|
||||
docker compose up -d --build lb cleanup
|
||||
./scripts/wait-ready.sh
|
||||
Executable
+5
@@ -0,0 +1,5 @@
|
||||
#!/usr/bin/env bash
|
||||
set -euo pipefail
|
||||
project_dir="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")/.." && pwd)"
|
||||
cd "$project_dir"
|
||||
exec python3 scripts/replicas.py stop
|
||||
Executable
+6
@@ -0,0 +1,6 @@
|
||||
#!/usr/bin/env bash
|
||||
set -euo pipefail
|
||||
project_dir="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")/.." && pwd)"
|
||||
cd "$project_dir"
|
||||
docker compose down --timeout 10
|
||||
echo "Контейнеры удалены; именованные volumes сохранены"
|
||||
Executable
+5
@@ -0,0 +1,5 @@
|
||||
#!/usr/bin/env bash
|
||||
set -euo pipefail
|
||||
project_dir="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")/.." && pwd)"
|
||||
cd "$project_dir"
|
||||
exec python3 scripts/replicas.py wait
|
||||
@@ -0,0 +1,16 @@
|
||||
"""Общий запуск"""
|
||||
|
||||
import os
|
||||
|
||||
import uvicorn
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
uvicorn.run(
|
||||
"src.app:app",
|
||||
host=os.environ.get("APP_HOST", "0.0.0.0"),
|
||||
port=int(os.environ.get("APP_PORT", "8080")),
|
||||
workers=1,
|
||||
access_log=False,
|
||||
timeout_graceful_shutdown=5,
|
||||
)
|
||||
+180
@@ -0,0 +1,180 @@
|
||||
"""HTTP-адреса, определение пользователя и обработка запросов"""
|
||||
|
||||
from contextlib import asynccontextmanager
|
||||
import json
|
||||
import logging
|
||||
import re
|
||||
from time import perf_counter
|
||||
from uuid import UUID, uuid4
|
||||
from urllib.parse import quote
|
||||
|
||||
from fastapi import FastAPI, Request, Response
|
||||
from fastapi.responses import StreamingResponse
|
||||
from starlette.concurrency import run_in_threadpool
|
||||
from fastapi.exceptions import RequestValidationError
|
||||
from starlette.exceptions import HTTPException
|
||||
|
||||
from src import attachments, auth, db, migrate, object_store, passwords, storage
|
||||
from src.errors import ApiError, error_response
|
||||
from src.models import CreateChat, CreateMessage, CreateUser
|
||||
from src.config import INSTANCE_ID
|
||||
|
||||
|
||||
@asynccontextmanager
|
||||
async def lifespan(app):
|
||||
await run_in_threadpool(db.pool.open, wait=True, timeout=15)
|
||||
try:
|
||||
await run_in_threadpool(migrate.check)
|
||||
yield
|
||||
finally:
|
||||
await run_in_threadpool(db.pool.close)
|
||||
|
||||
|
||||
app = FastAPI(title="Учебный мессенджер", redirect_slashes=False, lifespan=lifespan)
|
||||
logger = logging.getLogger("uvicorn.error")
|
||||
|
||||
|
||||
@app.middleware("http")
|
||||
async def handle_request(request: Request, call_next):
|
||||
request.state.request_id = str(uuid4())
|
||||
started = perf_counter()
|
||||
path = request.url.path
|
||||
try:
|
||||
is_registration = request.method == "POST" and path == "/api/v1/users"
|
||||
is_login = request.method == "POST" and path == "/api/v1/auth/sessions"
|
||||
is_upload = request.method == "POST" and re.fullmatch(r"/api/v1/chats/[^/]+/attachments", path)
|
||||
if is_login:
|
||||
request.state.user = await run_in_threadpool(auth.basic_user, request.headers.get("Authorization"))
|
||||
if await request.body():
|
||||
raise ApiError(400, "invalid_request", "Вход через Basic не принимает тело запроса")
|
||||
elif path.startswith("/api/v1/") and not is_registration:
|
||||
request.state.user = await run_in_threadpool(auth.current_user, request.headers.get("Authorization"))
|
||||
if request.method == "POST" and path.startswith("/api/v1/") and not is_login and not is_upload:
|
||||
content_type = request.headers.get("Content-Type", "").split(";", 1)[0].strip().lower()
|
||||
if content_type != "application/json":
|
||||
raise ApiError(415, "unsupported_media_type", "Ожидается application/json")
|
||||
try:
|
||||
json.loads((await request.body()).decode("utf-8"))
|
||||
except (ValueError, RecursionError):
|
||||
raise ApiError(400, "invalid_request", "Ожидается корректный JSON в UTF-8")
|
||||
response = await call_next(request)
|
||||
except ApiError as error:
|
||||
response = error_response(request, error)
|
||||
except Exception as error:
|
||||
# Не печатаем тело запроса или текст исключения: там могут быть сообщения.
|
||||
logger.error("%s request_id=%s", type(error).__name__, request.state.request_id)
|
||||
response = error_response(request, ApiError(500, "internal_error", "Внутренняя ошибка сервера"))
|
||||
response.headers["X-Request-Id"] = request.state.request_id
|
||||
response.headers["X-Instance-Id"] = INSTANCE_ID
|
||||
logger.info(
|
||||
"%s %s status=%s duration_ms=%.2f request_id=%s",
|
||||
request.method, path, response.status_code,
|
||||
(perf_counter() - started) * 1000, request.state.request_id,
|
||||
)
|
||||
return response
|
||||
|
||||
|
||||
@app.exception_handler(ApiError)
|
||||
def handle_api_error(request: Request, error: ApiError):
|
||||
return error_response(request, error)
|
||||
|
||||
|
||||
@app.exception_handler(RequestValidationError)
|
||||
def handle_validation_error(request: Request, error: RequestValidationError):
|
||||
# Контракт требует 400 и наш формат ошибки, а не стандартный ответ FastAPI.
|
||||
return error_response(request, ApiError(400, "invalid_request", "Неверные поля или параметры запроса"))
|
||||
|
||||
|
||||
@app.exception_handler(HTTPException)
|
||||
def handle_http_error(request: Request, error: HTTPException):
|
||||
code = "not_found" if error.status_code == 404 else "invalid_request"
|
||||
message = "Адрес не найден" if error.status_code == 404 else "Недопустимый HTTP-запрос"
|
||||
response = error_response(request, ApiError(error.status_code, code, message))
|
||||
if error.headers:
|
||||
response.headers.update(error.headers)
|
||||
return response
|
||||
|
||||
|
||||
@app.get("/health/live")
|
||||
def health_live():
|
||||
return {"status": "ok"}
|
||||
|
||||
|
||||
@app.get("/health/ready")
|
||||
def health_ready():
|
||||
db.ready()
|
||||
auth.ready()
|
||||
object_store.ready()
|
||||
return {"status": "ok"}
|
||||
|
||||
|
||||
@app.post("/api/v1/users", status_code=201)
|
||||
def create_user(data: CreateUser):
|
||||
return storage.create_user(data.username, data.display_name, passwords.hash_password(data.password))
|
||||
|
||||
|
||||
@app.get("/api/v1/users/me")
|
||||
def current_user(request: Request):
|
||||
return request.state.user
|
||||
|
||||
|
||||
@app.post("/api/v1/chats", status_code=201)
|
||||
def create_chat(request: Request, data: CreateChat):
|
||||
return storage.create_chat(request.state.user["id"], data.title, data.member_ids)
|
||||
|
||||
|
||||
@app.get("/api/v1/chats")
|
||||
def list_chats(request: Request, limit: str = "50", cursor: str | None = None):
|
||||
user_id = request.state.user["id"]
|
||||
return storage.list_chats(user_id, limit, cursor)
|
||||
|
||||
|
||||
@app.get("/api/v1/chats/{chat_id}")
|
||||
def get_chat(request: Request, chat_id: UUID):
|
||||
return storage.get_chat(request.state.user["id"], str(chat_id))
|
||||
|
||||
|
||||
@app.post("/api/v1/chats/{chat_id}/messages", status_code=201)
|
||||
def create_message(request: Request, chat_id: UUID, data: CreateMessage):
|
||||
keys = request.headers.getlist("Idempotency-Key")
|
||||
if len(keys) != 1 or re.fullmatch(r"[A-Za-z0-9._:-]{1,128}", keys[0]) is None:
|
||||
raise ApiError(400, "invalid_request", "Нужен Idempotency-Key: 1–128 символов ASCII [A-Za-z0-9._:-]")
|
||||
return storage.create_message(request.state.user["id"], str(chat_id), data.text, keys[0], data.attachment_ids)
|
||||
|
||||
|
||||
@app.post("/api/v1/chats/{chat_id}/attachments", status_code=201)
|
||||
async def upload_attachment(request: Request, chat_id: UUID, filename: str):
|
||||
return await attachments.upload(request, str(chat_id), filename)
|
||||
|
||||
|
||||
@app.get("/api/v1/attachments/{attachment_id}")
|
||||
def get_attachment(request: Request, attachment_id: UUID):
|
||||
return attachments.public_attachment(attachments.find(request.state.user["id"], str(attachment_id)))
|
||||
|
||||
|
||||
@app.get("/api/v1/attachments/{attachment_id}/content")
|
||||
def download_attachment(request: Request, attachment_id: UUID, variant: str = "original"):
|
||||
row = attachments.find(request.state.user["id"], str(attachment_id))
|
||||
if variant != "original":
|
||||
raise ApiError(404, "not_found", "Вариант вложения не найден")
|
||||
response = object_store.get(row["object_key"])
|
||||
return StreamingResponse(attachments.chunks(response), media_type=row["content_type"], headers={
|
||||
"Content-Length": str(row["size_bytes"]), "X-Content-Type-Options": "nosniff",
|
||||
"Content-Disposition": "attachment; filename*=UTF-8''" + quote(row["filename"], safe=""),
|
||||
})
|
||||
|
||||
|
||||
@app.get("/api/v1/chats/{chat_id}/messages")
|
||||
def list_messages(request: Request, chat_id: UUID, limit: str = "50", cursor: str | None = None):
|
||||
return storage.list_messages(request.state.user["id"], str(chat_id), limit, cursor)
|
||||
|
||||
|
||||
@app.post("/api/v1/auth/sessions", status_code=201)
|
||||
def create_session(request: Request):
|
||||
return auth.create_session(request.state.user)
|
||||
|
||||
|
||||
@app.delete("/api/v1/auth/sessions/current", status_code=204)
|
||||
def delete_session(request: Request):
|
||||
auth.logout(request.headers.get("Authorization"))
|
||||
return Response(status_code=204)
|
||||
@@ -0,0 +1,147 @@
|
||||
"""Синхронная загрузка: ограниченный поток -> проверка -> журнал -> S3 -> COMMIT."""
|
||||
import asyncio
|
||||
import hashlib
|
||||
import os
|
||||
from tempfile import TemporaryFile
|
||||
import unicodedata
|
||||
from uuid import UUID, uuid4
|
||||
import warnings
|
||||
|
||||
from PIL import Image, UnidentifiedImageError
|
||||
from starlette.concurrency import run_in_threadpool
|
||||
from starlette.requests import ClientDisconnect
|
||||
|
||||
from src import db, object_store, storage
|
||||
from src.errors import ApiError
|
||||
|
||||
|
||||
MAX_BYTES = int(os.environ.get("MAX_UPLOAD_BYTES", "10485760"))
|
||||
MAX_PIXELS = int(os.environ.get("MAX_IMAGE_PIXELS", "40000000"))
|
||||
if not 1 <= MAX_BYTES <= 10485760 or not 1 <= MAX_PIXELS <= 40000000:
|
||||
raise ValueError("Лимиты загрузки должны быть положительными и не превышать контракт")
|
||||
Image.MAX_IMAGE_PIXELS = MAX_PIXELS
|
||||
warnings.filterwarnings("error", category=Image.DecompressionBombWarning)
|
||||
# Максимум одно полное декодирование на реплику, независимо от числа клиентов.
|
||||
upload_slot = asyncio.Semaphore(1)
|
||||
|
||||
|
||||
def public_attachment(row):
|
||||
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": "ready",
|
||||
"variants": [], "error_code": None, "created_at": storage.utc(row["created_at"]),
|
||||
"updated_at": storage.utc(row["created_at"])}
|
||||
|
||||
|
||||
def validate_filename(filename):
|
||||
if not 1 <= len(filename) <= 255 or not filename.strip() or any(
|
||||
char in "/\\" or unicodedata.category(char) == "Cc" for char in filename
|
||||
):
|
||||
raise ApiError(400, "invalid_request", "Недопустимое имя файла")
|
||||
try:
|
||||
filename.encode("utf-8")
|
||||
except UnicodeError:
|
||||
raise ApiError(400, "invalid_request", "Недопустимое имя файла") from None
|
||||
|
||||
|
||||
def validate_image(file, declared_type):
|
||||
try:
|
||||
file.seek(0)
|
||||
with Image.open(file, formats=["PNG", "JPEG"]) as image:
|
||||
true_type = {"PNG": "image/png", "JPEG": "image/jpeg"}[image.format]
|
||||
if image.width * image.height > MAX_PIXELS:
|
||||
raise ApiError(413, "payload_too_large", "Слишком много пикселей")
|
||||
if true_type != declared_type:
|
||||
raise ApiError(415, "unsupported_media_type", "MIME не совпадает с содержимым")
|
||||
image.verify()
|
||||
# verify проверяет структуру/CRC, load дополнительно обнаруживает обрыв pixel data.
|
||||
file.seek(0)
|
||||
with Image.open(file, formats=["PNG", "JPEG"]) as image:
|
||||
image.load()
|
||||
return true_type
|
||||
except (Image.DecompressionBombError, Image.DecompressionBombWarning):
|
||||
raise ApiError(413, "payload_too_large", "Слишком много пикселей") from None
|
||||
except (UnidentifiedImageError, OSError, ValueError, SyntaxError):
|
||||
raise ApiError(415, "unsupported_media_type", "Повреждённый PNG/JPEG или другой формат") from None
|
||||
|
||||
|
||||
def lock_upload(conn, key, blocking=True):
|
||||
function = "pg_advisory_xact_lock" if blocking else "pg_try_advisory_xact_lock"
|
||||
return conn.execute(f"SELECT {function}(hashtextextended(%s, 4)) AS locked", (key,)).fetchone()["locked"]
|
||||
|
||||
|
||||
def save(user_id, chat_id, filename, content_type, file, size, sha256):
|
||||
attachment_id = uuid4()
|
||||
key = "attachments/" + attachment_id.hex
|
||||
# Даже при kill -9 после PUT остаётся долговечное намерение для cleaner.
|
||||
with db.connection() as conn:
|
||||
storage.require_member(conn, user_id, chat_id)
|
||||
conn.execute("INSERT INTO attachment_uploads(id, object_key) VALUES (%s, %s)", (attachment_id, key))
|
||||
with db.connection() as conn:
|
||||
conn.execute("SET LOCAL idle_in_transaction_session_timeout='30s'")
|
||||
lock_upload(conn, key)
|
||||
if not conn.execute("SELECT 1 FROM attachment_uploads WHERE id=%s", (attachment_id,)).fetchone():
|
||||
raise ApiError(503, "unavailable", "Загрузка больше не активна")
|
||||
object_store.put(key, file, size, content_type)
|
||||
row = conn.execute("""INSERT INTO attachments(id, chat_id, owner_id, object_key, filename,
|
||||
content_type, size_bytes, sha256) VALUES (%s, %s, %s, %s, %s, %s, %s, %s) RETURNING *""",
|
||||
(attachment_id, UUID(chat_id), UUID(user_id), key, filename, content_type, size, sha256)).fetchone()
|
||||
conn.execute("DELETE FROM attachment_uploads WHERE id=%s", (attachment_id,))
|
||||
result = public_attachment(row)
|
||||
# Ответ только после успешного COMMIT; при неопределённом исходе ничего не удаляем.
|
||||
return result
|
||||
|
||||
|
||||
async def upload(request, chat_id, filename):
|
||||
user_id = request.state.user["id"]
|
||||
await run_in_threadpool(storage.get_chat, user_id, chat_id)
|
||||
validate_filename(filename)
|
||||
content_type = request.headers.get("Content-Type", "").split(";", 1)[0].strip().lower()
|
||||
if content_type not in {"image/png", "image/jpeg"}:
|
||||
raise ApiError(415, "unsupported_media_type", "Ожидаются сырые bytes PNG/JPEG")
|
||||
length = request.headers.get("Content-Length")
|
||||
if length is not None:
|
||||
if not length.isascii() or not length.isdecimal():
|
||||
raise ApiError(400, "invalid_request", "Неверный Content-Length")
|
||||
if len(length) > 10 or int(length) > MAX_BYTES:
|
||||
raise ApiError(413, "payload_too_large", "Файл больше допустимого размера")
|
||||
try:
|
||||
await asyncio.wait_for(upload_slot.acquire(), timeout=20)
|
||||
except TimeoutError:
|
||||
raise ApiError(503, "unavailable", "Загрузки заняты; повторите позднее") from None
|
||||
try:
|
||||
with TemporaryFile() as file:
|
||||
size = 0
|
||||
digest = hashlib.sha256()
|
||||
try:
|
||||
async with asyncio.timeout(30):
|
||||
async for chunk in request.stream():
|
||||
size += len(chunk)
|
||||
if size > MAX_BYTES:
|
||||
raise ApiError(413, "payload_too_large", "Файл больше допустимого размера")
|
||||
digest.update(chunk)
|
||||
await run_in_threadpool(file.write, chunk)
|
||||
except (TimeoutError, ClientDisconnect):
|
||||
raise ApiError(400, "invalid_request", "Загрузка прервана или истёк таймаут") from None
|
||||
true_type = await run_in_threadpool(validate_image, file, content_type)
|
||||
return await run_in_threadpool(save, user_id, chat_id, filename, true_type, file, size, digest.hexdigest())
|
||||
finally:
|
||||
upload_slot.release()
|
||||
|
||||
|
||||
def find(user_id, attachment_id):
|
||||
with db.connection() as conn:
|
||||
row = conn.execute("""SELECT a.* FROM attachments a JOIN chat_members m ON m.chat_id=a.chat_id
|
||||
WHERE a.id=%s AND m.user_id=%s""", (UUID(attachment_id), UUID(user_id))).fetchone()
|
||||
if row is None:
|
||||
raise ApiError(404, "not_found", "Вложение не найдено")
|
||||
return row
|
||||
|
||||
|
||||
def chunks(response):
|
||||
try:
|
||||
while chunk := response.read(65536):
|
||||
yield chunk
|
||||
finally:
|
||||
response.close()
|
||||
response.release_conn()
|
||||
+95
@@ -0,0 +1,95 @@
|
||||
"""Basic только для входа; Bearer-сессии с TTL и AOF находятся в Valkey."""
|
||||
import base64
|
||||
import binascii
|
||||
from contextlib import contextmanager
|
||||
from datetime import datetime, timedelta, timezone
|
||||
import hashlib
|
||||
import json
|
||||
import secrets
|
||||
|
||||
import redis
|
||||
|
||||
from src import passwords, storage
|
||||
from src.config import SESSION_TTL, secret
|
||||
from src.errors import ApiError
|
||||
|
||||
|
||||
sessions = redis.Redis.from_url(
|
||||
secret("CACHE_URL"), decode_responses=True,
|
||||
socket_connect_timeout=0.5, socket_timeout=0.5, max_connections=10,
|
||||
retry=redis.retry.Retry(redis.backoff.NoBackoff(), 0),
|
||||
)
|
||||
|
||||
|
||||
@contextmanager
|
||||
def available():
|
||||
try:
|
||||
yield
|
||||
except redis.RedisError:
|
||||
raise ApiError(503, "unavailable", "Valkey временно недоступен") from None
|
||||
|
||||
|
||||
def unauthorized(basic=False):
|
||||
challenge = 'Basic realm="messenger", charset="UTF-8"' if basic else 'Bearer realm="messenger"'
|
||||
return ApiError(401, "unauthorized", "Неверная или отсутствующая идентификация", {"WWW-Authenticate": challenge})
|
||||
|
||||
|
||||
def credential(header, scheme):
|
||||
parts = (header or "").split()
|
||||
if len(parts) != 2 or parts[0].lower() != scheme.lower():
|
||||
raise unauthorized(scheme == "Basic")
|
||||
return parts[1]
|
||||
|
||||
|
||||
def basic_user(header):
|
||||
value = credential(header, "Basic")
|
||||
try:
|
||||
decoded = base64.b64decode(value, validate=True).decode("utf-8")
|
||||
username, password = decoded.split(":", 1)
|
||||
except (ValueError, UnicodeError, binascii.Error):
|
||||
raise unauthorized(True) from None
|
||||
user = storage.find_login(username)
|
||||
if user is None or not passwords.matches(user["password_hash"], password):
|
||||
raise unauthorized(True)
|
||||
return storage.public_user(user)
|
||||
|
||||
|
||||
def session_key(token):
|
||||
return "session:" + hashlib.sha256(token.encode()).hexdigest()
|
||||
|
||||
|
||||
def create_session(user):
|
||||
token = secrets.token_urlsafe(32)
|
||||
expires = datetime.now(timezone.utc) + timedelta(seconds=SESSION_TTL)
|
||||
value = {"user_id": user["id"], "expires_at": storage.utc(expires)}
|
||||
with available():
|
||||
sessions.set(session_key(token), json.dumps(value), ex=SESSION_TTL)
|
||||
return {"token": token, "token_type": "Bearer", "expires_at": value["expires_at"], "user": user}
|
||||
|
||||
|
||||
def current_user(header):
|
||||
token = credential(header, "Bearer")
|
||||
with available():
|
||||
value = sessions.get(session_key(token))
|
||||
if value is None:
|
||||
raise unauthorized()
|
||||
data = json.loads(value)
|
||||
if datetime.fromisoformat(data["expires_at"].replace("Z", "+00:00")) <= datetime.now(timezone.utc):
|
||||
raise unauthorized()
|
||||
user = storage.find_user(data["user_id"])
|
||||
if user is None:
|
||||
raise unauthorized()
|
||||
return user
|
||||
|
||||
|
||||
def logout(header):
|
||||
token = credential(header, "Bearer")
|
||||
with available():
|
||||
removed = sessions.delete(session_key(token))
|
||||
if not removed:
|
||||
raise unauthorized()
|
||||
|
||||
|
||||
def ready():
|
||||
with available():
|
||||
sessions.ping()
|
||||
@@ -0,0 +1,38 @@
|
||||
"""Идемпотентное создание приватного bucket отдельной административной учёткой."""
|
||||
import os
|
||||
import time
|
||||
from urllib.parse import urlsplit
|
||||
|
||||
from minio import Minio
|
||||
from minio.error import MinioException, S3Error
|
||||
import urllib3
|
||||
|
||||
from src.config import secret
|
||||
|
||||
|
||||
def bootstrap():
|
||||
endpoint = urlsplit(os.environ.get("S3_ENDPOINT", "http://s3:9000"))
|
||||
client = Minio(endpoint.netloc, access_key=secret("S3_ROOT_USER"), secret_key=secret("S3_ROOT_PASSWORD"),
|
||||
secure=endpoint.scheme == "https", region=os.environ.get("S3_REGION", "us-east-1"),
|
||||
http_client=urllib3.PoolManager(timeout=urllib3.Timeout(connect=1, read=3), retries=False))
|
||||
bucket = os.environ.get("S3_BUCKET", "messenger-attachments")
|
||||
deadline = time.monotonic() + 60
|
||||
while True:
|
||||
try:
|
||||
if not client.bucket_exists(bucket):
|
||||
client.make_bucket(bucket)
|
||||
print("Private bucket is ready; static IAM permits only authenticated accounts", flush=True)
|
||||
return
|
||||
except S3Error as error:
|
||||
if error.code in {"BucketAlreadyOwnedByYou", "BucketAlreadyExists"}:
|
||||
return
|
||||
if time.monotonic() >= deadline:
|
||||
raise RuntimeError("S3 bootstrap failed") from None
|
||||
except (MinioException, urllib3.exceptions.HTTPError, OSError):
|
||||
if time.monotonic() >= deadline:
|
||||
raise RuntimeError("S3 bootstrap timed out") from None
|
||||
time.sleep(1)
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
bootstrap()
|
||||
@@ -0,0 +1,60 @@
|
||||
"""Уровень 4: очистка только журнала незавершённых PUT, без полного обхода S3."""
|
||||
import argparse
|
||||
import json
|
||||
import logging
|
||||
import os
|
||||
import time
|
||||
|
||||
from src import db, object_store
|
||||
from src.attachments import lock_upload
|
||||
|
||||
|
||||
GRACE_SECONDS = int(os.environ.get("UPLOAD_CLEANUP_GRACE_SECONDS", "3600"))
|
||||
if GRACE_SECONDS < 60:
|
||||
raise ValueError("Безопасный grace period должен быть не меньше 60 секунд")
|
||||
|
||||
|
||||
def cleanup_once():
|
||||
result = {"removed": 0, "kept_ready": 0, "skipped_active": 0}
|
||||
with db.connection() as conn:
|
||||
candidates = conn.execute("""SELECT id, object_key FROM attachment_uploads
|
||||
WHERE created_at < clock_timestamp() - %s * interval '1 second'
|
||||
ORDER BY created_at LIMIT 100""", (GRACE_SECONDS,)).fetchall()
|
||||
for row in candidates:
|
||||
with db.connection() as conn:
|
||||
if not lock_upload(conn, row["object_key"], blocking=False):
|
||||
result["skipped_active"] += 1
|
||||
continue
|
||||
pending = conn.execute("""SELECT 1 FROM attachment_uploads WHERE id=%s
|
||||
AND created_at < clock_timestamp() - %s * interval '1 second' FOR UPDATE""",
|
||||
(row["id"], GRACE_SECONDS)).fetchone()
|
||||
if not pending:
|
||||
continue
|
||||
ready = conn.execute("SELECT 1 FROM attachments WHERE object_key=%s", (row["object_key"],)).fetchone()
|
||||
if ready:
|
||||
result["kept_ready"] += 1
|
||||
else:
|
||||
object_store.remove(row["object_key"])
|
||||
result["removed"] += 1
|
||||
conn.execute("DELETE FROM attachment_uploads WHERE id=%s", (row["id"],))
|
||||
return result
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
parser = argparse.ArgumentParser(description=__doc__)
|
||||
parser.add_argument("--once", action="store_true")
|
||||
args = parser.parse_args()
|
||||
db.pool.open(wait=True, timeout=15)
|
||||
try:
|
||||
while True:
|
||||
try:
|
||||
print(json.dumps(cleanup_once()), flush=True)
|
||||
except Exception as error:
|
||||
if args.once:
|
||||
raise
|
||||
logging.error("Cleanup postponed: %s", type(error).__name__)
|
||||
if args.once:
|
||||
break
|
||||
time.sleep(30)
|
||||
finally:
|
||||
db.pool.close()
|
||||
@@ -0,0 +1,20 @@
|
||||
"""Настройки и чтение локальных Docker secrets."""
|
||||
import os
|
||||
import socket
|
||||
from pathlib import Path
|
||||
|
||||
|
||||
def secret(name):
|
||||
return Path(os.environ[name + "_FILE"]).read_text().strip()
|
||||
|
||||
|
||||
SESSION_TTL = int(os.environ.get("SESSION_TTL_SECONDS", "3600"))
|
||||
if SESSION_TTL < 1:
|
||||
raise ValueError("SESSION_TTL_SECONDS должен быть положительным")
|
||||
if os.environ.get("SESSION_STORE", "valkey") != "valkey":
|
||||
raise ValueError("В этой реализации SESSION_STORE=valkey")
|
||||
|
||||
INSTANCE_ID = socket.gethostname()
|
||||
IDEMPOTENCY_TTL = int(os.environ.get("IDEMPOTENCY_TTL_SECONDS", "86400"))
|
||||
if IDEMPOTENCY_TTL < 86400:
|
||||
raise ValueError("IDEMPOTENCY_TTL_SECONDS должен быть не меньше 86400")
|
||||
@@ -0,0 +1,52 @@
|
||||
"""Ограниченный пул; каждый with connection() — отдельная транзакция."""
|
||||
from contextlib import contextmanager
|
||||
|
||||
import psycopg
|
||||
from psycopg.rows import dict_row
|
||||
from psycopg_pool import ConnectionPool, PoolTimeout, TooManyRequests
|
||||
|
||||
from src.config import secret
|
||||
from src.errors import ApiError
|
||||
|
||||
|
||||
IO_TIMEOUT = 2.0
|
||||
|
||||
|
||||
class TimedConnection(psycopg.Connection):
|
||||
def wait(self, gen, interval=0.1, timeout=None):
|
||||
# statement_timeout работает на сервере и не помогает при docker pause.
|
||||
# Ограничиваем само ожидание I/O: проверку пула, SQL, COMMIT и ROLLBACK.
|
||||
timeout = IO_TIMEOUT if timeout is None else min(timeout, IO_TIMEOUT)
|
||||
try:
|
||||
return super().wait(gen, interval=interval, timeout=timeout)
|
||||
except psycopg.OperationalError:
|
||||
# Не ждём отмены/ROLLBACK от зависшего сервера. Пул заменит соединение.
|
||||
self.close()
|
||||
raise
|
||||
|
||||
|
||||
pool = ConnectionPool(
|
||||
conninfo=secret("DATABASE_URL"), open=False,
|
||||
connection_class=TimedConnection,
|
||||
min_size=1, max_size=5, max_waiting=20, timeout=2,
|
||||
check=ConnectionPool.check_connection,
|
||||
kwargs={
|
||||
"row_factory": dict_row,
|
||||
"connect_timeout": 2,
|
||||
"options": "-c timezone=UTC -c statement_timeout=3000 -c lock_timeout=2000 -c idle_in_transaction_session_timeout=5000",
|
||||
},
|
||||
)
|
||||
|
||||
|
||||
@contextmanager
|
||||
def connection():
|
||||
try:
|
||||
with pool.connection() as conn:
|
||||
yield conn
|
||||
except (psycopg.OperationalError, PoolTimeout, TooManyRequests):
|
||||
raise ApiError(503, "unavailable", "PostgreSQL временно недоступен") from None
|
||||
|
||||
|
||||
def ready():
|
||||
with connection() as conn:
|
||||
conn.execute("SELECT 1")
|
||||
@@ -0,0 +1,27 @@
|
||||
"""общий формат ошибок"""
|
||||
|
||||
from fastapi import Request
|
||||
from fastapi.responses import JSONResponse
|
||||
|
||||
|
||||
class ApiError(Exception):
|
||||
def __init__(self, status: int, code: str, message: str, headers=None):
|
||||
super().__init__(message)
|
||||
self.status = status
|
||||
self.code = code
|
||||
self.message = message
|
||||
self.headers = headers or {}
|
||||
|
||||
|
||||
def error_response(request: Request, error: ApiError):
|
||||
return JSONResponse(
|
||||
status_code=error.status,
|
||||
content={
|
||||
"error": {
|
||||
"code": error.code,
|
||||
"message": error.message,
|
||||
"request_id": request.state.request_id,
|
||||
}
|
||||
},
|
||||
headers={"X-Request-Id": request.state.request_id, **error.headers},
|
||||
)
|
||||
@@ -0,0 +1,15 @@
|
||||
"""healthcheck докера"""
|
||||
|
||||
import json
|
||||
import os
|
||||
from urllib.request import urlopen
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
port = os.environ.get("APP_PORT", "8080")
|
||||
try:
|
||||
with urlopen(f"http://127.0.0.1:{port}/health/ready", timeout=2) as response:
|
||||
ready = response.status == 200 and json.load(response) == {"status": "ok"}
|
||||
raise SystemExit(0 if ready else 1)
|
||||
except (OSError, ValueError):
|
||||
raise SystemExit(1)
|
||||
@@ -0,0 +1,48 @@
|
||||
"""Версионируемые миграции с проверкой checksum и блокировкой."""
|
||||
import hashlib
|
||||
from pathlib import Path
|
||||
|
||||
from src import db
|
||||
|
||||
|
||||
DIRECTORY = Path(__file__).resolve().parents[1] / "migrations"
|
||||
|
||||
|
||||
def check():
|
||||
"""API только проверяет схему; DDL выполняет отдельный migrate-service."""
|
||||
with db.connection() as conn:
|
||||
for path in sorted(DIRECTORY.glob("*.sql")):
|
||||
row = conn.execute("SELECT checksum FROM schema_migrations WHERE version=%s", (path.name,)).fetchone()
|
||||
if row is None or row["checksum"] != hashlib.sha256(path.read_bytes()).hexdigest():
|
||||
raise RuntimeError("Сначала выполните миграции: " + path.name)
|
||||
|
||||
|
||||
def apply():
|
||||
applied = []
|
||||
with db.connection() as conn:
|
||||
conn.execute("SELECT pg_advisory_xact_lock(202602)")
|
||||
conn.execute("""
|
||||
CREATE TABLE IF NOT EXISTS schema_migrations (
|
||||
version text PRIMARY KEY, checksum text NOT NULL,
|
||||
applied_at timestamptz NOT NULL DEFAULT clock_timestamp()
|
||||
)
|
||||
""")
|
||||
for path in sorted(DIRECTORY.glob("*.sql")):
|
||||
checksum = hashlib.sha256(path.read_bytes()).hexdigest()
|
||||
existing = conn.execute("SELECT checksum FROM schema_migrations WHERE version=%s", (path.name,)).fetchone()
|
||||
if existing:
|
||||
if existing["checksum"] != checksum:
|
||||
raise RuntimeError("Изменена применённая миграция: " + path.name)
|
||||
continue
|
||||
conn.execute(path.read_text(), prepare=False)
|
||||
conn.execute("INSERT INTO schema_migrations(version, checksum) VALUES (%s, %s)", (path.name, checksum))
|
||||
applied.append(path.name)
|
||||
return applied
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
db.pool.open(wait=True, timeout=15)
|
||||
try:
|
||||
print("Migrations:", ", ".join(apply()) or "already applied")
|
||||
finally:
|
||||
db.pool.close()
|
||||
@@ -0,0 +1,56 @@
|
||||
"""допустимые поля и проверка данных"""
|
||||
|
||||
from uuid import UUID
|
||||
|
||||
from pydantic import BaseModel, ConfigDict, Field, ValidationInfo, field_validator, model_validator
|
||||
|
||||
|
||||
class RequestModel(BaseModel):
|
||||
model_config = ConfigDict(extra="forbid", strict=True)
|
||||
|
||||
@field_validator("*")
|
||||
@classmethod
|
||||
def check_strings(cls, value, info: ValidationInfo):
|
||||
if isinstance(value, str):
|
||||
if info.field_name != "text" and not value.strip():
|
||||
raise ValueError("Строка не должна состоять из пробелов")
|
||||
value.encode("utf-8")
|
||||
return value
|
||||
|
||||
|
||||
class CreateUser(RequestModel):
|
||||
username: str = Field(pattern=r"^[a-z0-9_]{3,32}$")
|
||||
display_name: str = Field(min_length=1, max_length=100)
|
||||
password: str = Field(min_length=12, max_length=128)
|
||||
|
||||
|
||||
class CreateChat(RequestModel):
|
||||
title: str = Field(min_length=1, max_length=100)
|
||||
member_ids: list[str] = Field(min_length=1, max_length=100)
|
||||
|
||||
@field_validator("member_ids")
|
||||
@classmethod
|
||||
def check_members(cls, values):
|
||||
member_ids = [str(UUID(value)) for value in values]
|
||||
if len(set(member_ids)) != len(member_ids):
|
||||
raise ValueError("Участники не должны повторяться")
|
||||
return member_ids
|
||||
|
||||
|
||||
class CreateMessage(RequestModel):
|
||||
text: str = Field(max_length=4000)
|
||||
attachment_ids: list[str] = Field(default_factory=list, max_length=10)
|
||||
|
||||
@field_validator("attachment_ids")
|
||||
@classmethod
|
||||
def check_attachments(cls, values):
|
||||
ids = [str(UUID(value)) for value in values]
|
||||
if len(ids) != len(set(ids)):
|
||||
raise ValueError("Вложения не должны повторяться")
|
||||
return ids
|
||||
|
||||
@model_validator(mode="after")
|
||||
def check_content(self):
|
||||
if not self.text.strip() and not self.attachment_ids:
|
||||
raise ValueError("Нужен текст или хотя бы одно вложение")
|
||||
return self
|
||||
@@ -0,0 +1,57 @@
|
||||
"""Один приватный bucket; короткие таймауты и отсутствие прозрачных повторов PUT."""
|
||||
from contextlib import contextmanager
|
||||
import os
|
||||
from urllib.parse import urlsplit
|
||||
|
||||
from minio import Minio
|
||||
from minio.error import MinioException
|
||||
import urllib3
|
||||
|
||||
from src.config import secret
|
||||
from src.errors import ApiError
|
||||
|
||||
|
||||
BUCKET = os.environ.get("S3_BUCKET", "messenger-attachments")
|
||||
endpoint = urlsplit(os.environ.get("S3_ENDPOINT", "http://s3:9000"))
|
||||
client = Minio(
|
||||
endpoint.netloc,
|
||||
access_key=secret("S3_ACCESS_KEY_ID"),
|
||||
secret_key=secret("S3_SECRET_ACCESS_KEY"),
|
||||
secure=endpoint.scheme == "https",
|
||||
region=os.environ.get("S3_REGION", "us-east-1"),
|
||||
http_client=urllib3.PoolManager(
|
||||
timeout=urllib3.Timeout(connect=1, read=3), retries=False, maxsize=4,
|
||||
),
|
||||
)
|
||||
|
||||
|
||||
@contextmanager
|
||||
def available():
|
||||
try:
|
||||
yield
|
||||
except (MinioException, urllib3.exceptions.HTTPError, OSError):
|
||||
raise ApiError(503, "unavailable", "Хранилище вложений временно недоступно") from None
|
||||
|
||||
|
||||
def ready():
|
||||
with available():
|
||||
if not client.bucket_exists(BUCKET):
|
||||
raise ApiError(503, "unavailable", "Хранилище вложений не готово")
|
||||
|
||||
|
||||
def put(key, file, size, content_type):
|
||||
with available():
|
||||
file.seek(0)
|
||||
# Весь обязательный диапазон <=10 MiB помещается в ОДИН PUT, без multipart.
|
||||
client.put_object(BUCKET, key, file, size, content_type=content_type,
|
||||
part_size=10 * 1024 * 1024, num_parallel_uploads=1)
|
||||
|
||||
|
||||
def get(key):
|
||||
with available():
|
||||
return client.get_object(BUCKET, key)
|
||||
|
||||
|
||||
def remove(key):
|
||||
with available():
|
||||
client.remove_object(BUCKET, key)
|
||||
@@ -0,0 +1,39 @@
|
||||
"""Курсор — scope, время и UUID; сами страницы выбирает PostgreSQL."""
|
||||
import base64
|
||||
import binascii
|
||||
from datetime import datetime
|
||||
import json
|
||||
import re
|
||||
from uuid import UUID
|
||||
|
||||
from src.errors import ApiError
|
||||
|
||||
|
||||
def parameters(limit, cursor, scope):
|
||||
try:
|
||||
if not re.fullmatch(r"[0-9]+", limit):
|
||||
raise ValueError
|
||||
size = int(limit)
|
||||
if not 1 <= size <= 100:
|
||||
raise ValueError
|
||||
anchor = None
|
||||
if cursor is not None:
|
||||
raw = base64.b64decode(cursor, altchars=b"-_", validate=True)
|
||||
data = json.loads(raw.decode("utf-8"))
|
||||
if not isinstance(data, dict) or set(data) != {"scope", "created_at", "id"}:
|
||||
raise ValueError
|
||||
if data["scope"] != scope or not isinstance(data["created_at"], str) or not data["created_at"].endswith("Z"):
|
||||
raise ValueError
|
||||
anchor = (datetime.fromisoformat(data["created_at"].replace("Z", "+00:00")), UUID(data["id"]))
|
||||
return size, anchor
|
||||
except (ValueError, TypeError, AttributeError, binascii.Error, RecursionError):
|
||||
raise ApiError(400, "invalid_request", "Неверный limit или cursor") from None
|
||||
|
||||
|
||||
def page(items, size, scope):
|
||||
cursor = None
|
||||
if len(items) > size:
|
||||
last = items[size - 1]
|
||||
value = {"scope": scope, "created_at": last["created_at"], "id": last["id"]}
|
||||
cursor = base64.urlsafe_b64encode(json.dumps(value).encode()).decode()
|
||||
return {"items": items[:size], "next_cursor": cursor}
|
||||
@@ -0,0 +1,22 @@
|
||||
"""Argon2id. Одновременно считаются не более двух хешей."""
|
||||
from threading import Semaphore
|
||||
|
||||
from argon2 import PasswordHasher
|
||||
from argon2.exceptions import VerificationError
|
||||
|
||||
|
||||
hasher = PasswordHasher(time_cost=2, memory_cost=19456, parallelism=1)
|
||||
slots = Semaphore(2)
|
||||
|
||||
|
||||
def hash_password(password):
|
||||
with slots:
|
||||
return hasher.hash(password)
|
||||
|
||||
|
||||
def matches(encoded, password):
|
||||
with slots:
|
||||
try:
|
||||
return hasher.verify(encoded, password)
|
||||
except VerificationError:
|
||||
return False
|
||||
+154
@@ -0,0 +1,154 @@
|
||||
"""Параметризованный SQL. Одна функция записи — одна транзакция."""
|
||||
from uuid import UUID, uuid4
|
||||
|
||||
from psycopg.errors import ForeignKeyViolation, UniqueViolation
|
||||
|
||||
from src import db, pagination
|
||||
from src.errors import ApiError
|
||||
from src.config import IDEMPOTENCY_TTL
|
||||
|
||||
|
||||
def utc(value):
|
||||
return value.isoformat(timespec="microseconds").replace("+00:00", "Z")
|
||||
|
||||
|
||||
def public_user(row):
|
||||
return {"id": str(row["id"]), "username": row["username"],
|
||||
"display_name": row["display_name"], "created_at": utc(row["created_at"])}
|
||||
|
||||
|
||||
def public_chat(row):
|
||||
return {"id": str(row["id"]), "title": row["title"],
|
||||
"member_ids": [str(value) for value in row["member_ids"]], "created_at": utc(row["created_at"])}
|
||||
|
||||
|
||||
def public_message(row):
|
||||
return {"id": str(row["id"]), "chat_id": str(row["chat_id"]), "sender_id": str(row["sender_id"]),
|
||||
"text": row["text"], "created_at": utc(row["created_at"]),
|
||||
"attachment_ids": [str(value) for value in row.get("attachment_ids", [])]}
|
||||
|
||||
|
||||
MESSAGE_ATTACHMENTS = """ARRAY(SELECT attachment_id FROM message_attachments
|
||||
WHERE message_id=m.id ORDER BY position) AS attachment_ids"""
|
||||
|
||||
|
||||
def create_user(username, display_name, password_hash):
|
||||
try:
|
||||
with db.connection() as conn:
|
||||
row = conn.execute("""INSERT INTO users(id, username, display_name, password_hash)
|
||||
VALUES (%s, %s, %s, %s) RETURNING *""", (uuid4(), username, display_name, password_hash)).fetchone()
|
||||
result = public_user(row)
|
||||
return result
|
||||
except UniqueViolation:
|
||||
raise ApiError(409, "conflict", "Имя пользователя уже занято") from None
|
||||
|
||||
|
||||
def find_login(username):
|
||||
with db.connection() as conn:
|
||||
return conn.execute("SELECT * FROM users WHERE username=%s", (username,)).fetchone()
|
||||
|
||||
|
||||
def find_user(user_id):
|
||||
with db.connection() as conn:
|
||||
row = conn.execute("SELECT * FROM users WHERE id=%s", (UUID(user_id),)).fetchone()
|
||||
return public_user(row) if row else None
|
||||
|
||||
|
||||
def create_chat(user_id, title, member_ids):
|
||||
if user_id not in member_ids:
|
||||
raise ApiError(400, "invalid_request", "Создатель должен входить в member_ids")
|
||||
try:
|
||||
with db.connection() as conn:
|
||||
row = conn.execute("INSERT INTO chats(id, title) VALUES (%s, %s) RETURNING *", (uuid4(), title)).fetchone()
|
||||
with conn.cursor() as cur:
|
||||
cur.executemany("INSERT INTO chat_members(chat_id, user_id) VALUES (%s, %s)",
|
||||
[(row["id"], UUID(member)) for member in member_ids])
|
||||
row["member_ids"] = member_ids
|
||||
result = public_chat(row)
|
||||
return result
|
||||
except ForeignKeyViolation:
|
||||
raise ApiError(400, "invalid_request", "Все участники должны существовать") from None
|
||||
|
||||
|
||||
def require_member(conn, user_id, chat_id):
|
||||
row = conn.execute("SELECT 1 FROM chat_members WHERE chat_id=%s AND user_id=%s", (UUID(chat_id), UUID(user_id))).fetchone()
|
||||
if row is None:
|
||||
raise ApiError(404, "not_found", "Чат не найден")
|
||||
|
||||
|
||||
def get_chat(user_id, chat_id):
|
||||
with db.connection() as conn:
|
||||
require_member(conn, user_id, chat_id)
|
||||
row = conn.execute("""SELECT c.*, ARRAY(SELECT user_id FROM chat_members WHERE chat_id=c.id ORDER BY user_id) AS member_ids
|
||||
FROM chats c WHERE c.id=%s""", (UUID(chat_id),)).fetchone()
|
||||
return public_chat(row)
|
||||
|
||||
|
||||
def list_chats(user_id, limit, cursor):
|
||||
scope = "chats:" + user_id
|
||||
size, anchor = pagination.parameters(limit, cursor, scope)
|
||||
with db.connection() as conn:
|
||||
if anchor:
|
||||
found = conn.execute("""SELECT 1 FROM chats c JOIN chat_members m ON m.chat_id=c.id
|
||||
WHERE m.user_id=%s AND (c.created_at, c.id)=(%s, %s)""", (UUID(user_id), *anchor)).fetchone()
|
||||
if not found:
|
||||
raise ApiError(400, "invalid_request", "Неверный cursor")
|
||||
condition = "AND (c.created_at, c.id) > (%s, %s)" if anchor else ""
|
||||
params = (UUID(user_id), *(anchor or ()), size + 1)
|
||||
rows = conn.execute("""WITH selected AS (
|
||||
SELECT c.* FROM chats c JOIN chat_members own ON own.chat_id=c.id
|
||||
WHERE own.user_id=%s """ + condition + """ ORDER BY c.created_at, c.id LIMIT %s
|
||||
) SELECT c.*, ARRAY(SELECT user_id FROM chat_members WHERE chat_id=c.id ORDER BY user_id) AS member_ids
|
||||
FROM selected c ORDER BY c.created_at, c.id""", params).fetchall()
|
||||
return pagination.page([public_chat(row) for row in rows], size, scope)
|
||||
|
||||
|
||||
def create_message(user_id, chat_id, text, key, attachment_ids=()):
|
||||
attachment_ids = [UUID(value) for value in attachment_ids]
|
||||
with db.connection() as conn:
|
||||
require_member(conn, user_id, chat_id)
|
||||
# Одна блокировка на область ключа во всех API-процессах.
|
||||
# Побочный эффект и результат повтора фиксируются одной транзакцией.
|
||||
scope = user_id + ":POST:/api/v1/chats/" + chat_id + "/messages:" + key
|
||||
conn.execute("SELECT pg_advisory_xact_lock(hashtextextended(%s, 0))", (scope,))
|
||||
previous = conn.execute("SELECT m.*, i.request_text, i.request_attachment_ids, " + MESSAGE_ATTACHMENTS + """ FROM message_idempotency i
|
||||
JOIN messages m ON m.id=i.message_id
|
||||
WHERE i.user_id=%s AND i.chat_id=%s AND i.key=%s AND i.expires_at>clock_timestamp()""",
|
||||
(UUID(user_id), UUID(chat_id), key)).fetchone()
|
||||
if previous:
|
||||
if previous["request_text"] != text or previous["request_attachment_ids"] != attachment_ids:
|
||||
raise ApiError(409, "conflict", "Этот ключ уже использован с другим сообщением")
|
||||
return public_message(previous)
|
||||
if attachment_ids:
|
||||
available = conn.execute("SELECT id FROM attachments WHERE chat_id=%s AND id=ANY(%s)",
|
||||
(UUID(chat_id), attachment_ids)).fetchall()
|
||||
if len(available) != len(attachment_ids):
|
||||
raise ApiError(404, "not_found", "Вложение не найдено в этом чате")
|
||||
conn.execute("DELETE FROM message_idempotency WHERE user_id=%s AND chat_id=%s AND key=%s",
|
||||
(UUID(user_id), UUID(chat_id), key))
|
||||
row = conn.execute("""INSERT INTO messages(id, chat_id, sender_id, text) VALUES (%s, %s, %s, %s)
|
||||
RETURNING *""", (uuid4(), UUID(chat_id), UUID(user_id), text)).fetchone()
|
||||
for position, attachment_id in enumerate(attachment_ids):
|
||||
conn.execute("INSERT INTO message_attachments(message_id, attachment_id, position) VALUES (%s, %s, %s)",
|
||||
(row["id"], attachment_id, position))
|
||||
conn.execute("""INSERT INTO message_idempotency(user_id, chat_id, key, request_text, request_attachment_ids, message_id, expires_at)
|
||||
VALUES (%s, %s, %s, %s, %s, %s, clock_timestamp() + %s * interval '1 second')""",
|
||||
(UUID(user_id), UUID(chat_id), key, text, attachment_ids, row["id"], IDEMPOTENCY_TTL))
|
||||
row["attachment_ids"] = attachment_ids
|
||||
result = public_message(row)
|
||||
return result
|
||||
|
||||
|
||||
def list_messages(user_id, chat_id, limit, cursor):
|
||||
scope = "messages:" + chat_id
|
||||
size, anchor = pagination.parameters(limit, cursor, scope)
|
||||
with db.connection() as conn:
|
||||
require_member(conn, user_id, chat_id)
|
||||
if anchor:
|
||||
found = conn.execute("SELECT 1 FROM messages WHERE chat_id=%s AND (created_at, id)=(%s, %s)", (UUID(chat_id), *anchor)).fetchone()
|
||||
if not found:
|
||||
raise ApiError(400, "invalid_request", "Неверный cursor")
|
||||
condition = "AND (m.created_at, m.id) > (%s, %s)" if anchor else ""
|
||||
rows = conn.execute("SELECT m.*, " + MESSAGE_ATTACHMENTS + " FROM messages m WHERE m.chat_id=%s " + condition +
|
||||
" ORDER BY m.created_at, m.id LIMIT %s", (UUID(chat_id), *(anchor or ()), size + 1)).fetchall()
|
||||
return pagination.page([public_message(row) for row in rows], size, scope)
|
||||
@@ -0,0 +1,275 @@
|
||||
"""Реальные отказы/очистка/память уровня 4; только временный тестовый стенд."""
|
||||
from concurrent.futures import ThreadPoolExecutor
|
||||
import hashlib
|
||||
import io
|
||||
import json
|
||||
import os
|
||||
import socket
|
||||
import subprocess
|
||||
import threading
|
||||
import time
|
||||
from urllib.parse import urlsplit
|
||||
from uuid import uuid4
|
||||
|
||||
from PIL import Image
|
||||
|
||||
from helpers import Client, ROOT
|
||||
from client import Failure
|
||||
|
||||
|
||||
def run_checks(base, env, compose, apis, script, sql):
|
||||
result = {}
|
||||
client = Client(base, timeout=30)
|
||||
alice, bob, _, chat = client.bootstrap()
|
||||
png = (ROOT / "tests/fixtures/sample.png").read_bytes()
|
||||
upload_path = "/api/v1/chats/" + chat["id"] + "/attachments?filename=sample.png"
|
||||
|
||||
def upload():
|
||||
return client.call("POST", upload_path, 201, actor=alice, raw=png,
|
||||
headers={"Content-Type": "image/png"}, schema="Attachment")
|
||||
|
||||
def inside(code, data=None):
|
||||
completed = subprocess.run(["docker", "exec", "-i", apis()[0]["Id"], "python", "-c", code],
|
||||
input=json.dumps(data), capture_output=True, text=True, timeout=45, check=True)
|
||||
return json.loads(completed.stdout)
|
||||
|
||||
def cleanup():
|
||||
return inside("from src import db; from src.cleanup import cleanup_once; import json; "
|
||||
"db.pool.open(wait=True); print(json.dumps(cleanup_once())); db.pool.close()")
|
||||
|
||||
def stat(key):
|
||||
return inside("import json,sys; from src import object_store; from minio.error import S3Error\n"
|
||||
"key=json.load(sys.stdin)\n"
|
||||
"try:\n r=object_store.client.stat_object(object_store.BUCKET,key); print(json.dumps({'size':r.size}))\n"
|
||||
"except S3Error as e:\n print(json.dumps({'error':e.code}))", key)
|
||||
|
||||
def age(key):
|
||||
sql("UPDATE attachment_uploads SET created_at=clock_timestamp()-interval '2 hours' WHERE object_key='" + key + "'")
|
||||
|
||||
compose("stop", "cleanup")
|
||||
try:
|
||||
for _ in range(2):
|
||||
compose("run", "--rm", "s3-bootstrap")
|
||||
ready = upload()["json"]
|
||||
key = sql("SELECT object_key FROM attachments WHERE id='" + ready["id"] + "'")
|
||||
backend_id = compose("ps", "-q", "s3-storage")
|
||||
backend = json.loads(subprocess.check_output(["docker", "inspect", backend_id], text=True))[0]
|
||||
assert not set(backend["NetworkSettings"]["Networks"]) & set(apis()[0]["NetworkSettings"]["Networks"])
|
||||
backend_ip = next(iter(backend["NetworkSettings"]["Networks"].values()))["IPAddress"]
|
||||
# Вызов S3 напрямую из контейнера клиента, минуя HTTP API приложения.
|
||||
result["private_bucket"] = inside("""
|
||||
import io,json,socket,sys
|
||||
from urllib.error import HTTPError
|
||||
from urllib.request import urlopen
|
||||
from minio.error import S3Error
|
||||
from src import object_store
|
||||
data=json.load(sys.stdin); key=data['key']
|
||||
try:
|
||||
urlopen('http://s3:9000/'+object_store.BUCKET+'/'+key,timeout=3)
|
||||
raise AssertionError('public original')
|
||||
except HTTPError as e:
|
||||
assert e.code == 403
|
||||
for operation in (lambda: object_store.client.make_bucket('forbidden-bucket'),
|
||||
lambda: object_store.client.put_object(object_store.BUCKET,'outside-prefix',io.BytesIO(b'x'),1)):
|
||||
try:
|
||||
operation()
|
||||
raise AssertionError('excess application permissions')
|
||||
except S3Error as e:
|
||||
assert e.code == 'AccessDenied', e.code
|
||||
for port in (9333,8888,8080):
|
||||
with socket.socket() as connection:
|
||||
connection.settimeout(1)
|
||||
assert connection.connect_ex(('s3',port)) != 0, 'admin/backend port open'
|
||||
with socket.socket() as connection:
|
||||
connection.settimeout(.5)
|
||||
assert connection.connect_ex((data['backend_ip'],port)) != 0, 'storage network reachable from API'
|
||||
print(json.dumps({'anonymous_get':403,'create_bucket':'AccessDenied','write_outside_prefix':'AccessDenied',
|
||||
'admin_ports_unreachable':[9333,8888,8080],'storage_network_isolated':True,'bootstrap_runs':2}))
|
||||
""", {"key":key, "backend_ip":backend_ip})
|
||||
print("PASS: private S3, limited credentials, isolated administration, repeated bootstrap", flush=True)
|
||||
|
||||
# Останавливаем именно реплику, которая ответила на upload, а затем читаем другой.
|
||||
uploaded = upload()
|
||||
target = uploaded["headers"]["X-Instance-Id"]
|
||||
stopped_at = time.monotonic()
|
||||
subprocess.run([str(ROOT / "scripts/stop-one.sh")], cwd=ROOT,
|
||||
env=dict(env, TARGET_INSTANCE_ID=target), check=True, timeout=15)
|
||||
script("wait-ready.sh")
|
||||
while True:
|
||||
try:
|
||||
response = client.call("GET", "/api/v1/attachments/" + uploaded["json"]["id"] + "/content", actor=bob)
|
||||
break
|
||||
except Failure:
|
||||
assert time.monotonic() - stopped_at < 10, "download failover exceeded 10 seconds"
|
||||
time.sleep(.1)
|
||||
assert response["bytes"] == png and response["headers"]["X-Instance-Id"] != target
|
||||
stopped = next(info for info in apis() if info["Config"]["Hostname"] == target)
|
||||
assert not stopped["State"]["Running"]
|
||||
result["upload_replica_failover"] = {"uploaded_by": target, "stopped_container": stopped["Id"],
|
||||
"downloaded_by": response["headers"]["X-Instance-Id"], "sha256": hashlib.sha256(png).hexdigest(),
|
||||
"recovery_seconds":round(time.monotonic()-stopped_at,3)}
|
||||
compose("start", "api")
|
||||
script("wait-ready.sh")
|
||||
print("PASS: original downloaded through another replica after stopping uploader", flush=True)
|
||||
|
||||
# Незавершённое HTTP-тело не достигает S3 и не создаёт метаданных/журнала.
|
||||
before = sql("SELECT (SELECT count(*) FROM attachments)||':'||(SELECT count(*) FROM attachment_uploads)")
|
||||
address = urlsplit(base)
|
||||
with socket.create_connection((address.hostname, address.port), timeout=3) as connection:
|
||||
headers = ("POST " + upload_path + " HTTP/1.1\r\nHost: localhost\r\nAuthorization: Bearer " + alice["token"] +
|
||||
"\r\nContent-Type: image/png\r\nContent-Length: 1000000\r\n\r\n").encode()
|
||||
connection.sendall(headers + png[:30])
|
||||
time.sleep(0.5)
|
||||
assert sql("SELECT (SELECT count(*) FROM attachments)||':'||(SELECT count(*) FROM attachment_uploads)") == before
|
||||
result["interrupted_body"] = {"metadata_or_journal_created": False}
|
||||
|
||||
# Детерминированный реальный отказ PostgreSQL ПОСЛЕ успешного S3 PUT.
|
||||
sql("""CREATE FUNCTION lab4_reject_attachment() RETURNS trigger LANGUAGE plpgsql AS $$
|
||||
BEGIN RAISE EXCEPTION 'injected storage failure' USING ERRCODE='08006'; END $$;
|
||||
CREATE TRIGGER lab4_reject BEFORE INSERT ON attachments FOR EACH ROW EXECUTE FUNCTION lab4_reject_attachment();""")
|
||||
try:
|
||||
failure = client.call("POST", upload_path, 503, actor=alice, raw=png, headers={"Content-Type": "image/png"})
|
||||
assert failure["json"]["error"]["code"] == "unavailable"
|
||||
finally:
|
||||
sql("DROP TRIGGER lab4_reject ON attachments; DROP FUNCTION lab4_reject_attachment()")
|
||||
pending_key = sql("SELECT object_key FROM attachment_uploads ORDER BY created_at DESC LIMIT 1")
|
||||
assert stat(pending_key)["size"] == len(png)
|
||||
assert sql("SELECT count(*) FROM attachments WHERE object_key='" + pending_key + "'") == "0"
|
||||
assert cleanup()["removed"] == 0
|
||||
age(pending_key)
|
||||
lock_code = ("from src import db; from src.attachments import lock_upload; import sys\n"
|
||||
"db.pool.open(wait=True)\nwith db.connection() as c:\n"
|
||||
" lock_upload(c,'" + pending_key + "'); print('locked',flush=True); sys.stdin.readline()\n"
|
||||
"db.pool.close()")
|
||||
holder = subprocess.Popen(["docker", "exec", "-i", apis()[0]["Id"], "python", "-u", "-c", lock_code],
|
||||
stdin=subprocess.PIPE, stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True)
|
||||
try:
|
||||
assert holder.stdout.readline().strip() == "locked"
|
||||
assert cleanup()["skipped_active"] == 1
|
||||
assert stat(pending_key)["size"] == len(png)
|
||||
finally:
|
||||
holder.communicate("\n", timeout=10)
|
||||
assert cleanup()["removed"] == 1
|
||||
assert stat(pending_key).get("error") == "NoSuchKey"
|
||||
assert cleanup()["removed"] == 0
|
||||
# Даже устаревшая ошибочная запись журнала не позволяет удалить ready-файл.
|
||||
sql("INSERT INTO attachment_uploads(id,object_key,created_at) VALUES ('" + str(uuid4()) + "','" + key +
|
||||
"',clock_timestamp()-interval '2 hours')")
|
||||
assert cleanup()["kept_ready"] == 1
|
||||
assert client.call("GET", "/api/v1/attachments/" + ready["id"] + "/content", actor=bob)["bytes"] == png
|
||||
result["compensation"] = {"failure_after_put":503, "orphan_recorded":True, "fresh_kept":True,
|
||||
"active_locked_kept":True, "expired_removed":True, "ready_kept":True, "repeat_safe":True}
|
||||
print("PASS: post-PUT DB failure recorded; cleanup protects fresh, active and ready uploads", flush=True)
|
||||
|
||||
try:
|
||||
compose("stop", "--timeout", "8", "s3")
|
||||
result["s3_outage"] = inside("""
|
||||
import json,sys
|
||||
from urllib.request import Request,urlopen
|
||||
from urllib.error import HTTPError
|
||||
data=json.load(sys.stdin)
|
||||
statuses={}
|
||||
for name,method,path,body in [('live','GET','/health/live',None),('ready','GET','/health/ready',None),
|
||||
('download','GET','/api/v1/attachments/'+data['id']+'/content',None),
|
||||
('upload','POST',data['upload'],bytes.fromhex(data['png']))]:
|
||||
req=Request('http://127.0.0.1:8080'+path,data=body,method=method,
|
||||
headers={'Authorization':'Bearer '+data['token'],'Content-Type':'image/png'})
|
||||
try: response=urlopen(req,timeout=8)
|
||||
except HTTPError as error: response=error
|
||||
with response:
|
||||
statuses[name]=response.status
|
||||
payload=json.load(response)
|
||||
if name!='live':
|
||||
assert response.status==503 and payload['error']['code']=='unavailable'
|
||||
assert payload['error']['request_id']==response.headers['X-Request-Id']
|
||||
assert statuses['live']==200
|
||||
print(json.dumps(statuses))
|
||||
""", {"id":ready["id"], "token":alice["token"], "upload":upload_path, "png":png.hex()})
|
||||
finally:
|
||||
compose("start", "s3")
|
||||
script("wait-ready.sh")
|
||||
assert client.call("GET", "/api/v1/attachments/" + ready["id"] + "/content", actor=bob)["bytes"] == png
|
||||
sql("UPDATE attachment_uploads SET created_at=clock_timestamp()-interval '2 hours'")
|
||||
assert cleanup()["removed"] >= 1
|
||||
result["s3_outage"]["original_preserved_after_recovery"] = True
|
||||
print("PASS: S3 outage gives API 503; recovery preserves original and session", flush=True)
|
||||
|
||||
# Доказываем работу постоянного worker, а не только ручного вызова cleanup_once.
|
||||
inside("import io,json; from src import object_store; "
|
||||
"object_store.put('attachments/cleanup-worker-test',io.BytesIO(b'x'),1,'application/octet-stream'); print('{}')")
|
||||
sql("INSERT INTO attachment_uploads(id,object_key,created_at) VALUES ('" + str(uuid4()) +
|
||||
"','attachments/cleanup-worker-test',clock_timestamp()-interval '2 hours')")
|
||||
compose("start", "cleanup")
|
||||
deadline = time.monotonic() + 40
|
||||
while sql("SELECT count(*) FROM attachment_uploads WHERE object_key='attachments/cleanup-worker-test'") != "0":
|
||||
assert time.monotonic() < deadline, "automatic cleanup not running"
|
||||
time.sleep(0.2)
|
||||
assert stat('attachments/cleanup-worker-test').get("error") == "NoSuchKey"
|
||||
result["compensation"]["automatic_worker"] = True
|
||||
|
||||
# 10 одновременно отправляемых реальных PNG ~5.5 MiB; монитор cgroup каждые 20 ms.
|
||||
image = Image.frombytes("RGB", (1600, 1200), os.urandom(1600 * 1200 * 3))
|
||||
buffer = io.BytesIO()
|
||||
image.save(buffer, format="PNG")
|
||||
image.close()
|
||||
data = buffer.getvalue()
|
||||
expected_sha = hashlib.sha256(data).hexdigest()
|
||||
monitor_code = """
|
||||
from pathlib import Path
|
||||
import json,sys,threading,time
|
||||
root=Path('/sys/fs/cgroup'); stop=threading.Event(); samples=[]
|
||||
threading.Thread(target=lambda:(sys.stdin.readline(),stop.set()),daemon=True).start()
|
||||
start=time.monotonic(); before=int((root/'memory.current').read_text())
|
||||
print('ready',flush=True)
|
||||
while not stop.is_set():
|
||||
samples.append([round(time.monotonic()-start,3),int((root/'memory.current').read_text())])
|
||||
stop.wait(.02)
|
||||
print(json.dumps({'baseline_bytes':before,'sample_peak_bytes':max(s[1] for s in samples),
|
||||
'lifetime_peak_bytes':int((root/'memory.peak').read_text()),'samples':samples}),flush=True)
|
||||
"""
|
||||
monitors = []
|
||||
responses = []
|
||||
try:
|
||||
for info in apis():
|
||||
process = subprocess.Popen(["docker", "exec", "-i", info["Id"], "python", "-u", "-c", monitor_code],
|
||||
stdin=subprocess.PIPE, stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True)
|
||||
assert process.stdout.readline().strip() == "ready"
|
||||
monitors.append((info, process))
|
||||
barrier = threading.Barrier(10)
|
||||
def send(_):
|
||||
concurrent_client = Client(base, timeout=60)
|
||||
barrier.wait(timeout=15)
|
||||
return concurrent_client.call("POST", upload_path, 201, actor=alice, raw=data,
|
||||
headers={"Content-Type":"image/png"}, schema="Attachment")
|
||||
started = time.monotonic()
|
||||
with ThreadPoolExecutor(max_workers=10) as pool:
|
||||
responses = list(pool.map(send, range(10)))
|
||||
elapsed = time.monotonic() - started
|
||||
finally:
|
||||
memory = []
|
||||
for info, process in monitors:
|
||||
output, error = process.communicate("\n", timeout=10)
|
||||
assert process.returncode == 0, error
|
||||
measurement = json.loads(output)
|
||||
measurement.update({"instance": info["Config"]["Hostname"], "limit_bytes": info["HostConfig"]["Memory"]})
|
||||
assert measurement["sample_peak_bytes"] < measurement["limit_bytes"]
|
||||
memory.append(measurement)
|
||||
assert len(responses) == 10
|
||||
assert len({r["headers"]["X-Instance-Id"] for r in responses}) >= 2
|
||||
for response in responses:
|
||||
assert response["json"]["sha256"] == expected_sha and response["json"]["size_bytes"] == len(data)
|
||||
original = client.call("GET", "/api/v1/attachments/" + response["json"]["id"] + "/content", actor=bob)
|
||||
assert hashlib.sha256(original["bytes"]).hexdigest() == expected_sha
|
||||
assert all(not i["State"]["OOMKilled"] for i in apis())
|
||||
timings = sorted(r["elapsed"] * 1000 for r in responses)
|
||||
result["parallel_uploads"] = {"concurrency":10, "successful":10, "errors":0,
|
||||
"dimensions":[1600,1200], "size_bytes":len(data), "sha256":expected_sha,
|
||||
"duration_seconds":round(elapsed,3), "successful_rps":round(10/elapsed,3),
|
||||
"p50_ms":round(timings[4],3), "p95_ms":round(timings[-1],3),
|
||||
"memory_sample_interval_seconds":0.02, "memory_includes_monitor_process":True,
|
||||
"memory":memory, "all_original_checksums_verified":True, "oom_killed":False}
|
||||
print("PASS: 10 concurrent real PNG uploads; all checksums match; memory peaks:",
|
||||
[m["sample_peak_bytes"] for m in memory], flush=True)
|
||||
return result
|
||||
finally:
|
||||
compose("start", "s3", "api", "cleanup")
|
||||
@@ -0,0 +1,319 @@
|
||||
"""Проверки уровня 4 в отдельном Compose project с синтетическими данными."""
|
||||
from concurrent.futures import ThreadPoolExecutor
|
||||
from datetime import datetime, timezone
|
||||
import json
|
||||
import os
|
||||
import platform
|
||||
import socket
|
||||
import subprocess
|
||||
import sys
|
||||
import threading
|
||||
import time
|
||||
from urllib.error import HTTPError
|
||||
from urllib.request import urlopen
|
||||
from uuid import uuid4
|
||||
|
||||
from helpers import Client, ROOT
|
||||
from client import Failure
|
||||
from resilience import history
|
||||
from attachment_checks import run_checks
|
||||
from postgres_pause import check_postgres_pause
|
||||
|
||||
|
||||
def docker(*args):
|
||||
return subprocess.check_output(["docker", *args], text=True, timeout=180).strip()
|
||||
|
||||
|
||||
def main():
|
||||
with socket.socket() as sock:
|
||||
sock.bind(("127.0.0.1", 0))
|
||||
port = sock.getsockname()[1]
|
||||
project = "lab4-check-" + uuid4().hex[:10]
|
||||
base = f"http://127.0.0.1:{port}"
|
||||
env = dict(os.environ, COMPOSE_PROJECT_NAME=project, HOST_PORT=str(port),
|
||||
API_REPLICAS="2", SESSION_TTL_SECONDS="3600", BASE_URL=base)
|
||||
result = {"utc": datetime.now(timezone.utc).isoformat(), "project": project,
|
||||
"base_url": base, "host": platform.system() + " " + platform.machine(),
|
||||
"docker": docker("info", "--format", "{{.ServerVersion}} {{.Architecture}} CPUs={{.NCPU}} RAM={{.MemTotal}}"),
|
||||
"commit": docker("compose", "version", "--short"),
|
||||
"profile": {"workers": 4, "pause_seconds": 0.05, "operation": "POST message then GET history, same-key retry after uncertain POST"}}
|
||||
result["compose_version"] = result.pop("commit")
|
||||
result["source_commit"] = subprocess.check_output(["git", "rev-parse", "HEAD"], cwd=ROOT, text=True).strip()
|
||||
result["working_tree"] = True
|
||||
|
||||
def compose(*args):
|
||||
return subprocess.check_output(["docker", "compose", *args], cwd=ROOT, env=env, text=True, timeout=180).strip()
|
||||
|
||||
def script(name):
|
||||
subprocess.run([str(ROOT / "scripts" / name)], cwd=ROOT, env=env, check=True, timeout=240)
|
||||
|
||||
def inspect_all():
|
||||
ids = compose("ps", "-a", "-q").split()
|
||||
return json.loads(docker("inspect", *ids))
|
||||
|
||||
def apis():
|
||||
return [i for i in inspect_all() if i["Config"]["Labels"]["com.docker.compose.service"] == "api"]
|
||||
|
||||
def metadata(info):
|
||||
return {"id": info["Id"], "instance": info["Config"]["Hostname"],
|
||||
"service": info["Config"]["Labels"]["com.docker.compose.service"],
|
||||
"image": info["Image"], "started_at": info["State"]["StartedAt"],
|
||||
"running": info["State"]["Running"], "exit_code": info["State"]["ExitCode"],
|
||||
"memory_bytes": info["HostConfig"]["Memory"], "nano_cpus": info["HostConfig"]["NanoCpus"],
|
||||
"published_ports": info["HostConfig"]["PortBindings"],
|
||||
"mounts": [{"type": m["Type"], "destination": m["Destination"], "name": m.get("Name")} for m in info["Mounts"]]}
|
||||
|
||||
def sql(query):
|
||||
return compose("exec", "-T", "postgres", "psql", "-U", "messenger", "-d", "messenger", "-At", "-c", query)
|
||||
|
||||
def check_shutdown():
|
||||
info = apis()[0]
|
||||
# Внутреннее подключение через docker exec не публикует порт API на хост.
|
||||
pending_code = """import socket,time
|
||||
s=socket.create_connection(('127.0.0.1',8080),timeout=2)
|
||||
s.sendall(b'POST /api/v1/users HTTP/1.1\\r\\nHost: localhost\\r\\nContent-Type: application/json\\r\\nContent-Length: 1000\\r\\nExpect: 100-continue\\r\\n\\r\\n')
|
||||
assert b'100 Continue' in s.recv(1024)
|
||||
s.sendall(b'{"username":')
|
||||
print('pending',flush=True)
|
||||
time.sleep(30)
|
||||
"""
|
||||
pending = subprocess.Popen(["docker", "exec", info["Id"], "python", "-u", "-c", pending_code],
|
||||
stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True)
|
||||
try:
|
||||
assert pending.stdout.readline().strip() == "pending"
|
||||
started = time.monotonic()
|
||||
docker("kill", "--signal=TERM", info["Id"])
|
||||
first_refusal = None
|
||||
while True:
|
||||
state = json.loads(docker("inspect", info["Id"]))[0]["State"]
|
||||
if not state["Running"]:
|
||||
break
|
||||
assert time.monotonic() - started < 8
|
||||
probe = subprocess.run(["docker", "exec", info["Id"], "python", "-c",
|
||||
"import socket; s=socket.socket(); s.settimeout(.2); raise SystemExit(s.connect_ex(('127.0.0.1',8080)))"],
|
||||
capture_output=True, timeout=3)
|
||||
if probe.returncode and first_refusal is None:
|
||||
first_refusal = time.monotonic() - started
|
||||
time.sleep(0.1)
|
||||
elapsed = time.monotonic() - started
|
||||
assert first_refusal is not None and first_refusal < elapsed < 8
|
||||
assert state["ExitCode"] == 0 and not state["OOMKilled"]
|
||||
logs = subprocess.run(["docker", "logs", info["Id"]], capture_output=True, text=True, check=True)
|
||||
assert "Application shutdown complete" in logs.stdout + logs.stderr
|
||||
result["sigterm"] = {"instance": info["Config"]["Hostname"], "unfinished_request": True,
|
||||
"shutdown_seconds": round(elapsed, 3), "new_connections_refused_seconds": round(first_refusal, 3),
|
||||
"exit_code": state["ExitCode"], "oom_killed": state["OOMKilled"]}
|
||||
print("PASS: SIGTERM with unfinished request:", json.dumps(result["sigterm"]), flush=True)
|
||||
finally:
|
||||
pending.communicate(timeout=10)
|
||||
compose("start", "api")
|
||||
script("wait-ready.sh")
|
||||
|
||||
def load_action(label, action, target=None):
|
||||
client = Client(base, timeout=2)
|
||||
alice, bob, _, chat = client.bootstrap()
|
||||
original = client.message(alice, chat, "До воздействия")["json"]
|
||||
stop = threading.Event()
|
||||
lock = threading.Lock()
|
||||
successes, errors, confirmed = [], [], {}
|
||||
started = time.monotonic()
|
||||
|
||||
def worker(index):
|
||||
c = Client(base, timeout=2)
|
||||
key = uuid4().hex
|
||||
while not stop.is_set():
|
||||
for method in ("POST", "GET"):
|
||||
try:
|
||||
if method == "POST":
|
||||
response = c.message(alice, chat, "load-" + key, key=key)
|
||||
with lock:
|
||||
confirmed[response["json"]["id"]] = response["json"]
|
||||
key = uuid4().hex
|
||||
else:
|
||||
response = c.call("GET", "/api/v1/chats/" + chat["id"] + "/messages?limit=100",
|
||||
actor=bob, schema="MessagePage")
|
||||
with lock:
|
||||
successes.append((time.monotonic() - started, method,
|
||||
response["headers"]["X-Instance-Id"], response["elapsed"]))
|
||||
except Failure as exc:
|
||||
with lock:
|
||||
errors.append((time.monotonic() - started, method, str(exc)))
|
||||
stop.wait(0.05)
|
||||
|
||||
with ThreadPoolExecutor(max_workers=4) as pool:
|
||||
futures = [pool.submit(worker, i) for i in range(4)]
|
||||
time.sleep(1)
|
||||
action_start = time.monotonic() - started
|
||||
try:
|
||||
action_info = action()
|
||||
action_end = time.monotonic() - started
|
||||
# Охватывает обнаружение отказа и устойчивую работу после него.
|
||||
time.sleep(max(3, 15 - (action_end - action_start)))
|
||||
finally:
|
||||
stop.set()
|
||||
for future in futures:
|
||||
future.result()
|
||||
elapsed = time.monotonic() - started
|
||||
items = history(client, bob, chat)
|
||||
by_id = {m["id"]: m for m in items}
|
||||
assert len(items) == len(by_id) == len({m["text"] for m in items}), "Повтор создал дубль"
|
||||
assert by_id.get(original["id"]) == original
|
||||
assert all(by_id.get(mid) == msg for mid, msg in confirmed.items()), "Потеря подтверждённого сообщения"
|
||||
after = [s for s in successes if s[0] >= action_end]
|
||||
assert {s[1] for s in after} == {"POST", "GET"}, "Нет чтений/записей после воздействия"
|
||||
recovery = {method: round(min(s[0] for s in successes if s[0] >= action_start and s[1] == method) - action_start, 3)
|
||||
for method in ("POST", "GET")}
|
||||
assert max(recovery.values()) <= 10, recovery
|
||||
max_gap = {}
|
||||
for method in ("POST", "GET"):
|
||||
moments = sorted(s[0] for s in successes if s[1] == method)
|
||||
max_gap[method] = round(max(b - a for a, b in zip(moments, moments[1:])), 3)
|
||||
assert max(max_gap.values()) <= 10, max_gap
|
||||
if target:
|
||||
assert target not in {s[2] for s in after[-20:]}, "Остановленная реплика ещё отвечает"
|
||||
buckets = []
|
||||
for second in range(int(elapsed) + 1):
|
||||
buckets.append({"second": second, "successes": sum(second <= s[0] < second + 1 for s in successes),
|
||||
"errors": sum(second <= e[0] < second + 1 for e in errors)})
|
||||
latencies = sorted(s[3] * 1000 for s in successes)
|
||||
summary = {"label": label, "duration_seconds": round(elapsed, 3), "successful_requests": len(successes),
|
||||
"successful_writes": len(confirmed), "errors": len(errors), "successful_rps": round(len(successes) / elapsed, 2),
|
||||
"first_success_after_action_seconds": recovery, "maximum_success_gap_seconds": max_gap,
|
||||
"action_start_seconds": round(action_start, 3), "action_end_seconds": round(action_end, 3),
|
||||
"p50_ms": round(latencies[len(latencies) // 2], 3),
|
||||
"p95_ms": round(latencies[int(len(latencies) * .95)], 3),
|
||||
"confirmed_data_preserved": True, "duplicate_messages": 0,
|
||||
"instances": sorted({s[2] for s in successes}), "per_second": buckets,
|
||||
"error_samples": errors[:5], "action": action_info}
|
||||
print(json.dumps({k: v for k, v in summary.items() if k not in ("per_second", "error_samples", "action")}, ensure_ascii=False), flush=True)
|
||||
return summary
|
||||
|
||||
print("Command: ./scripts/check-docker.sh; project:", project, flush=True)
|
||||
print("Docker:", result["docker"], flush=True)
|
||||
try:
|
||||
script("start.sh")
|
||||
initial = inspect_all()
|
||||
result["containers"] = [metadata(info) for info in initial]
|
||||
assert len(apis()) == 2
|
||||
for info in initial:
|
||||
assert info["HostConfig"]["Memory"] > 0 and info["HostConfig"]["NanoCpus"] > 0
|
||||
if info["Config"]["Labels"]["com.docker.compose.service"] != "lb":
|
||||
assert not info["HostConfig"]["PortBindings"]
|
||||
for info in apis():
|
||||
assert docker("exec", info["Id"], "id", "-u") == "10001"
|
||||
assert all(m["Destination"].startswith("/run/secrets/") for m in info["Mounts"])
|
||||
print("PASS: 2 real API containers, CPU/RAM limits, API non-root and no public ports; only LB published", flush=True)
|
||||
subprocess.run([str(ROOT / "scripts/check.sh")], cwd=ROOT, env=env, check=True, timeout=240)
|
||||
result["api_tests"] = "public smoke + student unittest suite passed"
|
||||
subprocess.run([str(ROOT / "scripts/demo.sh")], cwd=ROOT, env=env, check=True, stdout=subprocess.DEVNULL, timeout=30)
|
||||
assert sql("SELECT count(*) FROM schema_migrations") == "3"
|
||||
count = sql("SELECT count(*) FROM messages")
|
||||
for _ in range(2):
|
||||
compose("run", "--rm", "migrate")
|
||||
assert sql("SELECT count(*) FROM schema_migrations") == "3"
|
||||
assert sql("SELECT count(*) FROM messages") == count
|
||||
print("PASS: migrations only in one-shot service; repeated execution preserves data", flush=True)
|
||||
result["attachments"] = run_checks(base, env, compose, apis, script, sql)
|
||||
|
||||
replay_client = Client(base)
|
||||
replay_actor, _, _, replay_chat = replay_client.bootstrap()
|
||||
replay_key = uuid4().hex
|
||||
saved_message = replay_client.message(replay_actor, replay_chat, "Повтор после рестарта", key=replay_key)["json"]
|
||||
before = {i["Id"]: metadata(i) for i in inspect_all() if i["State"]["Running"]}
|
||||
subprocess.run(["make", "test-persistence", "PYTHON=" + sys.executable, "ACTION_SCRIPT=scripts/restart.sh"],
|
||||
cwd=ROOT, env=env, check=True, timeout=180)
|
||||
after = {i["Id"]: metadata(i) for i in inspect_all() if i["State"]["Running"]}
|
||||
assert before.keys() == after.keys()
|
||||
assert all(before[cid]["started_at"] != after[cid]["started_at"] for cid in before)
|
||||
assert replay_client.message(replay_actor, replay_chat, "Повтор после рестарта", key=replay_key)["json"] == saved_message
|
||||
result["persistence"] = {"before": list(before.values()), "after": list(after.values()), "passed": True,
|
||||
"idempotency_replay_after_restart": True}
|
||||
print("PASS: both API, LB, PostgreSQL, Valkey, S3 and cleaner actually restarted; data and session preserved", flush=True)
|
||||
|
||||
check_shutdown()
|
||||
|
||||
dependency_client = Client(base)
|
||||
actor = dependency_client.user("deps")
|
||||
result["dependency_readiness"] = []
|
||||
for dependency in ("valkey", "postgres", "s3"):
|
||||
try:
|
||||
compose("stop", "--timeout", "8", dependency)
|
||||
probe_id = apis()[0]["Id"]
|
||||
readiness = subprocess.run(["docker", "exec", probe_id, "python", "-m", "src.healthcheck"], capture_output=True, timeout=10)
|
||||
assert readiness.returncode == 1
|
||||
live = docker("exec", probe_id, "python", "-c",
|
||||
"from urllib.request import urlopen; print(urlopen('http://127.0.0.1:8080/health/live').status)")
|
||||
assert live == "200"
|
||||
deadline = time.monotonic() + 8
|
||||
while True:
|
||||
try:
|
||||
urlopen(base + "/health/ready", timeout=2).close()
|
||||
except HTTPError as error:
|
||||
if error.code == 503:
|
||||
break
|
||||
raise
|
||||
except OSError:
|
||||
# Уже отправленный запрос может истечь до исключения backend.
|
||||
pass
|
||||
assert time.monotonic() < deadline
|
||||
time.sleep(0.1)
|
||||
result["dependency_readiness"].append({"dependency": dependency, "api_live": 200, "api_ready": 503, "lb_ready": 503})
|
||||
print("PASS:", dependency, "outage: API live=200, ready=503, LB ready=503", flush=True)
|
||||
finally:
|
||||
compose("start", dependency)
|
||||
script("wait-ready.sh")
|
||||
dependency_client.call("GET", "/api/v1/users/me", actor=actor, schema="User")
|
||||
|
||||
result["postgres_pause"] = check_postgres_pause(compose, apis, base)
|
||||
|
||||
subprocess.run(["make", "test-failover", "PYTHON=" + sys.executable, "ACTION_SCRIPT=scripts/stop-one.sh"],
|
||||
cwd=ROOT, env=env, check=True, timeout=90)
|
||||
assert sum(i["State"]["Running"] for i in apis()) == 1
|
||||
result["public_failover"] = {"passed": True, "containers_after": [metadata(i) for i in apis()]}
|
||||
compose("start", "api")
|
||||
script("wait-ready.sh")
|
||||
|
||||
result["failovers"] = []
|
||||
for info in apis():
|
||||
target = info["Config"]["Hostname"]
|
||||
|
||||
def stop_target():
|
||||
subprocess.run([str(ROOT / "scripts/stop-one.sh")], cwd=ROOT,
|
||||
env=dict(env, TARGET_INSTANCE_ID=target), check=True, timeout=10)
|
||||
stopped = json.loads(docker("inspect", info["Id"]))[0]
|
||||
assert not stopped["State"]["Running"]
|
||||
assert not stopped["State"]["OOMKilled"] and stopped["State"]["ExitCode"] == 0
|
||||
# Uvicorn пишет в stderr; получаем оба потока без вывода запросов.
|
||||
logs_result = subprocess.run(["docker", "logs", info["Id"]], capture_output=True, text=True, check=True)
|
||||
assert "Application shutdown complete" in logs_result.stdout + logs_result.stderr
|
||||
return metadata(stopped)
|
||||
|
||||
result["failovers"].append(load_action("stop " + target, stop_target, target))
|
||||
compose("start", "api")
|
||||
script("wait-ready.sh")
|
||||
|
||||
before = {i["Id"]: metadata(i) for i in inspect_all() if i["State"]["Running"]}
|
||||
|
||||
def replace():
|
||||
script("rolling-update.sh")
|
||||
after = {i["Id"]: metadata(i) for i in inspect_all() if i["State"]["Running"]}
|
||||
old_api = {i["id"] for i in before.values() if i["service"] == "api"}
|
||||
new_api = {i["id"] for i in after.values() if i["service"] == "api"}
|
||||
assert len(new_api) == 2 and not old_api & new_api
|
||||
for cid, info in before.items():
|
||||
if info["service"] != "api":
|
||||
assert after[cid]["started_at"] == info["started_at"]
|
||||
return {"before": list(before.values()), "after": list(after.values())}
|
||||
|
||||
result["rolling_update"] = load_action("sequential API replacement", replace)
|
||||
result["passed"] = True
|
||||
print("PASS: all lab4 grade-4 checks completed", flush=True)
|
||||
finally:
|
||||
output = ROOT / "evidence" / "lab4-checks.json"
|
||||
output.write_text(json.dumps(result, ensure_ascii=False, indent=2) + "\n")
|
||||
compose("down", "--volumes", "--timeout", "8")
|
||||
print("Removed only temporary test containers and volumes:", project, flush=True)
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
main()
|
||||
@@ -0,0 +1,42 @@
|
||||
from pathlib import Path
|
||||
import sys
|
||||
import unittest
|
||||
from urllib.parse import urlencode
|
||||
from uuid import uuid4
|
||||
|
||||
|
||||
ROOT = Path(__file__).resolve().parents[1]
|
||||
sys.path.insert(0, str(ROOT / "tests"))
|
||||
from client import Client
|
||||
|
||||
|
||||
class ApiTestCase(unittest.TestCase):
|
||||
def setUp(self):
|
||||
self.client = Client()
|
||||
self.alice, self.bob, self.eve, self.chat = self.client.bootstrap()
|
||||
self.path = "/api/v1/chats/" + self.chat["id"]
|
||||
|
||||
def assert_error(self, method, path, status, code, **kwargs):
|
||||
if method == "POST" and path.endswith("/messages"):
|
||||
kwargs["headers"] = {"Idempotency-Key": uuid4().hex, **kwargs.get("headers", {})}
|
||||
result = self.client.call(method, path, status, **kwargs)
|
||||
self.assertEqual(result["json"]["error"]["code"], code)
|
||||
return result["json"]["error"]
|
||||
|
||||
def read_all(self, path, actor, schema, limit=3):
|
||||
items = []
|
||||
cursor = None
|
||||
seen_cursors = set()
|
||||
while True:
|
||||
query = {"limit": limit}
|
||||
if cursor is not None:
|
||||
query["cursor"] = cursor
|
||||
page = self.client.call("GET", path + "?" + urlencode(query), actor=actor, schema=schema)["json"]
|
||||
self.assertLessEqual(len(page["items"]), limit)
|
||||
items.extend(page["items"])
|
||||
cursor = page["next_cursor"]
|
||||
if cursor is None:
|
||||
return items
|
||||
self.assertTrue(page["items"], "Пустая страница не должна вести к следующей")
|
||||
self.assertNotIn(cursor, seen_cursors, "Зацикливание пагинации")
|
||||
seen_cursors.add(cursor)
|
||||
@@ -0,0 +1,145 @@
|
||||
"""Пауза живой PostgreSQL: прямой readiness, ограниченное SQL I/O и восстановление."""
|
||||
from concurrent.futures import ThreadPoolExecutor
|
||||
from datetime import datetime, timezone
|
||||
import json
|
||||
import os
|
||||
from pathlib import Path
|
||||
import socket
|
||||
import subprocess
|
||||
import sys
|
||||
import time
|
||||
from uuid import uuid4
|
||||
|
||||
from helpers import Client, ROOT
|
||||
from client import Failure
|
||||
|
||||
|
||||
def check_postgres_pause(compose, apis, base):
|
||||
client = Client(base)
|
||||
alice, bob, _, chat = client.bootstrap()
|
||||
saved_message = client.message(alice, chat, "До паузы PostgreSQL")["json"]
|
||||
before = {info["Id"]:info["State"]["StartedAt"] for info in apis() if info["State"]["Running"]}
|
||||
probe_id = sorted(before)[0]
|
||||
|
||||
def direct_probe(path, expected):
|
||||
# HTTP напрямую в API, без HAProxy и его собственных таймаутов/503.
|
||||
code = """
|
||||
import json,time
|
||||
from urllib.error import HTTPError
|
||||
from urllib.request import urlopen
|
||||
started=time.monotonic()
|
||||
try: response=urlopen('http://127.0.0.1:8080/PATH',timeout=5)
|
||||
except HTTPError as error: response=error
|
||||
with response:
|
||||
body=json.load(response)
|
||||
elapsed=time.monotonic()-started
|
||||
assert response.status==EXPECTED, response.status
|
||||
assert response.headers['X-Request-Id'] and response.headers['X-Instance-Id']
|
||||
if response.status==503:
|
||||
assert body['error']['code']=='unavailable'
|
||||
assert body['error']['request_id']==response.headers['X-Request-Id']
|
||||
assert elapsed<4.5, elapsed
|
||||
print(json.dumps({'status':response.status,'elapsed_seconds':round(elapsed,3)}))
|
||||
""".replace("PATH", path).replace("EXPECTED", str(expected))
|
||||
completed = subprocess.run(["docker", "exec", probe_id, "python", "-c", code],
|
||||
capture_output=True, text=True, timeout=8, check=True)
|
||||
return json.loads(completed.stdout)
|
||||
|
||||
# Соединение получено ДО pause: проверяем именно выполняющийся SQL, а не
|
||||
# только timeout получения нового соединения или check callback пула.
|
||||
query_code = """
|
||||
import json,sys,time
|
||||
import psycopg
|
||||
from src import db
|
||||
db.pool.open(wait=True,timeout=10)
|
||||
conn=db.pool.getconn()
|
||||
conn.execute('SET statement_timeout=0')
|
||||
print('connected',flush=True)
|
||||
sys.stdin.readline()
|
||||
started=time.monotonic()
|
||||
try:
|
||||
try: conn.execute('SELECT 1')
|
||||
except psycopg.OperationalError:
|
||||
elapsed=time.monotonic()-started
|
||||
assert elapsed<4.5, elapsed
|
||||
assert conn.closed, 'timed out connection was not discarded'
|
||||
print(json.dumps({'elapsed_seconds':round(elapsed,3),'connection_closed':conn.closed}),flush=True)
|
||||
else: raise AssertionError('paused database answered a query')
|
||||
finally:
|
||||
db.pool.putconn(conn)
|
||||
db.pool.close()
|
||||
"""
|
||||
query = subprocess.Popen(["docker", "exec", "-i", probe_id, "python", "-u", "-c", query_code],
|
||||
stdin=subprocess.PIPE, stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True)
|
||||
result = {}
|
||||
try:
|
||||
assert query.stdout.readline().strip() == "connected"
|
||||
compose("pause", "postgres")
|
||||
paused_at = time.monotonic()
|
||||
output, error = query.communicate("\n", timeout=10)
|
||||
assert query.returncode == 0, "SQL I/O deadline failed: " + error
|
||||
result["sql_without_server_timeout"] = json.loads(output)
|
||||
result["direct_ready"] = direct_probe("health/ready", 503)
|
||||
result["direct_live"] = direct_probe("health/live", 200)
|
||||
# Повторные запросы при длительной паузе не должны оставлять занятые потоки.
|
||||
with ThreadPoolExecutor(max_workers=10) as executor:
|
||||
result["repeated_ready"] = list(executor.map(lambda _: direct_probe("health/ready", 503), range(10)))
|
||||
# Сервер остаётся на pause не менее 12 секунд; ограничиваем именно API.
|
||||
remaining = 12 - (time.monotonic() - paused_at)
|
||||
if remaining > 0:
|
||||
time.sleep(remaining)
|
||||
result["ready_after_12_seconds"] = direct_probe("health/ready", 503)
|
||||
result["live_after_repeated_requests"] = direct_probe("health/live", 200)
|
||||
result["paused_seconds"] = round(time.monotonic() - paused_at, 3)
|
||||
finally:
|
||||
compose("unpause", "postgres")
|
||||
if query.poll() is None:
|
||||
query.communicate(timeout=10)
|
||||
|
||||
resumed_at = time.monotonic()
|
||||
while True:
|
||||
try:
|
||||
result["recovered_ready"] = direct_probe("health/ready", 200)
|
||||
client.call("GET", "/api/v1/users/me", actor=alice, schema="User")
|
||||
messages = client.call("GET", "/api/v1/chats/" + chat["id"] + "/messages", actor=bob, schema="MessagePage")["json"]["items"]
|
||||
assert saved_message in messages
|
||||
break
|
||||
except (subprocess.CalledProcessError, Failure):
|
||||
assert time.monotonic() - resumed_at < 30, "readiness did not recover after unpause"
|
||||
time.sleep(.2)
|
||||
assert before == {info["Id"]:info["State"]["StartedAt"] for info in apis() if info["State"]["Running"]}
|
||||
result.update({"recovery_seconds":round(time.monotonic()-resumed_at,3), "api_not_restarted":True,
|
||||
"existing_session_and_message_preserved":True, "passed":True})
|
||||
print("PASS: paused PostgreSQL: SQL and direct readiness bounded; live works; unpause restores API without restart", flush=True)
|
||||
return result
|
||||
|
||||
|
||||
def main():
|
||||
with socket.socket() as listener:
|
||||
listener.bind(("127.0.0.1", 0))
|
||||
port = listener.getsockname()[1]
|
||||
project = "lab4-pg-pause-" + uuid4().hex[:10]
|
||||
base = f"http://127.0.0.1:{port}"
|
||||
env = dict(os.environ, COMPOSE_PROJECT_NAME=project, HOST_PORT=str(port), API_REPLICAS="2", BASE_URL=base)
|
||||
|
||||
def compose(*args):
|
||||
return subprocess.check_output(["docker", "compose", *args], cwd=ROOT, env=env, text=True, timeout=180).strip()
|
||||
|
||||
def apis():
|
||||
ids = compose("ps", "-a", "-q", "api").split()
|
||||
return json.loads(subprocess.check_output(["docker", "inspect", *ids], text=True))
|
||||
|
||||
result = {"utc":datetime.now(timezone.utc).isoformat(), "project":project,
|
||||
"command":".venv/bin/python student-tests/postgres_pause.py", "passed":False}
|
||||
try:
|
||||
compose("up", "-d", "--no-build", "lb")
|
||||
subprocess.run([str(ROOT / "scripts/wait-ready.sh")], cwd=ROOT, env=env, check=True, timeout=120)
|
||||
result.update(check_postgres_pause(compose, apis, base))
|
||||
print(json.dumps(result, ensure_ascii=False), flush=True)
|
||||
finally:
|
||||
Path(ROOT / "evidence/postgres-pause.json").write_text(json.dumps(result, ensure_ascii=False, indent=2) + "\n")
|
||||
compose("down", "--volumes", "--timeout", "8")
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
main()
|
||||
@@ -0,0 +1,164 @@
|
||||
import base64
|
||||
import json
|
||||
from urllib.parse import urlencode
|
||||
from uuid import uuid4
|
||||
|
||||
from helpers import ApiTestCase
|
||||
|
||||
|
||||
class ApiTests(ApiTestCase):
|
||||
def test_duplicate_username(self):
|
||||
self.assert_error("POST", "/api/v1/users", 409, "conflict", body=self.alice["registration"])
|
||||
|
||||
def test_invalid_user_fields(self):
|
||||
invalid_bodies = [
|
||||
{}, [], None,
|
||||
{"username": "ab", "display_name": "Имя"},
|
||||
{"username": "UPPER", "display_name": "Имя"},
|
||||
{"username": "name\n", "display_name": "Имя"},
|
||||
{"username": "язык", "display_name": "Имя"},
|
||||
{"username": "a" * 33, "display_name": "Имя"},
|
||||
{"username": 123, "display_name": "Имя"},
|
||||
{"username": "valid_name", "display_name": " \t\n"},
|
||||
{"username": "valid_name", "display_name": "👋" * 101},
|
||||
{"username": "valid_name", "display_name": False},
|
||||
{"username": "valid_name", "display_name": "Имя", "extra": 1},
|
||||
]
|
||||
for body in invalid_bodies:
|
||||
if isinstance(body, dict):
|
||||
body = {**body, "password": "Synthetic-password-123"}
|
||||
with self.subTest(body=body):
|
||||
self.assert_error("POST", "/api/v1/users", 400, "invalid_request",
|
||||
raw=json.dumps(body).encode(), headers={"Content-Type": "application/json"})
|
||||
|
||||
def test_malformed_json_and_encoding(self):
|
||||
invalid_bodies = [
|
||||
b'{"username":', b'', b'not JSON', b'\xff',
|
||||
'{"username":"valid_name","display_name":"Имя"}'.encode("utf-16"),
|
||||
b'{"username":"valid_name","display_name":"\\ud800"}',
|
||||
]
|
||||
for body in invalid_bodies:
|
||||
with self.subTest(body=body):
|
||||
self.assert_error("POST", "/api/v1/users", 400, "invalid_request",
|
||||
raw=body, headers={"Content-Type": "application/json"})
|
||||
|
||||
def test_wrong_content_type(self):
|
||||
self.assert_error("POST", "/api/v1/users", 415, "unsupported_media_type",
|
||||
raw=b'{}', headers={"Content-Type": "text/plain"})
|
||||
|
||||
def test_identification_and_authentication_order(self):
|
||||
self.assert_error("GET", "/api/v1/users/me", 401, "unauthorized")
|
||||
self.assert_error("GET", "/api/v1/users/me", 401, "unauthorized",
|
||||
headers={"X-User-Id": self.alice["id"]})
|
||||
self.assert_error("GET", "/api/v1/users/me", 401, "unauthorized",
|
||||
headers={"Authorization": "Bearer unknown-session"})
|
||||
self.assert_error("POST", self.path + "/messages", 401, "unauthorized",
|
||||
raw=b'{', headers={"Content-Type": "application/json"})
|
||||
me = self.client.call("GET", "/api/v1/users/me", schema="User", actor=self.alice,
|
||||
headers={"X-User-Id": self.bob["id"]})["json"]
|
||||
self.assertEqual(me, self.alice["user"])
|
||||
|
||||
def test_invalid_chat_members(self):
|
||||
invalid_members = [
|
||||
[], [self.bob["id"]], [self.alice["id"], str(uuid4())],
|
||||
[self.alice["id"], self.alice["id"]],
|
||||
[self.alice["id"], self.alice["id"].upper()],
|
||||
[self.alice["id"], "not-a-uuid"], [True], self.alice["id"],
|
||||
[self.alice["id"]] + [str(uuid4()) for _ in range(100)],
|
||||
]
|
||||
for members in invalid_members:
|
||||
with self.subTest(members=members):
|
||||
self.assert_error("POST", "/api/v1/chats", 400, "invalid_request", actor=self.alice,
|
||||
body={"title": "Чат", "member_ids": members})
|
||||
chats = self.read_all("/api/v1/chats", self.alice, "ChatPage")
|
||||
self.assertEqual([chat["id"] for chat in chats], [self.chat["id"]])
|
||||
|
||||
def test_invalid_chat_title(self):
|
||||
for title in ("", " \n", "a" * 101, 123, None):
|
||||
with self.subTest(title=title):
|
||||
self.assert_error("POST", "/api/v1/chats", 400, "invalid_request", actor=self.alice,
|
||||
body={"title": title, "member_ids": [self.alice["id"]]})
|
||||
|
||||
def test_chat_access(self):
|
||||
outsider = self.assert_error("GET", self.path, 404, "not_found", actor=self.eve)
|
||||
missing = self.assert_error("GET", "/api/v1/chats/" + str(uuid4()), 404, "not_found", actor=self.eve)
|
||||
self.assertEqual(outsider["message"], missing["message"])
|
||||
self.assert_error("GET", self.path + "/messages", 404, "not_found", actor=self.eve)
|
||||
self.assert_error("POST", self.path + "/messages", 404, "not_found", actor=self.eve, body={"text": "Чужое"})
|
||||
self.assertEqual(self.read_all("/api/v1/chats", self.eve, "ChatPage"), [])
|
||||
self.assert_error("GET", "/api/v1/chats/not-a-uuid", 400, "invalid_request", actor=self.alice)
|
||||
|
||||
def test_invalid_message_fields(self):
|
||||
for text in ("", " \t\n", "👋" * 4001, 123, True, None, []):
|
||||
with self.subTest(text_type=type(text).__name__):
|
||||
self.assert_error("POST", self.path + "/messages", 400, "invalid_request",
|
||||
actor=self.alice, body={"text": text})
|
||||
self.assert_error("POST", self.path + "/messages", 400, "invalid_request", actor=self.alice,
|
||||
body={"text": "Подмена автора", "sender_id": self.bob["id"]})
|
||||
self.assertEqual(self.read_all(self.path + "/messages", self.alice, "MessagePage"), [])
|
||||
|
||||
def test_unicode_and_text_preservation(self):
|
||||
for text in (" Привет, мир 👋\n", "👋" * 4000):
|
||||
message = self.client.message(self.bob, self.chat, text)["json"]
|
||||
self.assertEqual(message["text"], text)
|
||||
self.assertEqual(message["sender_id"], self.bob["id"])
|
||||
items = self.read_all(self.path + "/messages", self.alice, "MessagePage")
|
||||
self.assertEqual([item["text"] for item in items], [" Привет, мир 👋\n", "👋" * 4000])
|
||||
|
||||
def test_message_pagination_and_changing_limit(self):
|
||||
sent = [self.client.message(self.alice, self.chat, f"Сообщение {i}")["json"] for i in range(8)]
|
||||
items = self.read_all(self.path + "/messages", self.bob, "MessagePage", limit=3)
|
||||
self.assertEqual(items, sorted(sent, key=lambda item: (item["created_at"], item["id"])))
|
||||
first = self.client.call("GET", self.path + "/messages?limit=1", actor=self.alice, schema="MessagePage")["json"]
|
||||
query = urlencode({"limit": 100, "cursor": first["next_cursor"]})
|
||||
rest = self.client.call("GET", self.path + "/messages?" + query, actor=self.alice, schema="MessagePage")["json"]
|
||||
self.assertEqual(first["items"] + rest["items"], items)
|
||||
self.assertIsNone(rest["next_cursor"])
|
||||
|
||||
def test_default_page_size(self):
|
||||
for i in range(51):
|
||||
self.client.message(self.alice, self.chat, f"Сообщение {i}")
|
||||
page = self.client.call("GET", self.path + "/messages", actor=self.alice, schema="MessagePage")["json"]
|
||||
self.assertEqual(len(page["items"]), 50)
|
||||
self.assertIsNotNone(page["next_cursor"])
|
||||
|
||||
def test_chat_pagination_and_cursor_owner(self):
|
||||
for i in range(4):
|
||||
self.client.call("POST", "/api/v1/chats", 201, actor=self.alice,
|
||||
body={"title": f"Чат {i}", "member_ids": [self.alice["id"], self.bob["id"]]})
|
||||
chats = self.read_all("/api/v1/chats", self.alice, "ChatPage", limit=2)
|
||||
self.assertEqual(len(chats), 5)
|
||||
self.assertEqual(len({chat["id"] for chat in chats}), 5)
|
||||
self.assertEqual(chats, sorted(chats, key=lambda item: (item["created_at"], item["id"])))
|
||||
first = self.client.call("GET", "/api/v1/chats?limit=1", actor=self.alice, schema="ChatPage")["json"]
|
||||
query = urlencode({"cursor": first["next_cursor"]})
|
||||
self.assert_error("GET", "/api/v1/chats?" + query, 400, "invalid_request", actor=self.bob)
|
||||
|
||||
def test_invalid_limits_and_cursors(self):
|
||||
bad_queries = [{"limit": value} for value in ("0", "101", "-1", "1.5", "1.0", "abc", "")]
|
||||
bad_queries += [{"cursor": value} for value in ("", "not-base64!", "e30=", "W10=")]
|
||||
for path in ("/api/v1/chats", self.path + "/messages"):
|
||||
for query in bad_queries:
|
||||
with self.subTest(path=path, query=query):
|
||||
self.assert_error("GET", path + "?" + urlencode(query), 400, "invalid_request", actor=self.alice)
|
||||
|
||||
def test_cursor_cannot_be_used_for_another_chat_or_changed(self):
|
||||
for i in range(2):
|
||||
self.client.message(self.alice, self.chat, f"Сообщение {i}")
|
||||
first = self.client.call("GET", self.path + "/messages?limit=1", actor=self.alice, schema="MessagePage")["json"]
|
||||
cursor = first["next_cursor"]
|
||||
other = self.client.call("POST", "/api/v1/chats", 201, actor=self.alice, schema="Chat",
|
||||
body={"title": "Другой чат", "member_ids": [self.alice["id"]]})["json"]
|
||||
path = "/api/v1/chats/" + other["id"] + "/messages?" + urlencode({"cursor": cursor})
|
||||
self.assert_error("GET", path, 400, "invalid_request", actor=self.alice)
|
||||
data = json.loads(base64.urlsafe_b64decode(cursor))
|
||||
data["id"] = str(uuid4())
|
||||
changed = base64.urlsafe_b64encode(json.dumps(data).encode()).decode()
|
||||
self.assert_error("GET", self.path + "/messages?" + urlencode({"cursor": changed}),
|
||||
400, "invalid_request", actor=self.alice)
|
||||
|
||||
def test_framework_errors_and_request_ids(self):
|
||||
first = self.assert_error("GET", "/unknown", 404, "not_found")
|
||||
second = self.assert_error("GET", "/unknown", 404, "not_found")
|
||||
self.assertNotEqual(first["request_id"], second["request_id"])
|
||||
self.assert_error("POST", "/health/live", 405, "invalid_request")
|
||||
@@ -0,0 +1,133 @@
|
||||
import hashlib
|
||||
import http.client
|
||||
import io
|
||||
import json
|
||||
import struct
|
||||
from urllib.parse import urlencode, urlsplit
|
||||
from uuid import uuid4
|
||||
import zlib
|
||||
|
||||
from PIL import Image
|
||||
|
||||
from helpers import ApiTestCase, ROOT
|
||||
|
||||
|
||||
class AttachmentTests(ApiTestCase):
|
||||
def upload(self, data=None, filename="photo.png", content_type="image/png", expected=201, actor=None):
|
||||
if data is None:
|
||||
data = (ROOT / "tests/fixtures/sample.png").read_bytes()
|
||||
return self.client.call("POST", self.path + "/attachments?" + urlencode({"filename": filename}),
|
||||
expected, actor=actor or self.alice, raw=data,
|
||||
headers={"Content-Type": content_type}, schema="Attachment" if expected == 201 else None)
|
||||
|
||||
def test_png_and_jpeg_originals(self):
|
||||
jpeg = io.BytesIO()
|
||||
Image.new("RGB", (100, 60), "orange").save(jpeg, format="JPEG")
|
||||
for data, mime, filename in (((ROOT / "tests/fixtures/sample.png").read_bytes(), "image/png", "Фото 👋.png"),
|
||||
(jpeg.getvalue(), "image/jpeg", "photo.jpeg")):
|
||||
with self.subTest(mime=mime):
|
||||
attachment = self.upload(data, filename, mime)["json"]
|
||||
self.assertEqual(attachment["filename"], filename)
|
||||
self.assertEqual(attachment["status"], "ready")
|
||||
self.assertEqual(attachment["variants"], [])
|
||||
self.assertIsNone(attachment["error_code"])
|
||||
self.assertEqual(attachment["sha256"], hashlib.sha256(data).hexdigest())
|
||||
self.assertEqual(attachment["size_bytes"], len(data))
|
||||
self.assertEqual(self.client.call("GET", "/api/v1/attachments/" + attachment["id"],
|
||||
actor=self.bob, schema="Attachment")["json"], attachment)
|
||||
result = self.client.call("GET", "/api/v1/attachments/" + attachment["id"] + "/content", actor=self.bob)
|
||||
self.assertEqual(result["bytes"], data)
|
||||
self.assertEqual(result["headers"].get_content_type(), mime)
|
||||
self.assertEqual(result["headers"]["X-Content-Type-Options"], "nosniff")
|
||||
|
||||
def test_corruption_and_mime_spoof(self):
|
||||
png = (ROOT / "tests/fixtures/sample.png").read_bytes()
|
||||
for data, mime in ((png, "image/jpeg"), (png[:50], "image/png"),
|
||||
(b"not an image", "image/png"), (b"", "image/png"),
|
||||
(b"GIF89a", "image/png"), (png, "application/octet-stream")):
|
||||
with self.subTest(size=len(data), mime=mime):
|
||||
result = self.upload(data, content_type=mime, expected=415)
|
||||
self.assertEqual(result["json"]["error"]["code"], "unsupported_media_type")
|
||||
|
||||
def test_filename_rejected_before_storage(self):
|
||||
for filename in ("", " ", "../a.png", "a/b.png", "a\\b.png", "a\x00.png", "a\r\n.png", "a\x7f.png", "a" * 256):
|
||||
with self.subTest(filename=repr(filename)):
|
||||
result = self.upload(filename=filename, expected=400)
|
||||
self.assertEqual(result["json"]["error"]["code"], "invalid_request")
|
||||
self.client.call("POST", self.path + "/attachments", 400, actor=self.alice, raw=b"x",
|
||||
headers={"Content-Type": "image/png"})
|
||||
|
||||
def test_content_length_limit_before_body(self):
|
||||
self.client.call("POST", self.path + "/attachments?filename=a.png", 413, actor=self.alice,
|
||||
raw=b"x", headers={"Content-Type": "image/png", "Content-Length": str(10485761)})
|
||||
|
||||
def test_chunked_limit_without_content_length(self):
|
||||
target = urlsplit(self.client.base)
|
||||
connection = http.client.HTTPConnection(target.hostname, target.port, timeout=15)
|
||||
try:
|
||||
connection.request("POST", self.path + "/attachments?filename=large.png",
|
||||
body=iter([b"x" * 65536] * 160 + [b"x"]),
|
||||
headers={"Authorization": "Bearer " + self.alice["token"], "Content-Type": "image/png"},
|
||||
encode_chunked=True)
|
||||
response = connection.getresponse()
|
||||
self.assertEqual(response.status, 413)
|
||||
self.assertEqual(json.loads(response.read())["error"]["code"], "payload_too_large")
|
||||
finally:
|
||||
connection.close()
|
||||
|
||||
def test_pixel_limit_before_decode(self):
|
||||
def chunk(kind, data):
|
||||
return struct.pack(">I", len(data)) + kind + data + struct.pack(">I", zlib.crc32(kind + data))
|
||||
# Размеры в корректном IHDR превышают лимит; pixel data вообще не выделяется.
|
||||
data = b"\x89PNG\r\n\x1a\n" + chunk(b"IHDR", struct.pack(">IIBBBBB", 10000, 4001, 8, 2, 0, 0, 0))
|
||||
data += chunk(b"IDAT", b"") + chunk(b"IEND", b"")
|
||||
self.upload(data, expected=413)
|
||||
|
||||
def test_access_and_authentication(self):
|
||||
attachment = self.upload()["json"]
|
||||
for suffix in ("", "/content"):
|
||||
path = "/api/v1/attachments/" + attachment["id"] + suffix
|
||||
self.assert_error("GET", path, 401, "unauthorized")
|
||||
self.assert_error("GET", path, 404, "not_found", actor=self.eve)
|
||||
self.assert_error("GET", "/api/v1/attachments/" + str(uuid4()) + suffix,
|
||||
404, "not_found", actor=self.eve)
|
||||
self.upload(expected=404, actor=self.eve)
|
||||
self.client.call("POST", self.path + "/attachments?filename=../bad", 401,
|
||||
raw=b"x", headers={"Content-Type": "image/png"})
|
||||
self.assert_error("GET", "/api/v1/attachments/" + attachment["id"] + "/content?variant=thumbnail",
|
||||
404, "not_found", actor=self.alice)
|
||||
|
||||
def test_attachment_only_message_and_other_member(self):
|
||||
attachment = self.upload()["json"]
|
||||
message = self.client.message(self.bob, self.chat, "", attachments=[attachment["id"]])["json"]
|
||||
self.assertEqual(message["attachment_ids"], [attachment["id"]])
|
||||
self.assertEqual(message["sender_id"], self.bob["id"])
|
||||
self.assertEqual(self.read_all(self.path + "/messages", self.alice, "MessagePage"), [message])
|
||||
|
||||
def test_foreign_and_unknown_attachment_ids(self):
|
||||
attachment = self.upload()["json"]
|
||||
other = self.client.call("POST", "/api/v1/chats", 201, actor=self.alice, schema="Chat",
|
||||
body={"title": "Другой чат", "member_ids": [self.alice["id"]]})["json"]
|
||||
for chat_id, ids in ((self.chat["id"], [str(uuid4())]), (other["id"], [attachment["id"]])):
|
||||
self.assert_error("POST", "/api/v1/chats/" + chat_id + "/messages", 404, "not_found", actor=self.alice,
|
||||
body={"text": "", "attachment_ids": ids})
|
||||
|
||||
def test_invalid_attachment_lists(self):
|
||||
attachment = self.upload()["json"]
|
||||
for ids in ([attachment["id"], attachment["id"].upper()], [str(uuid4()) for _ in range(11)],
|
||||
["not-a-uuid"], [True], None, "uuid"):
|
||||
self.assert_error("POST", self.path + "/messages", 400, "invalid_request", actor=self.alice,
|
||||
body={"text": "Текст", "attachment_ids": ids})
|
||||
|
||||
def test_idempotency_includes_ordered_attachment_ids(self):
|
||||
first, second = self.upload()["json"], self.upload()["json"]
|
||||
key = uuid4().hex
|
||||
ids = [first["id"], second["id"]]
|
||||
saved = self.client.message(self.alice, self.chat, "", key=key, attachments=ids)["json"]
|
||||
self.assertEqual(self.client.message(self.alice, self.chat, "", key=key, attachments=ids)["json"], saved)
|
||||
for changed in ([second["id"], first["id"]], [first["id"]]):
|
||||
self.assert_error("POST", self.path + "/messages", 409, "conflict", actor=self.alice,
|
||||
body={"text": "", "attachment_ids": changed}, headers={"Idempotency-Key": key})
|
||||
key = uuid4().hex
|
||||
saved = self.client.message(self.alice, self.chat, "Без файла", key=key)["json"]
|
||||
self.assertEqual(self.client.message(self.alice, self.chat, "Без файла", key=key, attachments=[])["json"], saved)
|
||||
@@ -0,0 +1,47 @@
|
||||
from concurrent.futures import ThreadPoolExecutor
|
||||
import threading
|
||||
from uuid import uuid4
|
||||
|
||||
from helpers import ApiTestCase, Client
|
||||
|
||||
|
||||
class ConcurrencyTests(ApiTestCase):
|
||||
def test_ten_clients_send_one_hundred_messages(self):
|
||||
barrier = threading.Barrier(10)
|
||||
|
||||
def send_messages(worker):
|
||||
client = Client()
|
||||
actor = self.alice if worker % 2 == 0 else self.bob
|
||||
barrier.wait(timeout=10)
|
||||
sent = []
|
||||
for index in range(10):
|
||||
message = client.message(actor, self.chat, f"parallel-{worker}-{index}")["json"]
|
||||
self.assertEqual(message["sender_id"], actor["id"])
|
||||
sent.append(message)
|
||||
return sent
|
||||
|
||||
with ThreadPoolExecutor(max_workers=10) as pool:
|
||||
batches = list(pool.map(send_messages, range(10)))
|
||||
sent = [message for batch in batches for message in batch]
|
||||
history = self.read_all(self.path + "/messages", self.alice, "MessagePage", limit=17)
|
||||
self.assertEqual(len(history), 100)
|
||||
self.assertEqual(len({message["id"] for message in history}), 100)
|
||||
self.assertEqual(history, sorted(sent, key=lambda item: (item["created_at"], item["id"])))
|
||||
self.assertEqual({message["text"] for message in history},
|
||||
{f"parallel-{worker}-{index}" for worker in range(10) for index in range(10)})
|
||||
print("PASS: 10 clients sent 100 messages; history contains exactly 100 unique messages.")
|
||||
|
||||
def test_simultaneous_registration_of_one_username(self):
|
||||
username = "race_" + uuid4().hex[:20]
|
||||
barrier = threading.Barrier(10)
|
||||
|
||||
def register(worker):
|
||||
client = Client()
|
||||
barrier.wait(timeout=10)
|
||||
return client.call("POST", "/api/v1/users", [201, 409],
|
||||
body={"username": username, "display_name": f"Клиент {worker}", "password": "Synthetic-password-123"})["status"]
|
||||
|
||||
with ThreadPoolExecutor(max_workers=10) as pool:
|
||||
statuses = list(pool.map(register, range(10)))
|
||||
self.assertEqual(statuses.count(201), 1)
|
||||
self.assertEqual(statuses.count(409), 9)
|
||||
@@ -0,0 +1,62 @@
|
||||
from concurrent.futures import ThreadPoolExecutor
|
||||
import json
|
||||
import threading
|
||||
from uuid import uuid4
|
||||
|
||||
from helpers import ApiTestCase, Client
|
||||
|
||||
|
||||
class IdempotencyTests(ApiTestCase):
|
||||
def test_parallel_replay_across_replicas(self):
|
||||
key = uuid4().hex
|
||||
barrier = threading.Barrier(20)
|
||||
|
||||
def send(_):
|
||||
client = Client()
|
||||
barrier.wait(timeout=10)
|
||||
return client.message(self.alice, self.chat, "Одно сообщение 👋", key=key)
|
||||
|
||||
with ThreadPoolExecutor(max_workers=20) as pool:
|
||||
responses = list(pool.map(send, range(20)))
|
||||
self.assertGreaterEqual(len({r["headers"]["X-Instance-Id"] for r in responses}), 2)
|
||||
self.assertTrue(all(r["json"] == responses[0]["json"] for r in responses))
|
||||
self.assertEqual(self.read_all(self.path + "/messages", self.bob, "MessagePage"), [responses[0]["json"]])
|
||||
|
||||
def test_key_format_and_missing_key(self):
|
||||
for key in (None, "", " ", "a b", "a/b", "a" * 129):
|
||||
with self.subTest(key=key):
|
||||
headers = {} if key is None else {"Idempotency-Key": key}
|
||||
self.client.call("POST", self.path + "/messages", 400, actor=self.alice,
|
||||
body={"text": "Текст"}, headers=headers)
|
||||
for key in ("A", "a" * 128, "ABCdef012._:-"):
|
||||
self.client.message(self.alice, self.chat, key, key=key)
|
||||
|
||||
def test_conflict_and_semantic_json_replay(self):
|
||||
key = uuid4().hex
|
||||
first = self.client.message(self.alice, self.chat, "Текст 👋", key=key)["json"]
|
||||
replay = self.client.call("POST", self.path + "/messages", 201, actor=self.alice,
|
||||
raw=json.dumps({"text": "Текст 👋"}, ensure_ascii=True, indent=2).encode(),
|
||||
headers={"Content-Type": "application/json", "Idempotency-Key": key},
|
||||
schema="Message")["json"]
|
||||
self.assertEqual(first, replay)
|
||||
self.assert_error("POST", self.path + "/messages", 409, "conflict", actor=self.alice,
|
||||
body={"text": "Другой"}, headers={"Idempotency-Key": key})
|
||||
self.assertEqual(self.read_all(self.path + "/messages", self.bob, "MessagePage"), [first])
|
||||
|
||||
def test_scope_is_user_and_chat(self):
|
||||
key = uuid4().hex
|
||||
first = self.client.message(self.alice, self.chat, "Алиса", key=key)["json"]
|
||||
second = self.client.message(self.bob, self.chat, "Боб", key=key)["json"]
|
||||
other = self.client.call("POST", "/api/v1/chats", 201, actor=self.alice, schema="Chat",
|
||||
body={"title": "Другой чат", "member_ids": [self.alice["id"]]})["json"]
|
||||
third = self.client.message(self.alice, other, "Другой чат", key=key)["json"]
|
||||
self.assertEqual(len({first["id"], second["id"], third["id"]}), 3)
|
||||
|
||||
def test_replay_rechecks_session_and_access(self):
|
||||
key = uuid4().hex
|
||||
self.client.message(self.alice, self.chat, "Текст", key=key)
|
||||
self.client.call("POST", self.path + "/messages", 404, actor=self.eve,
|
||||
body={"text": "Текст"}, headers={"Idempotency-Key": key})
|
||||
self.client.call("DELETE", "/api/v1/auth/sessions/current", 204, actor=self.alice)
|
||||
self.client.call("POST", self.path + "/messages", 401, actor=self.alice,
|
||||
body={"text": "Текст"}, headers={"Idempotency-Key": key})
|
||||
@@ -0,0 +1,51 @@
|
||||
import base64
|
||||
from uuid import uuid4
|
||||
|
||||
from helpers import ApiTestCase
|
||||
|
||||
|
||||
class SessionTests(ApiTestCase):
|
||||
def basic(self, username, password):
|
||||
value = base64.b64encode((username + ":" + password).encode()).decode()
|
||||
return {"Authorization": "Basic " + value}
|
||||
|
||||
def test_wrong_password_and_basic_only_for_login(self):
|
||||
registration = self.alice["registration"]
|
||||
self.assert_error("POST", "/api/v1/auth/sessions", 401, "unauthorized",
|
||||
headers=self.basic(registration["username"], "wrong-password"))
|
||||
self.assert_error("POST", "/api/v1/auth/sessions", 401, "unauthorized")
|
||||
self.assert_error("POST", "/api/v1/auth/sessions", 401, "unauthorized",
|
||||
headers={"Authorization": "Basic not-base64!"})
|
||||
self.assert_error("GET", "/api/v1/users/me", 401, "unauthorized",
|
||||
headers=self.basic(registration["username"], registration["password"]))
|
||||
|
||||
def test_logout_revokes_only_one_session(self):
|
||||
registration = self.alice["registration"]
|
||||
second = self.client.call("POST", "/api/v1/auth/sessions", 201, schema="Session",
|
||||
headers=self.basic(registration["username"], registration["password"]))["json"]
|
||||
self.client.call("DELETE", "/api/v1/auth/sessions/current", 204, actor=self.alice)
|
||||
self.assert_error("GET", "/api/v1/users/me", 401, "unauthorized", actor=self.alice)
|
||||
self.assert_error("DELETE", "/api/v1/auth/sessions/current", 401, "unauthorized", actor=self.alice)
|
||||
self.client.call("GET", "/api/v1/users/me", schema="User", headers={"Authorization": "Bearer " + second["token"]})
|
||||
|
||||
def test_password_validation(self):
|
||||
for password in ("short", "x" * 129, 123, None, " " * 12):
|
||||
body = {"username": "pw_" + uuid4().hex[:20], "display_name": "Пароль", "password": password}
|
||||
self.assert_error("POST", "/api/v1/users", 400, "invalid_request", body=body)
|
||||
|
||||
def test_unicode_password_with_colon_and_private_response(self):
|
||||
username = "pw_" + uuid4().hex[:20]
|
||||
password = "Пароль:с:двоеточием-123"
|
||||
user = self.client.call("POST", "/api/v1/users", 201, schema="User",
|
||||
body={"username": username, "display_name": "Пароль", "password": password})["json"]
|
||||
session = self.client.call("POST", "/api/v1/auth/sessions", 201, schema="Session",
|
||||
headers=self.basic(username, password))["json"]
|
||||
self.assertEqual(session["user"], user)
|
||||
self.assertEqual(set(user), {"id", "username", "display_name", "created_at"})
|
||||
self.assertGreaterEqual(len(session["token"]), 32)
|
||||
|
||||
def test_sql_like_message_is_plain_text(self):
|
||||
text = "'; DROP TABLE messages; -- Привет"
|
||||
message = self.client.message(self.alice, self.chat, text)["json"]
|
||||
self.assertEqual(message["text"], text)
|
||||
self.assertEqual(self.read_all(self.path + "/messages", self.bob, "MessagePage"), [message])
|
||||
Reference in New Issue
Block a user