forked from mtusi2026/mtusi2026lab4
88 lines
6.0 KiB
Markdown
88 lines
6.0 KiB
Markdown
# Шпаргалка для защиты — лабораторная 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`.
|
||
|
||
## Перезапуск всего стенда
|
||
|
||
Отдельная регрессия замечания к приостановленной PostgreSQL:
|
||
|
||
```sh
|
||
python -X utf8 scripts/check_postgres_pause.py --output evidence/postgres-pause.txt
|
||
```
|
||
|
||
Скрипт сам выполняет pause/unpause: проверяет прямой 503 с каждой реплики, живость API, замену закрытых соединений и восстановление чтения/записи. Также отдельно приостанавливает БД во время запроса, COMMIT и ROLLBACK. PostgreSQL возобновляется в `finally`; API не перезапускаются.
|
||
|
||
```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 проверяет членство в чате перед метаданными, скачиванием и загрузкой.
|