2026-11-02 20:21:41 +03:00
2026-11-02 20:05:33 +03:00
2026-11-02 20:05:33 +03:00
2026-11-02 20:05:33 +03:00
2026-11-02 20:05:33 +03:00
2026-11-02 20:05:33 +03:00
2026-11-02 20:05:33 +03:00
2026-11-02 20:05:33 +03:00
2026-11-02 20:05:33 +03:00
2026-11-02 20:05:33 +03:00
2026-11-02 20:05:33 +03:00
2026-11-02 20:05:33 +03:00
2026-11-02 20:05:33 +03:00
2026-11-02 20:05:33 +03:00
2026-11-02 20:05:33 +03:00
2026-11-02 20:05:33 +03:00
2026-11-02 20:05:33 +03:00
2026-11-02 20:05:33 +03:00
2026-11-02 20:05:33 +03:00
2026-11-02 20:05:33 +03:00
2026-11-02 20:05:33 +03:00
2026-11-02 20:05:33 +03:00
2026-11-02 20:05:33 +03:00
2026-11-02 20:21:41 +03:00
2026-11-02 20:05:33 +03:00
2026-11-02 20:05:33 +03:00
2026-11-02 20:05:33 +03:00

Лабораторная 3. Балансировка и отказ API-реплики

Реализация уровня 4: Compose, Nginx, две взаимозаменяемые API-реплики, общие PostgreSQL и Redis. Наружу открыт только http://localhost:8080.

Запуск и команды · Отчёт · Сценарий и вопросы защиты · Evidence · OpenAPI · Семантика · Публичные проверки · Карта курса · Процесс PR

flowchart TD
    C[Клиент] --> N[Nginx]
    N --> A[API A]
    N --> B[API B]
    A --> P[PostgreSQL]
    B --> P
    A --> R[Redis]
    B --> R

Быстрый старт

Нужны Docker Engine, Compose v2.24+ и Python 3.9+ для скриптов на хосте. API работает на Python 3.12. На Windows используйте WSL2, поскольку action hooks — sh.

cp env.lab3.template .env
# Замените POSTGRES_PASSWORD в .env на свой случайный пароль из латинских букв и цифр.
docker compose --env-file .env up -d --build
python3 scripts/replicas.py restore
make test
make test-student

migrate однократно применяет миграции перед API. restore ждёт готовности обеих реплик через LB. Сессии и сообщения сохраняются в pgdata; удалять volume не нужно.

Что реализовано для 3 и 4

Требование Реализация / проверка
Две реплики, единый LB, общие данные api-a, api-b, Nginx; PostgreSQL sessions/messages; make replicas
Одна сессия на обеих репликах X-Instance-Id генерируется на запуск процесса; lab3_evidence.py наблюдает обе
Отказ любой одной реплики scripts/stop-one.sh находит настоящий контейнер по TARGET_INSTANCE_ID и оставляет его остановленным
Общая идемпотентность на 24 ч Транзакция PostgreSQL: advisory lock, сообщение и результат POST; повтор другого тела — 409
Persistence и failover make test-persistence, make test-failover
Readiness, DNS, SIGTERM и таймауты Активный опрос readiness в LB, динамический Docker DNS, graceful shutdown Uvicorn
Последовательный отказ каждой реплики make lab3-evidence; отдельные JSON с RPS, ошибками, восстановлением, ID/PID
CPU/RAM, закрытые backend-порты cpus, mem_limit у всех служб; ports есть только у Nginx; нет container_name
Поочерёдная замена под нагрузкой make lab3-evidence заменяет каждую реплику и проверяет данные; make rolling для ручного обновления
Однократные миграции Отдельная служба migrate и advisory lock; API схему не меняют

Это реализация и воспроизводимая методика, а не заявление о пройденной приёмке. Фактически выполненные проверки и не выполненные Docker-эксперименты перечислены в EVIDENCE.md.

S
Description
No description provided
Readme
488 MiB
Languages
Python 93.6%
Makefile 3.4%
Shell 3%