docs: add rolling-update compatibility and script failure evidence

Old image passes smoke and student tests on the new schema, rolling
update, rollback and roll forward under tests/load.py give zero failed
requests; the run_docker known issue is not reproduced and is closed.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-11 01:01:33 +03:00
co-authored by Claude Opus 5.5
parent d2148ac566
commit 5403464cfb
7 changed files with 437 additions and 29 deletions
+5 -5
View File
@@ -29,7 +29,7 @@ Evidence снимается с закоммиченного кода: комми
Проверка: `uv run alembic upgrade head` и `downgrade -1` / `upgrade
head` на временной базе (не рабочей); `alembic check` после `upgrade`
— без расхождений.
- [ ] 1.2 `insert_message(..., instance_id)` в repo и передача
- [x] 1.2 `insert_message(..., instance_id)` в repo и передача
`settings.app.instance_id` из `MessageService.send_message`; DTO и
ответ API не меняются. Проверка: `make lint`; после задачи 5.2 строка
сообщения, записанного через API, содержит `instance_id` =
@@ -41,7 +41,7 @@ Evidence снимается с закоммиченного кода: комми
ipv4@127.0.0.1:9999 level admin` в `global` с комментарием (решение
2). Проверка: `haproxy -c` в закреплённом образе с `API_PORT=8080` —
`Configuration file is valid`.
- [ ] 2.2 `scripts/rolling-update.sh` по решениям 1–6 (исполняемый бит
- [x] 2.2 `scripts/rolling-update.sh` по решениям 1–6 (исполняемый бит
в git). Внутри:
- предусловия;
- сборка из рабочего дерева или `ROLLOUT_COMMIT`;
@@ -81,7 +81,7 @@ Evidence снимается с закоммиченного кода: комми
## 4. Документы
- [ ] 4.1 Правила под решения:
- [x] 4.1 Правила под решения:
- `balancer.md` — порядок «сборка → миграции», дренаж, состояния
слота, сбой, runtime API;
- `migrations.md` — новая ревизия, `lock_timeout`, откат кода без
@@ -117,7 +117,7 @@ Evidence снимается с закоммиченного кода: комми
## 6. Evidence с commit кода
- [ ] 6.1 Совместимость и `make run_docker` на рабочем стенде (решения 6,
- [x] 6.1 Совместимость и `make run_docker` на рабочем стенде (решения 6,
7, 9; `evidence/rollout/compatibility.md`):
- реплики на образе `c50b721` (`git archive`), LB пересоздан с новым
`haproxy.cfg`, ревизия `7652184b7016`, `make test`;
@@ -135,7 +135,7 @@ Evidence снимается с закоммиченного кода: комми
Исход решения 9 — в `KNOWN_ISSUES.md` (и `Makefile`, если дефект
подтвердился). Проверка: в файле на каждом шаге команда, код выхода и
наблюдение.
- [ ] 6.2 Отказы скрипта (`evidence/rollout/script-failures.md`):
- [x] 6.2 Отказы скрипта (`evidence/rollout/script-failures.md`):
- остановленная реплика (`stop-one.sh`) и `API_REPLICAS=3` —
отказ до сборки;
- `ROLLOUT_READY_TIMEOUT=1` — новая удалена, N реплик `UP`;