Files
mtusi2026lab3/evidence/tests/stand-lab3.md
T
ricoromaandClaude Opus 5.5 c5840bfaa8 docs: add idempotency and X-Instance-Id evidence to the report
- evidence for replay, conflict, replay through a new API process and
  after restarting API and storages, keys table, key race,
  X-Instance-Id in responses and logs, explicit and invalid
  instance_id and key TTL, test runs
- stand evidence: make wipe_data leaves the lab 2 volume intact, build
  from a fresh git clone passes smoke, bench restore stage sends with
  Idempotency-Key
- REPORT.md: X-Instance-Id, idempotency design, IDEMPOTENCY_TTL_SECONDS
  mapping, limitations and evidence rows
- tasks.md: mark the change tasks done, add follow-ups from verify

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-10 17:08:47 +03:00

111 lines
5.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Стенд лабы 3 — свой проект compose
| | |
|---|---|
| Спеки | `container-run` «Свой проект compose у лабы» — «Данные прошлой лабы не затронуты» |
| Change | `instance-id-idempotency`, задачи 1.1–1.2 и 9.1, `make wipe_data` — доработка по `/opsx:verify` |
| Дата | 2026-10-08 13:50 UTC (первый запуск), 16:47 UTC (проверка); 2026-10-10 13:58–14:04 UTC (`make run_docker`, `make wipe_data`, снова `make run_docker`) |
| Commit | `af4bca0` |
| Хост | Docker Desktop 29.8.1, macOS arm64; ВМ Docker: 12 CPU, 7,7 GiB RAM |
Код перенесён из репозитория лабы 2, где проект compose назывался
`mtusi-lab2`. Имя проекта задаёт имена volumes: с прежним именем стенд
лабы 3 подключился бы к базе второй лабы, миграции лабы 3 легли бы в
неё, а `make wipe_data` её удалил бы. Первой задачей change имя
сменено, и только после этого стенд запускался.
## До первого запуска (13:50 UTC)
```text
$ docker ps # пусто: стенд лабы 2 не запущен
$ docker volume ls | grep mtusi
mtusi-lab2_postgres_data
$ docker volume inspect mtusi-lab2_postgres_data --format '{{.CreatedAt}}'
2026-10-01T13:22:52Z
```
`make env_setup` создал новые `.env` и `config.toml` (свои случайные
пароли), `make run_docker` поднял стенд.
## Проверка (16:47 UTC)
```text
$ docker compose config --format json | python3 -c 'import json,sys; print(json.load(sys.stdin)["name"])'
mtusi-lab3
$ docker compose ps -a --format '{{.Name}}'
mtusi-lab3-api-1
mtusi-lab3-migrate-1
mtusi-lab3-postgres-1
mtusi-lab3-valkey-1
$ docker volume inspect mtusi-lab2_postgres_data mtusi-lab3_postgres_data \
--format '{{.Name}} CreatedAt={{.CreatedAt}} project={{index .Labels "com.docker.compose.project"}}'
mtusi-lab2_postgres_data CreatedAt=2026-10-01T13:22:52Z project=mtusi-lab2
mtusi-lab3_postgres_data CreatedAt=2026-10-08T13:50:04Z project=mtusi-lab3
```
Образ стенда — `mtusi-messenger:lab3`; тег `:lab2` второй лабы не
перезаписывался. Volume второй лабы не тронут: прежняя дата создания и
метка проекта `mtusi-lab2`. Стенды отказов и `make test_isolated`
работают под `mtusi-lab3-failures` и с базой `test_messenger` в
`mtusi-lab3` (`failure-checks.md`, `test-isolated.md`).
## `make run_docker`, затем `make wipe_data` (2026-10-10)
Шаг с удалением выполнен с согласия пользователя: в базе лабы 3 только
синтетические данные тестов и evidence.
```text
$ date -u
2026-10-10 13:58:06 UTC
$ docker volume inspect mtusi-lab2_postgres_data mtusi-lab3_postgres_data --format '...'
mtusi-lab2_postgres_data CreatedAt=2026-10-01T13:22:52Z project=mtusi-lab2
mtusi-lab3_postgres_data CreatedAt=2026-10-08T13:50:04Z project=mtusi-lab3
$ make run_docker && make test
PASS: lab3 public API scenario; infrastructure and grading evidence remain separate.
$ date -u
2026-10-10 14:03:16 UTC
$ echo yes | make wipe_data
Container mtusi-lab3-api-1 Removed
Container mtusi-lab3-migrate-1 Removed
Container mtusi-lab3-valkey-1 Removed
Container mtusi-lab3-postgres-1 Removed
Network mtusi-lab3_default Removed
Volume mtusi-lab3_postgres_data Removed
exit=0
$ docker volume ls --format '{{.Name}}' | grep '^mtusi-lab'
mtusi-lab2_postgres_data
$ docker volume inspect mtusi-lab2_postgres_data --format '...'
mtusi-lab2_postgres_data CreatedAt=2026-10-01T13:22:52Z project=mtusi-lab2
$ docker volume inspect mtusi-lab3_postgres_data
Error response from daemon: get mtusi-lab3_postgres_data: no such volume
$ docker ps -a --filter label=com.docker.compose.project=mtusi-lab2 --format '{{.Names}}\t{{.Status}}'
mtusi-lab2-api-1 Exited (0) 7 days ago
mtusi-lab2-migrate-1 Exited (0) 7 days ago
mtusi-lab2-valkey-1 Exited (0) 7 days ago
mtusi-lab2-postgres-1 Exited (0) 7 days ago
```
`wipe_data` (`docker compose down -v --remove-orphans` без `-p`, то
есть в проекте из `name:`) удалил только контейнеры, сеть и volume
`mtusi-lab3`. Volume и контейнеры второй лабы остались, дата создания
volume прежняя.
Стенд поднят заново, миграции — с нуля:
```text
$ make run_docker
Volume mtusi-lab3_postgres_data Created
Container mtusi-lab3-migrate-1 Exited
Container mtusi-lab3-api-1 Started
$ docker volume inspect mtusi-lab2_postgres_data mtusi-lab3_postgres_data --format '...'
mtusi-lab2_postgres_data CreatedAt=2026-10-01T13:22:52Z project=mtusi-lab2
mtusi-lab3_postgres_data CreatedAt=2026-10-10T14:03:26Z project=mtusi-lab3
$ docker compose logs migrate --no-log-prefix # события alembic
Running upgrade -> 16c279725564, added messenger tables
Running upgrade 16c279725564 -> 42bc3b9be38f, added sessions and password hashes
Running upgrade 42bc3b9be38f -> 7652184b7016, added idempotency keys
$ make test
PASS: lab3 public API scenario; infrastructure and grading evidence remain separate.
```