16 KiB
Отчёт — лабораторная 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 и отказ узла не заявлены.
- Compose services.
- Nginx upstream.
- Nginx proxy.
- Uvicorn shutdown.
- Контракт и публичные тесты репозитория, собственная реализация lab2.