forked from mtusi2026/mtusi2026lab3
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>
90 lines
5.4 KiB
INI
90 lines
5.4 KiB
INI
# 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
|