forked from mtusi2026/mtusi2026lab3
75 lines
5.2 KiB
Markdown
75 lines
5.2 KiB
Markdown
# Запуск лабораторной 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. Автоматические проверки не выставляют оценку преподавателя.
|