Files
mtusi2026lab2/RUN.md
T

4.2 KiB
Raw Blame History

Запуск лабораторной 2

Автор: Медведев Андрей Михайлович, БПИ2303. Исходное задание и контракт сохранены в README.md и contracts/. Реализация находится в backend/, дополнительные проверки в student-tests/.

Нужны Docker Engine с Compose, Bun 1.4 и Python 3.9+. Для Go-тестов на хосте нужен Go 1.27.2 или новее. Проверенный стенд: Linux x86_64, Docker 29.9.2, Compose 5.6.1, Bun 1.4.4; образ компилируется Go 1.27.2. Образы PostgreSQL 18.6 и Valkey 9 закреплены digest в compose.yaml.

Команды выполняются из этого каталога. scripts/compose.sh закрепляет manifest и имя vp-lab2-medvedev, чтобы переменные другого проекта не перенаправили операции.

bun --no-env-file scripts/bootstrap.ts
./scripts/compose.sh up -d --build
BASE_URL=http://127.0.0.1:28202 bun --no-env-file student-tests/wait.ts
python3 -m venv .venv
.venv/bin/pip install -r requirements-dev.txt
make check
make validate PYTHON=.venv/bin/python
make test BASE_URL=http://127.0.0.1:28202
BASE_URL=http://127.0.0.1:28202 bun --no-env-file student-tests/acceptance.ts
make test-persistence BASE_URL=http://127.0.0.1:28202 ACTION_SCRIPT=scripts/restart.sh
cd backend
go test -race ./...
go tool golangci-lint run
go generate ./...

Bootstrap создаёт отдельные случайные учебные credentials в .local/ и не печатает их. Каталог исключён из git и Docker context. Существующие файлы не перезаписываются. Миграции запускает отдельный service migrate; API не выполняет их конкурентно.

HTTP доступен только через localhost. Все данные тестов синтетические; публичные тесты сохраняют свой набор данных для демонстрации, дополнительные acceptance-тесты удаляют только свой случайный набор. Пароли и сессии не выводятся в отчёты.

Обычная остановка сохраняет volumes:

./scripts/compose.sh stop

Повторный запуск с сохранением данных:

./scripts/compose.sh up -d

Только для намеренного полного сброса собственных учебных данных:

./scripts/compose.sh down --volumes

Проверка отказов БД/кэша и короткого срока сессии:

FAILURES=1 BASE_URL=http://127.0.0.1:28202 bun --no-env-file student-tests/acceptance.ts

Исследование трека 2 запускается на omarchy без игры после обычного bootstrap и сборки. Скрипт сам проверяет game-running, останавливает API на время снимка, использует отдельный PostgreSQL для восстановления и возвращает API после очистки своего набора. Публичные демонстрационные данные сохраняются.

bun --no-env-file student-tests/research.ts

Новый результат появляется в evidence/research/run-*/summary.json. Для графика установите requirements-plots.txt в .venv и передайте файл конкретного завершённого запуска:

.venv/bin/pip install -r requirements-plots.txt
.venv/bin/python student-tests/plot_research.py evidence/research/run-16q3rN/summary.json

Последняя команда воспроизводит приложенный график; для нового эксперимента подставьте его каталог. Подтверждённые результаты и ограничения перечислены в REPORT.md. Автоматические проверки не выставляют оценку преподавателя.