Files
mtusi2026lab3/RUNBOOK.md
T

6.7 KiB
Raw Blame History

Лабораторная 3 — запуск и защита

Работать из mtusi2026lab3. Папки лабораторных 1 и 2 не нужны для запуска. Требования: Docker с Linux-контейнерами и Compose v2+, Python 3.9+. Go установлен внутри Dockerfile; локальная установка Go не требуется.

Запуск

python -X utf8 scripts/bootstrap.py
docker compose --env-file .env config --quiet
docker compose --env-file .env up -d --build --wait
python -X utf8 scripts/wait_ready.py --base-url http://127.0.0.1:8083
python -X utf8 tests/smoke.py --base-url http://127.0.0.1:8083

Единственный публичный адрес — http://127.0.0.1:8083. Выбраны отдельные имена Compose-проекта, сетей и volumes, чтобы сохранять работающий стенд lab2 на 8080. API, PostgreSQL и Redis не публикуют host-порты. В .env можно выбрать другой HOST_PORT; тогда его надо передать публичным тестам.

.env и secrets/ создаются локально, повторный bootstrap сохраняет пароль. Не копировать их из lab2. Не менять пароль при существующем volume: PostgreSQL использует initial password только при первой инициализации.

Все проверки

python -X utf8 student-tests/verify.py

Сценарий запускает публичные offline/smoke/persistence/failover, собственные проверки конкурентных запросов, поочерёдную остановку каждой реплики, SIGKILL, замену контейнеров и отказ Redis. В конце остаются две работающие реплики. Выводы сохраняются в evidence/checks/, реальные операции — в evidence/actions/, сводки — в evidence/verification.json и evidence/resilience-summary.json. Тесты создают только синтетические данные.

Отдельные публичные сценарии в Windows / PowerShell:

python -X utf8 tests/resilience.py --mode persistence --action-script scripts/restart.cmd --base-url http://127.0.0.1:8083
python -X utf8 tests/resilience.py --mode failover --action-script scripts/stop-one.cmd --base-url http://127.0.0.1:8083
python -X utf8 scripts/actions.py restore

На Linux:

chmod +x scripts/restart.sh scripts/stop-one.sh scripts/rolling-update.sh
make check test PYTHON=python3 BASE_URL=http://127.0.0.1:8083
make test-persistence PYTHON=python3 BASE_URL=http://127.0.0.1:8083 ACTION_SCRIPT=scripts/restart.sh
make test-failover PYTHON=python3 BASE_URL=http://127.0.0.1:8083 ACTION_SCRIPT=scripts/stop-one.sh
python3 scripts/actions.py restore

Hook остановки получает TARGET_INSTANCE_ID, сверяет его с hostname реального контейнера и дополнительно фильтрует Compose labels mtusi-lab3 / api. Реплика остаётся остановленной. Скрипт не действует на другие проекты.

Замена под нагрузкой

python -X utf8 student-tests/resilience_load.py выполняет эту проверку автоматически. Для самостоятельной демонстрации в двух терминалах:

# Терминал 1: запросы идут через балансировщик.
python -X utf8 student-tests/benchmark.py --label manual-rolling --duration 60 --concurrency 16
# Терминал 2: собрать образ и заменить процессы по одному.
docker compose --env-file .env build api
python -X utf8 scripts/actions.py rolling

Сначала запускается новая третья реплика и наблюдается через LB, затем старая получает SIGTERM и удаляется. Операция повторяется для второй старой реплики. Одновременная недоступность всех API не требуется. Это эквивалент поочерёдной замены в Compose, а не обещание поддержки Swarm update_config.

Миграции выполняет один job migrate; API только сверяют уже применённые checksums. Для будущего обновления схемы сначала выполняется docker compose run --rm migrate, затем rolling replacement. Нынешняя 002_idempotency.sql добавляет новую таблицу и индекс. Удаляющие/несовместимые изменения схемы таким способом не поддерживаются: нужны expand/contract этапы. Нельзя смешивать lab2 API без Idempotency-Key с API lab3 за одним LB.

Эксперимент на 5

python -X utf8 student-tests/research.py --duration 20 --repeats 3

Это последовательный эксперимент: не запускать одновременно другие тесты или ручные воздействия. Скрипт меняет только контейнеры проекта lab3, в конце возвращает стандартные две реплики, лимиты и включённый общий кэш чата. Он не удаляет volumes и сообщения. Используется отдельный Go-генератор loadgen с persistent HTTP connections, 32 конкурентными запросами, чтением истории/записью в пропорции 80/20; каждый запуск начинает новый чат с 1000 сообщений. Сырые результаты: evidence/runs/; сводка: evidence/research.json.

Графики воспроизводятся отдельно; matplotlib не нужен серверу и тестам:

python -m pip install -r requirements-research.txt
python -X utf8 student-tests/plot_results.py

Остановка

docker compose --env-file .env down

Данные сохраняются в named volumes. docker compose down --volumes — отдельная команда намеренного удаления всех учебных данных lab3; в тестах её нет.

Подробное объяснение решений и фактические измерения — в REPORT.md.