- 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>
111 lines
5.3 KiB
Markdown
111 lines
5.3 KiB
Markdown
# Стенд лабы 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.
|
||
```
|