Files
mtusi2026lab3/infra/haproxy/haproxy.cfg
T
RainakandClaude Opus 5.5 95556845e6 ЛР3 БВТ2304 Запорожец на 4
HAProxy + 2 API-реплики, общие PostgreSQL/Valkey, обязательный Idempotency-Key,
graceful drain по SIGTERM, stop-one/restart/rolling-update, серии отказов и REPORT.md.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-05 17:36:07 +03:00

90 lines
5.4 KiB
INI
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# HAProxy — единственная публичная точка входа lab3.
# Реплики API обнаруживаются через DNS Docker (имя сервиса "api" -> все IP его контейнеров),
# поэтому масштабирование `--scale api=N` (N <= 8) не требует правки конфигурации.
# Sticky session нет намеренно: любая реплика обслуживает любой запрос, состояние — в PostgreSQL/Valkey.
global
log stdout format raw local0 info
maxconn 4096
hard-stop-after 30s
# Встроенный DNS Docker. Интервал повторного разрешения 1 с: остановленный контейнер исчезает
# из ответа DNS, и его слот server-template уходит в MAINT ("No IP for server") за 1–2 с.
resolvers docker
nameserver dns 127.0.0.11:53
accepted_payload_size 8192
resolve_retries 2
timeout resolve 1s
timeout retry 500ms
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 dontlognull
timeout connect 1s # до живой реплики в той же сети — миллисекунды; 1 с = признак отказа
timeout client 30s
timeout server 15s # дольше statement_timeout БД (5 с) и Argon2id под нагрузкой
timeout http-request 10s
timeout http-keep-alive 10s # меньше keep-alive uvicorn (30 с): idle-соединение закрывает HAProxy первым
timeout queue 5s
timeout check 1s
# Повтор на ДРУГОЙ реплике (redispatch) при неудачном соединении; L7-повторы ограничены ниже.
retries 2
option redispatch 1
# Ответы, созданные самим LB, — в формате ошибок контракта (без X-Instance-Id: их создал не API).
http-error status 502 content-type application/json lf-string "{\"error\":{\"code\":\"unavailable\",\"message\":\"Bad gateway\",\"request_id\":\"%[req.hdr(x-request-id)]\"}}" hdr X-Request-Id "%[req.hdr(x-request-id)]"
http-error status 503 content-type application/json lf-string "{\"error\":{\"code\":\"unavailable\",\"message\":\"No API replica available\",\"request_id\":\"%[req.hdr(x-request-id)]\"}}" hdr X-Request-Id "%[req.hdr(x-request-id)]"
http-error status 504 content-type application/json lf-string "{\"error\":{\"code\":\"unavailable\",\"message\":\"Gateway timeout\",\"request_id\":\"%[req.hdr(x-request-id)]\"}}" hdr X-Request-Id "%[req.hdr(x-request-id)]"
frontend public
bind :8080
# Сквозной request id: API принимает корректный входящий X-Request-Id, LB подставляет свой, если его нет.
unique-id-format %[uuid()]
http-request set-header X-Request-Id %[unique-id] unless { req.hdr(x-request-id) -m reg ^[A-Za-z0-9._:-]{1,128}$ }
# Если /health/ready не проходит НИ У ОДНОЙ реплики (например, недоступна БД), не отвечаем
# безликим 503 от LB, а отдаём запрос живым процессам: они вернут честный 503 контракта,
# а /health/live продолжит работать.
use_backend api_live if { nbsrv(api) eq 0 }
default_backend api
backend api
balance roundrobin
option httpchk
http-check send meth GET uri /health/ready
http-check expect status 200
# Активная проверка раз в 1 с, вывод из ротации после 2 неудач подряд, возврат после 2 успехов.
# Пассивно: 2 ошибки соединения подряд на реальном трафике — сразу DOWN, не дожидаясь проверки.
default-server check inter 1s fastinter 500ms downinter 1s fall 2 rise 2 observe layer4 error-limit 2 on-error mark-down
# L7-повтор на другой реплике безопасен только для GET и POST сообщения (защищён Idempotency-Key).
# Для POST /users, /chats, /auth/sessions и DELETE остаются лишь повторы до отправки запроса (conn-failure).
retry-on conn-failure empty-response response-timeout
acl safe_method method GET HEAD
acl is_post method POST
acl messages_path path_reg ^/api/v1/chats/[^/]+/messages$
http-request disable-l7-retry unless safe_method || is_post messages_path
server-template api- 8 api:8080 resolvers docker init-addr none resolve-prefer ipv4
backend api_live
balance roundrobin
option httpchk
http-check send meth GET uri /health/live
http-check expect status 200
default-server check inter 1s fall 2 rise 2
server-template live- 8 api:8080 resolvers docker init-addr none resolve-prefer ipv4
# Наблюдаемость LB: состояние backend-ов и метрики. Публикуется только на 127.0.0.1 хоста.
frontend stats
bind :8404
http-request use-service prometheus-exporter if { path /metrics }
stats enable
stats uri /stats
stats refresh 2s
stats show-legends