Files
mtusi2026lab3/REPORT.md
T

8.5 KiB
Raw Blame History

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

  • Автор: Самохвалов Андрей Ремович, БПИ-2302.
  • Цель: оценка 5, трек 1 (цена масштабирования). Уровень 4 и исследование трека дополняются следующими блоками.
  • Ветка: solution/bpi2302-samohvalov; commit/PR после публикации.
  • Источники: README.md, COURSE.md, contracts/, публичные тесты репозитория, HAProxy 3.0 configuration, Docker Compose services. Код и текст подготовлены с помощью Codex; результаты ниже получены реальным запуском.

Запуск из чистого clone

Нужны Docker с Compose, Python 3.9+ и make. Dockerfile собирает исходники в python:3.12.12-slim-bookworm; БД — postgres:17.6-bookworm, балансировщик — haproxy:3.0.11-alpine. Python-пакеты закреплены в requirements.txt. Стенд рассчитан на localhost и синтетические данные.

cp .env.example .env
mkdir -p secrets
python3 - <<'PY'
from pathlib import Path
from secrets import token_urlsafe
password = token_urlsafe(32)
Path('secrets/postgres_password').write_text(password)
Path('secrets/database_url').write_text(f'postgresql://messenger:{password}@postgres:5432/messenger')
PY
chmod 600 .env secrets/*
docker compose --env-file .env config --quiet
docker compose --env-file .env up -d --build --wait --scale api=2
make check
make test
make test-persistence ACTION_SCRIPT=scripts/restart.sh
make test-failover ACTION_SCRIPT=scripts/stop-one.sh
docker compose --env-file .env up -d --wait --scale api=2 # восстановить остановленную реплику

Для повторного failover после восстановления балансировщик должен обслуживать обе реплики; повторите команду и сверьте, какой контейнер остановлен. docker compose --env-file .env ps -a показывает реальный процесс. migrate — одноразовый сервис, который под advisory lock применяет SQL-миграции до запуска API; повторный up безопасно проверяет уже применённые версии. docker compose --env-file .env down сохраняет volume. Только для намеренного удаления учебных данных: docker compose --env-file .env down -v.

Архитектура и решения

Клиент → HAProxy (lb, единственный опубликованный порт) → две FastAPI-реплики (api) → общий PostgreSQL (postgres). Сессии, сообщения и записи идемпотентности хранятся в PostgreSQL. Каждая реплика принимает любой действующий Bearer без sticky session. X-Instance-Id — случайный alias, постоянный в пределах процесса. Внешний порт PostgreSQL и API не опубликован.

Балансировка round-robin использует server-template на четыре слота, Docker DNS 127.0.0.11, повторное разрешение адресов и /health/ready раз в 1 секунду (fall 2, rise 1). Сбой backend обнаруживается примерно за 2 проверки; проверка через публичный endpoint важнее расчётного интервала. HAProxy имеет connect timeout 2 с и client/server timeout 15 с. Compose ждёт готовности БД и однократной миграции; API имеет 10-секундный stop_grace_period, Uvicorn получает SIGTERM как главный процесс контейнера. На API установлены ограничения 0.5 CPU/256 MiB на реплику, на LB — 0.5 CPU/128 MiB. Дополнительное исследование фиксированного суммарного бюджета выполняется позже.

Создание чата и членов атомарно. POST сообщения требует ключ [A-Za-z0-9._:-]{1,128}; PostgreSQL unique key (user_id, chat_id, request_key) резервируется в транзакции вместе с сообщением и ссылкой на результат. Конкурентный повтор ждёт исход первой транзакции. При одинаковом тексте возвращается тот же 201 Message, при другом — 409. Ключ другой пары пользователь/чат независим. Повтор проверяет Bearer и членство до чтения сохранённого результата. Записи старше 24 часов по тому же ключу удаляются перед новым запросом; массовая очистка исторических ключей пока не автоматизирована.

Проверки уровня 3

Критерий Команда/наблюдение Результат
Контракт make check; локальный make test BASE_URL=http://127.0.0.1:8083 через LB PASS; публичный lab3 smoke
Реальные реплики 12 GET /health/live через LB, docker compose ps -a Два разных X-Instance-Id, два healthy API-контейнера; только LB опубликован наружу
Конкурентная идемпотентность python -m unittest discover -s student-tests на временной PostgreSQL 7 тестов PASS; два конкурентных вызова, одна запись messages
Полный рестарт make test-persistence ACTION_SCRIPT=scripts/restart.sh PASS, прежние данные и токен; времена StartedAt обеих API, LB и PostgreSQL изменились
Отказ API-1 make test-failover ACTION_SCRIPT=scripts/stop-one.sh; docker compose ps -a PASS, 2 реплики до отказа, 112 записей, 1 переходная ошибка, первая успешная запись через 2.935 с; API-1 Exited (0)
Отказ API-2 Восстановить API-1, сдвинуть round-robin одним GET, повторить failover PASS, 2 реплики до отказа, 110 записей, 1 переходная ошибка, первая успешная запись через 3.985 с; API-2 Exited (0)

Сырые безопасные агрегаты и времена контейнеров: evidence/failover-2026-10-02.txt. После опытов обе реплики восстановлены. Проверки выполнялись на macOS/Colima arm64 с локальным портом 8083, поскольку 8080 занят стендом lab2. На чистом clone .env.example использует 8080. make validate локально не запускался: зависимость openapi-spec-validator недоступна из-за DNS к files.pythonhosted.org; обязательный контракт не менялся, штатный CI job contracts.yml выполняет validate.

Ограничения и дальнейшие измерения

Стенд имеет один Docker-host, один LB и один PostgreSQL: отказ узла или БД не переживает. depends_on гарантирует порядок запуска, а маршрутизацию выполняет HAProxy. Проверка failover измеряет краткие ошибки и время восстановления, но не RPS до/после и не rolling update; это и исследование 1/2/4 реплик на фиксированном бюджете с повторениями будут добавлены для уровня 4/5. Текущий локальный HTTP разрешён только для изолированного стенда с синтетическими данными; удалённая демонстрация требует TLS.