Files
mtusi2026lab3/evidence/lab3-summary.md
T
2026-10-25 21:46:21 +03:00

5.1 KiB
Raw Blame History

Lab 3 verification summary

Дата проверки: 2026-10-23.

Файл содержит обезличенную сводку воспроизводимых проверок. Bearer tokens, пароли, ключи идемпотентности, UUID пользователей/чатов/сообщений и содержимое локальных Docker secrets намеренно не сохранены.

Окружение

  • Windows + WSL2;
  • Docker Engine 29.7.2;
  • Docker Compose 5.5.0;
  • две Compose-реплики сервиса api;
  • единственный опубликованный endpoint: HAProxy на 127.0.0.1:8080;
  • Nginx доступен только внутри Compose network и отдаёт статический React;
  • PostgreSQL и Redis доступны только внутри Compose network.

Статические проверки

go test ./...                 PASS
go test -race ./...           PASS
go vet ./...                  PASS
make check                    PASS
make validate                 PASS
docker compose config         PASS
shell syntax for hooks        PASS

make validate запускался с Python virtual environment, где установлены зависимости преподавательского validator.

Топология и smoke

  • migration 1 and migration 2 applied successfully;
  • one-shot service migrate exited with code 0;
  • оба API-контейнера перешли в healthy;
  • 20 последовательных запросов к health через LB вернули два разных X-Instance-Id: распределение 10/10;
  • Windows PowerShell получил HTTP 200 и X-Instance-Id с http://localhost:8080/health/ready;
  • преподавательский python3 tests/smoke.py завершился строкой PASS: lab3 public API scenario.

Readiness-aware routing

make test-readiness-routing добавил в network namespace одной API-реплики правило, запрещающее TCP-доступ к PostgreSQL, не останавливая сам процесс. Его /health/ready вернул 503; HAProxy исключил backend за 2,861 с. После этого 40 запросов /health/live получили 200, а 20 корректных регистраций — 201; не готовая реплика не получила ни одного запроса. После удаления fault-правила она вернулась в ротацию. Машиночитаемый результат сохранён в evidence/readiness-routing.json.

Failover API

Команда:

make test-failover ACTION_SCRIPT=./scripts/stop-one.sh

Наблюдение преподавательского теста:

run 1:
  observed instances before action: 2
  successful writes / failures: 141 / 0
  first recovery: 2.668 seconds
run 2, after restoring the desired two replicas:
  observed instances before action: 2
  successful writes / failures: 142 / 0
  first recovery: 2.653 seconds
both results: PASS

После каждого запуска желаемое число реплик было восстановлено командой docker compose up -d --wait api. Hook сопоставляет TARGET_INSTANCE_ID с hostname контейнера и останавливает только выбранную API-реплику. Отдельный make grade4-experiment целенаправленно остановил обе исходные реплики по очереди: 7853/0 и 7970/0 успешных/ошибочных запросов, recovery 2,893/2,938 с.

Persistence и идемпотентность

  • make test-persistence ACTION_SCRIPT=./scripts/restart.sh: PASS; после рестарта PostgreSQL, Redis, всех API-реплик, frontend и HAProxy прежние bearer session и созданные данные сохранились;
  • 32 конкурентных POST сообщения с одинаковыми semantic payload и Idempotency-Key через HAProxy вернули один Message ID;
  • прямой запрос PostgreSQL подтвердил ровно одну строку сообщения;
  • повтор с тем же scope/key и другим payload возвращает HTTP 409.

Негативные и browser-security проверки

  • сырой Authorization: Bearer с UTF-8 é вернул 401, Bearer challenge и стандартный Error; процесс не завершился с panic/500;
  • тело JSON из одного байта FF вернуло 400 invalid_request, а error.request_id совпал с X-Request-Id;
  • login установил host-only HttpOnly; SameSite=Strict cookie;
  • cookie без Bearer на контрактном /api/v1/users/me дала 401, через /web-api/v1/users/me — 200;
  • logout через /web-api вернул 204 и инвалидировал серверную сессию;
  • статический frontend вернул 200 и Content-Security-Policy.