Files
mtusi2026lab3/MANUAL.md
T

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 для проверки сохранности не используется.