forked from mtusi2026/mtusi2026lab3
88 lines
5.4 KiB
INI
88 lines
5.4 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
|
||
|
||
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: первая же ошибка соединения у живого запроса сразу выводит реплику из балансировки.
|
||
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
|
||
# Аварийный режим: если НИ ОДНА реплика не готова (например, недоступна PostgreSQL), запросы всё
|
||
# равно идут в API. Клиент получает ответ самого API (503 в формате контракта, с X-Request-Id
|
||
# и X-Instance-Id), а /health/live отвечает 200. Пока готова хоть одна реплика, слоты не используются.
|
||
# allow-dup-ip: те же адреса, что у основных слотов (по умолчанию HAProxy запрещает повтор адреса).
|
||
server-template fallback 6 api:8080 backup resolvers docker resolve-prefer ipv4 resolve-opts allow-dup-ip init-addr none
|
||
option allbackups
|
||
|
||
# Второй вход только для проверки истечения сессии (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
|