# HAProxy — единственная точка входа: клиент -> lb:8080 -> api (2+ реплики). # Сессии и данные общие (Redis, PostgreSQL), поэтому любой запрос может обслужить # любая реплика: балансировка round robin, без привязки клиента к реплике (no sticky). global log stdout format raw local0 info maxconn 4096 # При остановке контейнера (SIGUSR1, soft stop) дождаться начатых запросов, но не дольше 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 option forwardfor default_backend api backend api balance roundrobin # Проверка готовности: /health/ready = API отвечает и видит PostgreSQL и Redis. option httpchk http-check send meth GET uri /health/ready ver HTTP/1.1 hdr Host lb http-check expect status 200 # До 6 реплик (2 обычно, 3 во время rolling update); пустые слоты стоят в 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 # Аварийный режим (как panic mode у Envoy): если НИ ОДНА реплика не готова (например, упал Redis # или PostgreSQL), запросы всё равно идут в API. Клиент получает ответ самого API — 503 в формате # контракта с X-Request-Id, /health/live — 200, а регистрация, которой Redis не нужен, работает. # Пока готова хоть одна реплика, эти записи не используются. # allow-dup-ip: те же IP, что у основных слотов (по умолчанию HAProxy запрещает повтор адреса в backend). server-template fallback 6 api:8080 backup no-check resolvers docker resolve-prefer ipv4 resolve-opts allow-dup-ip init-addr none option allbackups # Статистика HAProxy: http://127.0.0.1:8404/stats (опубликовано только на 127.0.0.1). # /lb-health — healthcheck контейнера lb: 503, если направить запрос некуда. frontend stats bind :8404 monitor-uri /lb-health monitor fail if { nbsrv(api) lt 1 } stats enable stats uri /stats stats refresh 2s