- X-Instance-Id в каждом ответе; обязательный Idempotency-Key, таблица idempotency_keys (миграция 0002, одна транзакция, конкурентные повторы через уникальный индекс) - graceful shutdown: SIGTERM -> ready=503 -> drain 3 с -> закрытие порта - compose: lb (HAProxy) + api x2 без портов + разовый migrate + postgres, лимиты CPU/RAM - хуки stop-one/restart/restore-replicas, scripts/experiments.py (failover, idempotency, rolling) - свои тесты: 44 (13 новых); evidence: smoke, pytest, persistence, failover, эксперименты
67 lines
3.5 KiB
INI
67 lines
3.5 KiB
INI
# Единственная публичная точка входа. Реплики API находятся по DNS-имени сервиса `api`
|
||
# (Docker DNS отдаёт IP всех реплик) и перечитываются каждые ~2 с, поэтому новые/пересозданные
|
||
# контейнеры подхватываются без перезапуска LB.
|
||
#
|
||
# Обнаружение отказа: проверка GET /health/ready каждую 1 с (inter), 2 неудачи подряд (fall),
|
||
# после первой неудачи период 0.5 с (fastinter) => реплика исключается за ~1.5 с, в худшем случае
|
||
# за inter + fastinter + timeout check = 1 + 0.5 + 0.5 ≈ 2 с (оценка сверху fall*inter + timeout = 2.5 с).
|
||
# Возврат в ротацию после 2 успешных проверок (rise), т.е. ~2 с после готовности реплики.
|
||
# Пока реплика не исключена, соединение к ней обрывается/отказывает и запрос сразу
|
||
# повторяется на другой реплике (retries + redispatch), поэтому клиент видит единицы ошибок.
|
||
|
||
global
|
||
log stdout format raw local0
|
||
maxconn 2000
|
||
|
||
defaults
|
||
mode http
|
||
log global
|
||
option httplog
|
||
option dontlognull
|
||
timeout connect 1s
|
||
# Больше statement_timeout БД (5 с): API успевает ответить 503 сам, а не получить обрыв от LB.
|
||
timeout server 10s
|
||
timeout client 15s
|
||
timeout http-request 10s
|
||
timeout http-keep-alive 5s
|
||
timeout queue 5s
|
||
timeout check 500ms
|
||
retries 3
|
||
# Повторять на другой реплике при каждой попытке (а не только на последней).
|
||
option redispatch 1
|
||
retry-on conn-failure empty-response response-timeout 502 503 504
|
||
|
||
resolvers docker
|
||
nameserver dns 127.0.0.11:53
|
||
accepted_payload_size 8192
|
||
resolve_retries 3
|
||
timeout resolve 1s
|
||
timeout retry 1s
|
||
hold valid 2s
|
||
hold nx 2s
|
||
hold other 2s
|
||
hold refused 2s
|
||
hold timeout 2s
|
||
hold obsolete 2s
|
||
|
||
frontend public
|
||
bind :8080
|
||
default_backend api
|
||
|
||
backend api
|
||
balance roundrobin
|
||
# Никакой привязки клиента к реплике (sticky): состояние общее, сессии лежат в PostgreSQL.
|
||
|
||
# Повтор на уровне HTTP безопасен только для GET и для POST сообщения (защищён Idempotency-Key).
|
||
# Остальные POST (регистрация, вход, создание чата) повторять нельзя: сервер мог уже выполнить запрос.
|
||
acl is_message_post path_reg ^/api/v1/chats/[^/]+/messages$
|
||
http-request disable-l7-retry if METH_POST !is_message_post
|
||
|
||
option httpchk
|
||
http-check send meth GET uri /health/ready ver HTTP/1.1 hdr Host api
|
||
http-check expect status 200
|
||
# Без `on-marked-down shutdown-sessions`: при выводе реплики из ротации начатые запросы не обрываются,
|
||
# реплика (drain) их дообслуживает. С этой опцией эксперимент давал 6–8 RemoteDisconnected на каждую остановку.
|
||
default-server check inter 1s fastinter 500ms downinter 1s fall 2 rise 2 resolvers docker resolve-prefer ipv4 init-addr none
|
||
server-template api 6 api:8080
|