Files
mtusi2026lab3-fork/infra/haproxy/haproxy.cfg

97 lines
5.5 KiB
INI
Raw Permalink 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 2.8 LTS — единственная публичная точка входа lab3.
#
# Обнаружение реплик: Docker DNS (127.0.0.11) отдаёт по имени сервиса `api`
# A-записи ВСЕХ запущенных контейнеров сервиса. server-template держит до 6 слотов
# и каждые 2 с синхронизирует их с DNS: новый контейнер (scale / rolling update)
# появляется сам, остановленный исчезает. Перезапуск LB при масштабировании не нужен.
#
# Исключение недоступного backend (активные проверки):
# GET /health/ready каждые inter=1s; после первой неудачи — fastinter=500ms;
# fall=2 неудачи подряд -> DOWN; rise=2 удачи -> UP; timeout check 1500ms.
# Время обнаружения:
# * graceful stop (реплика сразу отвечает 503): <= 1 с + 0.5 с ~ 1.5 с
# * crash / kill (соединение отклонено/сброшено): ~1.5 с
# * зависание без ответа: <= 1 + 1.5 + 0.5 + 1.5 = 4.5 с
# Пока реплика ещё не помечена DOWN, запрос к ней, не сумевший СОЕДИНИТЬСЯ
# (timeout connect 1s), повторяется на другой реплике (retries 2 + redispatch).
# Повторяются только ошибки установления соединения (retry-on conn-failure по
# умолчанию): запрос ещё не был отправлен, поэтому это безопасно и для POST.
# Уже отправленные POST LB не повторяет — это делает клиент с тем же
# Idempotency-Key (контракт запрещает прозрачные повторы POST /users, /chats).
#
# Согласование таймаутов:
# API: пул БД 3 с + statement_timeout 5 с = максимум ~8 с на запрос
# -> timeout server 10s; graceful shutdown API 10 с; drain API 3 с > 1.5 с.
# Docker stop_grace_period 20 с > drain 3 с + graceful 10 с.
global
log stdout format raw local0 info
maxconn 2000
resolvers docker
nameserver dns1 127.0.0.11:53
resolve_retries 3
timeout resolve 1s
timeout retry 1s
hold valid 2s
hold obsolete 2s
hold nx 2s
hold other 2s
hold refused 2s
hold timeout 2s
# 8 КБ: в ответ DNS помещаются A-записи всех слотов.
accepted_payload_size 8192
defaults
mode http
log global
option httplog
option dontlognull
option redispatch 1
retries 2
timeout connect 1s
timeout client 30s
timeout server 10s
timeout http-request 10s
timeout http-keep-alive 10s
timeout queue 3s
timeout check 1500ms
default-server inter 1s fastinter 500ms downinter 2s fall 2 rise 2
frontend public
bind :8080
# Сквозной идентификатор запроса: HAProxy генерирует X-Request-Id, если клиент
# не прислал свой; API отражает его в ответе и в теле ошибок, LB — в логе.
unique-id-format %{+X}o\ %ci%cp-%fp-%Ts%ms-%rt-%pid
http-request set-header X-Request-Id %[unique-id] unless { req.hdr(X-Request-Id) -m found }
log-format "%ci:%cp [%tr] %ft %b/%s %TR/%Tw/%Tc/%Tr/%Ta %ST %B %tsc %ac/%fc/%bc/%sc/%rc %sq/%bq rid=%[capture.req.hdr(0)] inst=%[capture.res.hdr(0)] \"%HM %HPO\""
http-request capture req.hdr(X-Request-Id) len 64
declare capture response len 32
http-response capture res.hdr(X-Instance-Id) id 0
default_backend api
backend api
balance roundrobin
option httpchk
http-check send meth GET uri /health/ready ver HTTP/1.1 hdr Host lb
http-check expect status 200
# Ответы, которые формирует сам LB (нет ни одной готовой реплики, таймаут),
# — в общем JSON-формате ошибок контракта, с тем же X-Request-Id.
http-error status 503 content-type application/json hdr X-Request-Id "%[req.hdr(X-Request-Id)]" lf-string "{\"error\":{\"code\":\"unavailable\",\"message\":\"No API instance is available\",\"request_id\":\"%[req.hdr(X-Request-Id)]\"}}"
http-error status 504 content-type application/json hdr X-Request-Id "%[req.hdr(X-Request-Id)]" lf-string "{\"error\":{\"code\":\"unavailable\",\"message\":\"API instance timeout\",\"request_id\":\"%[req.hdr(X-Request-Id)]\"}}"
http-error status 502 content-type application/json hdr X-Request-Id "%[req.hdr(X-Request-Id)]" lf-string "{\"error\":{\"code\":\"unavailable\",\"message\":\"Bad gateway\",\"request_id\":\"%[req.hdr(X-Request-Id)]\"}}"
# До 6 реплик (в т.ч. N+1 во время rolling update). init-addr none: LB стартует,
# даже если реплик ещё нет; слоты без адреса находятся в MAINT.
server-template api 1-6 api:8080 check resolvers docker init-addr none resolve-prefer ipv4
# Внутренняя страница состояния (UP/DOWN по репликам) — только чтение.
# Публикуется на 127.0.0.1:8404 хоста; используется scripts/ops.py.
frontend stats
bind :8404
monitor-uri /lb-health
stats enable
stats uri /stats
stats refresh 2s
stats show-legends
http-request set-log-level silent