forked from mtusi2026/mtusi2026lab2
45 lines
3.2 KiB
Markdown
45 lines
3.2 KiB
Markdown
# Лабораторная 2 на Python
|
|
|
|
Алихан Абдурашидов, БВТ2301. Целевая оценка 5, трек 2 — план запроса и восстановление.
|
|
|
|
Нужны Docker Compose, Python 3.11+ и make. PostgreSQL/Valkey устанавливаются контейнерами из этого репозитория. Рабочий HTTP-порт по умолчанию 8082; первая лабораторная может продолжать работать на 8080.
|
|
|
|
```sh
|
|
make up
|
|
# bootstrap автоматически создаст .env и secrets/ только при их отсутствии.
|
|
# up дождётся Docker healthcheck.
|
|
make check test student-test
|
|
make infra-test
|
|
```
|
|
|
|
`make infra-test` намеренно останавливает PostgreSQL и Valkey текущего проекта, проверяет 503/cache fallback/expiry и затем запускает публичный полный restart-сценарий. Учебные данные и именованный volume сохраняются.
|
|
|
|
```sh
|
|
# Отдельно публичная проверка сохранности:
|
|
make test-persistence ACTION_SCRIPT=scripts/restart.sh
|
|
# Повторяемое исследование на изолированных синтетических БД:
|
|
make research
|
|
# Полная проверка схемы:
|
|
python3 -m venv .venv
|
|
.venv/bin/python -m pip install -r requirements-dev.txt
|
|
make validate PYTHON=.venv/bin/python
|
|
# Необязательный рисунок по сохранённым данным:
|
|
.venv/bin/python -m pip install -r research/requirements.txt
|
|
.venv/bin/python research/summarize.py
|
|
```
|
|
|
|
Для другого порта: задать `HOST_PORT` в `.env`, пересоздать API командой `docker compose up -d`, передавать тестам `BASE_URL=http://localhost:<порт>`. `APP_PORT=8080` — внутренний порт контейнера. Для короткого TTL используется отдельный тестовый контейнер; обычный стенд оставляет SESSION_TTL_SECONDS=3600.
|
|
|
|
```sh
|
|
# Корректная остановка с сохранением данных:
|
|
docker compose down
|
|
# Повторный запуск с тем же volume:
|
|
docker compose up -d --wait
|
|
# Только если нужно намеренно уничтожить все учебные данные этого проекта:
|
|
docker compose down --volumes
|
|
```
|
|
|
|
Секреты не печатаются и не коммитятся. Не удалять secrets/ при сохранённом volume: смена пароля в файлах не меняет пароль уже инициализированной PostgreSQL. `make clean-clone-test` проверяет именно текущий commit в отдельном clone, со своими секретами, портом и временными volumes; незакоммиченные изменения в этот clone не попадают.
|
|
|
|
Схема до реализации запросов: [infra/SCHEMA.md](infra/SCHEMA.md). Подробный отчёт: [REPORT.md](REPORT.md). Методика исследования: [research/README.md](research/README.md).
|