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

90 lines
6.6 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.
# Запуск лабораторной 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, чтобы переменные другого проекта не перенаправили операции.
```sh
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:
```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: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 с восстановлением и проверкой подтверждённого оригинала:
```sh
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-*.
```sh
bun --no-env-file student-tests/reconciliation.ts
```
Не запускайте integration service напрямую на демонстрационной БД: тест сверяет весь изолированный набор. Для обычной сверки доступен CLI с ограничением 100 metadata и 100 объектов на вызов. Первая команда ничего не меняет; вторая явно применяет безопасные исправления.
```sh
./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.
```sh
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. Автоматические проверки не выставляют оценку преподавателя.