Files
mtusi2026lab4/DEMO.md
T

80 lines
5.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Шпаргалка для защиты — лабораторная 4
Рабочая папка — корень clone `mtusi2026lab4`. Нужны Docker Desktop с Compose и Python 3.9+ для публичных тестов. Скрипт эксперимента использует Python 3.9+; для `random.randbytes` нужна версия не ниже 3.9.
## Подготовка и запуск
```sh
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.
## Публичный сценарий и собственные тесты
```sh
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
```sh
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`.
## Перезапуск всего стенда
```sh
# 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-объектов
```sh
docker compose --profile tools run --rm cleanup # просмотр, ничего не удаляет
docker compose --profile tools run --rm cleanup --apply # только неучтённые объекты старше часа
```
Для регулярной очистки оператор запускает вторую команду раз в час планировщиком ОС. Ключи создаёт сервер; filename не участвует в S3 key. Блокировка в PostgreSQL защищает границу PUT/COMMIT от гонки со сборщиком. Ошибка доступа к БД прерывает очистку.
## Остановка
```sh
docker compose stop # безопасно, данные сохраняются
docker compose down # удалить контейнеры, volumes сохраняются
docker compose down -v # намеренно удалить ВСЕ учебные данные lab4
```
## Короткие ответы на вопросы
- Локальный файл реплики исчезнет вместе с контейнером и недоступен второй реплике. S3 общий и сохраняет данные в отдельном volume.
- 201 возвращается после PUT оригинала и COMMIT метаданных. После 201 другая реплика читает те же данные.
- Если PUT прошёл, а COMMIT нет, остаётся orphan. Сборщик удаляет его только после grace period и повторной проверки БД под блокировкой.
- Случайный ключ не является авторизацией. API проверяет членство в чате перед метаданными, скачиванием и загрузкой.