This commit is contained in:
2026-10-23 16:56:09 +03:00
parent bb600e9dd1
commit 7dd8ca5200
+35 -1
View File
@@ -88,7 +88,41 @@
Ключ хранится в общей базе, поэтому защита работает, даже если повтор пришёл на другую реплику. Если два одинаковых запроса пришли одновременно на разные реплики, второй ждёт в PostgreSQL (на уникальном ключе), пока первый закончит.
Проверено: 16 одновременных запросов с одним ключом — каждый раз ровно 1 сообщение.
### 1.5 Вопросы-ответы
### 1.5 схема архитектуры
```
client ──HTTP:8080──► HAProxy (lb) ──round-robin, проверка /health/ready раз в 1 s──► api-1 ─┐
│ DNS Docker 127.0.0.11: имя "api" → IP всех реплик api-2 ─┤
└─ X-Request-Id, повтор на другую реплику при отказе ... │
▼
сеть backend (internal): PostgreSQL (источник истины)
Valkey (кэш сессий)
```
1. `client ──HTTP:8080──► HAProxy` — клиент (пользователь, тест, curl) отправляет все запросы на один адрес: порт 8080. Там стоит HAProxy. Это единственная открытая наружу дверь, к репликам напрямую не попасть.
2. `──round-robin──► api-1, api-2` — HAProxy раздаёт запросы репликам по кругу: первый на api-1, второй на api-2, третий снова на api-1.
3. `проверка /health/ready раз в 1 s` — каждую секунду HAProxy спрашивает у каждой реплики «ты готова?». Если реплика 2 раза подряд не ответила «да», HAProxy перестаёт слать ей запросы.
4. `DNS Docker 127.0.0.11: имя "api" → IP всех реплик` — 127.0.0.11 — это адрес встроенного DNS-сервера Docker, он есть внутри каждого контейнера. HAProxy спрашивает у него: «какие адреса у имени `api`?» — и получает IP всех работающих реплик. Поэтому адреса не прописаны вручную, и новая реплика попадает в список сама (список обновляется каждые 2 секунды).
5. `X-Request-Id` — HAProxy даёт каждому запросу уникальный номер и передаёт его в API. Этот номер попадает в лог HAProxy, в лог реплики и в ответ. По нему можно найти один и тот же запрос во всех логах.
6. `повтор на другую реплику при отказе` — если реплика не ответила (упала), HAProxy сам отправляет тот же запрос на другую реплику. Пользователь ошибку не видит. Повторяются только безопасные запросы: GET и отправка сообщения с Idempotency-Key.
7. `...` под api-2 — реплик может быть больше двух. В конфиге заготовлено до 8 мест (`server-template api 8`).
8. `▼ сеть backend (internal)` — все реплики ходят в одну и ту же базу. Сеть `backend` внутренняя: из неё нет выхода наружу, и HAProxy к ней не подключён. До базы можно добраться только через API.
9. `PostgreSQL (источник истины)` — «источник истины» значит, что настоящие данные хранятся только здесь: пользователи, чаты, сообщения, сессии, ключи идемпотентности. Если где-то ещё есть копия, правильной считается та, что в PostgreSQL.
10. `Valkey (кэш сессий)` — Valkey (аналог Redis) хранит быструю копию «токен → пользователь», чтобы не ходить в базу на каждый запрос. Если Valkey пропадёт, ничего не сломается: данные возьмутся из PostgreSQL.
Коротко одной фразой: клиент ходит в один HAProxy, HAProxy по кругу раздаёт запросы живым репликам, а все реплики работают с одной общей базой — поэтому любая реплика может обработать любой запрос.
### 1.6 Вопросы-ответы
Чем отказ процесса отличается от отказа узла?
Процесс — одна программа (у меня один контейнер API). Упал — вторая реплика работает.