3.8 KiB
Отчёт — лабораторная работа №3
Целевая оценка
3 (работающий минимум). Используется Go REST API из лабораторной №2.
Архитектура
Клиент → Nginx (localhost:8080) → api1 / api2 → общая PostgreSQL и Redis. Обе API-реплики без локального состояния пользователей, сообщений и сессий. Токены проверяются по общей PostgreSQL; Redis используется как общий кэш.
Запуск
- Скопировать
.env.exampleв.env, заполнить POSTGRES_PASSWORD. docker compose --env-file .env up -d --build.docker compose --env-file .env ps.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 не покрыт. Результаты нагрузочных/отказных испытаний нельзя считать подтверждёнными до выполнения на пользовательской машине.