forked from mtusi2026/mtusi2026lab4
105 lines
6.3 KiB
INI
105 lines
6.3 KiB
INI
# HAProxy 2.8 LTS — единственная публичная точка входа (lab3, дополнено в lab4).
|
||
#
|
||
# Обнаружение реплик: 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 с.
|
||
# lab4: загрузка вложения (POST .../attachments) — до UPLOAD_READ_TIMEOUT_SECONDS
|
||
# 60 с чтения тела + очередь 5 с + S3 PUT (2 попытки по ~12 с) -> для этого
|
||
# пути timeout server 90s (http-request set-timeout), остальные — прежние 10 с.
|
||
# Скачивание идёт потоком, timeout server — это пауза между пакетами, не общая длительность.
|
||
# 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
|
||
# lab4: только загрузка вложения получает длинный timeout server (см. выше).
|
||
acl is_upload method POST
|
||
acl is_upload_path path_reg ^/api/v1/chats/[^/]+/attachments$
|
||
http-request set-timeout server 90s if is_upload is_upload_path
|
||
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
|