Files
mtusi2026lab4/START-HERE.md
T

3.2 KiB

Лабораторная 4 — запуск в PowerShell

Открой эту папку в VS Code и терминал PowerShell. Нужны запущенный Docker Desktop (Linux containers), Python 3.9+; для дополнительных тестов — Node.js 22+.

py -X utf8 scripts/setup.py
docker compose up -d --build --wait
py -X utf8 scripts/check_contract.py
py -X utf8 tests/smoke.py --base-url http://localhost:8084

API доступен на http://localhost:8084. Порт 8080 предыдущей лабы не занят. Первый запуск скачивает зависимости и собирает MinIO из исходников закреплённого релиза: это может занять несколько минут. Повторная сборка использует кэш. Миграции и создание приватного bucket выполняются автоматически.

Проверка полного перезапуска и отказа API (запускай по очереди):

py -X utf8 tests/resilience.py --mode persistence --action-script scripts/restart.cmd --base-url http://localhost:8084
py -X utf8 tests/resilience.py --mode failover --action-script scripts/stop-one.cmd --base-url http://localhost:8084
py -X utf8 scripts/control.py restore
node student-tests/check.js --lifecycle

Дополнительный тест сам загружает PNG/JPEG, проверяет ограничения и права доступа, останавливает принявшую файл реплику, скачивает оригинал через вторую, перезапускает весь стенд и временно отключает S3. После проверок восстанавливает сервисы.

Остановка с сохранением данных: docker compose down. Повторный запуск и сборка: docker compose up -d --build --wait. Только для намеренного удаления всех учебных данных этой лабы: docker compose down -v. Сохраняй папку secrets между запусками; не добавляй её и .env в Git или архив сдачи. Если переносишь уже работающий стенд в другую папку на этом же компьютере, перенеси .env и secrets/ туда отдельно: существующие Docker volumes ожидают прежние пароли. Для текущего запуска используй уже подготовленную папку проекта.

Linux: вместо py -X utf8 используй python3, вместо hooks .cmd — .sh. Перед запуском hooks: chmod +x scripts/restart.sh scripts/stop-one.sh. Эквиваленты публичных проверок: make check и make test BASE_URL=http://localhost:8084.

Короткий отчёт — REPORT.md; результаты реальных проверок — evidence/. Заголовок PR: ЛР 4 — БПИ2304 — Кирюпина — на 3.