7.3 KiB
Запуск и проверка лабораторной 2
Команды рассчитаны на локальный тестовый стенд: Docker с Compose v2, make и Python 3.9+. В этой лабораторной проверяются уровни 3, 4 и 5.
Запуск стенда
Из каталога mtusi2026lab2:
cp .env.example .env
Задайте в .env собственный локальный POSTGRES_PASSWORD (hex-строка), затем запустите API и зависимости:
docker compose --env-file .env up -d --build
Быстрая проверка через curl
BASE_URL=http://127.0.0.1:8080
# Процесс API работает: ожидается HTTP 200 и {"status":"ok"}
curl --fail --show-error "$BASE_URL/health/live"
# API и PostgreSQL готовы принимать запросы: ожидается HTTP 200
curl --fail --show-error "$BASE_URL/health/ready"
# Без Bearer-токена доступ запрещён: ожидается HTTP 401
curl -sS -o /dev/null -w 'HTTP %{http_code}\n' "$BASE_URL/api/v1/users/me"
Следующий пример регистрирует двух тестовых пользователей, получает Bearer-токен Алисы через Basic-аутентификацию, создаёт чат и отправляет в него сообщение. Нужен jq для чтения JSON-ответов; используйте только тестовые пароли:
ALICE_USERNAME="codes_alice_$(date +%s)"
ALICE_PASSWORD='Example-password-alice-42'
BOB_USERNAME="codes_bob_$(date +%s)"
BOB_PASSWORD='Example-password-bob-42'
# Создать пользователей и сохранить их ID
ALICE=$(curl --fail --show-error "$BASE_URL/api/v1/users" \
-H 'Content-Type: application/json' \
-d "$(jq -n --arg username "$ALICE_USERNAME" --arg password "$ALICE_PASSWORD" \
'{username:$username, display_name:"Алиса (тест)", password:$password}')")
ALICE_ID=$(printf '%s' "$ALICE" | jq -r '.id')
BOB=$(curl --fail --show-error "$BASE_URL/api/v1/users" \
-H 'Content-Type: application/json' \
-d "$(jq -n --arg username "$BOB_USERNAME" --arg password "$BOB_PASSWORD" \
'{username:$username, display_name:"Боб (тест)", password:$password}')")
BOB_ID=$(printf '%s' "$BOB" | jq -r '.id')
# Войти как Алиса с Basic-аутентификацией и получить Bearer-токен
SESSION=$(curl --fail --show-error "$BASE_URL/api/v1/auth/sessions" \
-u "$ALICE_USERNAME:$ALICE_PASSWORD" \
-X POST)
TOKEN=$(printf '%s' "$SESSION" | jq -r '.token')
# Проверить авторизованный запрос
curl --fail --show-error "$BASE_URL/api/v1/users/me" \
-H "Authorization: Bearer $TOKEN"
# Создать чат от имени Алисы и включить обоих пользователей
CHAT=$(curl --fail --show-error "$BASE_URL/api/v1/chats" \
-H "Authorization: Bearer $TOKEN" \
-H 'Content-Type: application/json' \
-d "$(jq -n --arg alice "$ALICE_ID" --arg bob "$BOB_ID" \
'{title:"Тестовый чат", member_ids:[$alice, $bob]}')")
CHAT_ID=$(printf '%s' "$CHAT" | jq -r '.id')
printf 'Создан чат: %s\n' "$CHAT_ID"
# Отправить сообщение; ожидается HTTP 201 и JSON нового сообщения
curl --fail --show-error "$BASE_URL/api/v1/chats/$CHAT_ID/messages" \
-H "Authorization: Bearer $TOKEN" \
-H 'Content-Type: application/json' \
-d '{"text":"Проверка отправки сообщения через curl"}'
Для полной проверки API используйте smoke-тест ниже: он сам регистрирует синтетических пользователей, создаёт чат и сообщения. Эти данные остаются в тестовой базе.
Проверки по уровням
Сначала выполните общую проверку контракта и OpenAPI:
make check
# Один раз, если ещё не установлен валидатор OpenAPI:
python3 -m venv .venv
. .venv/bin/activate
pip install -r requirements-dev.txt
make validate
Далее команды проверки уровней:
# Уровень 3: публичный API и сохранность данных/сессии после перезапуска
make test
make test-persistence ACTION_SCRIPT=scripts/restart.sh
# Уровень 4: проверки Redis TTL/fallback, конкурентной регистрации,
# rollback транзакции и истечения срока сессии
make grade4
# Уровень 5, трек 2: сравнение планов/индексов и backup/restore
make track5
Уровень 4 предполагает прохождение проверок уровня 3; уровень 5 — уровней 3 и 4, поэтому запускайте команды по порядку. make track5 создаёт и удаляет собственные временные базы для эксперимента. Используйте только локальный учебный стенд, не production.
Остановка
Останавливает контейнеры, сохраняя PostgreSQL volume и данные:
docker compose --env-file .env down
docker compose --env-file .env up -d curl --fail http://127.0.0.1:8080/health/ready Затем публичные тесты из tests/ можно запустить напрямую: python3 tests/smoke.py Он проверяет основной сценарий API: регистрацию и вход, чаты, отправку и чтение сообщений, доступы и пагинацию. В конце должен вывести PASS. Тест создаёт записи в базе, они автоматически не удаляются. python3 tests/resilience.py --mode persistence --action-script scripts/restart.sh Он проверяет, что данные и существующая сессия доступны после перезапуска. Скрипт перезапуска должен быть исполняемым; если нужно: python3 tests/resilience.py --mode persistence --action-script scripts/restart.sh Он проверяет, что данные и существующая сессия доступны после перезапуска. Скрипт перезапуска должен быть исполняемым; если нужно: chmod +x scripts/restart.sh python3 tests/load.py --duration 30 --concurrency 4 Это тест нагрузки: отправляет сообщения несколько секунд и показывает успешные запросы в секунду, ошибки и задержки. Он тоже создаёт тестовые сообщения. tests/client.py — вспомогательный модуль для этих проверок, отдельно его запускать не нужно. То же самое можно запускать короче командами Make: make test, make test-persistence ACTION_SCRIPT=scripts/restart.sh. С описанием публичных проверок можно свериться в tests/README.md.