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.