2.8 KiB
Запуск и демонстрация ЛР5
Крайкин Глеб Алексеевич, БВТ2303. Нужны Docker с Compose v2 и Python 3.9+. Go на host для запуска не нужен.
make up
make check
make test
# API: http://localhost:8085. Только LB опубликован на loopback.
Bootstrap создаёт .env и случайные credentials в игнорируемом secrets/, существующие не меняет. Один Compose содержит две API, HAProxy, PostgreSQL, Valkey cache, MinIO, отдельный persistent Valkey Streams broker, dispatcher, worker и housekeeping. make down сохраняет volumes. Не удалять volumes при проверке сохранности.
make test-race
python3 student-tests/pipeline.py
python3 student-tests/version_fence.py
python3 student-tests/retry_backpressure.py
make test-persistence ACTION_SCRIPT=scripts/restart.sh
make test-failover ACTION_SCRIPT=scripts/stop-one.sh
# После failover остановленная реплика остаётся остановленной:
docker compose up -d --no-deps --wait api
Аварийные тесты запускать последовательно: они останавливают только компоненты этого учебного Compose-проекта и создают синтетические данные. Pipeline-тест занимает несколько минут: реальное восстановление после crash ждёт 45s lease и 60s reclaim/redispatch, timestamps не подделываются. Это не обещание ready за 60s при аварии; smoke-бюджет 60s относится к свободному worker.
Операторский интерфейс (доступ к Docker/secrets, не публичный HTTP):
docker compose exec -T postgres psql -U messenger -d messenger -c 'TABLE failed_jobs;'
docker compose run --rm --no-deps worker replay ATTACHMENT_UUID
docker compose run --rm --no-deps worker reprocess ATTACHMENT_UUID
# reprocess переводит поддерживаемый pipeline 1 → 2, включая supersede активного v1.
docker compose run --rm --no-deps housekeeping cleanup # dry-run
docker compose run --rm --no-deps housekeeping cleanup --apply
replay разрешён только failed с доступным исходником, аудит сохраняется. Для ready дубликат — no-op. reprocess — явное новое задание/версия, а не retry. Поддерживаются v1 и v2. Полные объяснения и ответы — DEFENSE.md, эксперимент — REPORT.md, реальные данные — evidence/.