Files
mtusi2026lab3/evidence/idempotency/instance-id.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

3.8 KiB
Raw Blame History

X-Instance-Id и instance_id в журнале

Спеки service-configuration «Hostname по умолчанию»; service-logging «Поиск по реплике», «Повтор с ключом»; api-conventions «Одно значение на процесс»
Change instance-id-idempotency, задача 9.1
Дата 2026-10-08 16:44:53–16:44:59 UTC
Commit af4bca0
Стенд make run_docker: проект mtusi-lab3, один контейнер api (образ из af4bca0), 127.0.0.1:8080, без балансировщика; instance_id в .env, config.toml и compose не задан
Хост Docker Desktop 29.8.1, macOS arm64; ВМ Docker: 12 CPU, 7,7 GiB RAM; лимиты контейнерам не задавались

Значение — hostname контейнера

$ docker compose ps -q api | cut -c1-12
7956d7741a15
$ curl -sD - -o /dev/null http://localhost:8080/health/live | grep -i x-instance
x-instance-id: 7956d7741a15

docker compose restart api — тот же контейнер, новый процесс:

Контейнер StartedAt X-Instance-Id
до 7956d7741a15 2026-10-08T16:44:10.628095468Z 7956d7741a15
после restart 7956d7741a15 2026-10-08T16:44:54.716801044Z 7956d7741a15

Hostname у перезапущенного контейнера прежний, поэтому и значение прежнее. Новый контейнер — новое значение (replay-after-restart.md: 9b306176dcf4). stop-one.sh (change replicas-lb) по этому значению найдёт контейнер без таблицы соответствия.

Журнал: instance_id в каждой записи

docker compose logs api --no-log-prefix после отправок из replay.md и docker compose restart api: 85 JSON-записей, без instance_id — 0, значений instance_id — одно: 7956d7741a15. Первые записи каждого вида (поля сокращены):

{"event": "Started API", "instance_id": "7956d7741a15"}
{"event": "HTTP request completed", "instance_id": "7956d7741a15", "request_id": "1f65121ccd6d42679bd6c33a6582e44e", "method": "POST", "path": "/api/v1/users", "status": 201}
{"event": "Created message", "instance_id": "7956d7741a15", "request_id": "1060e6ab3e614eb08e9865e169ac9574", "message_id": "e046a2b6-bae7-4a69-8a74-f5cfa3ec7b04", "replayed": false, "method": "send_message"}
{"event": "Replayed message", "instance_id": "7956d7741a15", "request_id": "813240a323604d5a86f1e39ae5a4d465", "message_id": "e046a2b6-bae7-4a69-8a74-f5cfa3ec7b04", "replayed": true, "method": "send_message"}
{"event": "Shutting down", "instance_id": "7956d7741a15"}
{"event": "Waiting for application shutdown.", "instance_id": "7956d7741a15"}
{"event": "Stopped API", "instance_id": "7956d7741a15"}
{"event": "Finished server process [1]", "instance_id": "7956d7741a15"}

Created message / Replayed message здесь — от публичного smoke (make test) перед сбором: повтор того же сообщения виден по replayed: true и тому же message_id. Строки uvicorn о shutdown тоже несут instance_id: в общем журнале нескольких реплик видно, какая остановилась.

Чего в журнале нет:

отправленные значения Idempotency-Key (replay.md): найдено 0
текст сообщения «Привет из evidence»: найдено 0

Сервис migrate пишет свой instance_id — короткий ID своего контейнера (0b3e5b92d7a6 при первом make run_docker этого change).