Files
mtusi2026lab4/REPORT.md
T
2026-10-20 15:13:41 +03:00

6.4 KiB
Raw Blame History

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

  • Автор, группа: TODO
  • Целевая оценка; выбранный трек 5, если нужен: TODO
  • Commit/PR: TODO после публикации
  • Использованные источники, библиотеки и помощь ИИ: TODO

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

На текущем этапе перенесена база lab3; S3 и вложения ещё не реализованы. Инструкция ниже запускает только эту базу.

Нужны Docker Engine с Compose v2 и Python 3 для создания локальных секретов. Версии: Python 3.12.12 и uv 0.11.28 в Dockerfile, PostgreSQL 17.6-alpine, HAProxy 3.0.11-alpine в compose.yaml; зависимости Python закреплены в uv.lock.

Из корня репозитория:

python3 - <<'PY'
from pathlib import Path
import secrets

directory = Path("secrets")
directory.mkdir(mode=0o700, exist_ok=True)
names = ("postgres_password", "database_url", "cursor_secret")
if any((directory / name).exists() for name in names):
    raise SystemExit("Секреты уже существуют: сохраните их для существующей БД.")
password = secrets.token_hex(32)
values = (
    password,
    f"postgresql://messenger:{password}@postgres:5432/messenger",
    secrets.token_hex(32),
)
for name, value in zip(names, values):
    path = directory / name
    with path.open("x", encoding="utf-8") as stream:
        path.chmod(0o600)
        stream.write(value + "\n")
PY
docker compose --env-file .env.example config --quiet
docker compose --env-file .env.example up -d --build --wait
curl --fail http://localhost:8080/health/ready
make check
python3 student-tests/review_regressions.py

Сервис migrate применяет SQL-миграции до запуска API. Вход через HAProxy: http://localhost:8080; порты API и PostgreSQL на host не опубликованы. Порт 8080 должен быть свободен. Compose использует отдельный проект и volume lab4; секреты и данные lab3 не переносились.

Остановка с сохранением данных: docker compose down. Намеренное удаление данных этого стенда: docker compose down -v.

Полный make test пока не проходит: модель Message перенесена из lab3 без attachment_ids, endpoint вложений отсутствуют. Публичные тесты и контракт lab4 сохранены. Проверки test-persistence, test-failover и собственная проверка idempotency_concurrency.py используют контракт lab4 и требуют дальнейшей реализации. Скрипты restart/stop-one перенесены для текущей топологии; при добавлении S3 restart необходимо дополнить перезапуском этого хранилища.

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

Перенесено из локального проекта mtusi2026lab3: src/, миграции 001–003, Dockerfile, зависимости и lockfile, основной Compose, конфигурация HAProxy, restart/failover hooks и собственные проверки сессий, идемпотентности, readiness и ошибок API. Исследовательский benchmark lab3 и старые результаты экспериментов не входят в этот перенос.

Текущая схема: клиент → HAProxy → api-a / api-b → PostgreSQL. PostgreSQL хранит пользователей, сессии, чаты, сообщения и записи идемпотентности. Общий CURSOR_SECRET_FILE задаёт ключ подписи курсоров для обеих реплик. Исходники API пока сохраняют поведение и версию 1.3.0 из lab3. Параметры S3 из .env.example будут подключены на следующем этапе.

TODO: схема процессов/хранилищ, источник истины, транзакционные границы, ограничения. Что перенесено из lab3, что изменено в этой работе. Соответствие переменных из .env.example реальной конфигурации.

Доказательства критериев

Критерий README Команда/сценарий Наблюдаемый результат Файл доказательства
Публичный smoke make test TODO TODO
Остальные пункты уровня 3 TODO TODO TODO
Все пункты уровня 4, если заявлен TODO TODO TODO
Выбранный трек 5, если заявлен TODO TODO TODO

TODO: добавить отдельную строку для каждого заявленного критерия. PASS без команды и наблюдения не является доказательством. Проверка инфраструктурного hook требует подтверждения, какие реальные процессы/хранилища перезапущены.

Эксперименты и отказы

TODO: гипотеза, hardware/лимиты, версии, объём данных, профиль нагрузки, concurrency/arrival rate, длительность/прогрев, повторы, успешные RPS, ошибки, p50/p95/p99, CPU/RAM. Сохранить raw summary без tokens и объяснить ограничения измерения.

Воздействие Что ожидаем Что наблюдали Время восстановления / потеря данных
TODO TODO TODO TODO

Ограничения и следующие шаги

TODO: какие отказы выдерживаются и какие нет; что не реализовано; где учебное упрощение; какое улучшение подтверждено, а какое пока гипотеза.