Files
mtusi2026lab3/REPORT.md
T

3.8 KiB
Raw Blame History

Отчёт — лабораторная работа №3

Целевая оценка

3 (работающий минимум). Используется Go REST API из лабораторной №2.

Архитектура

Клиент → Nginx (localhost:8080) → api1 / api2 → общая PostgreSQL и Redis. Обе API-реплики без локального состояния пользователей, сообщений и сессий. Токены проверяются по общей PostgreSQL; Redis используется как общий кэш.

Запуск

  1. Скопировать .env.example в .env, заполнить POSTGRES_PASSWORD.
  2. docker compose --env-file .env up -d --build.
  3. docker compose --env-file .env ps.
  4. py -3 tests/smoke.py --base-url http://localhost:8080.

Миграции выполняются единственным сервисом migrate, завершение которого предшествует запуску обеих API-реплик. Миграция 002 добавляет общую таблицу идемпотентности; она и сообщение фиксируются в одной транзакции.

Балансировка и отказ

Nginx round-robin, Docker DNS resolver 127.0.0.11, обновление DNS каждые 2 с, проверка соединений при запросе и пассивное исключение backend после ошибки на 2 с. Переключение обычно происходит сразу при повторе через другую реплику; время восстановления требуется измерить на реальном Docker-стенде.

API имеет /health/live и /health/ready; заголовок X-Instance-Id принимает значения api1/api2. Graceful shutdown по SIGTERM — до 8 секунд.

Идемпотентность

Idempotency-Key обязателен для POST /api/v1/chats/{chat_id}/messages. Формат ASCII [A-Za-z0-9._:-]{1,128}. Область ключа: отправитель + чат + ключ. Уникальный PK в PostgreSQL сериализует конкурентные запросы; одинаковый текст возвращает исходный Message и HTTP 201, другой текст — 409. Срок удержания записи: минимум 24 часа (устаревшая запись очищается при повторном использовании того же ключа). При сбое транзакции нет ни сообщения, ни зафиксированного ключа. Авторизация и членство проверяются до операции.

Проверки и доказательства

Проверить на машине с Docker:

  • make check / make test (или py -3 tests/smoke.py ...).
  • make test-persistence ACTION_SCRIPT=scripts/restart.sh (Linux/WSL).
  • make test-failover ACTION_SCRIPT=scripts/stop-one.sh (Linux/WSL).
  • docker compose --env-file .env up -d --no-deps api1 api2 после failover.
  • Повторить отказ, выбрав вторую реплику; собрать вывод в evidence/.

Для Windows без WSL скрипты .ps1 выполняются вручную, а Python failover ожидает исполняемый POSIX hook: запускать в WSL или Git Bash с доступом к Docker.

Ограничения: PostgreSQL, Redis и LB остаются единичными точками отказа; отказ узла Docker не покрыт. Результаты нагрузочных/отказных испытаний нельзя считать подтверждёнными до выполнения на пользовательской машине.