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:
@@ -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 с после него | потерь нет |
|
||||
|
||||
## Ограничения и следующие шаги
|
||||
|
||||
|
||||
@@ -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`, число строк и
|
||||
версия схемы не изменились.
|
||||
@@ -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.
|
||||
@@ -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 с на обрыв соединения.
|
||||
- После разморозки сервис отвечает без рестарта.
|
||||
@@ -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`.
|
||||
@@ -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` и истории сохранился.
|
||||
@@ -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 ни в одном сценарии не затронуты.
|
||||
Reference in New Issue
Block a user