6.4 KiB
Отчёт — лабораторная 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: какие отказы выдерживаются и какие нет; что не реализовано; где учебное упрощение; какое улучшение подтверждено, а какое пока гипотеза.