fix: start DNS-resolved replicas down until checks pass

Without init-state down HAProxy marked a slot UP as soon as Docker DNS
returned the container address, before uvicorn listened, so requests
after LB restart or scale-up hit a replica that was not ready.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-10 18:08:50 +03:00
co-authored by Claude Opus 5.5
parent ab71c3b51e
commit 4e0cc4e965
4 changed files with 23 additions and 4 deletions
+11 -1
View File
@@ -109,13 +109,23 @@ HAProxy и Compose без Swarm подтверждён пользователе
### 2. Реплики через DNS Docker: `server-template api- 8`
```
default-server check inter 1s fall 2 rise 2 resolvers docker init-addr none resolve-prefer ipv4
default-server check inter 1s fall 2 rise 2 resolvers docker init-addr none init-state down resolve-prefer ipv4
server-template api- 8 "api:${API_PORT}"
```
- DNS Docker отвечает на имя сервиса `api` адресами всех работающих
реплик. HAProxy раскладывает их по 8 слотам, лишние слоты в `MAINT`.
`init-addr none` позволяет LB стартовать без реплик.
- **`init-state down`** (добавлено в apply). Без него слот, получивший
адрес из DNS, сразу считается `UP` («UP/READY (resolves again)» в
журнале), до первой проверки. Docker регистрирует адрес контейнера
при старте, раньше, чем uvicorn открыл порт. Поэтому после рестарта
LB, `make replicas` и масштабирования запросы шли на неслушающую
реплику: отказ соединения, повторы, а когда обе реплики ещё не
слушали — 503 от LB (видно на `scripts/restart.sh`). С `init-state
down` слот начинает `DOWN` и получает запросы только после `rise`
успешных проверок `/health/ready`. Новая реплика при `make replicas
API_REPLICAS=3` вошла в распределение через 4 с.
- `resolvers docker`: `timeout resolve 1s`, `hold valid 1s`,
`hold obsolete 1s`, `hold nx 1s`, `accepted_payload_size 8192`.
Пропавший адрес уходит из слота за 1–2 с, новый появляется за то же
+1 -1
View File
@@ -159,7 +159,7 @@ evidence, потом коммит evidence и отчёта (бриф основ
Проверка: `grep -n "(лаба 3)" AGENTS.md` — только
`rolling-update.sh`.
- [ ] 5.2 Общая проверка кода:
- [x] 5.2 Общая проверка кода:
- `make lint`, `make check`;
- `openspec validate replicas-lb --strict`;
- `make test`, `make student_test` через LB;