# HAProxy — балансировщик и единственная точка входа стенда lab5. # Клиент -> 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 30s # дольше самого долгого ответа API: загрузка файла (очередь проверки до 10 с + S3 до 6 с) 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 и S3 доступны, нет 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