5.8 KiB
Ручная проверка HLAlab3
Команды выполняются в обычном PowerShell из C:\Users\maxsi\HLAlab3\mtusi2026lab3-fork. Нужен работающий Docker Desktop, стандартный порт 8080 свободен. Сценарии создают синтетические данные.
Запуск
python -X utf8 scripts/manage.py start
python -X utf8 scripts/manage.py status
curl.exe -i http://127.0.0.1:8080/health/live
curl.exe -i http://127.0.0.1:8080/health/ready
В status должны быть две API, DB, Valkey, LB; migrate завершён с exit 0. Наружу опубликован только LB. Health возвращает 200, X-Request-Id и X-Instance-Id.
Пользователи, сессия, чат и сообщение
. .\scripts\manual.ps1
Точка и пробел в начале обязательны: функция Invoke-LabApi и $Lab останутся в текущем терминале. Сценарий создаст Alice/Bob, войдёт за Alice, создаст чат и несколько раз отправит одно сообщение через LB. В консоли видны HTTP-код и заголовки, токен не печатается. Все повторы должны вернуть один Message ID.
1..10 | ForEach-Object { $null = Invoke-LabApi GET '/api/v1/users/me' }
Invoke-LabApi GET ($Lab.MessagePath+'?limit=100')
Одна сессия обслуживается минимум двумя X-Instance-Id. В истории нет дублей повторного POST.
Повтор и конфликт
$replay = Invoke-LabApi POST $Lab.MessagePath $Lab.Body
$replay.id -eq $Lab.Message.id
try {
Invoke-LabApi POST $Lab.MessagePath @{text='Другое тело с прежним ключом'}
} catch {
[int]$_.Exception.Response.StatusCode
}
Первый результат — True, второй — 409. Для новой записи нужен новый ключ:
$Lab.Headers['Idempotency-Key'] = [guid]::NewGuid().ToString('N')
Invoke-LabApi POST $Lab.MessagePath @{text='Новое сообщение'}
Отказ обслужившей реплики
$Lab.Headers['Idempotency-Key'] = $Lab.Key
$null = Invoke-LabApi POST $Lab.MessagePath $Lab.Body
python -X utf8 scripts/manage.py stop-one --instance $Lab.LastInstance
python -X utf8 scripts/manage.py status
Одна API должна быть exited, другая running. С прежним токеном и ключом:
$replay = Invoke-LabApi POST $Lab.MessagePath $Lab.Body
$replay.id -eq $Lab.Message.id
Invoke-LabApi GET ($Lab.MessagePath+'?limit=100')
Ожидается 201 с прежним ID, без дубля. При краткой ошибке обнаружения отказа повторяется то же тело с тем же ключом. Новую запись проверяют после замены ключа. Восстановите API и повторите для другой:
python -X utf8 scripts/manage.py restore
python -X utf8 scripts/manage.py status
Автоматическая конкурентная проверка и последовательный отказ каждой API под измеряемой нагрузкой:
python -X utf8 student-tests/acceptance.py
python -X utf8 student-tests/failures.py
Перезапуск и logout
Не закрывайте текущий терминал и не создавайте новую сессию:
python -X utf8 scripts/manage.py restart
$null = Invoke-LabApi GET '/api/v1/users/me'
$Lab.Headers['Idempotency-Key'] = $Lab.Key
$replay = Invoke-LabApi POST $Lab.MessagePath $Lab.Body
$replay.id -eq $Lab.Message.id
Invoke-LabApi DELETE '/api/v1/auth/sessions/current'
try {
Invoke-LabApi GET '/api/v1/users/me'
} catch {
[int]$_.Exception.Response.StatusCode
}
После рестарта прежняя сессия действует до исходного expiry; повтор возвращает прежний Message. Logout — 204, следующий GET — 401. Для новой демонстрации снова выполните . .\scripts\manual.ps1.
Полная проверка и исследование
python -X utf8 scripts/verify.py
evidence/verification.json должен иметь complete=true. Фактические измерения — research.md/research.csv/research.json и scaling.png/saturation.png. Ручные остановки и другой нагрузочный сценарий во время полной проверки не запускаются. Для короткой проверки уровней 3/4: python -X utf8 scripts/verify.py --no-research.
После прерывания можно выполнить python -X utf8 scripts/verify.py --resume: уже завершённые проверки и замеры будут использованы повторно. Этот режим применяется к тому же стенду и неизменённым исходникам API/инфраструктуры; после их изменения нужен обычный полный прогон.
Публичные сценарии с Linux hooks отдельно:
python -X utf8 scripts/linux_tests.py test-persistence
python -X utf8 scripts/linux_tests.py test-failover
python -X utf8 scripts/manage.py restore
Остановка
docker compose down
Volumes и данные сохраняются. down -v для проверки сохранности не используется.