Files
mtusi2026lab3/docs/archive/compose-run.md
T

75 lines
5.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Запуск лабораторной 3
> Историческая инструкция Compose/HAProxy. Основной путь теперь описан в ../../RUN.md. Для старых action helpers явно задайте VP_RUNTIME=compose; прежний runner исследования сохранён как student-tests/research-compose.ts. Числа этого варианта не являются измерениями k3s/Pingap.
Автор: Медведев Андрей Михайлович, БПИ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-lab3-medvedev, чтобы переменные другого проекта не перенаправили операции.
```sh
bun --no-env-file scripts/bootstrap.ts
./scripts/compose.sh up -d --build
BASE_URL=http://127.0.0.1:28203 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:28203
BASE_URL=http://127.0.0.1:28203 bun --no-env-file student-tests/acceptance.ts
make test-persistence BASE_URL=http://127.0.0.1:28203 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:
```sh
./scripts/compose.sh stop
```
Повторный запуск с сохранением данных:
```sh
./scripts/compose.sh up -d
```
Только для намеренного полного сброса собственных учебных данных:
```sh
./scripts/compose.sh down --volumes
```
Для проверки отказа запустите публичный сценарий. Он передаёт реальный TARGET_INSTANCE_ID hook-скрипту; после проверки верните обе реплики и дождитесь готовности.
```sh
make test-failover BASE_URL=http://127.0.0.1:28203 ACTION_SCRIPT=scripts/stop-one.sh
./scripts/compose.sh up -d
BASE_URL=http://127.0.0.1:28203 bun --no-env-file student-tests/wait.ts
```
Чтобы проверить вторую реплику, повторите сценарий после восстановления; фактический остановленный контейнер записывается в evidence/stop-one-after.txt.
Трек 1 запускается на omarchy без игры; скрипт проверяет это до и после замеров. Он создаёт отдельный случайный Compose-проект на localhost:28303, сравнивает 1/2/4 реплики, выполняет ABBA для пула и замену под нагрузкой, затем удаляет только свои containers/volumes. Обычный демонстрационный стенд сохраняется.
```sh
bun --no-env-file student-tests/research.ts
bun --no-env-file student-tests/research.ts --pool-only
```
Первой команды достаточно для полного исследования; вторая отдельно повторяет четыре замера пула. Результат каждого запуска появляется в новом evidence/research/run-*. Для приложенных графиков:
```sh
.venv/bin/pip install -r requirements-plots.txt
.venv/bin/python student-tests/plot_research.py evidence/research/run-ImJmOz/summary.json --pool-summary evidence/research/run-sB0hdP/summary.json
```
Подтверждённые результаты и ограничения перечислены в REPORT.md. Автоматические проверки не выставляют оценку преподавателя.