HAProxy 3.4 is the only published entry point; api runs as API_REPLICAS replicas without ports, found through Docker DNS and checked on /health/ready. Retries only on connection failure, LB errors in the contract error format, resource limits and per-service secrets. Adds scripts/stop-one.sh, LB-aware restart.sh, make replicas / instances / lb_stats and replica tests driven by EXPECT_REPLICAS. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
96 lines
5.5 KiB
INI
96 lines
5.5 KiB
INI
# Балансировщик стенда лабы 3: единственная точка входа перед репликами
|
||
# сервиса api. Правила — .claude/rules/balancer.md, решения — design
|
||
# change replicas-lb (решения 1–5). Порт приходит переменной окружения
|
||
# API_PORT (= APP__PORT из .env); секретов LB не получает.
|
||
|
||
global
|
||
# журнал — в stdout контейнера (docker compose logs haproxy)
|
||
log stdout format raw local0 info
|
||
maxconn 4096
|
||
# один поток на лимит 1 CPU: иначе HAProxy создал бы поток на каждый
|
||
# CPU ВМ и делил между ними одну квоту
|
||
nbthread 1
|
||
|
||
# DNS Docker: имя сервиса api отвечает адресами всех работающих реплик.
|
||
# Пропавший адрес уходит из слота, новый появляется за 1–2 с без
|
||
# перезагрузки LB
|
||
resolvers docker
|
||
nameserver dns 127.0.0.11:53
|
||
accepted_payload_size 8192
|
||
resolve_retries 3
|
||
timeout resolve 1s
|
||
timeout retry 1s
|
||
hold valid 1s
|
||
hold obsolete 1s
|
||
hold nx 1s
|
||
hold other 1s
|
||
hold refused 1s
|
||
hold timeout 1s
|
||
|
||
defaults
|
||
mode http
|
||
log global
|
||
option httplog
|
||
# обычные успешные запросы не пишутся; ошибки, таймауты, повторы,
|
||
# перенаправления и смена состояния реплик — пишутся
|
||
option dontlog-normal
|
||
# timeout connect × (retries + 1) = 0,5 × 3 = 1,5 с < 2 с таймаута
|
||
# клиента tests/resilience.py: перенаправление успевает раньше
|
||
timeout connect 500ms
|
||
retries 2
|
||
# каждый повтор — на другую реплику, а не на ту же
|
||
option redispatch 1
|
||
# повтор только если соединение не установлено: запрос до реплики не
|
||
# дошёл, повтор безопасен для любого метода. Ответ, который реплика
|
||
# уже начала, не повторяется: POST /users и POST /chats не
|
||
# идемпотентны, отправку сообщения повторяет клиент с тем же ключом
|
||
retry-on conn-failure
|
||
# больше [database] request_timeout_seconds (6 с) и KDF входа
|
||
timeout server 10s
|
||
timeout client 30s
|
||
timeout http-request 10s
|
||
timeout http-keep-alive 10s
|
||
# больше таймаута проверки внутри /health/ready (2 с); обнаружение
|
||
# отказа ≈ inter × fall + timeout check = 1 × 2 + 3 = 5 с ≤ 10 с
|
||
timeout check 3s
|
||
# request_id ответов, которые создаёт сам LB
|
||
unique-id-format lb-%{+X}o%ci%cp%Ts%rt%pid
|
||
# ответы самого LB — в формате ошибки контракта; в перечислении кодов
|
||
# контракта нет отдельных кодов для 502 и 504, ближайший — unavailable.
|
||
# X-Instance-Id у них нет: контракт это допускает
|
||
http-error status 502 content-type application/json lf-string '{"error":{"code":"unavailable","message":"API replica closed the connection","request_id":"%[unique-id]"}}' hdr X-Request-Id "%[unique-id]"
|
||
http-error status 503 content-type application/json lf-string '{"error":{"code":"unavailable","message":"No API replica is available","request_id":"%[unique-id]"}}' hdr X-Request-Id "%[unique-id]"
|
||
http-error status 504 content-type application/json lf-string '{"error":{"code":"unavailable","message":"API replica did not respond in time","request_id":"%[unique-id]"}}' hdr X-Request-Id "%[unique-id]"
|
||
|
||
# точка входа клиентов: на хосте — 127.0.0.1:APP_OUT_PORT (compose)
|
||
frontend entry
|
||
bind "*:${API_PORT}"
|
||
default_backend api
|
||
|
||
backend api
|
||
# по очереди, без cookie и stick-table: sticky session запрещён
|
||
balance roundrobin
|
||
# активная проверка готовности: /health/live для LB не годится,
|
||
# живой процесс без PostgreSQL запросы не обслуживает
|
||
option httpchk
|
||
http-check send meth GET uri /health/ready
|
||
http-check expect status 200
|
||
# реплика исключается после 2 неудачных проверок подряд и
|
||
# возвращается после 2 успешных; проверка раз в секунду
|
||
default-server check inter 1s fall 2 rise 2 resolvers docker init-addr none resolve-prefer ipv4
|
||
# 8 слотов — максимум реплик в сериях трека 1; лишние слоты в MAINT,
|
||
# девятую реплику LB не увидит
|
||
server-template api- 8 "api:${API_PORT}"
|
||
|
||
# мониторинг внутри сети compose, наружу не публикуется:
|
||
# /lb/ready — healthcheck контейнера LB (200, пока есть готовая реплика),
|
||
# /stats и /stats;csv — состояние и счётчики каждой реплики (make lb_stats)
|
||
frontend monitor
|
||
bind :8404
|
||
monitor-uri /lb/ready
|
||
monitor fail if { nbsrv(api) lt 1 }
|
||
stats enable
|
||
stats uri /stats
|
||
# адрес реплики в статистике (поле addr): только внутри сети
|
||
stats show-legends
|