5.3 KiB
Шпаргалка для защиты — лабораторная 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.peakcgroup каждой реплики, включая 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 проверяет членство в чате перед метаданными, скачиванием и загрузкой.