Files
mtusi2026lab3/docs/DEFENSE.md
T

24 lines
4.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Короткий сценарий защиты
1. Открыть `REPORT.md`: цель — оценка 4. Показать `compose.yaml`: две реплики одного сервиса `api`, общие PostgreSQL/Redis, только один published port у `lb`, лимиты ресурсов.
2. Выполнить `docker compose ps`. Показать, что ID из `X-Instance-Id` относятся к разным контейнерам. Одна Bearer-сессия работает через обе реплики без повторного входа.
3. Выполнить `docker compose run --rm --no-deps checks make test`. Показать регистрацию, чат, сообщения, пагинацию и проверки доступа.
4. Выполнить `docker compose run --rm --no-deps checks make test-student`. В `evidence/idempotency.json` — 100 запросов с одним ключом, две реальные реплики и одно сообщение. В тестах также проверяется откат ошибки после INSERT сообщения.
5. Выполнить `docker compose run --rm --no-deps checks sh -ec 'chmod +x scripts/stop-one.sh; make test-failover ACTION_SCRIPT=scripts/stop-one.sh'`. Показать `evidence/last-stop.json` и остановленный контейнер в `docker compose ps --all`. Затем восстановить: `docker compose start api`.
6. Показать результаты отказа каждой реплики и замены под нагрузкой: `evidence/experiments.json`, подробности `failure-api-1.json`, `failure-api-2.json`, `rolling-update.json`. В каждом есть RPS, ошибки, latency и сверка подтверждённых сообщений.
7. Показать полный restart: `evidence/persistence.txt` и `restart.json`. Прежние токены и данные сохраняются; перезапущены API, PostgreSQL, Redis и LB, volumes те же.
## Что объяснить
- **Почему две реплики взаимозаменяемы?** Пользователи/сообщения находятся в PostgreSQL, сессии — в общем Redis; ключ cursor общий. В памяти API нет состояния, необходимого для следующего запроса.
- **Почему одного healthcheck Docker недостаточно?** Он отмечает состояние контейнера. Исключать backend из HTTP-маршрутизации должен балансировщик; HAProxy сам проверяет readiness.
- **Что будет при timeout POST?** COMMIT мог уже завершиться. Повторяем прежний ключ и тело: получаем то же сообщение. Новый ключ может создать новое сообщение.
- **Почему нет дублей при двух одновременных запросах?** Реплики используют одну транзакционную блокировку строки чата, а сообщение и запись результата фиксируются атомарно. PK дополнительно ограничивает ключ.
- **Что означает 409?** Действующий ключ уже был использован для другого текста. Клиенту нужно проверить свою логику повторов.
- **Зачем AOF, если есть TTL?** TTL задаёт срок действия, а AOF сохраняет сессии после рестарта Redis.
- **Почему нельзя говорить об отказоустойчивости всего сервиса?** БД, Redis, LB и host здесь одиночные. Проверен отказ API-процесса, а не потеря любого узла.
- **Чем последовательная замена отличается от остановки всего сервиса?** Одна реплика выводится из балансировки, завершается и заменяется, пока другая обслуживает клиентов. Затем роли меняются.
- **Что ограничивает масштабирование?** БД и Redis остаются общими, запись в один чат сериализуется. Добавление API не убирает эти ограничения.
Перед повтором экспериментов нужны работающий Docker и свободный опубликованный порт. Все тесты создают синтетические данные. Команды `down --volumes` для демонстрации отказа не применяются.