6.7 KiB
Лабораторная 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.