diff --git a/REPORT.md b/REPORT.md index c77d2c77..a8c84581 100644 --- a/REPORT.md +++ b/REPORT.md @@ -201,10 +201,10 @@ docker без правки файлов. Консольный сервис чи | Воздействие | Что ожидаем | Что наблюдали | Время восстановления / потеря данных | | --- | --- | --- | --- | -| `docker compose stop postgres` | 503 вместо 500, ready 503, live 200 | 503 через 0,1 с; ready 503, live 200 | после `start` — сразу, без рестарта API; подтверждённые данные на месте | -| `docker compose pause postgres` (сервер завис) | 503 не позже срока запроса | 503 через 8,0 с (6 с срок + 2 с закрытие), ready 503 через 2 с | после `unpause` — сразу | +| `docker compose stop postgres` | 503 вместо 500, ready 503, live 200 | 503 через 0,01 с; ready 503, live 200 | после `start` — сразу, без рестарта API; подтверждённые данные на месте | +| `docker compose pause postgres` (сервер завис) | 503 не позже срока запроса и закрытия соединения (6 + 2 с) | 503 через 8,0 с, ready 503 через 2 с | после `unpause` — сразу | | пул исчерпан (1 соединение, сервер завис) | ожидание не дольше `pool_timeout` | 503 через 1,0 с | после `unpause` — сразу | -| `scripts/restart.sh` (API и Postgres) | данные и порядок на месте | hook 3,7 с, готовность через 1 с после него | потерь нет | +| `scripts/restart.sh` (API и Postgres) | данные и порядок на месте | hook 3,6 с, готовность через 1 с после него | потерь нет | ## Ограничения и следующие шаги diff --git a/evidence/migrations/from-zero-and-rerun.md b/evidence/migrations/from-zero-and-rerun.md new file mode 100644 index 00000000..569c0a00 --- /dev/null +++ b/evidence/migrations/from-zero-and-rerun.md @@ -0,0 +1,123 @@ +# Миграции с нуля на пустом volume и повторный прогон без изменений + +| | | +|---|---| +| Спеки | `db-migrations`: «Схема с нуля», «Второй прогон», «Порядок запуска» | +| Change | `postgres-storage`, задача 7.2 | +| Дата | 2026-10-01 13:22 UTC | +| Commit | `2d0a7c8` | +| Стенд | `make run_docker` (compose: postgres, migrate, api), API на `127.0.0.1:8080` | +| Хост | Docker Desktop 29.8.1, macOS arm64; ВМ Docker: 12 CPU, 7 GiB RAM; лимиты контейнерам не задавались | +| Клиент | разовый stdlib-скрипт: HTTP по контракту, счётчики через `psql`; id сокращены, тексты синтетические | + +## 1. Пустой volume и запуск стенда + +```text +$ echo yes | make wipe_data +Volume mtusi-lab2_postgres_data Removing +Volume mtusi-lab2_postgres_data Removed + +$ make run_docker # exit 0 +Container mtusi-lab2-postgres-1 Started +Container mtusi-lab2-postgres-1 Healthy +Container mtusi-lab2-migrate-1 Started +Container mtusi-lab2-migrate-1 Exited +Container mtusi-lab2-api-1 Started +GET /health/ready -> 200 через 0,5 с после make run_docker +``` + +Журнал `migrate` (поле `event` JSON-строк, `src/infra/logger.py`): + +```text +Running alembic +Context impl PostgresqlImpl. +Will assume transactional DDL. +Running upgrade -> 16c279725564, added messenger tables +Finished alembic +``` + +| Контейнер | Момент | Код выхода | +|---|---|---| +| `mtusi-lab2-migrate-1` | `FinishedAt` 2026-10-01T13:22:55.192854126Z | 0 | +| `mtusi-lab2-api-1` | `StartedAt` 2026-10-01T13:22:55.681391251Z | — | + +`migrate` завершился с кодом 0 раньше старта API (`depends_on: +service_completed_successfully`). + +## 2. Схема после миграций + +Ограничения (`pg_constraint`; строки `NOT NULL` опущены — `NOT NULL` +стоит на всех колонках): + +| Таблица | Ограничение | Определение | +|---|---|---| +| `chat_members` | `ck_chat_members_position_non_negative` | `CHECK (("position" >= 0))` | +| `chat_members` | `fk_chat_members_chat_id_chats` | `FOREIGN KEY (chat_id) REFERENCES chats(id)` | +| `chat_members` | `fk_chat_members_user_id_users` | `FOREIGN KEY (user_id) REFERENCES users(id)` | +| `chat_members` | `pk_chat_members` | `PRIMARY KEY (chat_id, user_id)` | +| `chat_members` | `uq_chat_members_chat_id_position` | `UNIQUE (chat_id, "position")` | +| `chats` | `ck_chats_title_length` | `CHECK (((char_length(title) >= 1) AND (char_length(title) <= 100)))` | +| `chats` | `pk_chats` | `PRIMARY KEY (id)` | +| `messages` | `ck_messages_text_length` | `CHECK (((char_length(text) >= 1) AND (char_length(text) <= 4000)))` | +| `messages` | `fk_messages_chat_id_sender_id_chat_members` | `FOREIGN KEY (chat_id, sender_id) REFERENCES chat_members(chat_id, user_id)` | +| `messages` | `pk_messages` | `PRIMARY KEY (id)` | +| `users` | `ck_users_display_name_length` | `CHECK (((char_length(display_name) >= 1) AND (char_length(display_name) <= 100)))` | +| `users` | `ck_users_username_format` | `CHECK ((username ~ '^[a-z0-9_]{3,32}$'::text))` | +| `users` | `pk_users` | `PRIMARY KEY (id)` | +| `users` | `uq_users_username` | `UNIQUE (username)` | + +Индексы (`pg_indexes`): + +| Индекс | Определение | +|---|---| +| `ix_chat_members_user_id_created_at_chat_id` | `CREATE INDEX … ON public.chat_members USING btree (user_id, created_at, chat_id)` | +| `pk_chat_members` | `CREATE UNIQUE INDEX … ON public.chat_members USING btree (chat_id, user_id)` | +| `uq_chat_members_chat_id_position` | `CREATE UNIQUE INDEX … ON public.chat_members USING btree (chat_id, "position")` | +| `pk_chats` | `CREATE UNIQUE INDEX … ON public.chats USING btree (id)` | +| `ix_messages_chat_id_created_at_id` | `CREATE INDEX … ON public.messages USING btree (chat_id, created_at, id)` | +| `pk_messages` | `CREATE UNIQUE INDEX … ON public.messages USING btree (id)` | +| `pk_users` | `CREATE UNIQUE INDEX … ON public.users USING btree (id)` | +| `uq_users_username` | `CREATE UNIQUE INDEX … ON public.users USING btree (username)` | + +Модели совпадают со схемой базы: + +```text +$ docker compose run --rm migrate alembic check # exit 0 +Running alembic +Context impl PostgresqlImpl. +Will assume transactional DDL. +setting up autogenerate plugin alembic.autogenerate.schemas +… (tables, types, constraints, defaults, comments) +Finished alembic +No new upgrade operations detected. +``` + +## 3. Данные и повторный прогон миграций + +| Запрос | Статус | Результат | +|---|---|---| +| `POST /users` (alice) | 201 | id `c8e2863e…` | +| `POST /users` (bob) | 201 | id `d76be039…` | +| `POST /chats` (alice) | 201 | id `3571d202…` | +| `POST …/messages` (alice) | 201 | id `9448360e…` | + +```text +$ docker compose run --rm migrate # exit 0 +Running alembic +Context impl PostgresqlImpl. +Will assume transactional DDL. +Finished alembic +``` + +| Момент | users | chats | chat_members | messages | alembic_version | +|---|---|---|---|---|---| +| сразу после миграций | 0 | 0 | 0 | 0 | `16c279725564` | +| до повтора | 2 | 1 | 2 | 1 | `16c279725564` | +| после повтора | 2 | 1 | 2 | 1 | `16c279725564` | + +## Вывод + +- Миграция поднимает схему на пустом volume и не создаёт данных. +- `migrate` завершается раньше старта API. +- Повторный прогон — no-op: нет строки `Running upgrade`, число строк и + версия схемы не изменились. diff --git a/evidence/storage/db-unavailable.md b/evidence/storage/db-unavailable.md new file mode 100644 index 00000000..6c49df55 --- /dev/null +++ b/evidence/storage/db-unavailable.md @@ -0,0 +1,73 @@ +# Недоступность PostgreSQL: 503 вместо 500 и зависания, работа без рестарта API + +| | | +|---|---| +| Спеки | `data-storage` «БД остановлена», «БД вернулась»; `health` «Хранилище не готово» | +| Change | `postgres-storage`, задачи 5.2 и 5.3 | +| Дата | 2026-10-01 13:23 UTC | +| Commit | `2d0a7c8` | +| Стенд | `make run_docker` (compose: postgres, migrate, api), API на `127.0.0.1:8080` | +| Хост | Docker Desktop 29.8.1, macOS arm64; ВМ Docker: 12 CPU, 7 GiB RAM; лимиты контейнерам не задавались | +| Таймауты | по умолчанию: `request_timeout_seconds=6`, мягкое закрытие соединения 2 с, readiness 2 с (design, решения 5 и 6) | +| Клиент | разовый stdlib-скрипт: статусы, коды ошибок и время ответа; id сокращены, тексты синтетические | + +## Подготовка + +| Запрос | Статус | Результат | +|---|---|---| +| `POST /users` (alice) | 201 | id `844d4bd3…` | +| `POST /users` (bob) | 201 | id `5d38e7d5…` | +| `POST /chats` (alice) | 201 | id `435eb170…` | + +## `docker compose stop postgres` + +| Запрос | Статус | Результат | Время | +|---|---|---|---| +| `POST …/messages` (alice) | 503 | `unavailable` | 0,01 с | +| `GET /health/ready` | 503 | `unavailable` | 0,01 с | +| `GET /health/live` | 200 | `ok` | 0,00 с | + +Текст ошибки в ответе: `Service is temporarily unavailable`, без +деталей. + +## `docker compose start postgres`, ожидание healthy + +| Запрос | Статус | Результат | Время | +|---|---|---|---| +| `POST …/messages` (alice) | 201 | id `1868a0e6…` | 0,03 с | + +API не перезапускался. + +## `docker compose pause postgres` (сервер завис, TCP принимает) + +| Запрос | Статус | Результат | Время | +|---|---|---|---| +| `POST …/messages` (alice) | 503 | `unavailable` | 8,02 с | +| `GET /health/ready` | 503 | `unavailable` | 2,01 с | + +## `docker compose unpause postgres` + +| Запрос | Статус | Результат | Время | +|---|---|---|---| +| `POST …/messages` (alice) | 201 | id `8b68c87d…` | 0,05 с | + +API не перезапускался. + +## Журнал API + +`docker compose logs --no-log-prefix api`, записи `Database is +unavailable` за время сценария: + +```json +{"timestamp": "2026-10-01T13:23:36.489168Z", "event": "Database is unavailable", "error_type": "gaierror", "error": "[Errno -2] Name or service not known", "level": "warning"} +{"timestamp": "2026-10-01T13:23:45.882845Z", "event": "Database is unavailable", "error_type": "TimeoutError", "error": "", "level": "warning"} +``` + +## Вывод + +- Остановленный контейнер postgres не резолвится по имени сервиса + (`gaierror`, подкласс `OSError`), и 503 приходит сразу. +- Замёрзший сервер даёт 503 через срок запроса 6 с плюс 2 с на обрыв + соединения. +- В ответе деталей нет, они есть в журнале. +- После возврата БД запросы проходят без рестарта API. diff --git a/evidence/storage/pool-timeout.md b/evidence/storage/pool-timeout.md new file mode 100644 index 00000000..6e3e5f35 --- /dev/null +++ b/evidence/storage/pool-timeout.md @@ -0,0 +1,48 @@ +# Исчерпание пула соединений: 503 по таймауту ожидания, а не бесконечная очередь + +| | | +|---|---| +| Спек | `data-storage` «Соединения исчерпаны» | +| Change | `postgres-storage`, задача 5.4 | +| Дата | 2026-10-01 13:24 UTC | +| Commit | `2d0a7c8` | +| Стенд | сервис в console (`driver.py start`: `make upgrade`, затем `uv run python -m src`) на `127.0.0.1:18080`, Postgres из compose | +| Переопределено окружением | `DATABASE__POOL_SIZE=1`, `DATABASE__MAX_OVERFLOW=0`, `DATABASE__POOL_TIMEOUT_SECONDS=1` | +| Хост | Docker Desktop 29.8.1, macOS arm64; ВМ Docker: 12 CPU, 7 GiB RAM; лимиты контейнерам не задавались | +| Клиент | разовый stdlib-скрипт: два запроса одновременно, второй через 0,3 с после первого; id сокращены | + +## Подготовка + +| Запрос | Статус | Результат | +|---|---|---| +| `POST /users` (alice) | 201 | id `edaa3f10…` | + +## `docker compose pause postgres`, два запроса одновременно + +| Запрос | Статус | Результат | Время | +|---|---|---|---| +| `GET /users/me` №1 (держит единственное соединение) | 503 | `unavailable` | 8,00 с | +| `GET /users/me` №2 (через 0,3 с, ждёт пул) | 503 | `unavailable` | 1,01 с | + +## `docker compose unpause postgres` + +| Запрос | Статус | Результат | Время | +|---|---|---|---| +| `GET /users/me` (alice) | 200 | id `edaa3f10…` | 0,04 с | + +## Журнал сервиса + +Записи `Database is unavailable` за время сценария: + +```json +{"timestamp": "2026-10-01T13:24:20.411310Z", "event": "Database is unavailable", "error_type": "TimeoutError", "error": "QueuePool limit of size 1 overflow 0 reached, connection timed out, timeout 1.00 (Background on this error at: https://sqlalche.me/e/21/3o7r)", "level": "warning"} +{"timestamp": "2026-10-01T13:24:27.104944Z", "event": "Database is unavailable", "error_type": "TimeoutError", "error": "", "level": "warning"} +``` + +## Вывод + +- Второй запрос не дождался соединения за `pool_timeout_seconds=1`: + `sqlalchemy.exc.TimeoutError` и 503 через 1 с. +- Первый держал соединение с замёрзшим сервером: 503 через срок + запроса 6 с плюс 2 с на обрыв соединения. +- После разморозки сервис отвечает без рестарта. diff --git a/evidence/storage/postgres-port.md b/evidence/storage/postgres-port.md new file mode 100644 index 00000000..0f1c7192 --- /dev/null +++ b/evidence/storage/postgres-port.md @@ -0,0 +1,78 @@ +# Другой порт Postgres без правки compose + +| | | +|---|---| +| Спек | `container-run` «Другой порт Postgres» | +| Change | `postgres-storage`, задача 7.3 | +| Дата | 2026-10-01 13:24 UTC | +| Commit | `2d0a7c8` | +| Стенд | `make run_docker` (compose: postgres, migrate, api), API на `127.0.0.1:8080`; console — `uv run python -m src` (`driver.py start`) на `127.0.0.1:18080` | +| Хост | Docker Desktop 29.8.1, macOS arm64; ВМ Docker: 12 CPU, 7 GiB RAM; лимиты контейнерам не задавались | + +## Изменение `.env` + +Изменены две строки, остальное (в том числе пароль) не трогалось: + +| Переменная | Было | Стало | +|---|---|---| +| `POSTGRES_PORT` | 5432 | 5544 | +| `POSTGRES_OUT_PORT` | 5433 | 5545 | + +```text +$ git diff --quiet docker-compose.yml +docker-compose.yml: без изменений +``` + +## Docker: `make run_docker` + +```text +$ make run_docker # exit 0 +Container mtusi-lab2-postgres-1 Recreated +Container mtusi-lab2-migrate-1 Recreated +Container mtusi-lab2-api-1 Recreated +Container mtusi-lab2-postgres-1 Healthy +Container mtusi-lab2-migrate-1 Exited +Container mtusi-lab2-api-1 Started +GET /health/ready -> 200 +``` + +| Проверка | Значение | +|---|---| +| `PGPORT` в контейнере postgres | 5544 | +| `show port` в `psql` | 5544 | +| `docker port` postgres | `5544/tcp -> 127.0.0.1:5545` | +| `docker port` api | `8080/tcp -> 127.0.0.1:8080` | +| `DATABASE__HOST` / `DATABASE__PORT` в контейнере api | `postgres` / 5544 | + +## Консоль: `driver.py start` + +Строка `Started API` журнала сервиса: + +```json +{"event": "Started API", "database_host": "127.0.0.1", "database_port": 5545, "database_name": "messenger"} +``` + +## Данные на месте + +Пользователь и сообщение созданы до смены порта +(`evidence/migrations/from-zero-and-rerun.md`, раздел 3); volume тот же. + +| Стенд | Запрос | Статус | Результат | Проверка | +|---|---|---|---|---| +| console (18080) | `GET /users/me` (alice) | 200 | id `c8e2863e…` | тот же id: да | +| console (18080) | `GET …/messages` (alice) | 200 | items: 1 | | +| docker (8080) | `GET /users/me` (alice) | 200 | id `c8e2863e…` | тот же id: да | +| docker (8080) | `GET …/messages` (alice) | 200 | items: 1 | | + +## Возврат + +`.env` возвращён (5432 / 5433), `make run_docker` пересоздал стенд: +`docker port` postgres — `5432/tcp -> 127.0.0.1:5433`, +`/health/ready` — 200. + +## Вывод + +`PGPORT` меняет порт самого сервера и `pg_isready` в healthcheck. +Алиас и `DATABASE__PORT` берутся из тех же переменных `.env`. Литералов +адреса и порта Postgres в compose нет, литерал — только адрес публикации +`127.0.0.1`. diff --git a/evidence/storage/restart.md b/evidence/storage/restart.md new file mode 100644 index 00000000..d38e4722 --- /dev/null +++ b/evidence/storage/restart.md @@ -0,0 +1,46 @@ +# Рестарт стенда hook-ом: данные и порядок участников на месте + +| | | +|---|---| +| Спеки | `data-storage` «Прежний пользователь после рестарта», `container-run` «Рестарт hook-ом» | +| Change | `postgres-storage`, задача 6.2 | +| Дата | 2026-10-01 13:23 UTC | +| Commit | `2d0a7c8` | +| Стенд | `make run_docker` (compose: postgres, migrate, api), API на `127.0.0.1:8080` | +| Хост | Docker Desktop 29.8.1, macOS arm64; ВМ Docker: 12 CPU, 7 GiB RAM; лимиты контейнерам не задавались | +| Клиент | разовый stdlib-скрипт: HTTP по контракту, `docker inspect` до и после `scripts/restart.sh`; id сокращены, тексты синтетические | +| Идентификация | `X-User-Id` (лаба 1, до change `session-auth`) | + +## Данные до рестарта + +| Запрос | Статус | Результат | +|---|---|---| +| `POST /users` (alice) | 201 | id `37e0fe8e…` | +| `POST /users` (bob) | 201 | id `d266ad46…` | +| `POST /chats` (alice, участники `[bob, alice]`) | 201 | id `649e0f51…` | +| `POST …/messages` (alice) | 201 | id `d74d128e…` | +| `POST …/messages` (bob) | 201 | id `937b2ad5…` | +| `POST …/messages` (alice) | 201 | id `fcaea432…` | + +## Рестарт: `scripts/restart.sh` + +Код выхода 0 за 3,6 с; `/health/ready` — 200 через 1,0 с после hook. + +| Контейнер | `StartedAt` до | `StartedAt` после | Перезапущен | +|---|---|---|---| +| `mtusi-lab2-api-1` | 2026-10-01T13:22:55.681391251Z | 2026-10-01T13:23:34.695966797Z | да | +| `mtusi-lab2-postgres-1` | 2026-10-01T13:22:52.995875167Z | 2026-10-01T13:23:31.833930962Z | да | + +## После рестарта + +| Запрос | Статус | Результат | Проверка | +|---|---|---|---| +| `GET /users/me` (alice) | 200 | id `37e0fe8e…` | тот же id: да | +| `GET /chats/{id}` (bob) | 200 | id `649e0f51…` | порядок `member_ids` тот же (`[bob, alice]`): да | +| `GET …/messages` (bob) | 200 | items: 3 | те же сообщения в том же порядке: да | + +## Вывод + +Оба контейнера перезапущены (новый `StartedAt`), volume `postgres_data` +не трогался. Прежний `X-User-Id` видит свои данные, порядок +`member_ids` и истории сохранился. diff --git a/evidence/tests/test-isolated-mechanics.md b/evidence/tests/test-isolated-mechanics.md new file mode 100644 index 00000000..43e07ee6 --- /dev/null +++ b/evidence/tests/test-isolated-mechanics.md @@ -0,0 +1,166 @@ +# `make test_isolated`: механика временной базы и тестового контейнера + +| | | +|---|---| +| Спек | `student-tests` «Прогон на временной базе»: сценарии «Упавшие тесты», «Прерывание», «Хвост прошлого прогона», «Сохранить базу для разбора» | +| Change | `postgres-storage`, задача 7.6 | +| Дата | 2026-10-01 13:25–13:27 UTC | +| Commit | `2d0a7c8` | +| Стенд | `make run_docker` (рабочий API на `127.0.0.1:8080`, данные в базе `messenger`); тестовый контейнер `mtusi-lab2-test-api` на `127.0.0.1:18088`, база `test_messenger` в том же Postgres | +| Хост | Docker Desktop 29.8.1, macOS arm64; ВМ Docker: 12 CPU, 7 GiB RAM; лимиты контейнерам не задавались | +| Как снято | разовый stdlib-скрипт запускал `make test_isolated` в отдельной группе процессов, сигналы — `os.killpg` группе `make`. Состояние — `psql` (`pg_database`, счётчики рабочей базы), `docker ps -a`, `GET /health/ready` рабочего API. В блоках кода — строки `[test_isolated]` и итоги проверок из вывода `make` | + +Сценарий «Успешный прогон» и evidence набора против контейнера — задача +change `session-auth`. До неё smoke лабы 2 падает на регистрации с +`password` (400), а `test_security_scheme_in_openapi` — на схеме +`devUser`, которой нет в контракте lab2 (design `postgres-storage`, +Goals). + +## 1. Обычный прогон (сценарий «Упавшие тесты») + +| Момент | База `test_messenger` | Тестовый контейнер | Рабочая база users/chats/messages | Рабочий API `/health/ready` | +|---|---|---|---|---| +| до | нет | нет | 7/3/6 | 200 | +| после | нет | нет | 7/3/6 | 200 | + +```text +[test_isolated] database=test_messenger container=mtusi-lab2-test-api base_url=http://127.0.0.1:18088 +[test_isolated] build image +[test_isolated] create database test_messenger +[test_isolated] migrations +[test_isolated] start api container +[test_isolated] ready +[test_isolated] make test +FAIL: POST /api/v1/users: expected [201], received 400 +[test_isolated] make student_test +student-tests/test_identification.py::test_security_scheme_in_openapi FAILED [ 61%] +========================= 1 failed, 79 passed in 1.24s ========================= +[test_isolated] last 50 lines of mtusi-lab2-test-api +[test_isolated] cleanup +[test_isolated] results: {'test': 2, 'student_test': 2} +# exit code make: 2 +``` + +## 2. Тестовый контейнер остановлен во время прогона + +| Момент | База `test_messenger` | Тестовый контейнер | Рабочая база users/chats/messages | Рабочий API `/health/ready` | +|---|---|---|---|---| +| до | нет | нет | 7/3/6 | 200 | +| после | нет | нет | 7/3/6 | 200 | + +```text +[test_isolated] database=test_messenger container=mtusi-lab2-test-api base_url=http://127.0.0.1:18088 +[test_isolated] build image +[test_isolated] create database test_messenger +[test_isolated] migrations +[test_isolated] start api container +[test_isolated] ready +[test_isolated] make test +FAIL: POST /api/v1/users: expected [201], received 400 +[test_isolated] make student_test +$ docker stop mtusi-lab2-test-api # во время make student_test +[test_isolated] last 50 lines of mtusi-lab2-test-api +[test_isolated] cleanup +[test_isolated] results: {'test': 2, 'student_test': 2} +# exit code make: 2 +``` + +## 3. Ctrl+C (сценарий «Прерывание») + +| Момент | База `test_messenger` | Тестовый контейнер | Рабочая база users/chats/messages | Рабочий API `/health/ready` | +|---|---|---|---|---| +| до | нет | нет | 7/3/6 | 200 | +| после | нет | нет | 7/3/6 | 200 | + +```text +[test_isolated] database=test_messenger container=mtusi-lab2-test-api base_url=http://127.0.0.1:18088 +[test_isolated] build image +[test_isolated] create database test_messenger +[test_isolated] migrations +[test_isolated] start api container +[test_isolated] ready +$ Ctrl+C # SIGINT группе процессов make +[test_isolated] make test +[test_isolated] interrupted +[test_isolated] last 50 lines of mtusi-lab2-test-api +[test_isolated] cleanup +[test_isolated] results: {'interrupted': 130} +# exit code make: -2 (make завершён сигналом SIGINT после уборки) +``` + +Строка `make test` стоит после `Ctrl+C`: скрипт читает вывод `make` +по строкам и отправляет сигнал сразу после `ready`. К этому моменту +`make test` уже был запущен и прерван. + +## 4. `kill -9` и следующий прогон (сценарий «Хвост прошлого прогона») + +| Момент | База `test_messenger` | Тестовый контейнер | Рабочая база users/chats/messages | Рабочий API `/health/ready` | +|---|---|---|---|---| +| до | нет | нет | 7/3/6 | 200 | +| после `kill -9` | есть | Up 2 seconds (healthy) | 7/3/6 | 200 | +| после следующего прогона | нет | нет | 7/3/6 | 200 | + +```text +[test_isolated] database=test_messenger container=mtusi-lab2-test-api base_url=http://127.0.0.1:18088 +[test_isolated] build image +[test_isolated] create database test_messenger +[test_isolated] migrations +[test_isolated] start api container +[test_isolated] ready +$ kill -9 # SIGKILL группе процессов make, уборка не успевает +# состояние «после kill -9» — в таблице +$ make test_isolated # следующий прогон +[test_isolated] database=test_messenger container=mtusi-lab2-test-api base_url=http://127.0.0.1:18088 +[test_isolated] build image +[test_isolated] create database test_messenger +[test_isolated] migrations +[test_isolated] start api container +[test_isolated] ready +[test_isolated] make test +FAIL: POST /api/v1/users: expected [201], received 400 +[test_isolated] make student_test +========================= 1 failed, 79 passed in 1.38s ========================= +[test_isolated] last 50 lines of mtusi-lab2-test-api +[test_isolated] cleanup +[test_isolated] results: {'test': 2, 'student_test': 2} +# exit code make: 2 +``` + +Хвост убран в начале следующего прогона. Без этого `CREATE DATABASE` +(без `IF NOT EXISTS`) упал бы на оставшейся базе, а `docker compose +run --name` — на оставшемся контейнере. Оба шага прошли. + +## 5. `KEEP_TEST_DB=1` (сценарий «Сохранить базу для разбора») + +| Момент | База `test_messenger` | Тестовый контейнер | Рабочая база users/chats/messages | Рабочий API `/health/ready` | +|---|---|---|---|---| +| до | нет | нет | 7/3/6 | 200 | +| после прогона с `KEEP_TEST_DB=1` | есть | нет | 7/3/6 | 200 | +| после `DROP DATABASE` руками | нет | нет | 7/3/6 | 200 | + +```text +[test_isolated] database=test_messenger container=mtusi-lab2-test-api base_url=http://127.0.0.1:18088 +[test_isolated] build image +[test_isolated] create database test_messenger +[test_isolated] migrations +[test_isolated] start api container +[test_isolated] ready +[test_isolated] make test +FAIL: POST /api/v1/users: expected [201], received 400 +[test_isolated] make student_test +========================= 1 failed, 79 passed in 1.30s ========================= +[test_isolated] last 50 lines of mtusi-lab2-test-api +[test_isolated] cleanup +[test_isolated] kept database test_messenger +[test_isolated] results: {'test': 2, 'student_test': 2} +# exit code make: 2 +$ DROP DATABASE "test_messenger" # руками после разбора +``` + +## Вывод + +- Временная база и тестовый контейнер убираются при любом исходе: + упавшие тесты, остановленный контейнер, Ctrl+C. +- После `kill -9` хвост убирает следующий прогон. +- С `KEEP_TEST_DB=1` база остаётся для разбора. +- Рабочая база (7/3/6) и рабочий API ни в одном сценарии не затронуты.