# 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