Files
mtusi2026lab4/DEMO.md
T

5.3 KiB
Raw Blame History

Шпаргалка для защиты — лабораторная 4

Рабочая папка — корень clone mtusi2026lab4. Нужны Docker Desktop с Compose и Python 3.9+ для публичных тестов. Скрипт эксперимента использует Python 3.9+; для random.randbytes нужна версия не ниже 3.9.

Подготовка и запуск

python scripts/init_secrets.py
cp .env.example .env                  # PowerShell: Copy-Item .env.example .env
docker compose config --quiet
docker compose up -d --build --wait
docker compose ps -a

API: http://127.0.0.1:8080/health/ready. HAProxy: http://127.0.0.1:8404. В Windows у Python добавляйте -X utf8, чтобы публичные скрипты читали контракт в UTF-8.

Публичный сценарий и собственные тесты

python -X utf8 scripts/check_contract.py
python -X utf8 tests/smoke.py --base-url http://127.0.0.1:8080
python -X utf8 -m unittest discover -s student-tests -v

Smoke создаёт Алису, Боба и постороннего пользователя, загружает PNG, отправляет сообщение с вложением, скачивает оригинал как Боб и сравнивает SHA-256. Посторонний получает 404.

Проверки уровня 4

python -X utf8 scripts/lab4_checks.py --only stack private
python -X utf8 scripts/lab4_checks.py --only failover
python -X utf8 scripts/lab4_checks.py --only outage
python -X utf8 scripts/lab4_checks.py --only memory
python -X utf8 scripts/lab4_checks.py --only compensation
  • private: прямой анонимный GET S3 возвращает 403; API credentials не могут создать bucket.
  • failover: определяет реплику по ответу upload, останавливает её, скачивает через другую, сравнивает байты; возвращает реплику в finally.
  • outage: останавливает SeaweedFS, ожидает ограниченный 503, запускает обратно и скачивает тем же токеном.
  • memory: десять одновременных загрузок PNG 1024×1024; выводит время, задержки и memory.peak cgroup каждой реплики, включая decoder и tmpfs.
  • compensation: временный DB trigger ломает INSERT после успешного S3 PUT; затем проверяется rollback, запуск dry-run очистки и прерывание загрузки клиентом. Trigger удаляется в finally.

Перезапуск всего стенда

# Windows
python -X utf8 tests/resilience.py --mode persistence --action-script scripts/restart.cmd --base-url http://127.0.0.1:8080
python -X utf8 tests/resilience.py --mode failover --action-script scripts/stop-one.cmd --base-url http://127.0.0.1:8080
docker compose up -d --wait

# Linux / Git Bash: использовать restart.sh и stop-one.sh; в Linux предварительно chmod +x scripts/*.sh

Публичный persistence проверяет старый токен, сообщение, метаданные и оригинал после перезапуска API, PostgreSQL, Valkey, S3 и HAProxy.

Очистка orphan-объектов

docker compose --profile tools run --rm cleanup          # просмотр, ничего не удаляет
docker compose --profile tools run --rm cleanup --apply  # только неучтённые объекты старше часа

Для регулярной очистки оператор запускает вторую команду раз в час планировщиком ОС. Ключи создаёт сервер; filename не участвует в S3 key. Блокировка в PostgreSQL защищает границу PUT/COMMIT от гонки со сборщиком. Ошибка доступа к БД прерывает очистку.

Остановка

docker compose stop                 # безопасно, данные сохраняются
docker compose down                 # удалить контейнеры, volumes сохраняются
docker compose down -v              # намеренно удалить ВСЕ учебные данные lab4

Короткие ответы на вопросы

  • Локальный файл реплики исчезнет вместе с контейнером и недоступен второй реплике. S3 общий и сохраняет данные в отдельном volume.
  • 201 возвращается после PUT оригинала и COMMIT метаданных. После 201 другая реплика читает те же данные.
  • Если PUT прошёл, а COMMIT нет, остаётся orphan. Сборщик удаляет его только после grace period и повторной проверки БД под блокировкой.
  • Случайный ключ не является авторизацией. API проверяет членство в чате перед метаданными, скачиванием и загрузкой.