Files
mtusi2026lab4/docs/archive/compose-run.md

6.6 KiB
Raw Permalink Blame History

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

Историческая инструкция Compose/HAProxy. Основной путь теперь описан в ../../RUN.md. Для старых action helpers явно задайте VP_RUNTIME=compose; прежние runners сохранены как student-tests/reconciliation-compose.ts и concurrent-images-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-lab4-medvedev, чтобы переменные другого проекта не перенаправили операции.

bun --no-env-file scripts/bootstrap.ts
./scripts/compose.sh up -d --build
BASE_URL=http://127.0.0.1:28204 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:28204
BASE_URL=http://127.0.0.1:28204 bun --no-env-file student-tests/acceptance.ts
make test-persistence BASE_URL=http://127.0.0.1:28204 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

Для проверки отказа запустите публичный сценарий. Он передаёт реальный TARGET_INSTANCE_ID hook-скрипту; после проверки верните обе реплики и дождитесь готовности.

make test-failover BASE_URL=http://127.0.0.1:28204 ACTION_SCRIPT=scripts/stop-one.sh
./scripts/compose.sh up -d
BASE_URL=http://127.0.0.1:28204 bun --no-env-file student-tests/wait.ts

Чтобы проверить вторую реплику, повторите сценарий после восстановления; фактический остановленный контейнер записывается в evidence/stop-one-after.txt.

Отказ S3 с восстановлением и проверкой подтверждённого оригинала:

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

Исследование трека 2 запускайте через изолирующий runner. Он создаёт отдельный случайный Compose-проект с пустыми DB/bucket, воспроизводит настоящие частичные отказы и dry-run/apply/repeat, затем удаляет только свой проект. Результаты появляются в новом evidence/reconciliation/run-*.

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

Не запускайте integration service напрямую на демонстрационной БД: тест сверяет весь изолированный набор. Для обычной сверки доступен CLI с ограничением 100 metadata и 100 объектов на вызов. Первая команда ничего не меняет; вторая явно применяет безопасные исправления.

./scripts/compose.sh run --rm --no-deps api -reconcile
./scripts/compose.sh run --rm --no-deps api -reconcile -apply

CLI возвращает поля продолжения metadata/object. Для следующей страницы передайте их через -after и -object-after; при ошибке повторите страницу с прежними курсорами. Default grace равен 10 минутам, минимальный -grace равен 60s.

Проверки памяти выполняются на omarchy без игры. Сначала соберите обычный образ и дождитесь готовности. Генератор создаёт только синтетический PNG в .local/; скрипт одновременно начинает десять upload и проверяет исходные bytes всех успешных загрузок. Отдельный процесс декодирует экстремальные PNG вместе с KDF-worker.

go run ./student-tests/image-fixtures/main.go
BASE_URL=http://127.0.0.1:28204 bun --no-env-file student-tests/concurrent-images.ts
./student-tests/image-memory.sh

Команда генератора выполняется из корня лабы. Поля продолжения CLI называются NextMetadata и NextObject. Подтверждённые результаты и ограничения перечислены в REPORT.md. Автоматические проверки не выставляют оценку преподавателя.