forked from mtusi2026/mtusi2026lab3
92 lines
6.3 KiB
INI
92 lines
6.3 KiB
INI
# HAProxy — балансировщик и единственная точка входа стенда lab3.
|
||
# Клиент -> 127.0.0.1:8080 -> HAProxy -> одна из реплик api (порт 8080 внутри сети edge).
|
||
# Данные и сессии общие (PostgreSQL, Valkey), поэтому любой запрос может обслужить любая
|
||
# реплика: балансировка round robin, без привязки клиента к реплике (без sticky session).
|
||
|
||
global
|
||
log stdout format raw local0 info
|
||
maxconn 2000
|
||
# При остановке контейнера (SIGUSR1, мягкая остановка) доделать начатые запросы, но не дольше 10 с.
|
||
hard-stop-after 10s
|
||
|
||
# Список реплик берётся из DNS Docker: имя сервиса "api" -> IP всех ЗАПУЩЕННЫХ реплик.
|
||
# Остановили реплику или добавили новую — HAProxy увидит это сам, без перезапуска.
|
||
resolvers docker
|
||
nameserver dns 127.0.0.11:53
|
||
resolve_retries 3
|
||
timeout resolve 1s
|
||
timeout retry 1s
|
||
hold valid 2s # перечитывать список реплик раз в 2 с
|
||
hold obsolete 2s # IP, пропавший из DNS (контейнер остановлен), убрать через 2 с
|
||
hold nx 2s
|
||
hold other 2s
|
||
hold refused 2s
|
||
hold timeout 2s
|
||
accepted_payload_size 8192
|
||
|
||
defaults
|
||
mode http
|
||
log global
|
||
option httplog
|
||
option dontlog-normal # в лог только ошибки и смены состояния реплик, а не каждый запрос
|
||
timeout connect 1s # сеть внутри Docker быстрая: мёртвый адрес не держит запрос дольше 1 с
|
||
timeout client 30s
|
||
timeout server 15s # дольше самого долгого ответа API (8 с: пул 3 с + statement_timeout 5 с)
|
||
timeout http-request 10s
|
||
timeout http-keep-alive 5s
|
||
timeout queue 5s
|
||
timeout check 1s
|
||
# Ошибка СОЕДИНЕНИЯ (запрос ещё не отправлен) — повторить, причём на другой реплике.
|
||
# Это безопасно для любого метода. Запрос, который уже ушёл в API, HAProxy сам НЕ повторяет:
|
||
# POST сообщения повторяет клиент с тем же Idempotency-Key.
|
||
retries 2
|
||
option redispatch 1
|
||
# Ошибки, которые создаёт сам балансировщик (нет ни одной готовой реплики — 503, реплика оборвала
|
||
# соединение — 502, не ответила вовремя — 504), отдаются в формате ошибки из контракта
|
||
# с X-Request-Id. X-Instance-Id у них нет: ни одна реплика API этот ответ не создавала.
|
||
unique-id-format %[uuid]
|
||
http-error status 503 content-type application/json lf-string '{"error":{"code":"unavailable","message":"Нет готовой реплики API, повторите запрос позже","request_id":"%[unique-id]"}}' hdr X-Request-Id "%[unique-id]"
|
||
http-error status 502 content-type application/json lf-string '{"error":{"code":"unavailable","message":"Реплика API оборвала соединение, повторите запрос","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 не ответила вовремя, повторите запрос","request_id":"%[unique-id]"}}' hdr X-Request-Id "%[unique-id]"
|
||
|
||
frontend api_in
|
||
bind :8080
|
||
default_backend api
|
||
|
||
backend api
|
||
balance roundrobin
|
||
# Проверка готовности: /health/ready = процесс отвечает, PostgreSQL доступна, нет SIGTERM.
|
||
option httpchk
|
||
http-check send meth GET uri /health/ready ver HTTP/1.1 hdr Host lb
|
||
http-check expect status 200
|
||
# До 6 реплик (обычно 2, во время rolling update 3); пустые слоты стоят в MAINT.
|
||
# Проверка раз в 1 с, при смене состояния раз в 0,5 с; 2 неудачи подряд -> DOWN, 2 удачи -> UP.
|
||
# observe layer4: первая же ошибка соединения у живого запроса сразу выводит реплику из балансировки.
|
||
# Запросы получают ТОЛЬКО реплики, прошедшие проверку готовности. Резервных слотов без проверки нет:
|
||
# если не готова ни одна реплика (например, недоступна PostgreSQL), балансировщик сам отвечает 503
|
||
# и никуда запрос не передаёт, даже если реплика могла бы ответить из кэша.
|
||
server-template api 6 api:8080 check inter 1s fastinter 500ms downinter 2s fall 2 rise 2 observe layer4 error-limit 1 on-error mark-down resolvers docker resolve-prefer ipv4 init-addr none
|
||
|
||
# Второй вход только для проверки истечения сессии (make expiry): API с SESSION_TTL_SECONDS=2
|
||
# (сервис api-short-ttl, профиль ttl). Он тоже доступен только через балансировщик.
|
||
frontend ttl_in
|
||
bind :8081
|
||
default_backend api_short_ttl
|
||
|
||
backend api_short_ttl
|
||
option httpchk
|
||
http-check send meth GET uri /health/ready ver HTTP/1.1 hdr Host lb
|
||
http-check expect status 200
|
||
server-template ttl 2 api-short-ttl:8080 check inter 1s fall 2 rise 2 resolvers docker resolve-prefer ipv4 init-addr none
|
||
|
||
# Статистика HAProxy: http://127.0.0.1:8404/stats (только на 127.0.0.1 хоста, только чтение).
|
||
# Там видно, какие реплики UP/DOWN. /lb-health — healthcheck контейнера lb:
|
||
# 503, пока в backend api нет ни одной готовой реплики.
|
||
frontend stats
|
||
bind :8404
|
||
monitor-uri /lb-health
|
||
monitor fail if { nbsrv(api) lt 1 }
|
||
stats enable
|
||
stats uri /stats
|
||
stats refresh 2s
|