6.9 KiB
Шпаргалка для защиты — лабораторная 3
Команды по порядку сценария защиты из README. Подробности решения — в REPORT.md.
Shell: Git Bash в Windows или обычный терминал в Linux/macOS (в Linux вместо python -X utf8 — python3).
-X utf8 в Windows обязателен для публичных тестов: они читают контракт в кодировке системы (cp1251), а в контракте lab3 есть символы, которых в ней нет.
Адрес — 127.0.0.1, а не localhost: в Windows localhost сначала пробует IPv6, и каждый запрос идёт около двух секунд.
0. Подготовка (один раз)
python scripts/init_secrets.py # случайные пароли в secrets/, в Git не попадают
cp .env.example .env
URL=http://127.0.0.1:8080
# post <путь> [токен] [Idempotency-Key] — JSON со стандартного ввода; печатает код и реплику
post() { curl -s -X POST "$URL$1" -H 'Content-Type: application/json' ${2:+-H "Authorization: Bearer $2"} ${3:+-H "Idempotency-Key: $3"} --data-binary @- -w '\nHTTP %{http_code} via %header{x-instance-id}\n'; }
# get <путь> [токен]
get() { curl -s "$URL$1" ${2:+-H "Authorization: Bearer $2"} -w '\nHTTP %{http_code} via %header{x-instance-id}\n'; }
# new <ПЕРЕМЕННАЯ> <путь> [токен] — как post, но ещё сохраняет id созданного объекта
new() { local r; r=$(post "$2" "$3"); echo "$r"; printf -v "$1" %s "$(echo "$r" | sed -nE 's/.*"id":"([^"]+)".*/\1/p' | head -1)"; }
# signin <ПЕРЕМЕННАЯ> <username> <password> — вход по Basic, токен сохраняется в переменную
signin() { local r; r=$(curl -s -X POST "$URL/api/v1/auth/sessions" -u "$2:$3" -w '\nHTTP %{http_code}\n'); echo "$r" | tail -1; printf -v "$1" %s "$(echo "$r" | sed -nE 's/.*"token":"([^"]+)".*/\1/p')"; }
1. Запуск и две реплики через балансировщик с одной сессией
docker compose up -d --build --wait # postgres, valkey, migrate (один раз), api x2, lb
docker compose ps # api-1, api-2 без портов; порты только у lb, на 127.0.0.1
new ALICE /api/v1/users <<< '{"username":"alice","display_name":"Алиса","password":"Alice-password-123"}'
new BOB /api/v1/users <<< '{"username":"bob","display_name":"Боб","password":"Bob-password-12345"}'
signin TA alice Alice-password-123
signin TB bob Bob-password-12345
for i in 1 2 3 4; do get /api/v1/users/me "$TA" | tail -1; done # via чередуется: две реплики, один токен
docker ps --filter label=com.docker.compose.service=api --format '{{.ID}} {{.Names}}' # X-Instance-Id = ID контейнера
python -X utf8 tests/smoke.py --base-url $URL # make test
Идемпотентность: тот же ключ — то же сообщение, другое тело — 409, без ключа — 400:
new CHAT /api/v1/chats "$TA" <<< "{\"title\":\"Проект по ВНП\",\"member_ids\":[\"$ALICE\",\"$BOB\"]}"
post /api/v1/chats/$CHAT/messages "$TA" key-001 <<< '{"text":"Привет, Боб!"}'
post /api/v1/chats/$CHAT/messages "$TA" key-001 <<< '{"text":"Привет, Боб!"}' # тот же id, возможно другая реплика
post /api/v1/chats/$CHAT/messages "$TA" key-001 <<< '{"text":"Другой текст"}' # 409
post /api/v1/chats/$CHAT/messages "$TA" <<< '{"text":"Без ключа"}' # 400
get /api/v1/chats/$CHAT/messages "$TB" # одно сообщение
2–3. Отказ одной реплики
Страница состояния балансировщика: http://127.0.0.1:8404 — видно, какая реплика UP, а какая DOWN.
python -X utf8 tests/resilience.py --mode failover --action-script scripts/stop-one.cmd --base-url $URL # Windows
make test-failover ACTION_SCRIPT=scripts/stop-one.sh BASE_URL=$URL # Linux/macOS
docker compose ps -a # какой контейнер действительно остановлен: Exited (0)
docker compose logs lb | grep -E "is (DOWN|UP)" # HAProxy исключил его: Layer7 wrong status 503
docker compose up -d --wait # вернуть реплику
# повторить тест: если остановлена та же реплика, запустить ещё раз, пока не будет вторая
4. Перезапуск всего стенда с тем же токеном
python -X utf8 tests/resilience.py --mode persistence --action-script scripts/restart.cmd --base-url $URL # Windows
make test-persistence ACTION_SCRIPT=scripts/restart.sh BASE_URL=$URL # Linux/macOS
get /api/v1/chats/$CHAT/messages "$TA" # после перезапуска: те же данные, тот же токен
Уровень «4»
Каждый пункт можно показать отдельно (скрипт сам печатает команды и вывод):
python -X utf8 scripts/lab3_checks.py --only stack # лимиты CPU/RAM, порты только у lb, секреты, нет container_name
python -X utf8 scripts/lab3_checks.py --only idempotency # 20 одновременных запросов с одним ключом
python -X utf8 scripts/lab3_checks.py --only experiment # stop и kill каждой реплики под нагрузкой: RPS, ошибки, время
python -X utf8 scripts/lab3_checks.py --only rolling # поочерёдная замена реплик новым образом под нагрузкой
python -X utf8 scripts/lab3_checks.py --only valkey-down postgres-down
Плавная остановка одной реплики: в логе реплики shutdown_started, затем через 3 с закрытие приёма и clean=True:
docker stop <ID реплики>; docker logs --tail 3 <ID реплики>; docker compose up -d --wait
Собственные тесты:
BASE_URL=$URL python -X utf8 -m unittest discover -s student-tests -v # make student-test
BASE_URL=$URL python student-tests/race.py # make race
Остановка и уборка
docker compose stop # безопасная остановка, данные остаются в volumes
docker compose down # удалить контейнеры, volumes остаются
docker compose down -v # удалить ещё и все данные