Update Lab 3 report

This commit is contained in:
2026-11-13 00:45:56 +03:00
parent db070826c0
commit 0bea93922e
+36 -15
View File
@@ -1,10 +1,9 @@
# Отчёт по лабораторной работе 3 — балансировка реплик мессенджера
- Автор / группа: Badradine Ali / BVT2302
- Автор / группа: Бадрадин Али / БВТ2302
- Целевая оценка: 4 (выполнены требования на оценки 3 и 4)
- Исследовательский трек на оценку 5: не заявлен
- Исходный проект ЛР 2: Badradine/mtusi2026lab2, ветка master, коммит 39277c14677fe8b3f362022af069d4e7a68f8158
- Коммит / запрос на слияние: заполнить после коммита и открытия PR для ЛР 3
- Источники и помощь: спецификация Docker Compose Deploy; документация NGINX по upstream и proxy; требования и публичные тесты ЛР 3; помощь OpenAI Codex при реализации и проверке. Студент должен понимать и уметь защитить принятые решения.
## Клонирование и запуск с нуля
@@ -27,34 +26,52 @@ docker compose --env-file .env ps
В WSL, находясь в каталоге репозитория, сначала разрешите запуск служебных скриптов: chmod +x scripts/*.sh. Затем выполните:
~~~sh
--sh
make check
make validate
make test BASE_URL=http://localhost:8080
make test-idempotency BASE_URL=http://localhost:8080
make test-persistence ACTION_SCRIPT=scripts/restart.sh BASE_URL=http://localhost:8080
~~~
--
Для полной проверки OpenAPI установите dev-зависимости в WSL и укажите Python из виртуального окружения:
---sh
python3 -m venv .venv
.venv/bin/python -m pip install -r requirements-dev.txt
make validate PYTHON=.venv/bin/python
--
Чтобы проверить переключение при параллельной записи, выполните проверку дважды, восстанавливая остановленную реплику между запусками. Учитывайте оба запуска только если в evidence/stopped-replicas.txt указаны два разных ID экземпляров:
~~~sh
bash scripts/verify-failover.sh replica-run-1
--sh
make test-failover ACTION_SCRIPT=scripts/stop-one.sh BASE_URL=http://localhost:8080
bash scripts/recover-api.sh
make test-failover ACTION_SCRIPT=scripts/stop-one.sh BASE_URL=http://localhost:8080
--
Для одновременного сбора 40-секундных метрик нагрузки и проверки отказа использовалась оболочка:
--sh
bash scripts/verify-failover.sh replica-run-2
~~~
bash scripts/verify-failover.sh replica-run-3
--
Каждый запуск `verify-failover.sh` сначала восстанавливает две API-реплики, затем запускает 40-секундную нагрузку и проверку отказа. Между зачтёнными запусками были остановлены разные экземпляры; их ID сверены с `evidence/stopped-replicas.txt`.
Чтобы проверить последовательную замену реплик во время генерации нагрузки:
~~~sh
--sh
make test-rolling
~~~
--
Служебные скрипты сохраняют тома. Команда docker compose down останавливает стек, не удаляя данные. Удаляйте тома только если намеренно хотите стереть локальные данные лабораторной работы.
## Архитектура и принятые решения
~~~text
--text
Клиент -> NGINX :8080 -> 2 реплики API -> общие PostgreSQL и Redis
~~~
--
В проект перенесена реализация ЛР 2 из актуальной ветки Gitea: хеши паролей Argon2id, вход Basic, непрозрачные Bearer-сессии в Redis, пользователи/чаты/участники/сообщения в PostgreSQL, постраничная навигация по ключу, ограниченные пулы и тайм-ауты, версионированные миграции. В ЛР 3 добавлена общая таблица результатов идемпотентности без изменения прежних таблиц и конечных точек API.
@@ -77,13 +94,17 @@ NGINX распределяет запросы по алгоритму round-robi
| Публичный контракт API, включая конечные точки ЛР 2 | python tests/smoke.py --base-url http://localhost:8080 | PASS после последнего перезапуска с проверкой сохранности данных; все сервисы работоспособны | evidence/smoke.txt |
| Две реплики и параллельные POST одного сообщения с одинаковым ключом | python tests/idempotency_concurrency.py --base-url http://localhost:8080 | PASS: 24 запроса, 12 рабочих потоков, обнаружены 2 реплики, один ID сообщения и одна сохранённая копия | evidence/idempotency.txt |
| Сохранность данных после перезапуска API, Redis и PostgreSQL | python3 tests/resilience.py --mode persistence --action-script scripts/restart.sh --base-url http://localhost:8080 | PASS: подтверждённое сообщение и существующая сессия остались доступны; ручной перезапуск записан в журнал | evidence/persistence.txt, evidence/persistence-hook.log |
| Переключение с реплики 46c9e552d0a0 | bash scripts/verify-failover.sh replica-run-2 | PASS: 51 успешная запись в сценарии, 0 неудачных попыток, первое восстановление за 1,897 с. Параллельная нагрузка: 1 123 успешных / 0 неудачных запроса, 27,902 успешного запроса/с, p50 109,335 мс, p95 380,847 мс, p99 509,395 мс | evidence/failover-replica-run-2.log, evidence/failover-replica-run-2-load.json, evidence/stopped-replicas.txt |
| Переключение с реплики 3375d99fba8b | bash scripts/verify-failover.sh replica-run-3 (первый запуск с другим ID экземпляра) | PASS: 50 успешных записей в сценарии, 0 неудачных попыток, первое восстановление за 1,955 с. Параллельная нагрузка: 1 162 успешных / 0 неудачных запроса, 28,919 успешного запроса/с, p50 107,255 мс, p95 352,709 мс, p99 439,816 мс | evidence/failover-distinct-3375.log, evidence/failover-distinct-3375-load.json, evidence/stopped-replicas.txt |
| Переключение с реплики `46c9e552d0a0` | `bash scripts/verify-failover.sh replica-run-2` | PASS: 51 подтверждённая запись в сценарии, 0 неудачных попыток, первое восстановление за 1,897 с. Параллельная нагрузка: 1 123 успешных / 0 неудачных запросов, 27,902 успешного запроса/с, p50 109,335 мс, p95 380,847 мс, p99 509,395 мс | `evidence/failover-replica-run-2.log`, `evidence/failover-replica-run-2-load.json`, `evidence/stopped-replicas.txt` |
| Переключение с другой реплики `3375d99fba8b` | `bash scripts/verify-failover.sh replica-run-3` | PASS: 50 подтверждённых записей в сценарии, 0 неудачных попыток, первое восстановление за 1,955 с. Параллельная нагрузка: 1 162 успешных / 0 неудачных запросов, 28,919 успешного запроса/с, p50 107,255 мс, p95 352,709 мс, p99 439,816 мс | `evidence/failover-distinct-3375.log`, `evidence/failover-distinct-3375-load.json`, `evidence/stopped-replicas.txt` |
| Последовательная замена реплик под нагрузкой | bash scripts/verify-rolling.sh (последний запуск) | PASS: старые контейнеры API заменены по одному; 2 новые реплики работоспособны (revision=roll-20261110095038). Нагрузка 60,079 с: 2 881 успешный / 2 неудачных запроса, 0,0694% ошибок, 47,953 успешного запроса/с, p50 83,439 мс, p95 198,871 мс, p99 289,461 мс | evidence/rolling-update.log, evidence/rolling-update-load.json |
| Внутренние порты API, локальная точка входа и ограничения ресурсов | docker compose config и проверка запущенных сервисов | PASS: только LB публикует 127.0.0.1:8080; порты API доступны только внутри сети; для каждого сервиса заданы ограничения CPU и памяти | evidence/runtime-config.txt |
| Проверки структуры без запуска, smoke-тест и OpenAPI | make check, make test, validate_openapi.py, docker compose config --quiet | PASS в WSL/Ubuntu и PowerShell | evidence/make-check.log, evidence/make-test.log, evidence/implementation-checks.txt |
| Структура, публичный smoke-тест, OpenAPI и конфигурация Compose | `make check`; `make test BASE_URL=http://localhost:8080`; `make validate PYTHON=.venv/bin/python`; `docker compose --env-file .env config --quiet` | PASS в WSL/Ubuntu и PowerShell | `evidence/make-check.log`, `evidence/make-test.log`, `evidence/implementation-checks.txt` |
Результаты переключения с разными экземплярами — это более ранние запуски для ID 46c9e552d0a0 и 3375d99fba8b, записанные в evidence/stopped-replicas.txt соответственно в 2026-11-06T21:35:34Z и 2026-11-06T21:38:58Z. Поздние повторные запуски после последовательной замены выбрали экземпляр 74e4faa7a0f1 дважды; они сохранены в файлах запусков 1 и 3, но не считаются подтверждением переключения между двумя разными репликами.
Два измеряемых запуска, зачтённых в таблице, остановили разные экземпляры: `46c9e552d0a0` (2026-11-06T21:35:34Z) и `3375d99fba8b` (2026-11-06T21:38:58Z). В более поздних записях `evidence/stopped-replicas.txt` также есть дополнительные остановки с ID `2f298bdf21b0`, `3895110fa377` и `80747c6466aa`; они не подменяют измерения, связанные с двумя подробными наборами нагрузки выше. Повторные запуски, где остановился один и тот же ID `74e4faa7a0f1`, не засчитываются как проверка обеих реплик.
Одна предварительная попытка, `evidence/failover-failover-2.log`, завершилась до проверки отказа: тест не увидел две реплики. Она не засчитана. После пересоздания NGINX были проверены две реплики за балансировщиком; успешный дополнительный запуск сохранён в `evidence/failover-rr-after-lb-recreate.log` и `evidence/failover-rr-after-lb-recreate-load.json`.
Дополнительно позднее был выполнен официальный target `make test-failover ACTION_SCRIPT=scripts/stop-one.sh BASE_URL=http://localhost:8080`: PASS, 101 подтверждённая запись, 0 неудачных попыток, первое восстановление за 2,295 с. Сразу после hook команда `docker compose --env-file .env ps -a` показала остановленную реплику `api-10` и оставшуюся healthy `api-9`; после `bash scripts/recover-api.sh` обе реплики снова были healthy. Этот запуск подтверждает сам сценарий Make, но не используется для RPS в таблице, так как отдельная нагрузка вместе с ним не сохранялась.
Последняя проверка последовательной замены завершилась с двумя работоспособными репликами; параллельная нагрузка зафиксировала 2 881 успешный и два неудачных запроса. Результат приведён без исключений. Генератор нагрузки работает по замкнутому циклу с параллелизмом 4; это небольшая демонстрация, а не проверка производительности для промышленной эксплуатации. Процентили рассчитаны только по успешным запросам.