From 7dd8ca52004be0ae88d3e84c400dbc9de367b49e Mon Sep 17 00:00:00 2001 From: masha Date: Fri, 23 Oct 2026 16:56:09 +0300 Subject: [PATCH] 3 lab --- REPORT.md | 36 +++++++++++++++++++++++++++++++++++- 1 file changed, 35 insertions(+), 1 deletion(-) diff --git a/REPORT.md b/REPORT.md index ecf41a32..e4969f55 100644 --- a/REPORT.md +++ b/REPORT.md @@ -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). Упал — вторая реплика работает.