docs: add postgres-storage evidence

- migrations from zero, schema and rerun on 2d0a7c8
- restart hook, database outage, pool timeout, postgres port
- make test_isolated mechanics: failure, stop, Ctrl+C, kill -9, keep db
- align REPORT.md numbers with the new evidence

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-01 16:27:58 +03:00
co-authored by Claude Opus 5.5
parent 2d0a7c83e9
commit 8a5d2b8c8a
7 changed files with 537 additions and 3 deletions
+3 -3
View File
@@ -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 с после него | потерь нет |
## Ограничения и следующие шаги
+123
View File
@@ -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`, число строк и
версия схемы не изменились.
+73
View File
@@ -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.
+48
View File
@@ -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 с на обрыв соединения.
- После разморозки сервис отвечает без рестарта.
+78
View File
@@ -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`.
+46
View File
@@ -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` и истории сохранился.
+166
View File
@@ -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 ни в одном сценарии не затронуты.