From 36ad7a4f5a10bf427bd2a93c3ca374deb80da255 Mon Sep 17 00:00:00 2001 From: Khamid Date: Thu, 8 Oct 2026 18:58:37 +0300 Subject: [PATCH] =?UTF-8?q?=D0=97=D0=B0=D0=BF=D0=BE=D0=BB=D0=BD=D0=B8?= =?UTF-8?q?=D1=82=D1=8C=20=D0=BE=D1=82=D1=87=D1=91=D1=82=20=D0=B8=20=D0=B4?= =?UTF-8?q?=D0=BE=D0=B1=D0=B0=D0=B2=D0=B8=D1=82=D1=8C=20=D0=B4=D0=BE=D0=BA?= =?UTF-8?q?=D0=B0=D0=B7=D0=B0=D1=82=D0=B5=D0=BB=D1=8C=D1=81=D1=82=D0=B2?= =?UTF-8?q?=D0=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- REPORT.md | 225 +++++++++++++++++++++++++++++++-- evidence/01-up-and-smoke.txt | 72 +++++++++++ evidence/02-student-tests.txt | 73 +++++++++++ evidence/03-persistence.txt | 46 +++++++ evidence/04-redis-sessions.txt | 36 ++++++ evidence/05-failures.txt | 36 ++++++ evidence/06-explain.txt | 74 +++++++++++ evidence/07-containers.txt | 58 +++++++++ evidence/08-sigterm.txt | 11 ++ 9 files changed, 617 insertions(+), 14 deletions(-) create mode 100644 evidence/01-up-and-smoke.txt create mode 100644 evidence/02-student-tests.txt create mode 100644 evidence/03-persistence.txt create mode 100644 evidence/04-redis-sessions.txt create mode 100644 evidence/05-failures.txt create mode 100644 evidence/06-explain.txt create mode 100644 evidence/07-containers.txt create mode 100644 evidence/08-sigterm.txt diff --git a/REPORT.md b/REPORT.md index e42f2b05..543a7b40 100644 --- a/REPORT.md +++ b/REPORT.md @@ -1,37 +1,234 @@ # Отчёт — лабораторная 2 -- Автор, группа: TODO -- Целевая оценка; выбранный трек 5, если нужен: TODO +- Автор, группа: Мусаев Абдул-Хамид Рамзанович, БВТ-2303 +- Целевая оценка; выбранный трек 5, если нужен: 4, трек 5 не заявлен - Commit/PR: TODO после публикации -- Использованные источники, библиотеки и помощь ИИ: TODO +- Использованные источники, библиотеки и помощь ИИ: + - библиотеки: FastAPI 0.143.0, Uvicorn 0.54.0, psycopg 3.3.6 и psycopg-pool 3.3.3, redis-py 8.1.0, argon2-cffi 25.1.0 (полный список с версиями в `requirements.txt`); + - источники: документация PostgreSQL (транзакции, EXPLAIN), Redis persistence, psycopg, Docker Compose, RFC 7617, `contracts/README.md`; + - помощь ИИ: ИИ-ассистент использовался во вспомогательных целях. ## Запуск из чистого clone -TODO: версии runtime/образов, prerequisites, команды создания локальных secrets/.env, build, миграций, запуска, ожидания готовности, тестов и остановки. Указать необходимые действия оператора. Не вставлять секреты. Отдельно указать безопасную остановку и команду намеренного удаления учебных данных. +Нужны Docker с Compose v2 (проверено на Docker 29.3.0, Compose 5.1.0), `make`, `openssl`, `curl` и Python 3.9+ на хосте для тестов. Сервер, PostgreSQL и Redis работают только в контейнерах. + +```sh +make up # создаёт .env с паролями, собирает образ, поднимает стенд и ждёт /health/ready + +make check # структура skeleton +make test # публичный smoke +make test-persistence ACTION_SCRIPT=scripts/restart.sh +make student-test # собственные тесты API +make test-failures # истечение сессии, остановка Redis и PostgreSQL, откат транзакции +make explain # 60 000 синтетических сообщений и планы запросов +python3 scripts/sigterm_check.py + +make down # остановить и удалить контейнеры, данные остаются в volumes +make clean # то же и удалить volumes: намеренное удаление учебных данных +``` + +То же без `make`: + +```sh +./scripts/init-env.sh +docker compose --env-file .env config --quiet +docker compose --env-file .env up -d --build +./scripts/wait-ready.sh +``` + +`scripts/init-env.sh` копирует `.env.example` в `.env` и дописывает в него случайные пароли PostgreSQL и Redis (`openssl rand`). Файл `.env` исключён из Git. Повторный запуск скрипта пароли не меняет: пароль PostgreSQL задаётся один раз при создании volume, поэтому после `make clean` нужно либо оставить старый `.env`, либо удалить его и создать заново. + +Миграции отдельной команды не требуют: при `up` одноразовый контейнер `migrate` применяет их до старта API. Повторить вручную можно командой `docker compose --env-file .env run --rm migrate`. + +`make test-failures` сам останавливает и запускает `redis` и `postgres` и поднимает второй экземпляр API на порту 8081, поэтому запускать его нужно только на учебном стенде. ## Архитектура и решения -TODO: схема процессов/хранилищ, источник истины, транзакционные границы, ограничения. Что перенесено из lab1, что изменено в этой работе. Соответствие переменных из .env.example реальной конфигурации. +``` +клиент ──HTTP──> api (uvicorn + FastAPI) ──┬──> postgres: пользователи, чаты, участники, сообщения + └──> redis: сессии с TTL +``` + +### Роли и сервисы + +| Роль | Сервис compose | Образ | Готовность | Volume | Сеть и порт | Как получает секреты | +| --- | --- | --- | --- | --- | --- | --- | +| api | `api` | собирается из `Dockerfile` на `python:3.13.16-slim-bookworm` | HEALTHCHECK → `/health/ready` | нет, состояния не хранит | опубликован `127.0.0.1:8080` | файлы `/run/secrets/database_url`, `/run/secrets/cache_url` | +| миграции | `migrate` | тот же образ, команда `python migrate.py` | одноразовый, код выхода 0 | нет | только внутренняя сеть | файл `/run/secrets/database_url` | +| postgres | `postgres` | `postgres:17.11-alpine` | `pg_isready` | `pgdata` | только внутренняя сеть, 5432 | `POSTGRES_PASSWORD_FILE=/run/secrets/postgres_password` | +| redis | `redis` | `redis:7.4.11-alpine` | `redis-cli ping` | `redisdata` | только внутренняя сеть, 6379 | `--requirepass` из `/run/secrets/redis_password` | + +Секреты описаны в `compose.yaml` как `secrets` с источником из переменных `.env`. Compose кладёт их в контейнеры файлами, в окружении контейнеров паролей нет (проверка в `evidence/07-containers.txt`). Наружу опубликован только порт API. + +### Файлы + +| Файл | Что в нём | +| --- | --- | +| `migrations/0001_init.sql` | таблицы, ключи, ограничения, индексы | +| `src/migrate.py` | применяет миграции по порядку, ведёт таблицу `schema_migrations` | +| `src/store.py` | все SQL-запросы и пул соединений | +| `src/sessions.py` | сессии в Redis | +| `src/security.py` | hash пароля (Argon2id), разбор заголовков Basic и Bearer | +| `src/main.py` | endpoint, middleware, обработка ошибок | +| `src/schemas.py`, `src/errors.py`, `src/config.py` | валидация JSON, формат ошибки, настройки | + +### Схема данных + +- `users`: `id` (PK), `username` (UNIQUE и CHECK по шаблону), `display_name`, `password_hash`, `created_at`. +- `chats`: `id` (PK), `title`, `created_at`. +- `chat_members`: PK `(chat_id, user_id)`, внешние ключи на `chats` и `users`, `position` — порядок участника в запросе. Индекс `(user_id, chat_id)` для списка чатов пользователя. +- `messages`: `id` (PK), внешние ключи `chat_id` и `sender_id`, `text` (CHECK 1–4000 символов), `created_at`. Индекс `(chat_id, created_at, id)` для истории. + +`id` и `created_at` назначает PostgreSQL (`gen_random_uuid()`, `now()`). Ограничения длины продублированы в CHECK, чтобы неверные данные не попали в БД даже в обход приложения. + +### Транзакционные границы + +Каждый метод `Store` берёт одно соединение из пула и выполняется в одной транзакции: `with pool.connection()` делает COMMIT при выходе и ROLLBACK при исключении. + +- **Регистрация** — один `INSERT`. Уникальность username проверяет сама БД; нарушение ограничения превращается в 409. Поэтому два одновременных запроса не создадут двух пользователей. +- **Создание чата** — составная операция: `INSERT` в `chats`, затем `INSERT` всех участников в `chat_members`. Если участника нет, срабатывает внешний ключ, транзакция откатывается вместе с уже вставленным чатом, клиент получает 400. +- **Отправка сообщения** — проверка членства и `INSERT` в одной транзакции. +- Ответ 201 отправляется только после COMMIT. PostgreSQL работает с настройками по умолчанию (`fsync=on`, `synchronous_commit=on`), то есть подтверждённая запись уже на диске. + +Все значения попадают в запросы только параметрами `%s`, строки SQL из пользовательских данных не собираются. + +### Аутентификация + +- Пароль хешируется Argon2id (`argon2-cffi`, 19 МиБ памяти, 2 прохода, 1 поток — минимальные параметры из рекомендаций OWASP). В БД хранится только hash. +- `POST /api/v1/auth/sessions` принимает только `Authorization: Basic`. Неизвестный username и неверный пароль дают одинаковый 401 с `WWW-Authenticate: Basic`. Если пользователя нет, пароль всё равно сверяется с заранее посчитанным hash, чтобы время ответа не выдавало существование username. +- Токен — `secrets.token_urlsafe(32)`, 256 бит случайности. Остальные endpoint принимают только `Authorization: Bearer`; `X-User-Id` не читается, Basic на бизнес-запросах даёт 401. +- Проверка токена выполняется до валидации параметров и тела и до обращения к чату: сначала аутентификация, потом доступ к конкретному ресурсу. + +### Роль Redis + +Redis — **единственное хранилище сессий**. PostgreSQL о сессиях ничего не знает; источник истины для пользователей, чатов и сообщений — PostgreSQL, для сессий — Redis. + +- Ключ `session:`, значение — id пользователя. Сам токен в Redis не хранится, поэтому по дампу нельзя получить рабочий токен. +- **Expiry**: ключ записывается командой `SET ... EX SESSION_TTL_SECONDS`, срок отсчитывается от входа и запросами не продлевается. Истёкший ключ Redis удаляет сам. +- **Инвалидация**: logout — это `DEL` ключа текущей сессии. Другие сессии того же пользователя остаются. +- **Persistence**: включён AOF с `appendfsync always`, данные лежат в volume `redisdata`. Сессия переживает перезапуск Redis, а оставшийся TTL при этом не увеличивается (`evidence/04-redis-sessions.txt`: 3591 с до перезапуска, 3583 с после). +- Политика вытеснения — `noeviction`: при нехватке памяти Redis откажет в записи новой сессии, но не удалит действующие. +- После `FLUSHALL` или удаления volume `redisdata` все сессии пропадают: каждый токен получит 401, пользователям нужно войти заново. Данные в PostgreSQL при этом не страдают. + +### Пул соединений и таймауты + +| Что | Значение | Где задаётся | +| --- | --- | --- | +| соединений с PostgreSQL | от 2 до 10 | `DB_POOL_MIN_SIZE`, `DB_POOL_MAX_SIZE` | +| ожидание свободного соединения | 3 с | `DB_POOL_TIMEOUT` | +| установка соединения с PostgreSQL | 3 с | `DB_CONNECT_TIMEOUT` | +| выполнение одного запроса | 5 с (`statement_timeout`) | `DB_STATEMENT_TIMEOUT` | +| соединений с Redis | до 20 | `CACHE_POOL_MAX_SIZE` | +| операция с Redis и ожидание соединения | 2 с | `CACHE_TIMEOUT` | + +Перед выдачей из пула соединение с PostgreSQL проверяется, поэтому после перезапуска БД запросы не получают мёртвые соединения. + +### Поведение при отказе зависимостей + +- **Redis недоступен**: проверить токен нечем, поэтому любой запрос с токеном получает 503 `unavailable`. Запрос не выполняется ни от имени владельца токена, ни как анонимный. Запрос без токена по-прежнему получает 401. +- **PostgreSQL недоступен**: запросы, которым нужны данные, получают 503 не позже чем через 3 секунды (ожидание соединения из пула). +- `/health/ready` проверяет обе зависимости (`SELECT 1` и `PING`) и отвечает 503 в общем формате ошибки, если хотя бы одна недоступна. `/health/live` от них не зависит. +- API стартует, даже если БД ещё не поднялась, и отвечает 503 до её появления. + +### Пагинация и порядок + +Запрос истории: + +```sql +SELECT id, chat_id, sender_id, text, created_at FROM messages +WHERE chat_id = $1 AND (created_at, id) > ($2, $3) +ORDER BY created_at, id LIMIT $4 +``` + +Cursor — base64 от JSON `[область, created_at, id]` последней выданной записи; область привязывает его к конкретному чату или к списку чатов конкретного пользователя. Запрашивается `limit + 1` строк: лишняя строка показывает, есть ли следующая страница. + +**Семантика при конкурентных вставках.** `created_at` — это `now()` PostgreSQL, то есть время начала транзакции. Две параллельные транзакции могут зафиксироваться не в порядке своих `created_at`. Поэтому сообщение с чуть более ранним временем может появиться в истории уже после того, как клиент прошёл это место по cursor, и при обходе вперёд он его не увидит (окно — миллисекунды, длительность транзакции вставки). Повторов при обходе нет. Чтение после записи выполняется: ответ 201 приходит после COMMIT, следующий `GET` это сообщение видит. + +### Соответствие переменных окружения + +| Переменная в `.env` | По умолчанию | Что делает | +| --- | --- | --- | +| `APP_HOST`, `APP_PORT` | `0.0.0.0`, `8080` | адрес сервера; в compose заданы жёстко, из `.env` не читаются | +| `APP_ENV` | `lab` | выводится в лог при старте | +| `SESSION_TTL_SECONDS` | `3600` | срок жизни сессии | +| `SESSION_STORE` | `redis` | поддерживается только `redis`, с другим значением сервер не стартует | +| `DATABASE_URL_FILE`, `CACHE_URL_FILE` | `/run/secrets/...` | пути к файлам со строками подключения; в compose заданы жёстко | +| `LOG_LEVEL`, `SHUTDOWN_TIMEOUT` | `info`, `8` | как в lab1 | +| `DB_POOL_*`, `DB_*_TIMEOUT`, `CACHE_*` | см. таблицу выше | пул и таймауты | +| `POSTGRES_PASSWORD`, `REDIS_PASSWORD`, `DATABASE_URL`, `CACHE_URL` | создаёт `init-env.sh` | источник compose-секретов; в контейнер `api` попадают только файлами | + +### Что перенесено из lab1 и что изменено + +Перенесены: структура `src/`, формат ошибок и `X-Request-Id`, валидация JSON, cursor-пагинация, логирование без содержимого, Dockerfile (непривилегированный пользователь, healthcheck, корректная остановка по SIGTERM), собственные тесты. + +Изменено: хранилище в памяти заменено на PostgreSQL; `X-User-Id` заменён на пароль, Basic и Bearer; добавлены миграции, Redis, compose, проверка зависимостей в `/health/ready` и ответ 503. Строки теперь проверяются ещё и на символ NUL, который PostgreSQL не хранит. Контракт и публичные тесты не менялись. ## Доказательства критериев +Стенд: Apple M3 Pro, 11 CPU, 18 ГБ RAM, macOS 26.1, Docker 29.3.0, Compose 5.1.0, без ограничений CPU/RAM для контейнеров. Все файлы получены из чистого clone на пустых volumes, commit `6473fd0`. + | Критерий README | Команда/сценарий | Наблюдаемый результат | Файл доказательства | | --- | --- | --- | --- | -| Публичный smoke | make test | TODO | TODO | -| Остальные пункты уровня 3 | TODO | TODO | TODO | -| Все пункты уровня 4, если заявлен | TODO | TODO | TODO | -| Выбранный трек 5, если заявлен | TODO | TODO | TODO | - -TODO: добавить отдельную строку для каждого заявленного критерия. PASS без команды и наблюдения не является доказательством. Проверка инфраструктурного hook требует подтверждения, какие реальные процессы/хранилища перезапущены. +| Публичный smoke | `make test` | `PASS: lab2 public API scenario` | `evidence/01-up-and-smoke.txt` | +| 3: данные и сессии переживают рестарт API и хранилищ | `make test-persistence ACTION_SCRIPT=scripts/restart.sh` | `PASS`; у контейнеров `postgres`, `redis`, `api` новое время старта, volumes те же | `evidence/03-persistence.txt` | +| 3: таблицы, ключи, уникальность username, миграции с нуля | `make up` на пустом volume | `применена: 0001_init.sql`, smoke проходит | `evidence/01-up-and-smoke.txt`, `migrations/0001_init.sql` | +| 3: создание чата атомарно | `make test-failures` (`test_transactions.py`) | после неудачного создания в `chats` 0 строк, после удачного — чат и 2 участника | `evidence/05-failures.txt` | +| 3: Basic только на входе, Bearer на остальном, срок жизни, отзыв, `X-User-Id` не даёт доступ | `make student-test` (`test_auth.py`) | 15 тестов `ok` | `evidence/02-student-tests.txt` | +| 3: пароли хешируются KDF | `test_password_is_stored_as_argon2id_hash` | hash в БД начинается с `$argon2id$` | `evidence/05-failures.txt` | +| 3: миграции повторяются без дублирования | `docker compose run --rm migrate` | `уже применена: 0001_init.sql`, в `schema_migrations` одна строка, число строк в таблицах не изменилось | `evidence/03-persistence.txt`, `evidence/05-failures.txt` | +| 3: secrets и volumes не в Git | `git ls-files \| grep -E "^\.env$\|secrets"` | пусто | `evidence/07-containers.txt` | +| 4: Redis реально используется для сессий с TTL и persistence | `redis-cli CONFIG GET`, `TTL`, `docker compose restart redis` | `appendonly yes`, `appendfsync always`; ключ пережил перезапуск, TTL 3591 → 3583 | `evidence/04-redis-sessions.txt` | +| 4: параметризованные запросы, ограниченный пул, таймауты | `src/store.py`, `src/sessions.py`; остановка зависимостей | 503 через 0,01 с без Redis и через 3,0 с без PostgreSQL | `evidence/05-failures.txt` | +| 4: гонка регистрации одного username | `test_username_race_creates_one_row`, `test_same_username_registered_once` | один ответ 201 и девять 409, в `users` одна строка | `evidence/05-failures.txt`, `evidence/02-student-tests.txt` | +| 4: rollback составной операции | `test_chat_with_unknown_member_is_rolled_back` | 400, в `chats` 0 строк с этим названием, участников без чата нет | `evidence/05-failures.txt` | +| 4: индекс истории обоснован EXPLAIN на ≥10 000 сообщений | `make explain` | Index Scan, 8 буферов на страницу в любом месте истории | `evidence/06-explain.txt` | +| 4: автоматическая проверка expiry при коротком TTL | `test_expiry.py`, API с `SESSION_TTL_SECONDS=2` | через 3 с токен получает 401, запросы срок не продлевают | `evidence/05-failures.txt` | +| 4: автоматическая проверка logout и неверного пароля | `test_auth.py` | после logout 401, вторая сессия работает; неверный пароль — 401 | `evidence/02-student-tests.txt` | +| 4: недоступность Redis и БД | `test_dependencies.py` | 503 `unavailable` за ограниченное время, аноним получает 401, после восстановления прежний токен и данные на месте | `evidence/05-failures.txt` | +| Возможности lab1: непривилегированный пользователь, закреплённые версии, SIGTERM | `docker compose exec api id`, `scripts/sigterm_check.py` | `uid=10001(app)`; начатый запрос получил 201, выход за 1,45 с с кодом 0 | `evidence/07-containers.txt`, `evidence/08-sigterm.txt` | ## Эксперименты и отказы -TODO: гипотеза, hardware/лимиты, версии, объём данных, профиль нагрузки, concurrency/arrival rate, длительность/прогрев, повторы, успешные RPS, ошибки, p50/p95/p99, CPU/RAM. Сохранить raw summary без tokens и объяснить ограничения измерения. +Нагрузочное исследование (трек 5) не проводилось. + +### Индекс истории + +Гипотеза: индекс `(chat_id, created_at, id)` позволяет читать любую страницу истории за число обращений к диску, не зависящее от длины истории и от положения страницы. + +Методика: `scripts/seed_history.sql` создаёт 21 чат и 60 000 сообщений, из них 10 000 в исследуемом чате, остальные 50 000 поровну в 20 других; затем `ANALYZE`. `scripts/explain_history.sql` выполняет `EXPLAIN (ANALYZE, BUFFERS)` для четырёх запросов с `LIMIT 51` (страница 50 плюс одна строка). Данные небольшие и целиком в кэше, поэтому сравнивать нужно число буферов, а не миллисекунды. + +| Запрос | План | Буферов | Время выполнения | +| --- | --- | --- | --- | +| первая страница | Index Scan по `messages_chat_history_idx` | 8 | 0,025 мс | +| страница после 5000-го сообщения, keyset | Index Scan, условие на `(created_at, id)` внутри Index Cond | 8 | 0,034 мс | +| та же страница через `OFFSET 5000` | Index Scan, прочитано 5051 строка | 491 | 0,469 мс | +| keyset без индекса | Seq Scan всей таблицы (отброшено 55 140 строк) и сортировка | 862 | 2,266 мс | + +Вывод: с индексом и keyset страница из середины стоит столько же, сколько первая, сортировка не нужна. OFFSET читает все пропущенные строки, и стоимость растёт с номером страницы. Без индекса каждая страница читает всю таблицу, включая чужие чаты. + +Ограничение измерения: одна таблица на 60 000 строк, один запуск, всё в памяти. Для вывода о реальной нагрузке этого мало. Четвёртый запрос выполняет `DROP INDEX` внутри транзакции с `ROLLBACK`: на это время таблица `messages` заблокирована, поэтому скрипт годится только для учебного стенда. + +### Отказы | Воздействие | Что ожидаем | Что наблюдали | Время восстановления / потеря данных | | --- | --- | --- | --- | -| TODO | TODO | TODO | TODO | +| `docker compose restart postgres redis api` | данные и сессия на месте | прежний токен читает прежние сообщения | готов через несколько секунд, потерь нет | +| `docker compose stop redis` | запросы с токеном не выполняются | 503 за 0,01 с; без токена 401; `/health/ready` 503, `/health/live` 200 | после `start redis` прежний токен работает, сообщение, отправленное во время отказа, не записано | +| `docker compose stop postgres` | запросы к данным не выполняются | 503 за 3,0 с; без токена 401 | после `start postgres` данные на месте, запись снова работает | +| сессия с TTL 2 с | через 2 с токен недействителен | через 3 с 401, logout с ним тоже 401, новый вход работает | — | +| чат с несуществующим участником | ничего не создаётся | 400, в `chats` и `chat_members` следов нет | — | +| 10 одновременных регистраций одного username | один пользователь | один 201, девять 409, одна строка | — | +| SIGTERM процессу API | начатый запрос завершится | 201, новые соединения не принимаются, выход за 1,45 с | — | ## Ограничения и следующие шаги -TODO: какие отказы выдерживаются и какие нет; что не реализовано; где учебное упрощение; какое улучшение подтверждено, а какое пока гипотеза. +- Один экземпляр API, один PostgreSQL, один Redis на одном хосте. Отказ хоста, диска или любого из хранилищ не переживается, резервных копий нет. +- При недоступном Redis не работает ни один запрос с токеном: запасного пути проверки сессии нет. Это осознанный выбор в пользу простоты и того, что отозванная сессия не может «ожить» из другого хранилища. +- `appendfsync always` делает каждую запись сессии синхронной записью на диск. Для учебного стенда это незаметно, под нагрузкой вход станет узким местом. +- Нет ограничения числа попыток входа и числа сессий на пользователя, код 429 не используется. +- Порядок истории при параллельных вставках описан выше: возможен пропуск сообщения при обходе вперёд в окне длительности транзакции. +- Если JSON синтаксически сломан, FastAPI отвечает 400 раньше, чем проверяется токен. На доступ к данным это не влияет. +- При недоступной БД ответ 503 приходит через 3 секунды, а не сразу: столько запрос ждёт соединение из пула. +- Пароли в `.env` лежат открытым текстом на диске разработчика (права 600). Для локального стенда с синтетическими данными это допустимо. +- `make explain` оставляет в БД синтетические чаты и 60 000 сообщений; убрать их можно только `make clean`. +- Проверено на одном стенде (macOS, Docker Desktop). На Linux не запускалось. diff --git a/evidence/01-up-and-smoke.txt b/evidence/01-up-and-smoke.txt new file mode 100644 index 00000000..1a9770e5 --- /dev/null +++ b/evidence/01-up-and-smoke.txt @@ -0,0 +1,72 @@ +# Запуск из чистого clone на пустых volumes, публичный smoke +# дата: 2026-10-08T15:55Z, commit: 6473fd0 +# стенд: Apple M3 Pro, 11 CPU, 18 GB RAM, macOS 26.1, Docker 29.3.0, Compose 5.1.0 + +$ ./scripts/init-env.sh +пароли записаны в .env + +$ docker compose --env-file .env config --quiet + +$ docker compose --env-file .env up -d --build + Image mtusi-messenger:lab2 Built + Image mtusi-messenger:lab2 Built + Network mtusi-messenger-lab2_default Creating + Network mtusi-messenger-lab2_default Created + Volume mtusi-messenger-lab2_redisdata Creating + Volume mtusi-messenger-lab2_redisdata Created + Volume mtusi-messenger-lab2_pgdata Creating + Volume mtusi-messenger-lab2_pgdata Created + Container mtusi-messenger-lab2-postgres-1 Creating + Container mtusi-messenger-lab2-redis-1 Creating + Container mtusi-messenger-lab2-postgres-1 Created + Container mtusi-messenger-lab2-redis-1 Created + Container mtusi-messenger-lab2-migrate-1 Creating + Container mtusi-messenger-lab2-migrate-1 Created + Container mtusi-messenger-lab2-api-1 Creating + Container mtusi-messenger-lab2-api-1 Created + Container mtusi-messenger-lab2-postgres-1 Starting + Container mtusi-messenger-lab2-redis-1 Starting + Container mtusi-messenger-lab2-postgres-1 Started + Container mtusi-messenger-lab2-postgres-1 Waiting + Container mtusi-messenger-lab2-redis-1 Started + Container mtusi-messenger-lab2-postgres-1 Healthy + Container mtusi-messenger-lab2-migrate-1 Starting + Container mtusi-messenger-lab2-migrate-1 Started + Container mtusi-messenger-lab2-migrate-1 Waiting + Container mtusi-messenger-lab2-redis-1 Waiting + Container mtusi-messenger-lab2-migrate-1 Exited + Container mtusi-messenger-lab2-redis-1 Healthy + Container mtusi-messenger-lab2-api-1 Starting + Container mtusi-messenger-lab2-api-1 Started + +$ ./scripts/wait-ready.sh +готов: http://localhost:8080 + +$ docker compose --env-file .env ps -a +SERVICE IMAGE STATE STATUS +api mtusi-messenger:lab2 running Up 1 second (health: starting) +migrate mtusi-messenger:lab2 exited Exited (0) 1 second ago +postgres postgres:17.11-alpine running Up 7 seconds (healthy) +redis redis:7.4.11-alpine running Up 7 seconds (healthy) + +$ docker compose --env-file .env logs migrate +migrate-1 | применена: 0001_init.sql + +$ curl -s -i http://localhost:8080/health/ready +HTTP/1.1 200 OK +date: Thu, 08 Oct 2026 15:55:10 GMT +server: uvicorn +content-length: 15 +content-type: application/json +x-request-id: c5fc87a41bdc4cfaa665cddb6d79a6c0 + +{"status":"ok"} + +$ make check +python3 scripts/check_contract.py +PASS: offline skeleton structure, local refs and Python syntax; application NOT tested. + +$ make test +python3 tests/smoke.py --base-url "http://localhost:8080" +PASS: lab2 public API scenario; infrastructure and grading evidence remain separate. + diff --git a/evidence/02-student-tests.txt b/evidence/02-student-tests.txt new file mode 100644 index 00000000..c8921eb6 --- /dev/null +++ b/evidence/02-student-tests.txt @@ -0,0 +1,73 @@ +# Собственные тесты API +# дата: 2026-10-08T15:55Z, commit: 6473fd0 +# стенд: Apple M3 Pro, 11 CPU, 18 GB RAM, macOS 26.1, Docker 29.3.0, Compose 5.1.0 + +$ make student-test +BASE_URL="http://localhost:8080" python3 -m unittest discover -s student-tests -v +test_blank_title (test_access.CreateChatTest.test_blank_title) ... ok +test_creator_must_be_member (test_access.CreateChatTest.test_creator_must_be_member) ... ok +test_duplicate_members (test_access.CreateChatTest.test_duplicate_members) ... ok +test_empty_members (test_access.CreateChatTest.test_empty_members) ... ok +test_failed_create_leaves_no_chat (test_access.CreateChatTest.test_failed_create_leaves_no_chat) ... ok +test_unknown_member (test_access.CreateChatTest.test_unknown_member) ... ok +test_bad_chat_id (test_access.ForeignChatTest.test_bad_chat_id) ... ok +test_chat_is_not_listed_for_outsider (test_access.ForeignChatTest.test_chat_is_not_listed_for_outsider) ... ok +test_foreign_chat_looks_like_missing_chat (test_access.ForeignChatTest.test_foreign_chat_looks_like_missing_chat) ... ok +test_members_can_read_and_write (test_access.ForeignChatTest.test_members_can_read_and_write) ... ok +test_outsider_gets_404_everywhere (test_access.ForeignChatTest.test_outsider_gets_404_everywhere) ... ok +test_outsider_message_is_not_saved (test_access.ForeignChatTest.test_outsider_message_is_not_saved) ... ok +test_basic_is_not_accepted_on_business_endpoints (test_auth.BearerTest.test_basic_is_not_accepted_on_business_endpoints) ... ok +test_no_token (test_auth.BearerTest.test_no_token) ... ok +test_token_is_checked_before_anything_else (test_auth.BearerTest.test_token_is_checked_before_anything_else) ... ok +test_unknown_tokens (test_auth.BearerTest.test_unknown_tokens) ... ok +test_x_user_id_does_not_change_identity (test_auth.BearerTest.test_x_user_id_does_not_change_identity) ... ok +test_x_user_id_gives_no_access (test_auth.BearerTest.test_x_user_id_gives_no_access) ... ok +test_colon_and_unicode_in_password (test_auth.LoginTest.test_colon_and_unicode_in_password) ... ok +test_login (test_auth.LoginTest.test_login) ... ok +test_malformed_credentials (test_auth.LoginTest.test_malformed_credentials) ... ok +test_token_is_opaque_and_unique (test_auth.LoginTest.test_token_is_opaque_and_unique) ... ok +test_username_that_cannot_exist (test_auth.LoginTest.test_username_that_cannot_exist) ... ok +test_wrong_password_and_unknown_user_look_the_same (test_auth.LoginTest.test_wrong_password_and_unknown_user_look_the_same) ... ok +test_login_again_after_logout (test_auth.LogoutTest.test_login_again_after_logout) ... ok +test_logout_requires_token (test_auth.LogoutTest.test_logout_requires_token) ... ok +test_logout_revokes_only_current_session (test_auth.LogoutTest.test_logout_revokes_only_current_session) ... ok +test_100_messages_from_10_clients (test_concurrency.ConcurrencyTest.test_100_messages_from_10_clients) ... ok +test_same_username_registered_once (test_concurrency.ConcurrencyTest.test_same_username_registered_once) ... ok +test_chat_cursor_belongs_to_user (test_pagination.ChatPaginationTest.test_chat_cursor_belongs_to_user) ... ok +test_walk_chat_list (test_pagination.ChatPaginationTest.test_walk_chat_list) ... ok +test_bad_cursor (test_pagination.MessagePaginationTest.test_bad_cursor) ... ok +test_bad_limit (test_pagination.MessagePaginationTest.test_bad_limit) ... ok +test_cursor_from_another_chat (test_pagination.MessagePaginationTest.test_cursor_from_another_chat) ... ok +test_default_limit (test_pagination.MessagePaginationTest.test_default_limit) ... ok +test_exact_page_has_no_cursor (test_pagination.MessagePaginationTest.test_exact_page_has_no_cursor) ... ok +test_limit_can_change_between_pages (test_pagination.MessagePaginationTest.test_limit_can_change_between_pages) ... ok +test_new_message_appears_after_last_page (test_pagination.MessagePaginationTest.test_new_message_appears_after_last_page) ... ok +test_no_duplicates_and_order (test_pagination.MessagePaginationTest.test_no_duplicates_and_order) ... ok +test_walk_several_pages (test_pagination.MessagePaginationTest.test_walk_several_pages) ... ok +test_extra_field (test_validation.InvalidJsonTest.test_extra_field) ... ok +test_malformed_json (test_validation.InvalidJsonTest.test_malformed_json) ... ok +test_malformed_json_in_message (test_validation.InvalidJsonTest.test_malformed_json_in_message) ... ok +test_missing_field (test_validation.InvalidJsonTest.test_missing_field) ... ok +test_not_an_object (test_validation.InvalidJsonTest.test_not_an_object) ... ok +test_wrong_type (test_validation.InvalidJsonTest.test_wrong_type) ... ok +test_empty_message (test_validation.MessageValidationTest.test_empty_message) ... ok +test_nul_character (test_validation.MessageValidationTest.test_nul_character) ... ok +test_sender_id_is_not_accepted (test_validation.MessageValidationTest.test_sender_id_is_not_accepted) ... ok +test_text_limit (test_validation.MessageValidationTest.test_text_limit) ... ok +test_unicode_is_kept (test_validation.MessageValidationTest.test_unicode_is_kept) ... ok +test_whitespace_message (test_validation.MessageValidationTest.test_whitespace_message) ... ok +test_bad_display_names (test_validation.UserValidationTest.test_bad_display_names) ... ok +test_bad_passwords (test_validation.UserValidationTest.test_bad_passwords) ... ok +test_bad_usernames (test_validation.UserValidationTest.test_bad_usernames) ... ok +test_display_name_length_is_counted_in_code_points (test_validation.UserValidationTest.test_display_name_length_is_counted_in_code_points) ... ok +test_duplicate_username (test_validation.UserValidationTest.test_duplicate_username) ... ok +test_password_is_never_returned (test_validation.UserValidationTest.test_password_is_never_returned) ... ok +test_password_length_limits (test_validation.UserValidationTest.test_password_length_limits) ... ok + +---------------------------------------------------------------------- +Ran 59 tests in 1.690s + +OK + +отправлено 100, подтверждено 100, в истории 100, уникальных id 100 + diff --git a/evidence/03-persistence.txt b/evidence/03-persistence.txt new file mode 100644 index 00000000..3ab62be6 --- /dev/null +++ b/evidence/03-persistence.txt @@ -0,0 +1,46 @@ +# Сохранность: перезапуск API, PostgreSQL и Redis с сохранением volumes +# дата: 2026-10-08T15:55Z, commit: 6473fd0 +# стенд: Apple M3 Pro, 11 CPU, 18 GB RAM, macOS 26.1, Docker 29.3.0, Compose 5.1.0 + +# до перезапуска +postgres StartedAt=2026-10-08T15:55:04.230004924Z +redis StartedAt=2026-10-08T15:55:04.230356549Z +api StartedAt=2026-10-08T15:55:10.436053969Z + +$ cat scripts/restart.sh +#!/bin/sh +# Перезапускает API и оба хранилища. Volumes не трогает: данные и сессии должны остаться. +set -eu +cd "$(dirname "$0")/.." +docker compose --env-file .env restart postgres redis api + +$ make test-persistence ACTION_SCRIPT=scripts/restart.sh +python3 tests/resilience.py --mode persistence --action-script "scripts/restart.sh" --base-url "http://localhost:8080" +Executing explicit persistence hook; hook output suppressed to avoid leaking secrets. +PASS: persistence preserved confirmed data and existing session. Hook scope needs operator evidence. + +# после перезапуска: у всех трёх контейнеров новое время старта +postgres StartedAt=2026-10-08T15:55:15.070657346Z +redis StartedAt=2026-10-08T15:55:15.160837596Z +api StartedAt=2026-10-08T15:55:15.392988013Z + +$ docker volume ls --filter name=mtusi-messenger-lab2 +DRIVER VOLUME NAME +local mtusi-messenger-lab2_pgdata +local mtusi-messenger-lab2_redisdata + +# повторный запуск миграций +$ docker compose --env-file .env run --rm migrate + Container mtusi-messenger-lab2-postgres-1 Running + Container mtusi-messenger-lab2-postgres-1 Waiting + Container mtusi-messenger-lab2-postgres-1 Healthy + Container mtusi-messenger-lab2-migrate-run-c47ffc8919e4 Creating + Container mtusi-messenger-lab2-migrate-run-c47ffc8919e4 Created +уже применена: 0001_init.sql + +$ psql: SELECT * FROM schema_migrations + version | applied_at +---------------+------------------------------- + 0001_init.sql | 2026-10-08 15:55:10.184216+00 +(1 row) + diff --git a/evidence/04-redis-sessions.txt b/evidence/04-redis-sessions.txt new file mode 100644 index 00000000..37f779f4 --- /dev/null +++ b/evidence/04-redis-sessions.txt @@ -0,0 +1,36 @@ +# Сессии в Redis: настройки persistence, вид ключа, TTL не продлевается перезапуском +# дата: 2026-10-08T15:55Z, commit: 6473fd0 +# стенд: Apple M3 Pro, 11 CPU, 18 GB RAM, macOS 26.1, Docker 29.3.0, Compose 5.1.0 + +$ redis-cli CONFIG GET appendonly / appendfsync / maxmemory-policy +appendonly +yes +appendfsync +always +maxmemory-policy +noeviction + +$ redis-cli --scan --pattern 'session:*' | wc -l + 41 + +# один из ключей: sha256 от токена, значение — id пользователя +$ redis-cli GET session:e478544e3e6f92c4c36896617f812541bdb171df4654de1fafaad9074c962367 +97dbb54c-2e55-441f-ae31-ef469b935758 +$ redis-cli TTL session:e478544e3e6f92c4c36896617f812541bdb171df4654de1fafaad9074c962367 +3591 + +$ docker compose --env-file .env restart redis + Container mtusi-messenger-lab2-redis-1 Restarting + Container mtusi-messenger-lab2-redis-1 Started + +$ redis-cli TTL session:e478544e3e6f92c4c36896617f812541bdb171df4654de1fafaad9074c962367 # после перезапуска ключ на месте, TTL уменьшился +3583 + +$ docker compose --env-file .env exec -T redis ls -la /data/appendonlydir +total 24 +drwx------ 2 redis redis 4096 Oct 8 15:55 . +drwxr-xr-x 3 redis redis 4096 Oct 8 15:55 .. +-rw------- 1 redis redis 89 Oct 8 15:55 appendonly.aof.1.base.rdb +-rw------- 1 redis redis 7582 Oct 8 15:55 appendonly.aof.1.incr.aof +-rw------- 1 redis redis 88 Oct 8 15:55 appendonly.aof.manifest + diff --git a/evidence/05-failures.txt b/evidence/05-failures.txt new file mode 100644 index 00000000..c6a19d91 --- /dev/null +++ b/evidence/05-failures.txt @@ -0,0 +1,36 @@ +# Тесты отказов: истечение сессии, остановка Redis и PostgreSQL, откат транзакции, гонка регистрации +# дата: 2026-10-08T15:55Z, commit: 6473fd0 +# стенд: Apple M3 Pro, 11 CPU, 18 GB RAM, macOS 26.1, Docker 29.3.0, Compose 5.1.0 + +$ make test-failures +BASE_URL="http://localhost:8080" python3 -m unittest discover -s student-tests/failures -v +test_postgres_down (test_dependencies.DependencyDownTest.test_postgres_down) ... ok +test_redis_down (test_dependencies.DependencyDownTest.test_redis_down) ... ok +test_expires_at_matches_ttl (test_expiry.SessionExpiryTest.test_expires_at_matches_ttl) ... ok +test_login_after_expiry (test_expiry.SessionExpiryTest.test_login_after_expiry) ... ok +test_requests_do_not_extend_session (test_expiry.SessionExpiryTest.test_requests_do_not_extend_session) ... ok +test_session_expires (test_expiry.SessionExpiryTest.test_session_expires) ... ok +test_chat_with_unknown_member_is_rolled_back (test_transactions.TransactionTest.test_chat_with_unknown_member_is_rolled_back) ... ok +test_migrations_can_be_repeated (test_transactions.TransactionTest.test_migrations_can_be_repeated) ... ok +test_password_is_stored_as_argon2id_hash (test_transactions.TransactionTest.test_password_is_stored_as_argon2id_hash) ... ok +test_username_race_creates_one_row (test_transactions.TransactionTest.test_username_race_creates_one_row) ... ok +test_valid_chat_is_committed_whole (test_transactions.TransactionTest.test_valid_chat_is_committed_whole) ... ok + +---------------------------------------------------------------------- +Ran 11 tests in 47.384s + +OK + +# время ответа при отказе (после тестов сервисы снова остановлены вручную) +$ docker compose stop redis; curl /api/v1/users/me с Bearer-токеном +{"error":{"code":"unavailable","message":"Сервис временно недоступен","request_id":"ec599bbf80da42ba9410d2bb5fe44408"}} +HTTP 503 за 0.010007 с +$ docker compose stop postgres; curl /health/ready +{"error":{"code":"unavailable","message":"Сервис временно недоступен","request_id":"ff86a9409ca74d1a9207d7efe82e4313"}} +HTTP 503 за 3.015225 с + +$ docker compose logs api | grep unavailable | tail -4 +api-1 | 2026-10-08 15:55:59,645 WARNING messenger: redis unavailable: ConnectionError request_id=7303c9edcbe8408496ff607945e71893 +api-1 | 2026-10-08 15:55:59,653 WARNING messenger: redis unavailable: ConnectionError request_id=0a217c1035f548f0b3a68b9bb0640d3f +api-1 | 2026-10-08 15:56:17,960 WARNING messenger: redis unavailable: ConnectionError request_id=ec599bbf80da42ba9410d2bb5fe44408 +api-1 | 2026-10-08 15:56:21,270 WARNING messenger: postgres unavailable: PoolTimeout request_id=ff86a9409ca74d1a9207d7efe82e4313 diff --git a/evidence/06-explain.txt b/evidence/06-explain.txt new file mode 100644 index 00000000..37977829 --- /dev/null +++ b/evidence/06-explain.txt @@ -0,0 +1,74 @@ +# Индекс истории: EXPLAIN (ANALYZE, BUFFERS) на 60 000 сообщений, 10 000 в одном чате +# дата: 2026-10-08T15:56Z, commit: 6473fd0 +# стенд: Apple M3 Pro, 11 CPU, 18 GB RAM, macOS 26.1, Docker 29.3.0, Compose 5.1.0 + +$ make explain +./scripts/explain_history.sh +== Объём данных + messages_total | messages_in_chat | table_size | index_size +----------------+------------------+------------+------------ + 60140 | 10000 | 6848 kB | 6160 kB +(1 row) + + +== 1. Первая страница (limit 50, запрос берёт 51 строку) + QUERY PLAN +--------------------------------------------------------------------------------------------------------------------------------------------------- + Limit (cost=0.41..21.21 rows=51 width=80) (actual time=0.007..0.015 rows=51 loops=1) + Buffers: shared hit=8 + -> Index Scan using messages_chat_history_idx on messages (cost=0.41..4114.85 rows=10089 width=80) (actual time=0.006..0.012 rows=51 loops=1) + Index Cond: (chat_id = '00000000-0000-4000-8000-000000000100'::uuid) + Buffers: shared hit=8 + Planning: + Buffers: shared hit=33 + Planning Time: 0.079 ms + Execution Time: 0.025 ms +(9 rows) + + +== 2. Страница из середины истории: keyset после 5000-го сообщения + QUERY PLAN +------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- + Limit (cost=0.41..38.79 rows=51 width=80) (actual time=0.006..0.015 rows=51 loops=1) + Buffers: shared hit=8 + -> Index Scan using messages_chat_history_idx on messages (cost=0.41..3778.58 rows=5021 width=80) (actual time=0.006..0.012 rows=51 loops=1) + Index Cond: ((chat_id = '00000000-0000-4000-8000-000000000100'::uuid) AND (ROW(created_at, id) > ROW('2026-10-08 07:36:22.289031+00'::timestamp with time zone, '31ba47ee-c105-47bd-9bb1-79986700dbd4'::uuid))) + Buffers: shared hit=8 + Planning Time: 0.031 ms + Execution Time: 0.034 ms +(7 rows) + + +== 3. Та же страница через OFFSET (так делать не стали) + QUERY PLAN +----------------------------------------------------------------------------------------------------------------------------------------------------- + Limit (cost=2039.48..2060.28 rows=51 width=80) (actual time=0.459..0.464 rows=51 loops=1) + Buffers: shared hit=491 + -> Index Scan using messages_chat_history_idx on messages (cost=0.41..4114.85 rows=10089 width=80) (actual time=0.005..0.359 rows=5051 loops=1) + Index Cond: (chat_id = '00000000-0000-4000-8000-000000000100'::uuid) + Buffers: shared hit=491 + Planning Time: 0.016 ms + Execution Time: 0.469 ms +(7 rows) + + +== 4. Запрос из пункта 2 без индекса messages_chat_history_idx (DROP INDEX внутри транзакции с ROLLBACK) + QUERY PLAN +--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- + Limit (cost=2075.96..2076.09 rows=51 width=80) (actual time=2.252..2.256 rows=51 loops=1) + Buffers: shared hit=862 + -> Sort (cost=2075.96..2088.51 rows=5021 width=80) (actual time=2.252..2.254 rows=51 loops=1) + Sort Key: created_at, id + Sort Method: top-N heapsort Memory: 31kB + Buffers: shared hit=862 + -> Seq Scan on messages (cost=0.00..1908.45 rows=5021 width=80) (actual time=0.939..2.012 rows=5000 loops=1) + Filter: ((chat_id = '00000000-0000-4000-8000-000000000100'::uuid) AND (ROW(created_at, id) > ROW('2026-10-08 07:36:22.289031+00'::timestamp with time zone, '31ba47ee-c105-47bd-9bb1-79986700dbd4'::uuid))) + Rows Removed by Filter: 55140 + Buffers: shared hit=856 + Planning: + Buffers: shared hit=4 + Planning Time: 0.032 ms + Execution Time: 2.266 ms +(14 rows) + + diff --git a/evidence/07-containers.txt b/evidence/07-containers.txt new file mode 100644 index 00000000..2f70cc31 --- /dev/null +++ b/evidence/07-containers.txt @@ -0,0 +1,58 @@ +# Контейнеры: пользователи, секреты, версии +# дата: 2026-10-08T15:56Z, commit: 6473fd0 +# стенд: Apple M3 Pro, 11 CPU, 18 GB RAM, macOS 26.1, Docker 29.3.0, Compose 5.1.0 + +$ docker compose --env-file .env exec -T api id +uid=10001(app) gid=10001(app) groups=10001(app) + +$ docker compose exec api ls -l /run/secrets +total 8 +-r--r--r-- 1 root root 70 Oct 8 15:55 cache_url +-r--r--r-- 1 root root 95 Oct 8 15:55 database_url + +$ docker compose exec api env | grep -ci "password\|postgresql://\|redis://" # секретов в окружении нет +0 + +$ docker compose exec redis ps -o user,args +USER COMMAND +redis redis-server *:6379 +root ps -o user,args + +$ docker compose exec postgres ps -o user,args | head -3 +USER COMMAND +postgres postgres +postgres postgres: checkpointer + +$ docker compose --env-file .env images +CONTAINER REPOSITORY TAG PLATFORM IMAGE ID SIZE CREATED +mtusi-messenger-lab2-api-1 mtusi-messenger lab2 linux/arm64 46505be4fa02 203MB 47 minutes ago +mtusi-messenger-lab2-migrate-1 mtusi-messenger lab2 linux/arm64 46505be4fa02 203MB 47 minutes ago +mtusi-messenger-lab2-postgres-1 postgres 17.11-alpine linux/arm64/v8 25a89970a832 291MB 2 weeks ago +mtusi-messenger-lab2-redis-1 redis 7.4.11-alpine linux/arm64/v8 ec4f171e9ff0 39.5MB 2 weeks ago + +$ docker compose --env-file .env exec -T api pip freeze --disable-pip-version-check +annotated-doc==0.0.5 +annotated-types==0.8.0 +anyio==4.15.1 +argon2-cffi==25.1.0 +argon2-cffi-bindings==26.1.0 +cffi==2.1.1 +click==8.5.0 +fastapi==0.143.0 +h11==0.16.0 +idna==3.20 +opentelemetry-api==1.45.1 +psycopg==3.3.6 +psycopg-binary==3.3.6 +psycopg-pool==3.3.3 +pycparser==3.1 +pydantic==2.13.5 +pydantic_core==2.46.5 +redis==8.1.0 +starlette==1.7.0 +typing-inspection==0.4.4 +typing_extensions==4.16.0 +uvicorn==0.54.0 + +$ git ls-files | grep -E "^\.env$|secrets" # в Git секретов нет +(пусто) diff --git a/evidence/08-sigterm.txt b/evidence/08-sigterm.txt new file mode 100644 index 00000000..c687132c --- /dev/null +++ b/evidence/08-sigterm.txt @@ -0,0 +1,11 @@ +# SIGTERM (возможность lab1 сохранена) +# дата: 2026-10-08T15:56Z, commit: 6473fd0 +# стенд: Apple M3 Pro, 11 CPU, 18 GB RAM, macOS 26.1, Docker 29.3.0, Compose 5.1.0 + +$ python3 scripts/sigterm_check.py +$ docker kill --signal=SIGTERM <контейнер api> +новый запрос после SIGTERM: не принят (RemoteDisconnected) +начатый до SIGTERM запрос: HTTP/1.1 201 Created +процесс завершился за 1.45 с, код выхода 0 +PASS: остановка корректная и укладывается в 10 секунд +