Files
mtusi2026lab3/REPORT.md
T
2026-10-23 15:36:38 +03:00

16 KiB
Raw Blame History

Отчёт — лабораторная 3

  • Автор, группа: Ромашко Владимир, БВТ2301.
  • Целевая оценка: 4, Docker Compose + nginx.
  • Проверка: 23 октября 2026 года.
  • Основа lab2 зафиксирована отдельным коммитом cd9c340.
  • Использован Codex для реализации и проверок. Треки оценки 5 не заявлены.

Запуск

Нужны Docker Engine/Desktop с Compose v2 и Python 3.9+ на хосте. Приложение работает на Python 3.12.8 в контейнере.

Copy-Item .env.example .env
# Задать в .env случайный локальный POSTGRES_PASSWORD.
docker compose --env-file .env config --quiet
docker compose --env-file .env up -d --build --wait --wait-timeout 120
python -X utf8 scripts/verify_lab3.py
docker compose exec -T api python -m unittest discover -s student-tests -v

verify_lab3.py проверяет контракт, smoke, конкурентные повторы, полный restart, отказ каждой API и поочерёдную замену под нагрузкой. Скрипт останавливает контейнеры только этого проекта и восстанавливает реплики; volumes сохраняются. Запускать без одновременного ручного управления стендом. Результаты пишутся в evidence/.

На Linux: cp .env.example .env, задать пароль, затем те же Docker-команды и python3 scripts/verify_lab3.py. Перед тестами:

chmod +x scripts/restart.sh scripts/stop-one.sh
make check
make test
make test-persistence ACTION_SCRIPT=scripts/restart.sh
make test-failover ACTION_SCRIPT=scripts/stop-one.sh
# Восстановить реплику после отдельного failover:
docker compose up -d --no-deps --no-recreate api

Windows-варианты отдельных проверок:

python -X utf8 scripts/check_contract.py
python -X utf8 tests/smoke.py
python -X utf8 tests/resilience.py --mode persistence --action-script scripts/restart.cmd
python -X utf8 tests/resilience.py --mode failover --action-script scripts/stop-one.cmd
docker compose up -d --no-deps --no-recreate api

На Windows make отсутствует: выполнены те же Python-команды, которые вызывают цели Makefile. -X utf8 нужен публичным скриптам для чтения файлов с русским текстом. Контракт, публичные tests, Makefile и README задания не менялись.

Остановка с сохранением данных: docker compose down. Намеренное удаление всех учебных данных проекта: docker compose down -v. При проверках volumes не удалялись. Исходный проект lab2 не изменялся.

Архитектура

Клиент → 127.0.0.1:8080 nginx → один Compose-service api с двумя репликами → общие PostgreSQL и Redis. У API нет опубликованных портов и container_name. Sticky sessions нет. X-Instance-Id — hostname контейнера; его соответствие реальному процессу проверяется через Docker. В каждом контейнере один Uvicorn worker.

Из lab2 сохранены пользователи, чаты, сообщения, Argon2id, Redis-сессии с TTL, миграции и кэш страниц истории. PostgreSQL — источник истины данных и ключей идемпотентности. Redis хранит сессии с абсолютным expiry и AOF appendfsync always. Кэш истории использует версию из PostgreSQL: после записи другая реплика не читает старую версию страницы. Локального состояния сессий в API нет.

Пароль хранится в игнорируемом .env. Он передаётся PostgreSQL, API и migrator. Nginx не получает пароль. Volumes монтируются только соответствующему хранилищу. API и хранилища находятся во внутренней сети backend, nginx также подключён к edge.

Сервис Образ CPU RAM
API, каждая реплика python:3.12.8-slim-bookworm + requirements.txt 1 512 MiB
migrate, одноразовый тот же образ приложения 1 512 MiB
nginx nginx:1.28.0-alpine 0,5 128 MiB
PostgreSQL postgres:17.4-bookworm 1 512 MiB
Redis redis:7.4.2-bookworm 0,5 256 MiB

.env.example сохранён из lab2. APP_PORT меняет внешний порт nginx (тестам тогда нужен --base-url); остальные используемые настройки — БД, TTL и лимиты запросов. API внутри контейнера слушает 0.0.0.0:8080 независимо от APP_HOST в локальном .env. В Compose заданы две реплики и образ mtusi2026lab3-api:local.

Идемпотентность

POST сообщения требует ключ [A-Za-z0-9._:-]{1,128}. Область ключа: пользователь + POST messages конкретного чата + ключ. Сначала проверяются сессия и доступ. SELECT FOR UPDATE блокирует строку чата до поиска сохранённого результата. Записи в один чат выполняются последовательно; разные чаты не блокируют друг друга. Та же строка уже обновляется для инвалидации кэша, отдельный механизм блокировок не нужен.

Сообщение, увеличение версии истории и запись ключа сохраняются одной транзакцией. После COMMIT возвращается 201. Повтор возвращает тот же Message и 201, другое тело — 409. Сбой до COMMIT откатывает всё; неопределённый ответ после COMMIT можно повторить. 5xx не сохраняется как результат. Сравнивается значение text, а не JSON-байты.

Ключи хранятся бессрочно, что обеспечивает обязательные 24 часа повторов. Очистка не реализована: таблица растёт, использовать старый ключ для нового тела нельзя.

Health, DNS и остановка

  • /health/live проверяет процесс; /health/ready — PostgreSQL SELECT 1 и Redis PING. Обе зависимости критичны для защищённых запросов.
  • Docker healthcheck API: каждые 2 с, timeout 2 с, 2 неудачи, стартовый период 5 с. После стартового периода верхняя оценка отметки unhealthy — 8 с. Эта отметка сама по себе не управляет nginx.
  • Nginx исключает backend пассивно: max_fails=1, fail_timeout=2s. Учитываются сетевые ошибки, timeout, 502/503/504. При запросах connect-отказ обнаруживается за ≤1 с, отсутствие ответа — за ≤6 с. Без трафика пассивная проверка не имеет предельного времени обнаружения. Ошибки переходного периода допустимы.
  • Nginx использует Docker DNS 127.0.0.11, valid=2s, resolver timeout 1 с, server api:8080 resolve. Новые адреса появляются без reload nginx.
  • GET может перейти на второй backend: до 2 попыток. Бюджет выбора следующей попытки — 8 с, это не абсолютный deadline всего запроса. Уже отправленный POST автоматически не повторяется; клиент повторяет сообщение с прежним ключом.
  • PostgreSQL: connect 2 с, pool wait 2 с, statement 3 с, lock 2 с; pool до 10/API. Redis: connect/read по 1 с. Это таймауты отдельных операций.
  • Uvicorn получает SIGTERM как PID 1, прекращает приём соединений и даёт активным запросам до 5 с. Compose ждёт 10 с, action script — 8 с до SIGKILL.

Миграции и поочерёдная замена

Отдельный сервис migrate применяет SQL перед запуском API. Startup API миграций не выполняет. Реестр версий и перенесённая из lab2 блокировка миграций позволяют безопасно повторять запуск. Миграция 003 только добавляет таблицу ключей.

python -X utf8 scripts/rolling.py собирает образ, один раз запускает migrator, затем заменяет API по одной: stop выбранного контейнера, удаление только этого остановленного контейнера, compose up --no-recreate --scale api=2, ожидание health и 3 с на DNS. Соседняя реплика продолжает работать; volumes не удаляются.

Проверена замена контейнеров текущей версии под нагрузкой. Смешанный переход lab2→lab3 не поддерживается: lab2 ещё не обеспечивает ключи и X-Instance-Id. Несовместимые будущие изменения схемы потребуют отдельного порядка обновления.

Результаты

Среда: Docker Desktop Linux x86_64, Engine 28.5.1, Compose 2.40.0; Docker VM — 8 CPU и 8 328 015 872 байт RAM. Данные синтетические, токены не сохраняются.

Нагрузка: 2 клиента, каждый пишет сообщение, читает чат, ждёт 20 мс. До воздействия 3 с, весь сценарий минимум 20 с и минимум 5 с после завершения воздействия. После него сверяется вся история, подтверждения и отсутствие дублей; повторяется прежний ключ. RPS — успешные HTTP-ответы, latency — только успешные запросы. Один прогон на воздействие, closed-loop нагрузка: это не предел производительности. Время восстановления считается от начала action до первого успешного read/write после его завершения, включая время Docker CLI.

Проверка Результат Доказательство
Контракт и smoke через nginx PASS check.txt, final-smoke.txt
Регрессия lab2, миграции, rollback и гонка разных тел 15 тестов OK unit-tests.txt
Один ключ через разные API 24 запроса, concurrency 8, 2 реплики, 1 сообщение idempotency.json
Restart API, LB, PostgreSQL и Redis Прежняя сессия, сообщения и результат ключа сохранены persistence.txt, restart.txt, idempotency-restart.json
Публичный failover, два запуска с восстановлением PASS, по 124 записи, 0 ошибок; 2,204 / 2,233 с Первый, второй
Отдельно остановлена каждая API PASS, прежняя сессия, потерь и дублей нет failover-1.json, failover-2.json
Поочерёдная замена под нагрузкой Обе исходные API заменены, 0 ошибок, данные сохранены rolling-load.json, включая снимки контейнеров
Nginx, health, DNS, SIGTERM, лимиты и порты Nginx config OK; остановленные ID исчезают, новые появляются; обе API healthy, порт только у LB nginx-check.txt, final-containers.json
Отдельные миграции 001/002/003 применяются повторно без дублирования; чистая схема проверена unit-tests.txt, compose.yaml
Воздействие HTTP/с Записей/с Ошибок p50 / p95 / p99, мс Первые read / write после stop, с
Stop 6fc32ef53bc9 61.9 30.95 0 18.0 / 52.71 / 71.25 2.466 / 2.458
Stop a6ee3d7e3779 65.84 32.92 0 16.38 / 48.29 / 70.66 2.409 / 2.397
Замена обеих API 62.91 31.45 0 16.51 / 48.68 / 75.14 Запросы продолжались всю замену

Замена заняла 29.127 с, включая ожидание health и DNS. Это длительность операции, не простой API. Максимальный интервал между успешными ответами: read 0.216 с, write 0.231 с. Полная сводка: grade4-summary.json.

Сохраняются сводки измерений, ошибки и снимки реальных контейнеров, без тысяч отдельных сообщений. Доказательство исходного переноса: baseline-lab2.txt.

Ограничения и источники

Выдерживается отказ одной API при работающей соседней и общих зависимостях. Nginx, PostgreSQL, Redis и Docker-host остаются единичными точками отказа. HTTP предназначен для локального учебного стенда. Создание пользователей/чатов не имеет гарантии идемпотентного повтора. Уровень 5 и отказ узла не заявлены.