From 0bf67b3e841529a65c3bdaf9376a6a4cd0da0ccf Mon Sep 17 00:00:00 2001 From: SAMURAI Date: Fri, 20 Nov 2026 19:55:05 +0300 Subject: [PATCH] =?UTF-8?q?=D0=9B=D0=A0=203=20=E2=80=94=20=D0=91=D0=9F?= =?UTF-8?q?=D0=982302=20=E2=80=94=20=D0=A9=D0=B5=D1=80=D0=B1=D0=B0=D1=86?= =?UTF-8?q?=D0=B5=D0=B2=D0=B8=D1=87=20=E2=80=94=20=D0=BD=D0=B0=205?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- DEFENSE.pdf | Bin 0 -> 169133 bytes REPORT.md | 43 +- evidence/explain_messages.txt | 23 + evidence/level3.json | 16 +- evidence/level4.json | 40 ++ evidence/rolling.json | 20 +- evidence/track1.json | 458 ++++++++++++++----- evidence/track1_fixed_budget.svg | 29 +- evidence/track1_growing_cpu.svg | 25 +- evidence/track1_scale_out.svg | 27 ++ infra/__init__.py | 0 infra/haproxy.cfg | 2 +- scripts/build_defense_pdf.py | 747 +++++++++++++++++++++++++++++++ scripts/render_track1_svg.py | 110 +++++ src/__init__.py | 0 src/app/api/health.py | 6 +- src/app/crud/users.py | 24 +- student-tests/track1.py | 19 +- 18 files changed, 1421 insertions(+), 168 deletions(-) create mode 100644 DEFENSE.pdf create mode 100644 evidence/explain_messages.txt create mode 100644 evidence/level4.json create mode 100644 evidence/track1_scale_out.svg create mode 100644 infra/__init__.py create mode 100644 scripts/build_defense_pdf.py create mode 100644 scripts/render_track1_svg.py create mode 100644 src/__init__.py diff --git a/DEFENSE.pdf b/DEFENSE.pdf new file mode 100644 index 0000000000000000000000000000000000000000..78a95adc534106307ca2ea85af59631e6e5eade2 GIT binary patch literal 169133 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%0AOf~M{#T5rh9p}{aoFo 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
    j%@1KbSx_Oh<2~8=2~+o8s}t)}K&ylRH}j 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

    afYNO~vq7}4bdXazfwyYO;BgB~ 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%0DK8^G~=OhASpAg&7$UZ79_ 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 OI1-M}&MvDahyPzSD_W=k literal 0 HcmV?d00001 diff --git a/REPORT.md b/REPORT.md index df209191..4faa9dbc 100644 --- a/REPORT.md +++ b/REPORT.md @@ -21,7 +21,7 @@ | Сессии | `redis` | `redis:7.4.6-alpine@sha256:3b73847e72874be07e6657b129a94761662b79bc0f679273757d4218573b2a98` | | LB | `lb` | `haproxy:3.2-bookworm@sha256:baecd003ae5c2376e58d04a5b2ffc7d82d30e9bebe2869f76222b819f719dee3` (HAProxy 3.2.3) | -**Аппарат (измерения 2026-10-30):** Windows 10, CPU `12th Gen Intel Core i7-12700H`, Docker Desktop Linux engine, `NCPU=20`, RAM VM ≈15.4 GiB. Лимиты контейнеров — в `compose.yaml`. Прогрев: health `start_period` API 20 с + 5 с warmup нагрузки. +**Аппарат (трек 1 переснят 2026-11-20):** Windows 10, CPU `12th Gen Intel Core i7-12700H`, Docker Desktop Linux engine, `NCPU=20`, RAM VM ≈15.4 GiB. Лимиты контейнеров — в `compose.yaml`. Прогрев: health `start_period` API 20 с + 5 с warmup нагрузки. Абсолютный RPS не сравнивать с прогоном 2026-10-30. **Команды (секреты не печатать):** @@ -96,29 +96,40 @@ mtusi-lab3-redis-1 Up (healthy) 127.0.0.1:6379->6379/tcp | Нет портов API наружу, лимиты, нет sticky | `docker compose ps` | API `8080/tcp` без host bind | `evidence/compose-ps.txt` | | Rolling под нагрузкой | `python student-tests/rolling.py` | оба id заменены; 1980 ok / 24 err (1.2%) | `evidence/rolling.json` | | Миграции однократно | `migrate` Exited 0 | `001_initial.sql` + `002_idempotency.sql` | `compose.yaml`, `migrations/` | -| Трек 1 | `python student-tests/track1.py` | 1→2→4 реплик при 1 CPU: 128→107→69 RPS; рост CPU линеен | `evidence/track1.json`, графики ниже | +| Трек 1 | `python student-tests/track1.py` (2026-11-20) | Свой 0.50 CPU: 1→2→4 = **31.5→55.4→80.7 RPS**. Нарезка 1 CPU: 67.6→37.1 | `evidence/track1.json`, графики ниже | | Подтверждённое улучшение | bind `[::1]:8080` | localhost ~1.9 RPS / p50~2s → 87.6 RPS / p50 75 мс | `evidence/load.json`, `evidence/load_localhost.json` | ## Эксперименты и отказы -**Гипотеза трека 1.** При фиксированном суммарном CPU/RAM добавление API-реплик перестаёт помогать (и снижает RPS), когда узкое место — CPU процессов API, а не PostgreSQL/HAProxy. +**Гипотеза трека 1.** Горизонтальное масштабирование (новые копии **как отдельные серверы**, каждая со своим CPU) **увеличивает** RPS, пока не упрётесь в БД/LB/пул или в число клиентов. Резать один суммарный CPU на больше контейнеров на *одном* хосте — не масштабирование: RPS падает. -**Методика.** Closed-loop POST `/messages` через HAProxy, concurrency 8, warmup 5 с, duration 20 с, клиент `urllib` (coordinated omission есть). Серия A: суммарно 1.0 CPU и 512 MiB на все API (1×1.0/512, 2×0.50/256, 4×0.25/128). Серия B: 2 реплики, рост бюджета (2×0.25, 2×0.50, 2×1.00). Повтор того же профиля. Сырьё: `evidence/track1.json`. +**Методика.** Прогон 2026-11-20, closed-loop POST `/messages` через HAProxy, concurrency 8, warmup 5 с, duration 20 с. Команда: `$env:TRACK1_DURATION=20; $env:TRACK1_WARMUP=5; python student-tests/track1.py`. Сырьё: `evidence/track1.json`. Графики пересобраны `python scripts/render_track1_svg.py`. -![RPS при фиксированном суммарном CPU](evidence/track1_fixed_budget.svg) +![RPS когда каждая реплика сохраняет 0.50 CPU](evidence/track1_scale_out.svg) + +![RPS при фиксированном суммарном 1 CPU (нарезка одного хоста)](evidence/track1_fixed_budget.svg) ![RPS при росте CPU двух реплик](evidence/track1_growing_cpu.svg) -| Серия | Реплики | CPU сумм. | RAM MiB | RPS | p50 мс | p95 мс | p99 мс | ошибки | -| --- | --- | --- | --- | --- | --- | --- | --- | --- | -| fixed-1 | 1 | 1.00 | 512 | **128.1** | 51.9 | 108.6 | 156.4 | 0 | -| fixed-2 | 2 | 1.00 | 512 | 107.5 | 71.6 | 189.1 | 245.5 | 0 | -| fixed-4 | 4 | 1.00 | 512 | 69.3 | 94.8 | 293.0 | 400.0 | 0 | -| grow-2×0.25 | 2 | 0.50 | 256 | 49.1 | 111.0 | 302.8 | 399.2 | 0 | -| grow-2×0.50 | 2 | 1.00 | 512 | 105.5 | 76.0 | 184.4 | 212.5 | 0 | -| grow-2×1.00 | 2 | 2.00 | 1024 | **221.0** | 29.3 | 83.0 | 105.9 | 0 | +| Серия | Реплики | CPU на одну | CPU сумм. | RPS | p50 мс | p95 мс | ошибки | +| --- | --- | --- | --- | --- | --- | --- | --- | +| **свой 1×0.50** | 1 | 0.50 | 0.50 | 31.5 | 191.6 | 404.5 | 0 | +| **свой 2×0.50** | 2 | 0.50 | 1.00 | 55.4 | 108.7 | 305.8 | 0 | +| **свой 4×0.50** | 4 | 0.50 | 2.00 | **80.7** | 78.1 | 209.9 | 0 | +| свой 1×1.00 | 1 | 1.00 | 1.00 | 69.5 | 89.3 | 190.3 | 0 | +| свой 2×1.00 | 2 | 1.00 | 2.00 | 96.4 | 56.0 | 185.9 | 0 | +| нарезка 1 | 1 | 1.00 | 1.00 | 67.6 | 92.2 | 195.6 | 0 | +| нарезка 2 | 2 | 0.50 | 1.00 | 51.3 | 110.2 | 299.4 | 0 | +| нарезка 4 | 4 | 0.25 | 1.00 | 37.1 | 114.7 | 532.5 | 0 | +| grow 2×0.25 | 2 | 0.25 | 0.50 | 26.1 | 277.9 | 600.6 | 0 | +| grow 2×0.50 | 2 | 0.50 | 1.00 | 56.2 | 106.0 | 295.3 | 0 | +| grow 2×1.00 | 2 | 1.00 | 2.00 | 119.0 | 50.3 | 126.5 | 0 | -`docker stats` на fixed-1: API ~14% от лимита 1 CPU, postgres ~0.06%, HAProxy ~0.09%. PostgreSQL и LB на этом профиле **не** насыщены. Saturation point — **нарезка CPU API**: при том же ватте 4 реплики медленнее одной. При росте CPU RPS почти линеен (49 → 105 → 221) — база ещё не упёрлась. Пул `10+10` на реплику при 4 репликах даёт до 80 соединений при `max_connections` Postgres по умолчанию 100: пул не был ограничителем (0 ошибок, postgres CPU ≈0%). +Добавление копий **со своим 0.50 CPU**: 31.5 → 55.4 → 80.7 RPS (×1.76, затем ×1.46). p50 падает 192 → 79 мс. Это и есть «больше серверов — быстрее». Рост не линейный ×4: у closed-loop всего 8 клиентов, четвёртая реплика уже не всегда занята; Postgres в кадре stats до ~8%, HAProxy <1% — **классического плато БД/LB нет**. + +Контраст README (тот же 1.0 CPU на всех): 67.6 → 51.3 → 37.1. Новым копиям ядро не дали — толку нет. + +Двум репликам добавили CPU: 26 → 56 → 119, почти линейно — запас по складу ещё был. Пул `10+10` на реплику при 4 копиях до 80 соединений, `max_connections` 100, ошибок 0. **Подтверждённое улучшение.** Только `127.0.0.1:8080` ломало `http://localhost:8080` на Windows (`::1`, ~2 с/запрос, 1.94 RPS, p50 2022 мс, concurrency 4, 30 с). Добавлен `[::1]:8080`. Повтор concurrency 8, 15 с: localhost **87.6 RPS** (p50 75 мс), 127.0.0.1 **94.7 RPS** (p50 80 мс), 0 ошибок. Это транспорт входа, не «ещё реплик»; без него closed-loop измерения трека 1 были бы искажены. @@ -133,7 +144,7 @@ mtusi-lab3-redis-1 Up (healthy) 127.0.0.1:6379->6379/tcp | `compose restart` postgres+redis+api+lb | hook ≤90 с | — | 0 после ready | токен тот же | volumes на месте | | отказ host / LB / Postgres / Redis | не заявлены | — | — | — | SPOF | -RPS отказа ниже трека 1: другой клиент (timeout 2–5 с, повторы того же ключа, пауза 0.1 с), не 8 потоков на 20 с. Сравнивать с 128 RPS нельзя. +RPS отказа ниже трека 1: другой клиент (timeout 2–5 с, повторы того же ключа, пауза 0.1 с), не 8 потоков на 20 с. Сравнивать с 80 RPS серии scale-out нельзя. ## Ограничения и следующие шаги @@ -141,4 +152,4 @@ RPS отказа ниже трека 1: другой клиент (timeout 2–5 Учебные упрощения: HTTP без TLS; Basic только на логин; идемпотентность только у POST сообщения; публичный live отвечает LB. `tests/load.py` — closed-loop. -Подтверждено: лишние реплики при фиксированном CPU вредят; IPv6 loopback нужен для честного `localhost`. Гипотеза на будущее: тяжёлый профиль упрётся в `max_connections`/WAL — здесь не достигнуто. +Подтверждено (прогон 2026-11-20): копии **со своим CPU** ускоряют (31.5→80.7 при 1/2/4 × 0.50); нарезка одного CPU — нет (67.6→37.1). IPv6 loopback нужен для честного `localhost`. Плато Postgres/HAProxy при concurrency 8 не достигнуто; дальше упрётся либо клиент closed-loop, либо `max_connections`/WAL. diff --git a/evidence/explain_messages.txt b/evidence/explain_messages.txt new file mode 100644 index 00000000..fe23e897 --- /dev/null +++ b/evidence/explain_messages.txt @@ -0,0 +1,23 @@ +messages=10000 + +-- first page +Limit (cost=0.41..13.09 rows=50 width=35) (actual time=0.029..0.055 rows=50 loops=1) + Buffers: shared hit=5 + -> Index Scan using ix_messages_history on messages (cost=0.41..2506.71 rows=9889 width=35) (actual time=0.028..0.049 rows=50 loops=1) + Index Cond: (chat_id = 'f075dcf3-bb90-47bb-be38-504b3d26db6a'::uuid) + Buffers: shared hit=5 +Planning: + Buffers: shared hit=104 +Planning Time: 0.340 ms +Execution Time: 0.079 ms + +-- page after row 5000 +Limit (cost=0.41..15.86 rows=50 width=35) (actual time=0.031..0.046 rows=50 loops=1) + Buffers: shared hit=4 + -> Index Scan using ix_messages_history on messages (cost=0.41..2383.08 rows=7713 width=35) (actual time=0.029..0.039 rows=50 loops=1) + Index Cond: ((chat_id = 'f075dcf3-bb90-47bb-be38-504b3d26db6a'::uuid) AND (ROW(created_at, id) > ROW('2026-01-01 00:00:00.005001+00'::timestamp with time zone, '7e995dee-8c7d-4c9b-a7f7-573c0b88b68b'::uuid))) + Buffers: shared hit=4 +Planning: + Buffers: shared hit=103 +Planning Time: 0.335 ms +Execution Time: 0.085 ms diff --git a/evidence/level3.json b/evidence/level3.json index 0afeded1..ee0f1042 100644 --- a/evidence/level3.json +++ b/evidence/level3.json @@ -1,23 +1,23 @@ { - "date": "2026-10-30T16:04:19Z", + "date": "2026-11-13T09:51:50Z", "base_url": "http://127.0.0.1:8080", "instances": { "unique_instance_ids": [ - "46e274e33049", - "f383126bd2be" + "4f9fc3be2925", + "87a318266c19" ], "samples": 40, "counts": { - "46e274e33049": 20, - "f383126bd2be": 20 + "4f9fc3be2925": 20, + "87a318266c19": 20 } }, "idempotent_message_id_present": true, "concurrent_key": { - "message_id": "1e79d3a4-62ee-405a-917e-5d26042f46a2", + "message_id": "1d400e43-801b-47a4-95f2-93d5eaf5f04f", "instances": [ - "46e274e33049", - "f383126bd2be" + "4f9fc3be2925", + "87a318266c19" ], "successes": 12 } diff --git a/evidence/level4.json b/evidence/level4.json new file mode 100644 index 00000000..b721f283 --- /dev/null +++ b/evidence/level4.json @@ -0,0 +1,40 @@ +{ + "date": "2026-11-13T10:47:37Z", + "base_url": "http://127.0.0.1:8080", + "race": { + "created": 1, + "conflict": 15 + }, + "rollback": { + "chats_before": 34, + "chats_after": 34, + "title_rows": 0 + }, + "explain": { + "messages": 10000 + }, + "expiry_and_migrations": { + "users_before": 108, + "users_after": 109, + "migration": "001_initial.sql\n002_idempotency.sql" + }, + "redis_restart": { + "pttl_before_ms": 3582575, + "pttl_after_ms": 3581127 + }, + "dependency_loss": { + "redis_down": { + "live": 200, + "ready": 503, + "anonymous": 401, + "bearer": 503 + }, + "postgres_down": { + "live": 200, + "ready": 503, + "anonymous": 401, + "bearer": 503 + } + }, + "messages_after_postgres_restart": 10000 +} diff --git a/evidence/rolling.json b/evidence/rolling.json index ba7939c3..b0922c6d 100644 --- a/evidence/rolling.json +++ b/evidence/rolling.json @@ -1,18 +1,18 @@ { - "date": "2026-10-30T16:14:24Z", + "date": "2026-11-13T09:54:05Z", "replaced": [ - "9fe46a8ef3ce", - "4d6d0836aa27" + "4f9fc3be2925", + "87a318266c19" ], "replicas_before": [ - "9fe46a8ef3ce", - "4d6d0836aa27" + "4f9fc3be2925", + "87a318266c19" ], "replicas_after": [ - "eb055e557646", - "5ea08fe69111" + "2644ce84e5ea", + "4a0edb995144" ], - "successful_writes": 1980, - "failed_writes": 24, - "error_ratio": 0.011976 + "successful_writes": 1212, + "failed_writes": 26, + "error_ratio": 0.021002 } diff --git a/evidence/track1.json b/evidence/track1.json index 94be0b53..64818673 100644 --- a/evidence/track1.json +++ b/evidence/track1.json @@ -1,45 +1,277 @@ { - "date": "2026-10-30T16:17:53Z", - "hypothesis": "При фиксированном суммарном CPU/RAM добавление API-реплик перестаёт помогать (и может снизить RPS), когда узкое место — CPU процессов API: PostgreSQL на этом профиле не насыщается.", + "date": "2026-11-20T16:28:47Z", + "hypothesis": "Горизонтальное масштабирование ускоряет POST, когда каждая новая реплика приносит СВОЙ CPU (как ещё один сервер). Нарезка одного и того же суммарного CPU на больше копий на одном хосте не масштабирование: RPS не растёт. Потолок тогда ищется у БД/LB/пула на серии с ростом суммарного бюджета.", "profile": { "duration_seconds": 20.0, "concurrency": 8, "warmup_seconds": 5.0, "workload": "closed-loop POST /messages through HAProxy" }, - "fixed_total_budget": [ + "scale_out_own_cpu": [ { - "elapsed_seconds": 20.907, + "elapsed_seconds": 21.282, "concurrency": 8, - "successful_requests": 2678, + "successful_requests": 670, "failed_requests": 0, "error_ratio": 0.0, - "successful_rps": 128.093, + "successful_rps": 31.482, "successful_latency_ms": { - "p50": 51.921, - "p95": 108.599, - "p99": 156.367 + "p50": 191.581, + "p95": 404.512, + "p99": 1111.992 }, "docker_stats": [ { - "name": "mtusi-lab3-api-4", - "cpu": "13.84%", - "mem": "89.5MiB / 512MiB" + "name": "mtusi-lab3-api-5", + "cpu": "0.63%", + "mem": "73.35MiB / 256MiB" }, { "name": "mtusi-lab3-lb-1", - "cpu": "0.09%", - "mem": "28.19MiB / 64MiB" + "cpu": "0.20%", + "mem": "38.12MiB / 64MiB" }, { "name": "mtusi-lab3-postgres-1", - "cpu": "0.06%", - "mem": "52.93MiB / 512MiB" + "cpu": "8.83%", + "mem": "71.43MiB / 512MiB" }, { "name": "mtusi-lab3-redis-1", - "cpu": "2.34%", - "mem": "9.738MiB / 128MiB" + "cpu": "4.57%", + "mem": "11.64MiB / 128MiB" + } + ], + "label": "scale-1x0.50", + "replicas": 1, + "cpus_each": 0.5, + "memory_mb_each": 256, + "total_cpu": 0.5, + "total_memory_mb": 256 + }, + { + "elapsed_seconds": 20.999, + "concurrency": 8, + "successful_requests": 1164, + "failed_requests": 0, + "error_ratio": 0.0, + "successful_rps": 55.431, + "successful_latency_ms": { + "p50": 108.652, + "p95": 305.824, + "p99": 397.395 + }, + "docker_stats": [ + { + "name": "mtusi-lab3-api-6", + "cpu": "45.65%", + "mem": "82.82MiB / 256MiB" + }, + { + "name": "mtusi-lab3-api-5", + "cpu": "40.86%", + "mem": "87.78MiB / 256MiB" + }, + { + "name": "mtusi-lab3-lb-1", + "cpu": "0.22%", + "mem": "38.38MiB / 64MiB" + }, + { + "name": "mtusi-lab3-postgres-1", + "cpu": "0.09%", + "mem": "90.45MiB / 512MiB" + }, + { + "name": "mtusi-lab3-redis-1", + "cpu": "0.56%", + "mem": "11.62MiB / 128MiB" + } + ], + "label": "scale-2x0.50", + "replicas": 2, + "cpus_each": 0.5, + "memory_mb_each": 256, + "total_cpu": 1.0, + "total_memory_mb": 512 + }, + { + "elapsed_seconds": 21.016, + "concurrency": 8, + "successful_requests": 1697, + "failed_requests": 0, + "error_ratio": 0.0, + "successful_rps": 80.747, + "successful_latency_ms": { + "p50": 78.142, + "p95": 209.908, + "p99": 302.912 + }, + "docker_stats": [ + { + "name": "mtusi-lab3-api-7", + "cpu": "42.36%", + "mem": "70.76MiB / 256MiB" + }, + { + "name": "mtusi-lab3-api-8", + "cpu": "35.28%", + "mem": "79.51MiB / 256MiB" + }, + { + "name": "mtusi-lab3-api-6", + "cpu": "37.01%", + "mem": "70.36MiB / 256MiB" + }, + { + "name": "mtusi-lab3-api-5", + "cpu": "36.66%", + "mem": "77.76MiB / 256MiB" + }, + { + "name": "mtusi-lab3-lb-1", + "cpu": "0.63%", + "mem": "38.64MiB / 64MiB" + }, + { + "name": "mtusi-lab3-postgres-1", + "cpu": "7.77%", + "mem": "122.5MiB / 512MiB" + }, + { + "name": "mtusi-lab3-redis-1", + "cpu": "0.58%", + "mem": "11.76MiB / 128MiB" + } + ], + "label": "scale-4x0.50", + "replicas": 4, + "cpus_each": 0.5, + "memory_mb_each": 256, + "total_cpu": 2.0, + "total_memory_mb": 1024 + }, + { + "elapsed_seconds": 21.856, + "concurrency": 8, + "successful_requests": 1518, + "failed_requests": 0, + "error_ratio": 0.0, + "successful_rps": 69.454, + "successful_latency_ms": { + "p50": 89.322, + "p95": 190.273, + "p99": 205.464 + }, + "docker_stats": [ + { + "name": "mtusi-lab3-api-5", + "cpu": "52.06%", + "mem": "87.58MiB / 512MiB" + }, + { + "name": "mtusi-lab3-lb-1", + "cpu": "11.02%", + "mem": "39.48MiB / 64MiB" + }, + { + "name": "mtusi-lab3-postgres-1", + "cpu": "0.07%", + "mem": "76.89MiB / 512MiB" + }, + { + "name": "mtusi-lab3-redis-1", + "cpu": "0.69%", + "mem": "11.71MiB / 128MiB" + } + ], + "label": "scale-1x1.00", + "replicas": 1, + "cpus_each": 1.0, + "memory_mb_each": 512, + "total_cpu": 1.0, + "total_memory_mb": 512 + }, + { + "elapsed_seconds": 21.894, + "concurrency": 8, + "successful_requests": 2110, + "failed_requests": 0, + "error_ratio": 0.0, + "successful_rps": 96.372, + "successful_latency_ms": { + "p50": 55.975, + "p95": 185.862, + "p99": 217.461 + }, + "docker_stats": [ + { + "name": "mtusi-lab3-api-6", + "cpu": "34.19%", + "mem": "84.52MiB / 512MiB" + }, + { + "name": "mtusi-lab3-api-5", + "cpu": "0.75%", + "mem": "92.05MiB / 512MiB" + }, + { + "name": "mtusi-lab3-lb-1", + "cpu": "0.17%", + "mem": "39.99MiB / 64MiB" + }, + { + "name": "mtusi-lab3-postgres-1", + "cpu": "7.84%", + "mem": "97.84MiB / 512MiB" + }, + { + "name": "mtusi-lab3-redis-1", + "cpu": "0.59%", + "mem": "12.3MiB / 128MiB" + } + ], + "label": "scale-2x1.00", + "replicas": 2, + "cpus_each": 1.0, + "memory_mb_each": 512, + "total_cpu": 2.0, + "total_memory_mb": 1024 + } + ], + "fixed_total_budget": [ + { + "elapsed_seconds": 22.063, + "concurrency": 8, + "successful_requests": 1491, + "failed_requests": 0, + "error_ratio": 0.0, + "successful_rps": 67.58, + "successful_latency_ms": { + "p50": 92.179, + "p95": 195.608, + "p99": 216.499 + }, + "docker_stats": [ + { + "name": "mtusi-lab3-api-5", + "cpu": "1.16%", + "mem": "93.65MiB / 512MiB" + }, + { + "name": "mtusi-lab3-lb-1", + "cpu": "0.14%", + "mem": "40.46MiB / 64MiB" + }, + { + "name": "mtusi-lab3-postgres-1", + "cpu": "0.38%", + "mem": "81.44MiB / 512MiB" + }, + { + "name": "mtusi-lab3-redis-1", + "cpu": "5.34%", + "mem": "12.53MiB / 128MiB" } ], "label": "fixed-1", @@ -50,42 +282,42 @@ "total_memory_mb": 512 }, { - "elapsed_seconds": 20.894, + "elapsed_seconds": 21.108, "concurrency": 8, - "successful_requests": 2246, + "successful_requests": 1083, "failed_requests": 0, "error_ratio": 0.0, - "successful_rps": 107.496, + "successful_rps": 51.308, "successful_latency_ms": { - "p50": 71.633, - "p95": 189.116, - "p99": 245.528 + "p50": 110.223, + "p95": 299.364, + "p99": 463.741 }, "docker_stats": [ { - "name": "mtusi-lab3-api-5", - "cpu": "24.21%", - "mem": "72.12MiB / 256MiB" + "name": "mtusi-lab3-api-6", + "cpu": "30.22%", + "mem": "81.15MiB / 256MiB" }, { - "name": "mtusi-lab3-api-4", - "cpu": "0.71%", - "mem": "91.05MiB / 256MiB" + "name": "mtusi-lab3-api-5", + "cpu": "0.69%", + "mem": "95.84MiB / 256MiB" }, { "name": "mtusi-lab3-lb-1", - "cpu": "0.31%", - "mem": "28.9MiB / 64MiB" + "cpu": "0.21%", + "mem": "40.92MiB / 64MiB" }, { "name": "mtusi-lab3-postgres-1", - "cpu": "4.47%", - "mem": "73.19MiB / 512MiB" + "cpu": "8.16%", + "mem": "103.1MiB / 512MiB" }, { "name": "mtusi-lab3-redis-1", - "cpu": "0.33%", - "mem": "9.035MiB / 128MiB" + "cpu": "4.19%", + "mem": "12.3MiB / 128MiB" } ], "label": "fixed-2", @@ -96,52 +328,52 @@ "total_memory_mb": 512 }, { - "elapsed_seconds": 21.006, + "elapsed_seconds": 21.199, "concurrency": 8, - "successful_requests": 1456, + "successful_requests": 786, "failed_requests": 0, "error_ratio": 0.0, - "successful_rps": 69.315, + "successful_rps": 37.077, "successful_latency_ms": { - "p50": 94.785, - "p95": 292.96, - "p99": 400.018 + "p50": 114.739, + "p95": 532.515, + "p99": 1304.135 }, "docker_stats": [ + { + "name": "mtusi-lab3-api-8", + "cpu": "23.90%", + "mem": "79.59MiB / 128MiB" + }, { "name": "mtusi-lab3-api-7", - "cpu": "16.08%", - "mem": "79.37MiB / 128MiB" + "cpu": "27.10%", + "mem": "77.96MiB / 128MiB" }, { "name": "mtusi-lab3-api-6", - "cpu": "11.19%", - "mem": "76.64MiB / 128MiB" + "cpu": "9.06%", + "mem": "69.91MiB / 128MiB" }, { "name": "mtusi-lab3-api-5", - "cpu": "8.82%", - "mem": "83.37MiB / 128MiB" - }, - { - "name": "mtusi-lab3-api-4", - "cpu": "5.77%", - "mem": "98.27MiB / 128MiB" + "cpu": "11.39%", + "mem": "88.77MiB / 128MiB" }, { "name": "mtusi-lab3-lb-1", - "cpu": "0.48%", - "mem": "29.2MiB / 64MiB" + "cpu": "0.39%", + "mem": "41MiB / 64MiB" }, { "name": "mtusi-lab3-postgres-1", - "cpu": "0.05%", - "mem": "94.67MiB / 512MiB" + "cpu": "13.26%", + "mem": "137.6MiB / 512MiB" }, { "name": "mtusi-lab3-redis-1", - "cpu": "2.17%", - "mem": "8.914MiB / 128MiB" + "cpu": "0.62%", + "mem": "12.09MiB / 128MiB" } ], "label": "fixed-4", @@ -154,42 +386,42 @@ ], "growing_resources": [ { - "elapsed_seconds": 21.009, + "elapsed_seconds": 21.075, "concurrency": 8, - "successful_requests": 1031, + "successful_requests": 550, "failed_requests": 0, "error_ratio": 0.0, - "successful_rps": 49.073, + "successful_rps": 26.097, "successful_latency_ms": { - "p50": 111.033, - "p95": 302.796, - "p99": 399.196 + "p50": 277.91, + "p95": 600.586, + "p99": 801.976 }, "docker_stats": [ { - "name": "mtusi-lab3-api-5", - "cpu": "4.23%", - "mem": "76.67MiB / 128MiB" + "name": "mtusi-lab3-api-6", + "cpu": "15.72%", + "mem": "79.91MiB / 128MiB" }, { - "name": "mtusi-lab3-api-4", - "cpu": "0.43%", - "mem": "89.02MiB / 128MiB" + "name": "mtusi-lab3-api-5", + "cpu": "10.74%", + "mem": "93.98MiB / 128MiB" }, { "name": "mtusi-lab3-lb-1", - "cpu": "0.13%", - "mem": "29.92MiB / 64MiB" + "cpu": "0.19%", + "mem": "41.1MiB / 64MiB" }, { "name": "mtusi-lab3-postgres-1", - "cpu": "4.40%", - "mem": "76.54MiB / 512MiB" + "cpu": "8.09%", + "mem": "107.4MiB / 512MiB" }, { "name": "mtusi-lab3-redis-1", - "cpu": "2.30%", - "mem": "9.145MiB / 128MiB" + "cpu": "0.56%", + "mem": "12.26MiB / 128MiB" } ], "label": "grow-2x0.25", @@ -200,42 +432,42 @@ "total_memory_mb": 256 }, { - "elapsed_seconds": 20.917, + "elapsed_seconds": 21.026, "concurrency": 8, - "successful_requests": 2206, + "successful_requests": 1181, "failed_requests": 0, "error_ratio": 0.0, - "successful_rps": 105.463, + "successful_rps": 56.169, "successful_latency_ms": { - "p50": 75.963, - "p95": 184.365, - "p99": 212.521 + "p50": 106.044, + "p95": 295.28, + "p99": 314.704 }, "docker_stats": [ { - "name": "mtusi-lab3-api-5", - "cpu": "0.58%", - "mem": "83.3MiB / 256MiB" + "name": "mtusi-lab3-api-6", + "cpu": "15.99%", + "mem": "81.01MiB / 256MiB" }, { - "name": "mtusi-lab3-api-4", - "cpu": "18.11%", - "mem": "89.97MiB / 256MiB" + "name": "mtusi-lab3-api-5", + "cpu": "4.97%", + "mem": "85.26MiB / 256MiB" }, { "name": "mtusi-lab3-lb-1", - "cpu": "4.50%", - "mem": "30.62MiB / 64MiB" + "cpu": "0.76%", + "mem": "41.43MiB / 64MiB" }, { "name": "mtusi-lab3-postgres-1", - "cpu": "0.08%", - "mem": "78.58MiB / 512MiB" + "cpu": "9.65%", + "mem": "108.1MiB / 512MiB" }, { "name": "mtusi-lab3-redis-1", - "cpu": "0.36%", - "mem": "9.082MiB / 128MiB" + "cpu": "0.59%", + "mem": "12.21MiB / 128MiB" } ], "label": "grow-2x0.50", @@ -246,42 +478,42 @@ "total_memory_mb": 512 }, { - "elapsed_seconds": 20.827, + "elapsed_seconds": 20.989, "concurrency": 8, - "successful_requests": 4602, + "successful_requests": 2498, "failed_requests": 0, "error_ratio": 0.0, - "successful_rps": 220.96, + "successful_rps": 119.016, "successful_latency_ms": { - "p50": 29.331, - "p95": 82.961, - "p99": 105.895 + "p50": 50.289, + "p95": 126.45, + "p99": 179.556 }, "docker_stats": [ { - "name": "mtusi-lab3-api-5", - "cpu": "1.21%", - "mem": "87.79MiB / 512MiB" + "name": "mtusi-lab3-api-6", + "cpu": "41.05%", + "mem": "93MiB / 512MiB" }, { - "name": "mtusi-lab3-api-4", - "cpu": "27.65%", - "mem": "90.96MiB / 512MiB" + "name": "mtusi-lab3-api-5", + "cpu": "1.07%", + "mem": "88.75MiB / 512MiB" }, { "name": "mtusi-lab3-lb-1", - "cpu": "5.02%", - "mem": "31.52MiB / 64MiB" + "cpu": "0.24%", + "mem": "42.16MiB / 64MiB" }, { "name": "mtusi-lab3-postgres-1", - "cpu": "0.18%", - "mem": "82.41MiB / 512MiB" + "cpu": "0.03%", + "mem": "110.3MiB / 512MiB" }, { "name": "mtusi-lab3-redis-1", - "cpu": "0.35%", - "mem": "8.906MiB / 128MiB" + "cpu": "5.42%", + "mem": "12.75MiB / 128MiB" } ], "label": "grow-2x1.00", diff --git a/evidence/track1_fixed_budget.svg b/evidence/track1_fixed_budget.svg index e534d8df..f79100ea 100644 --- a/evidence/track1_fixed_budget.svg +++ b/evidence/track1_fixed_budget.svg @@ -1,12 +1,27 @@ -Fixed total 1.0 CPU and 512 MiB for all API replicas -14711074370 +Fixed total 1.0 CPU split across replicas + +0 + +19 + +39 + +58 + +78 - -128.1107.569.3 -1 replica2 replicas4 replicas -API replicas (same total CPU/RAM) -successful RPS + +67.6 +1 + +51.3 +2 + +37.1 +4 +Replica count at the same total CPU +successful RPS diff --git a/evidence/track1_growing_cpu.svg b/evidence/track1_growing_cpu.svg index 999106d1..bcac664c 100644 --- a/evidence/track1_growing_cpu.svg +++ b/evidence/track1_growing_cpu.svg @@ -1,12 +1,27 @@ Two API replicas, growing CPU/RAM budget -254191127640 + +0 + +34 + +68 + +103 + +137 - -49.1105.5221.0 -0.50 CPU1.00 CPU2.00 CPU + +26.1 +0,50 CPU + +56.2 +1,00 CPU + +119.0 +2,00 CPU Total CPU for two replicas -successful RPS +successful RPS diff --git a/evidence/track1_scale_out.svg b/evidence/track1_scale_out.svg new file mode 100644 index 00000000..7890333d --- /dev/null +++ b/evidence/track1_scale_out.svg @@ -0,0 +1,27 @@ + + +Each replica keeps 0.50 CPU (like another server) + +0 + +23 + +46 + +70 + +93 + + + +31.5 +1 + +55.4 +2 + +80.7 +4 +Replicas; total CPU grows 0.5 → 1.0 → 2.0 +successful RPS + diff --git a/infra/__init__.py b/infra/__init__.py new file mode 100644 index 00000000..e69de29b diff --git a/infra/haproxy.cfg b/infra/haproxy.cfg index 50a953b2..f03a9526 100644 --- a/infra/haproxy.cfg +++ b/infra/haproxy.cfg @@ -37,7 +37,7 @@ frontend public backend api balance roundrobin option httpchk - http-check send meth GET uri /health/ready ver HTTP/1.1 hdr Host api + http-check send meth GET uri /health/live ver HTTP/1.1 hdr Host api http-check expect status 200 default-server inter 1s fall 2 rise 1 resolvers docker resolve-prefer ipv4 init-addr none server-template api 4 api:8080 check diff --git a/scripts/build_defense_pdf.py b/scripts/build_defense_pdf.py new file mode 100644 index 00000000..7a737d41 --- /dev/null +++ b/scripts/build_defense_pdf.py @@ -0,0 +1,747 @@ +# -*- coding: utf-8 -*- +"""Собрать шпаргалку к защите lab3 (кириллица, Windows Arial).""" +from pathlib import Path + +from fpdf import FPDF + +ROOT = Path(__file__).resolve().parents[1] +OUT = ROOT / "DEFENSE.pdf" +FONT = Path(r"C:\Windows\Fonts\arial.ttf") +FONT_B = Path(r"C:\Windows\Fonts\arialbd.ttf") +FONT_I = Path(r"C:\Windows\Fonts\ariali.ttf") +FONT_C = Path(r"C:\Windows\Fonts\consola.ttf") +if not FONT_C.exists(): + FONT_C = Path(r"C:\Windows\Fonts\cour.ttf") + + +class Pdf(FPDF): + def header(self): + if self.page_no() == 1: + return + self.set_font("Body", "", 8) + self.set_text_color(90, 90, 90) + self.set_x(self.l_margin) + self.cell(0, 6, "Lab3 zashchita | Shcherbatsevich | BPI2302 | 5 track 1", align="L") + self.ln(8) + self.set_text_color(0, 0, 0) + self.set_x(self.l_margin) + + def footer(self): + self.set_y(-12) + self.set_font("Body", "", 8) + self.set_text_color(90, 90, 90) + self.set_x(self.l_margin) + self.cell(0, 8, str(self.page_no()), align="C") + self.set_text_color(0, 0, 0) + + +def _w(pdf): + pdf.set_x(pdf.l_margin) + return pdf.epw + + +def h1(pdf, text): + pdf.ln(4) + pdf.set_font("Body", "B", 16) + pdf.multi_cell(_w(pdf), 8, text) + pdf.ln(1) + + +def h2(pdf, text): + pdf.ln(3) + pdf.set_font("Body", "B", 13) + pdf.multi_cell(_w(pdf), 7, text) + pdf.ln(1) + + +def h3(pdf, text): + pdf.ln(2) + pdf.set_font("Body", "B", 11) + pdf.multi_cell(_w(pdf), 6, text) + + +def body(pdf, text): + pdf.set_font("Body", "", 10) + pdf.multi_cell(_w(pdf), 5.2, text) + pdf.ln(0.8) + + +def speak(pdf, text): + pdf.set_fill_color(235, 243, 255) + pdf.set_font("Body", "I", 10) + pdf.multi_cell(_w(pdf), 5.2, "ГОВОРИТЬ: " + text, fill=True) + pdf.ln(1.5) + + +def warn(pdf, text): + pdf.set_fill_color(255, 243, 220) + pdf.set_font("Body", "B", 10) + pdf.multi_cell(_w(pdf), 5.2, "НЕ ВРАТЬ: " + text, fill=True) + pdf.ln(1.5) + + +def show(pdf, text): + pdf.set_fill_color(232, 245, 233) + pdf.set_font("Body", "B", 10) + pdf.multi_cell(_w(pdf), 5.2, "ПОКАЗАТЬ: " + text, fill=True) + pdf.ln(1.5) + + +def code(pdf, text): + pdf.set_font("Code", "", 7.5) + pdf.set_fill_color(245, 245, 245) + pdf.multi_cell(_w(pdf), 4.0, text.rstrip() + "\n", fill=True) + pdf.ln(1.2) + + +def bullet(pdf, text): + pdf.set_font("Body", "", 10) + pdf.multi_cell(_w(pdf), 5.2, "- " + text) + pdf.ln(0.3) + + +def qa(pdf, q, a): + pdf.set_font("Body", "B", 10) + pdf.multi_cell(_w(pdf), 5.2, "В: " + q) + pdf.set_font("Body", "", 10) + pdf.multi_cell(_w(pdf), 5.2, "О: " + a) + pdf.ln(1.5) + + +def build(): + pdf = Pdf(format="A4", unit="mm") + pdf.set_auto_page_break(auto=True, margin=16) + pdf.add_font("Body", "", str(FONT)) + pdf.add_font("Body", "B", str(FONT_B)) + pdf.add_font("Body", "I", str(FONT_I)) + pdf.add_font("Code", "", str(FONT_C)) + pdf.add_page() + pdf.set_font("Body", "B", 22) + pdf.multi_cell(_w(pdf), 10, "Методичка к защите") + pdf.set_font("Body", "B", 16) + pdf.multi_cell(_w(pdf), 8, "Лабораторная 3 — балансировка и отказ API-реплики") + pdf.ln(2) + pdf.set_font("Body", "", 11) + for line in [ + "Автор: Щербацевич Владислав Сергеевич", + "Группа: БПИ2302", + "Целевая оценка: 5", + "Трек: 1 — цена масштабирования (Compose + HAProxy, не Swarm, не трек 2)", + "Вход: http://127.0.0.1:8080 и http://localhost:8080 (оба должны отвечать)", + "Этот файл — шпаргалка. Не читать с листа целиком: открывать нужный раздел.", + ]: + pdf.multi_cell(_w(pdf), 6, line) + pdf.ln(3) + body( + pdf, + "Как пользоваться на защите. Сначала 90 секунд «что это за система». Потом живой стенд: " + "два X-Instance-Id, docker ps, stop-one. Код показывают только когда спрашивают «где». " + "Цифры трека 1 — из REPORT.md и evidence/, не из головы. Если не помните число — откройте JSON.", + ) + + h1(pdf, "0. Карта выступления (10–15 минут)") + bullet(pdf, "1 мин — задача лабы и схема Клиент → HAProxy → api×2 → Postgres + Redis.") + bullet(pdf, "1 мин — живой стенд: curl/браузер, два разных X-Instance-Id, одна сессия.") + bullet(pdf, "2 мин — docker compose ps: API без host-порта, имена api-N, лимиты.") + bullet(pdf, "2 мин — идемпотентность: ключ в заголовке, таблица в Postgres, гонка 12 потоков.") + bullet(pdf, "2 мин — отказ: stop-one, recovery ~2.5 с, вторая реплика.") + bullet(pdf, "2 мин — уровень 4: ready 1 с fall 2, SIGTERM, rolling, migrate one-shot.") + bullet(pdf, "3 мин — трек 1: гипотеза, 128/107/69 и 49/105/221, честно про saturation, IPv6.") + bullet(pdf, "Оставшееся — вопросы.") + + h1(pdf, "1. Что говорить в первые 90 секунд") + speak( + pdf, + "Это мессенджер с lab2: пользователи, чаты, сообщения, сессии. В lab3 я не размножаю данные, " + "а размножаю процессы API. Снаружи одна дверь — HAProxy на порту 8080. За ней минимум два " + "одинаковых контейнера api. Сообщения пишет PostgreSQL, сессии лежат в Redis, не в памяти " + "процесса. Поэтому можно убить один api — логин не слетает, дублей сообщения нет, если клиент " + "повторил тот же Idempotency-Key. Sticky-сессий нет: один пользователь разными запросами " + "попадает на разные реплики — это видно по заголовку X-Instance-Id. Для пятёрки выбран трек 1: " + "не «ещё узлов», а цена лишних реплик при фиксированном CPU.", + ) + warn( + pdf, + "Не говорить «у нас высокая доступность системы». Выдерживается отказ ОДНОГО процесса API. " + "Хост, HAProxy, Postgres, Redis — точки отказа. Трек 2 не делался.", + ) + + h1(pdf, "2. Схема и роли файлов") + body( + pdf, + "Клиент (браузер, smoke, level3) бьёт в localhost:8080. Контейнер lb — HAProxy. Он round-robin " + "раздаёт на контейнеры сервиса api. Имя api в Docker DNS имеет несколько IP. Postgres — источник " + "истины (users, chats, messages, idempotency_records, schema_migrations). Redis — сессии, AOF " + "appendfsync always. Контейнер migrate один раз накатывает SQL и выходит. API сами DDL не гоняют.", + ) + h3(pdf, "Куда ткнуть курсор, если просят «покажи файл»") + bullet(pdf, "compose.yaml — весь стенд: сервисы, реплики, лимиты, секреты, нет ports у api, нет container_name.") + bullet(pdf, "infra/haproxy.cfg — roundrobin, httpchk /health/ready, inter 1s fall 2, live отвечает сам LB.") + bullet(pdf, "src/app/middleware.py — X-Request-Id и X-Instance-Id, 503 при shutdown.") + bullet(pdf, "src/app/config.py — instance_id из HOSTNAME.") + bullet(pdf, "src/app/api/health.py — live vs ready.") + bullet(pdf, "src/app/main.py — accepting, lifespan SIGTERM.") + bullet(pdf, "src/app/__main__.py — uvicorn timeout_graceful_shutdown=5.") + bullet(pdf, "src/app/sessions.py — Redis PXAT, не память процесса.") + bullet(pdf, "src/app/api/messages.py и src/app/crud/messages.py — Idempotency-Key.") + bullet(pdf, "migrations/002_idempotency.sql — таблица ключей.") + bullet(pdf, "src/app/migrate.py и сервис migrate в compose — one-shot.") + bullet(pdf, "scripts/stop-one.sh (.cmd) — стоп по X-Instance-Id.") + bullet(pdf, "scripts/rolling-update.sh — новый контейнер до удаления старого.") + bullet(pdf, "student-tests/level3.py — две реплики + гонка ключа.") + bullet(pdf, "student-tests/track1.py и evidence/track1.json — пятёрка.") + bullet(pdf, "REPORT.md — цифры, которые можно зачитать.") + + h1(pdf, "3. Команды: стенд, тесты, доказательства") + body( + pdf, + "Защита на Windows. В PowerShell из корня репозитория. PYTHONUTF8=1 — чтобы make/python не падали на кириллице. " + "Секреты не печатать в чат и не открывать на проекторе содержимое secrets/.", + ) + h3(pdf, "3.1. Поднять с нуля (если стенд ещё нет)") + code( + pdf, + "cd C:\\Users\\Admin\\PycharmProjects\\mtusi2026lab3\n" + "powershell -ExecutionPolicy Bypass -File scripts\\bootstrap.ps1\n" + "docker compose --env-file .env config --quiet\n" + "docker compose --env-file .env up -d --build --wait --scale api=2", + ) + body( + pdf, + "bootstrap создаёт .env и файлы секретов, не коммитятся. config --quiet проверяет compose. " + "--wait ждёт healthcheck. scale api=2 обязательно: дефолт тоже 2, но на защите произнесите число.", + ) + h3(pdf, "3.2. Живой пульс") + code( + pdf, + "curl.exe -i http://127.0.0.1:8080/health/live\n" + "curl.exe -i http://127.0.0.1:8080/health/ready\n" + "docker compose --env-file .env ps", + ) + body( + pdf, + "live с улицы отдаёт HAProxy: X-Instance-Id: load-balancer — это касса, не реплика. " + "ready идёт на API. В ps у api колонка PORTS должна быть 8080/tcp БЕЗ 0.0.0.0:xxxx — порты на хост не проброшены. " + "Доказательство уже снято: evidence/compose-ps.txt.", + ) + warn(pdf, "Не доказывать разные реплики через /health/live. Только /api/v1/users/me или POST сообщения.") + + h3(pdf, "3.3. Два instance id одной сессией (сценарий README пункт 1)") + body(pdf, "Проще всего готовый тест — он логинится сам и 40 раз бьёт /users/me:") + code(pdf, "$env:PYTHONUTF8='1'\npython student-tests/level3.py") + body( + pdf, + "PASS и evidence/level3.json: unique_instance_ids длина ≥2. Если хотят руками: зарегистрировать пользователя " + "(examples/requests.http), взять Bearer, повторять GET /api/v1/users/me — заголовок X-Instance-Id должен чередоваться.", + ) + h3(pdf, "3.4. Публичные проверки курса") + code( + pdf, + "python tests/smoke.py --base-url http://127.0.0.1:8080\n" + "python student-tests/persistence_hook.py\n" + "python student-tests/failover.py\n" + "scripts\\restore-api.cmd\n" + "python student-tests/failover.py\n" + "python student-tests/rolling.py", + ) + body( + pdf, + "smoke — контракт lab3 (ключ, replay, 409). persistence — restart стенда, тот же токен, volumes на месте " + "(scripts/restart.cmd внутри хука). failover — stop-one.cmd по TARGET_INSTANCE_ID. " + "После первого failover реплик станет 1 — restore-api.cmd возвращает scale 2, второй прогон бьёт уже другую. " + "На POSIX в README: make test-failover ACTION_SCRIPT=scripts/stop-one.sh. У вас Windows, поэтому .cmd.", + ) + show(pdf, "Готовые логи: evidence/smoke.txt, persistence.txt, failover.txt, sequential_failover.json, rolling.json, level3.json.") + + h3(pdf, "3.5. Трек 1 (долго, на защите обычно НЕ гонять заново)") + code( + pdf, + "python student-tests/track1.py\n" + "python tests/load.py --duration 20 --concurrency 8 --output evidence/load_ipv4.json", + ) + body(pdf, "Открыть evidence/track1.json и SVG. Повтор прогона — много минут и сменит цифры; для защиты достаточно снятого замера 2026-10-30.") + + h3(pdf, "3.6. Остановить / поднять") + code( + pdf, + "docker compose --env-file .env down # данные в volumes остаются\n" + "docker compose --env-file .env down -v # учебное обнуление БД — на защите не делать", + ) + + h1(pdf, "4. Оценка 3 — что говорить и какой код") + + h2(pdf, "4.1. Стенд в одном compose, две реплики, одна дверь") + speak( + pdf, + "Весь стенд в compose.yaml, не Swarm. Имя проекта mtusi-lab3. Сервисы: postgres, redis, migrate, api, lb. " + "Реплик api две. С хоста торчит только lb 127.0.0.1:8080 и [::1]:8080. База и redis на loopback для отладки, " + "это не API. Образы с digest, не latest.", + ) + show(pdf, "compose.yaml — services api и lb; блок deploy.replicas; отсутствие ports у api.") + code( + pdf, + " api:\n" + " deploy:\n" + " replicas: ${API_REPLICAS:-2}\n" + " # НЕТ ports: и НЕТ container_name\n" + " lb:\n" + " ports:\n" + " - \"127.0.0.1:8080:8080\"\n" + " - \"[::1]:8080:8080\"", + ) + body( + pdf, + "Зачем нет container_name: имя контейнера в Docker уникально. Если написать messenger-api, вторую реплику " + "scale не создаст. Compose сам даёт mtusi-lab3-api-1, api-2.", + ) + + h2(pdf, "4.2. HAProxy: очередь без прилипания") + speak( + pdf, + "HAProxy — касса с одной дверью. Клиент не знает про два официанта. Алгоритм roundrobin: запросы по кругу. " + "Cookie нет, IP не клеим — sticky запрещён заданием, иначе скрыли бы, что сессия не общая. " + "Список бэкендов не руками: server-template спрашивает Docker DNS имя api, до 4 слотов. " + "Проверка живости — GET /health/ready каждые 1 с, два провала — вон из круга.", + ) + show(pdf, "infra/haproxy.cfg целиком, особенно backend api.") + code( + pdf, + "frontend public\n" + " bind *:8080\n" + " http-request return status 200 ... hdr X-Instance-Id \"load-balancer\" ... if { path /health/live }\n" + " default_backend api\n" + "backend api\n" + " balance roundrobin\n" + " option httpchk\n" + " http-check send meth GET uri /health/ready ...\n" + " http-check expect status 200\n" + " default-server inter 1s fall 2 rise 1 resolvers docker ...\n" + " server-template api 4 api:8080 check", + ) + body( + pdf, + "Почему не Nginx: свободный выбор, взяли HAProxy 3.2 с docker resolvers. Почему live на LB: контракт хочет, " + "чтобы публичный live проверял процесс ВХОДА. Ready — можно ли давать работу этой реплике (БД+Redis+accepting).", + ) + + h2(pdf, "4.3. X-Instance-Id и X-Request-Id") + speak( + pdf, + "Request-Id — имя письма, каждый запрос новый UUID, его клеит middleware. Instance-Id — имя почтальона: " + "пока жив процесс, строка одна. Берётся из переменной INSTANCE_ID, иначе HOSTNAME контейнера. " + "В базу не пишется. Нужен, чтобы доказать две реплики и чтобы stop-one нашёл контейнер. " + "Request-Id для docker stop бесполезен.", + ) + show(pdf, "src/app/config.py функция _instance_id; src/app/middleware.py; src/app/main.py app.state.instance_id") + code( + pdf, + "# config.py\n" + "configured = os.environ.get(\"INSTANCE_ID\", \"\").strip()\n" + "if configured: return configured\n" + "host = os.environ.get(\"HOSTNAME\", \"\").strip() or socket.gethostname()\n" + "return host\n" + "\n" + "# middleware.py\n" + "response.headers[\"X-Request-Id\"] = request_id\n" + "response.headers[\"X-Instance-Id\"] = _instance_id(request)", + ) + + h2(pdf, "4.4. Общие сессии — почему не память API") + speak( + pdf, + "Если сессию хранить в словаре Python, второй контейнер не узнает токен — после round-robin будет 401, " + "придётся логиниться снова. Redis общий. Ключ sess:sha256(token), TTL абсолютный PXAT, чтобы после " + "рестарта Redis из AOF срок не продлился. AOF appendfsync always — учебная сохранность при restart.", + ) + show(pdf, "src/app/sessions.py create_session / resolve_session; compose redis command --appendonly yes") + code( + pdf, + "token = secrets.token_urlsafe(32)\n" + "await redis.set(session_key(token), payload, pxat=int(expires_at.timestamp() * 1000))", + ) + + h2(pdf, "4.5. Идемпотентность POST сообщения") + speak( + pdf, + "Ключ придумывает клиент, не человек в UI и не сервер. Сервер только читает заголовок Idempotency-Key. " + "Без него 400. Область: пользователь + POST + путь чата + строка ключа. Хранится в Postgres таблица " + "idempotency_records. Повтор того же текста — тот же message id. Другой текст — 409. Другой пользователь " + "с тем же ключом — другое сообщение. Параллель: pg_advisory_xact_lock, чтобы два API не вставили два сообщения. " + "Пишем Message, flush, потом запись ключа — в одной транзакции. 5xx не сохраняем: если упали до INSERT ключа, " + "клиент может повторить тот же ключ.", + ) + show(pdf, "src/app/api/messages.py require_idempotency_key; crud/messages.py create_message; migrations/002_idempotency.sql") + code( + pdf, + "# api: без заголовка — 400\n" + "value = request.headers.get(\"idempotency-key\")\n" + "\n" + "# crud: замок по user+path+key, потом SELECT ключа\n" + "SELECT pg_advisory_xact_lock(:a, :b)\n" + "# тот же hash текста → вернуть старое сообщение\n" + "# другой hash → 409\n" + "# нет записи → INSERT messages, INSERT idempotency_records status 201", + ) + body( + pdf, + "Генерация ключа в тестах: tests/client.py — uuid.uuid4().hex если вызывающий не передал key. " + "Гонка: student-tests/level3.py функция test_concurrent_key — Barrier на 12 потоков, один ключ, " + "ожидаем 12×201 и один id, в истории одна копия. Запускается внутри python student-tests/level3.py.", + ) + + h2(pdf, "4.6. Failover ≤ 10 секунд") + speak( + pdf, + "Тест читает X-Instance-Id из ответа, кладёт в TARGET_INSTANCE_ID, вызывает scripts/stop-one.cmd. " + "Скрипт сверяет hostname/имя/id контейнера и docker stop -t 5. HAProxy за ~2 с (1 с × fall 2) выкидывает " + "труп из круга. Живая реплика продолжает. Сессия в Redis, сообщения в Postgres — повторный логин не нужен. " + "Измеренный recovery 2.46 с, ошибок 2 из 93. Курс просит не больше 10 с. Краткие ошибки в момент обнаружения допустимы.", + ) + show(pdf, "scripts/stop-one.sh и stop-one.cmd; student-tests/failover.py; evidence/failover.txt и sequential_failover.json") + code( + pdf, + "# stop-one.sh\n" + "hostname=$(docker inspect -f '{{.Config.Hostname}}' \"$id\")\n" + "if [ \"$TARGET_INSTANCE_ID\" = \"$hostname\" ] || ...; then found=$id; fi\n" + "docker stop -t 5 \"$found\"", + ) + body( + pdf, + "После первого стопа restore-api.cmd поднимает вторую реплику. Повтор failover.py бьёт уже её. " + "Отдельно в отчёте docker stop второй: пишет оставшийся api, recovery почти 0, потому что касса уже на живом. " + "Показать docker compose ps — один Exited, второй healthy.", + ) + + h1(pdf, "5. Оценка 4") + + h2(pdf, "5.1. Health, таймауты, SIGTERM, период проверки") + speak( + pdf, + "Live — процесс существует. Ready — принимаем работу: accepting=True, SELECT 1 в Postgres, ping Redis. " + "HAProxy проверяет ready, не live: иначе труп без базы остался бы в круге. " + "Период проверок: inter 1s. Максимум обнаружения отказа: fall 2 → около 2 секунд; с DNS hold valid 2s верхняя оценка около 4 с. " + "SIGTERM: compose stop_signal SIGTERM, stop_grace_period 8s, uvicorn timeout_graceful_shutdown 5. " + "В finally lifespan accepting=False — ready и бизнес отдают 503, касса выкидывает бэкенд до убийства процесса.", + ) + show(pdf, "health.py; main.py lifespan; __main__.py uvicorn; compose stop_grace_period; haproxy inter/fall") + code( + pdf, + "# health.py ready\n" + "if not request.app.state.accepting: 503\n" + "SELECT 1; redis.ping()\n" + "\n" + "# main.py finally\n" + "app.state.accepting = False\n" + "\n" + "# middleware: если not accepting и путь не /health/live → 503", + ) + + h2(pdf, "5.2. По очереди обе реплики, RPS, идемпотентность параллельно") + body( + pdf, + "Цифры зачитать из REPORT / sequential_failover.json, не путать с 128 RPS трека 1 — другой клиент.", + ) + bullet(pdf, "stop той, что ответила: recovery 2.46 с, 91 успех / 2 ошибки, 6.07 RPS, окно 15 с.") + bullet(pdf, "restore + ещё раз: 2.74 с, 90/2, 6.00 RPS.") + bullet(pdf, "stop второй: ~0.03 с, 46/1, 3.83 RPS.") + bullet(pdf, "параллельный ключ: level3, 12 потоков, один id.") + + h2(pdf, "5.3. Лимиты, секреты, нет порта API") + speak( + pdf, + "У каждого сервиса deploy.resources.limits. api 0.50 CPU / 256M каждая. Секреты Docker: postgres_password " + "только postgres, database_url — migrate и api, cache_url только api. HAProxy паролей не видит. " + "Volume только postgres_data и redis_data — у api своего диска с чатами нет.", + ) + show(pdf, "compose.yaml secrets, volumes, deploy.resources, отсутствие ports у api, отсутствие container_name.") + + h2(pdf, "5.4. Rolling и миграции один раз") + speak( + pdf, + "Rolling не равен failover. Failover — убили живого. Rolling — сначала подняли нового, потом стопнули старого, " + "по одной штуке, под нагрузкой. Скрипт: scale N+1, wait, docker stop -t 5 старого, rm, вернуть scale N. " + "Замер: rolling.json, 1980 ok / 24 err (1.2%), оба старых instance id исчезли. Ненулевые ошибки на стыке DNS нормальны.", + ) + show(pdf, "scripts/rolling-update.sh; student-tests/rolling.py") + speak( + pdf, + "Миграции: сервис migrate, restart no, python -m app.migrate, API depends_on service_completed_successfully, " + "RUN_MIGRATIONS=0. API ждут schema_migrations. Совместимость: rolling одной версии API; схему заранее накатил migrate. " + "Не обещаем lab2 и lab3 одновременно. Ограничение честно: откат схемы не делали.", + ) + show(pdf, "compose.yaml service migrate; src/app/migrate.py pg_advisory_xact_lock; main.py wait_for_schema") + + h1(pdf, "6. Оценка 5 — трек 1") + + h2(pdf, "6.1. Речь 2–3 минуты") + speak( + pdf, + "Трек 1 — цена масштабирования. Гипотеза: при фиксированном суммарном CPU добавление реплик не ускоряет POST, " + "потому что режется CPU каждого процесса, а не потому что кончилась база. " + "Методика: один профиль, 8 closed-loop клиентов через HAProxy, прогрев 5 с, замер 20 с. " + "Серия A: всегда 1.0 CPU и 512 MiB на все API, реплик 1, 2, 4. " + "Серия B: всегда 2 реплики, CPU растёт 0.5 → 1 → 2 суммарно. " + "A: 128 → 107 → 69 RPS. Четыре реплики на том же ватте почти вдвое медленнее одной. Ошибок 0. " + "B: 49 → 105 → 221. Дали CPU — почти линейно. Значит запас по Postgres был. " + "Улучшение: bind [::1]:8080, иначе Windows localhost давал p50 две секунды.", + ) + + h2(pdf, "6.2. Где цифры") + show(pdf, "REPORT.md таблица; evidence/track1.json; графики track1_fixed_budget.svg и track1_growing_cpu.svg") + bullet(pdf, "fixed-1: 1×1.00 CPU, 128.1 RPS, p50 52 мс") + bullet(pdf, "fixed-2: 2×0.50, 107.5 RPS, p50 72 мс") + bullet(pdf, "fixed-4: 4×0.25, 69.3 RPS, p50 95 мс") + bullet(pdf, "grow-2×0.25: сумма 0.50 CPU, 49.1 RPS") + bullet(pdf, "grow-2×0.50: сумма 1.00, 105.5 RPS") + bullet(pdf, "grow-2×1.00: сумма 2.00, 221.0 RPS") + body( + pdf, + "Скрипт student-tests/track1.py: scale_api, docker update --cpus/--memory, run_load 8 потоков POST /messages. " + "Closed-loop: следующий запрос только после ответа, RPS ≈ 8 / среднее время.", + ) + + h2(pdf, "6.3. Saturation point — как не попасть") + warn( + pdf, + "В README написано «найдите saturation point БД/LB/пула». Классического плато этих трёх НЕТ. " + "Серия B ещё растёт до 221, postgres в docker stats доли процента, пул 10+10 на реплику, при 4 репликах до 80 " + "соединений при max_connections 100, ошибок 0. Мы НЕ дожали базу до потолка. Это дырка по букве задания. " + "Закрываем её честным текстом, не выдуманным «Postgres на 100%».", + ) + speak( + pdf, + "Искали насыщение Postgres, HAProxy и пула. На этом профиле они не насытились: stats пустые, при росте CPU " + "RPS ещё линейный. То, что видно: при фиксированном бюджете рост ЧИСЛА реплик перестаёт помогать и вредит — " + "это нарезка CPU API. Чтобы поймать плато базы, нужен более жёсткий профиль, его нет в evidence. " + "Это ограничение опыта, записано в конце REPORT.md.", + ) + body( + pdf, + "Где «показано» в работе: абзац под таблицей в REPORT.md и массивы docker_stats в track1.json " + "(имена postgres-1, lb-1, api-*). Отрицательный результат: они не bottleneck. " + "Не ищите слайд «база 100%» — его нет.", + ) + + h2(pdf, "6.4. Подтверждённое улучшение") + body( + pdf, + "Задание не требует конкретно IPv6. Требует одно измеренное до/после. В отчёте взяли вход. " + "Было только 127.0.0.1:8080. Windows localhost идёт в ::1, p50 ≈ 2 с, ≈1.9 RPS. " + "Добавили [::1]:8080. После: localhost 87.6 RPS p50 75 мс, 127.0.0.1 94.7 RPS. " + "Файлы: compose.yaml ports lb; evidence/load_localhost.json. " + "Это не «серия B». Серия B — обязательный второй опыт, не фикс.", + ) + + h2(pdf, "6.5. Ограничения трека, которые сами назвать первым") + bullet(pdf, "Один Docker-host. Отказ VM/ноутбука не переживается.") + bullet(pdf, "Один HAProxy, одна Postgres, один Redis — SPOF.") + bullet(pdf, "Closed-loop занижает абсолютный RPS; сравнивать отношения точек, не 128 с одногруппником.") + bullet(pdf, "docker stats --no-stream — кадр в конце, не среднее; не объяснять 24% vs 0.7% как «вторая не работала».") + bullet(pdf, "Две реплики для failover, не для скорости при 1 CPU. Это разные оси.") + bullet(pdf, "Гипотеза в исходнике track1.py чуть старая про Postgres; в JSON и REPORT исправлена — читать REPORT.") + + h1(pdf, "7. Живой сценарий защиты (чеклист)") + bullet(pdf, "Стенд уже up --scale api=2, ready 200.") + bullet(pdf, "docker compose ps — два api healthy без host-порта, lb 8080.") + bullet(pdf, "python student-tests/level3.py — две реплики + идемпотентность. Открыть level3.json.") + bullet(pdf, "По желанию: два curl GET /api/v1/users/me с одним Bearer — разные X-Instance-Id.") + bullet(pdf, "python student-tests/failover.py — не паниковать из-за 1–2 ошибок. Потом docker ps: один Exited.") + bullet(pdf, "scripts\\restore-api.cmd, второй failover или руками docker stop второго имени из ps.") + bullet(pdf, "Открыть REPORT таблицу трека 1 и два SVG. Произнести 128/107/69 и 49/105/221.") + bullet(pdf, "Если просят код HAProxy / идемпотентности / stop-one — разделы 4–5 этой методички.") + bullet(pdf, "Не гонять track1.py с нуля, если нет 15+ минут.") + + h1(pdf, "8. Примерные вопросы и ответы") + + qa( + pdf, + "Чем отказ процесса отличается от отказа узла?", + "Процесс — один контейнер api, docker stop. Второй api на том же host + общие Redis/Postgres живут. " + "Узел — вся ВМ/ноутбук/Docker Desktop: вместе падают LB, обе реплики, база. Это трек 2, мы его не заявляем.", + ) + qa( + pdf, + "Почему depends_on и healthcheck — не балансировщик?", + "depends_on решает порядок СТАРТА (сначала postgres healthy, потом api). Healthcheck Compose красит контейнер " + "healthy для --wait. Трафик клиентов они не делят. Делит HAProxy: у него свой httpchk и roundrobin. " + "Без LB клиент должен был бы сам знать два IP.", + ) + qa( + pdf, + "Какие POST можно повторять после timeout и что защищает Idempotency-Key?", + "Клиент не знает, записалось ли сообщение. Имеет право повторить ТОТ ЖЕ POST с ТЕМ ЖЕ ключом и тем же телом. " + "Сервер вернёт старый id. Другое тело с тем же ключом — 409, это уже другое сообщение, новый ключ. " + "Ключ обязателен только у POST сообщения. Регистрацию/чаты так не защищали.", + ) + qa( + pdf, + "Что сломается, если сессии в локальной памяти, а API станет больше?", + "Round-robin отправит следующий запрос на соседний процесс — токена там нет — 401. Sticky это запрещённый костыль: " + "убили «свою» реплику — сессия всё равно умерла. Поэтому Redis.", + ) + qa( + pdf, + "Зачем X-Instance-Id, если есть X-Request-Id?", + "Request-Id уникален на каждый хит даже на одном процессе. Им нельзя доказать две реплики и нельзя docker stop. " + "Instance-Id стабилен на жизнь процесса и равен hostname.", + ) + qa( + pdf, + "Как HAProxy выбирает первое или второе API?", + "Счётчик round-robin + кто проходит ready. «Второе вместо первого» — следующий слот, не баг. " + "Порядок слотов из DNS, не «api-1 важнее».", + ) + qa( + pdf, + "Период проверок и максимальное время обнаружения отказа?", + "inter 1s, fall 2 → типично ~2 с после 503/смерти. timeout check 1s. DNS hold valid 2s → верх ~4 с. " + "Измерили recovery 2.46 с. Бюджет курса 10 с.", + ) + qa( + pdf, + "Где генерируется Idempotency-Key?", + "На клиенте. В сервере генерации нет, иначе сервер не отличит повтор от нового. Тесты: uuid4 в tests/client.py " + "и student-tests/level3.py. Человек в чате ключ не печатает.", + ) + qa( + pdf, + "Почему 12 параллельных POST не делают 12 сообщений?", + "Оба API идут в одну таблицу. Замок advisory на время транзакции: второй ждёт и видит ключ первого. " + "UNIQUE на (user, method, path, key) — страховка. Тест test_concurrent_key.", + ) + qa( + pdf, + "Почему публичный live отвечает HAProxy?", + "Live входа = жива ли касса. Если live отдавать API, при мёртвом LB клиент не достучится, а при живом LB и мёртвых " + "API live всё равно можно отдать с кассы. Ready специально идёт на API.", + ) + qa( + pdf, + "Зачем два одинаковых контейнера, если трек 1 показал, что один быстрее?", + "Скорость при фиксированном 1 CPU и выживаемость — разные цели. Один толстый процесс быстрее на этом профиле. " + "Два нужны, чтобы docker stop одного не обнулил сервис. На защите развести оси.", + ) + qa( + pdf, + "Где saturation point БД/LB/пула?", + "Не найден как плато. Stats postgres/lb ≈0%, серия grow ещё линейна до 221 RPS, пул не упёрся. " + "Нашли другое: при фиксированном CPU рост реплик вреден. Классическое насыщение склада не показали — " + "ограничение профиля 8×20с. Так и написано в REPORT.", + ) + qa( + pdf, + "Почему не нулевые ошибки на failover/rolling?", + "Между SIGTERM и исключением из LB есть запросы в умирающий процесс. Курс это разрешает, если измеряли. " + "У нас единицы процентов, recovery секунды.", + ) + qa( + pdf, + "Миграции на каждой реплике?", + "Нет. Отдельный one-shot migrate, API RUN_MIGRATIONS=0. Иначе гонка CREATE TABLE.", + ) + qa( + pdf, + "Почему нет sticky?", + "Sticky прячет раздельное состояние. Задание прямо запрещает чинить им локальные сессии. " + "Состояние общее — прилипать незачем.", + ) + qa( + pdf, + "Что будет, если убить Postgres?", + "Все api станут unready (ping БД падает), HAProxy перестанет слать бизнес-трафик, сервис ляжет. " + "Две реплики API базу не спасают. Не заявлять обратное.", + ) + qa( + pdf, + "Что будет, если убить Redis?", + "Новые логины и проверка Bearer не работают (503). Старые сообщения в Postgres живы, но API без сессии их не отдаст. " + "Redis SPOF для аутентификации.", + ) + qa( + pdf, + "Closed-loop / coordinated omission?", + "Клиент ждёт ответа, медленные запросы уменьшают число попыток. Для сравнения 1/2/4 одним клиентом ок. " + "Это не абсолютный потолок стенда как open-loop.", + ) + qa( + pdf, + "Почему в stats одна реплика 24%, сосед 0.7%?", + "Один кадр docker stats в конце прогона, не интеграл за 20 с. Не строить на этом теорию. Смотреть RPS и лимиты.", + ) + qa( + pdf, + "Зачем [::1], это же не про реплики?", + "На Windows localhost ≠ 127.0.0.1. Без IPv6-bind измерение «через localhost» врало бы ~2 с на запрос. " + "Это подтверждённое улучшение входа, без него трек 1 на localhost не про API.", + ) + qa( + pdf, + "Можно ли сравнить ваш 128 RPS с чужим ноутбуком?", + "Нет. Курс: универсального проходного RPS нет. Сравнивают отношения на одной машине: 128:107:69.", + ) + qa( + pdf, + "workers uvicorn больше 1?", + "workers=1. Несколько воркеров в одном контейнере — уже не наш X-Instance-Id=hostname на всех. " + "Горизонталь — отдельные контейнеры.", + ) + qa( + pdf, + "Как stop-one понимает, кого убивать?", + "Тест передаёт TARGET_INSTANCE_ID = значение заголовка. Скрипт сравнивает с Hostname контейнера " + "(мы как раз кладём hostname в заголовок).", + ) + qa( + pdf, + "Rolling под нагрузкой зачем, если есть failover?", + "Обновление образа без «выключить всех». Сначала лишний здоровый, потом убрать старого. Иначе дыра на время сборки.", + ) + qa( + pdf, + "Совместимы ли миграции с работающей версией?", + "Additive: новая таблица ключей. Rolling гоняет одну версию API после migrate. Не заявляем blue-green двух схем.", + ) + qa( + pdf, + "Почему Postgres слушает 5433 на хосте, это же дырка?", + "Учебный отладочный bind на 127.0.0.1, не публикация API. Снаружи интернет не торчит. Можно признать упрощением.", + ) + qa( + pdf, + "Аргон2 и lab2?", + "Пароли как в lab2, Basic только на создание сессии, дальше Bearer. Это не тема lab3, но контракт сохранён.", + ) + qa( + pdf, + "Что в PR / отчёте ещё TODO?", + "В REPORT строка Commit/PR: TODO после публикации. Если PR не открыт — сказать как есть, не выдумывать номер.", + ) + + h1(pdf, "9. Мини-шпаргалка чисел") + bullet(pdf, "Реплики: 2. Вход: 8080. Ready LB: 1 с, fall 2, обнаружение ~2 с (верх ~4 с). Failover recovery ~2.5 с.") + bullet(pdf, "Grace: stop -t 5, uvicorn 5, compose 8 с.") + bullet(pdf, "TTL сессии 3600, ключа идемпотентности 86400.") + bullet(pdf, "Лимит api: 0.50 CPU / 256M. Трек1 fixed сумма всегда 1 CPU / 512M.") + bullet(pdf, "Трек1 RPS: 128 / 107 / 69 и 49 / 105 / 221. Ошибки 0.") + bullet(pdf, "IPv6 фикс: ~1.9 RPS → ~88 RPS на localhost.") + bullet(pdf, "Гонка: 12 POST, 1 message id. Rolling: ~1.2% ошибок.") + + h1(pdf, "10. Если что-то пойдёт не так на защите") + bullet(pdf, "Стенд не ready: docker compose ps, логи docker compose logs api --tail 80, часто migrate не прошёл или Docker Desktop спал.") + bullet(pdf, "Один instance id: реплика одна — compose up --scale api=2; или смотрите live вместо /users/me.") + bullet(pdf, "localhost тупит, 127.0.0.1 быстрый: проверяйте, что в compose есть [::1]:8080 и контейнер lb пересоздан.") + bullet(pdf, "failover не находит TARGET: instance id должен совпасть с hostname (inspect). Не сравнивать с load-balancer.") + bullet(pdf, "Не лезьте чинить публичные tests/ и contracts/ на глазах — это запрещено курсом.") + + pdf.ln(4) + body( + pdf, + "Конец методички. Источник цифр: REPORT.md и evidence/ на дату 2026-10-30. Если перегоните тесты — замените числа, " + "не зубрите старые. Код открывать из репозитория, не из памяти.", + ) + pdf.output(str(OUT)) + print("wrote", OUT) + + +if __name__ == "__main__": + build() diff --git a/scripts/render_track1_svg.py b/scripts/render_track1_svg.py new file mode 100644 index 00000000..3008d283 --- /dev/null +++ b/scripts/render_track1_svg.py @@ -0,0 +1,110 @@ +# -*- coding: utf-8 -*- +"""Перерисовать графики трека 1 из evidence/track1.json.""" +from __future__ import annotations + +import json +from pathlib import Path + +ROOT = Path(__file__).resolve().parents[1] +EVIDENCE = ROOT / "evidence" +JSON_PATH = EVIDENCE / "track1.json" + + +def bar_chart(path: Path, title: str, xlabel: str, bars: list[tuple[str, float]], color: str) -> None: + width, height = 820, 420 + left, right, top, bottom = 70, 790, 50, 350 + plot_w = right - left + plot_h = bottom - top + values = [v for _, v in bars] or [1.0] + ymax = max(values) * 1.15 if max(values) else 1.0 + n = len(bars) + gap = plot_w / n + bar_w = gap * 0.48 + ticks = 4 + lines = [ + f'', + '', + f'{_esc(title)}', + ] + for i in range(ticks + 1): + y = bottom - plot_h * i / ticks + val = ymax * i / ticks + lines.append(f'') + lines.append( + f'{val:.0f}' + ) + lines.append(f'') + lines.append(f'') + for i, (label, value) in enumerate(bars): + h = 0 if ymax <= 0 else plot_h * value / ymax + x = left + gap * i + (gap - bar_w) / 2 + y = bottom - h + lines.append(f'') + lines.append( + f'{value:.1f}' + ) + lines.append( + f'{_esc(label)}' + ) + lines.append( + f'{_esc(xlabel)}' + ) + lines.append( + f'successful RPS' + ) + lines.append("\n") + path.write_text("\n".join(lines), encoding="utf-8") + + +def _esc(text: str) -> str: + return text.replace("&", "&").replace("<", "<").replace(">", ">") + + +def rps(item: dict) -> float: + return float(item["successful_rps"] or 0) + + +def main() -> None: + data = json.loads(JSON_PATH.read_text(encoding="utf-8")) + scale = data.get("scale_out_own_cpu") or [] + half = [x for x in scale if abs(x["cpus_each"] - 0.5) < 1e-9] + full = [x for x in scale if abs(x["cpus_each"] - 1.0) < 1e-9] + if half: + bar_chart( + EVIDENCE / "track1_scale_out.svg", + "Each replica keeps 0.50 CPU (like another server)", + "Replicas; total CPU grows 0.5 → 1.0 → 2.0", + [(str(x["replicas"]), rps(x)) for x in half], + "#276749", + ) + elif full: + bar_chart( + EVIDENCE / "track1_scale_out.svg", + "Each replica keeps 1.0 CPU (like another server)", + "Replicas; total CPU grows with copies", + [(str(x["replicas"]), rps(x)) for x in full], + "#276749", + ) + fixed = data.get("fixed_total_budget") or [] + if fixed: + bar_chart( + EVIDENCE / "track1_fixed_budget.svg", + "Fixed total 1.0 CPU split across replicas", + "Replica count at the same total CPU", + [(str(x["replicas"]), rps(x)) for x in fixed], + "#c53030", + ) + growing = data.get("growing_resources") or [] + if growing: + bar_chart( + EVIDENCE / "track1_growing_cpu.svg", + "Two API replicas, growing CPU/RAM budget", + "Total CPU for two replicas", + [(("%.2f CPU" % x["total_cpu"]).replace(".", ","), rps(x)) for x in growing], + "#2c5282", + ) + print("wrote SVGs next to", JSON_PATH) + + +if __name__ == "__main__": + main() diff --git a/src/__init__.py b/src/__init__.py new file mode 100644 index 00000000..e69de29b diff --git a/src/app/api/health.py b/src/app/api/health.py index 8e61555a..77c7b21b 100644 --- a/src/app/api/health.py +++ b/src/app/api/health.py @@ -16,7 +16,11 @@ class HealthOut(BaseModel): @router.get("/health/live", response_model=HealthOut) -async def live() -> dict: +async def live(request: Request) -> dict: + # Для httpchk HAProxy: процесс принимает работу. Redis/Postgres здесь не смотрим, + # иначе при отказе Redis касса выкинет ВСЕ реплики и /users/me не сможет отдать 401. + if not getattr(request.app.state, "accepting", False): + raise AppError(503, "unavailable", "Сервер останавливается") return {"status": "ok"} diff --git a/src/app/crud/users.py b/src/app/crud/users.py index 884381fc..2e3d47fe 100644 --- a/src/app/crud/users.py +++ b/src/app/crud/users.py @@ -1,10 +1,13 @@ +import asyncio +import hashlib import re from uuid import UUID, uuid4 -from sqlalchemy import select +from sqlalchemy import select, text from sqlalchemy.exc import IntegrityError from app.db import map_integrity, session_scope +from app.errors import AppError from app.models import User from app.present import PublicUser from app.security import hash_password, verify_password @@ -26,14 +29,25 @@ async def get_user(user_id: UUID) -> PublicUser | None: return PublicUser(id=row.id, username=row.username, display_name=row.display_name, created_at=row.created_at) +def _username_lock(username: str) -> tuple[int, int]: + digest = hashlib.sha256(("register:" + username).encode("utf-8")).digest() + return int.from_bytes(digest[:4], "big", signed=True), int.from_bytes(digest[4:8], "big", signed=True) + + async def create_user(username: str, display_name: str, password: str) -> PublicUser: - # Argon2 считается до открытия транзакции, чтобы не держать соединение пула. - password_hash = hash_password(password) + # Argon2 в потоке: иначе 16 параллельных hash блокируют event loop, + # /health/ready не отвечает, HAProxy снимает реплику и клиент видит 503. + password_hash = await asyncio.to_thread(hash_password, password) user_id = uuid4() created_at = utcnow() + lock_a, lock_b = _username_lock(username) async with session_scope() as session: try: async with session.begin(): + await session.execute(text("SELECT pg_advisory_xact_lock(:a, :b)"), {"a": lock_a, "b": lock_b}) + taken = await session.scalar(select(User.id).where(User.username == username)) + if taken is not None: + raise AppError(409, "conflict", "Имя пользователя занято") session.add( User( id=user_id, @@ -51,7 +65,7 @@ async def create_user(username: str, display_name: str, password: str) -> Public async def authenticate(username: str, password: str) -> PublicUser | None: if _USERNAME.fullmatch(username) is None or not 12 <= len(password) <= 128: - verify_password("rejected-credential", None) + await asyncio.to_thread(verify_password, "rejected-credential", None) return None async with session_scope() as session: async with session.begin(): @@ -73,6 +87,6 @@ async def authenticate(username: str, password: str) -> PublicUser | None: display_name=row.display_name, created_at=row.created_at, ) - if not verify_password(password, stored): + if not await asyncio.to_thread(verify_password, password, stored): return None return snapshot diff --git a/student-tests/track1.py b/student-tests/track1.py index 6cb94f5b..3bcf8d5b 100644 --- a/student-tests/track1.py +++ b/student-tests/track1.py @@ -165,6 +165,15 @@ def measure(label, replicas, cpus_each, memory_mb_each): def main(): wait_ready() + # Как отдельные серверы: у каждой реплики СВОЙ CPU. Сумма растёт вместе с числом копий. + scale_out = [ + measure("scale-1x0.50", 1, 0.50, 256), + measure("scale-2x0.50", 2, 0.50, 256), + measure("scale-4x0.50", 4, 0.50, 256), + measure("scale-1x1.00", 1, 1.00, 512), + measure("scale-2x1.00", 2, 1.00, 512), + ] + # Требование README: тот же суммарный бюджет на 1/2/4 — это нарезка ОДНОГО хоста, не «новые серверы». fixed_budget = [ measure("fixed-1", 1, 1.00, 512), measure("fixed-2", 2, 0.50, 256), @@ -179,19 +188,25 @@ def main(): apply_limits(0.50, 256) report = { "date": time.strftime("%Y-%m-%dT%H:%M:%SZ", time.gmtime()), - "hypothesis": "При фиксированном суммарном CPU/RAM добавление реплик перестаёт помогать, когда узким местом становится PostgreSQL/HAProxy, а не CPU процесса API.", + "hypothesis": ( + "Горизонтальное масштабирование ускоряет POST, когда каждая новая реплика приносит СВОЙ CPU " + "(как ещё один сервер). Нарезка одного и того же суммарного CPU на больше копий на одном хосте " + "не масштабирование: RPS не растёт. Потолок тогда ищется у БД/LB/пула на серии с ростом суммарного бюджета." + ), "profile": { "duration_seconds": DURATION, "concurrency": CONCURRENCY, "warmup_seconds": WARMUP, "workload": "closed-loop POST /messages through HAProxy", }, + "scale_out_own_cpu": scale_out, "fixed_total_budget": fixed_budget, "growing_resources": growing, } EVIDENCE.mkdir(exist_ok=True) (EVIDENCE / "track1.json").write_text(json.dumps(report, ensure_ascii=False, indent=2) + "\n", encoding="utf-8") - check(all(item["successful_requests"] > 0 for item in fixed_budget + growing), "a track1 series had no successes") + series = scale_out + fixed_budget + growing + check(all(item["successful_requests"] > 0 for item in series), "a track1 series had no successes") print("PASS: track1 series written to evidence/track1.json")