# 1. Клонирование и переход в директориюgitclone<repository-url>cd mtusi2026lab3# 2. Создание .env файла (опционально, конфигурация в docker-compose.yaml)cp .env.example.env# 3. Очистка старых контейнеров (если есть)dockercomposedown-v# 4. Сборка и запускdockercomposeup-d--build# 5. Ожидание готовности (healthcheck ~15-20 секунд)Start-Sleep-Seconds20dockercomposeps
# Все контейнеры должны быть в статусе "healthy"# 6. Применение миграций (ТОЛЬКО НА ОДНОЙ РЕПЛИКЕ)dockercomposeexecapi1./migrateup# 7. Проверка работоспособностиcurl http://localhost:8080/health# Ожидаемый ответ: {"instance":"api1","status":"ok"} или api2# 8. Запуск тестовpythontests/client.pypythontests/load.py# 9. Безопасная остановкаdockercomposedown# 10. Удаление учебных данных (полная очистка)dockercomposedown-v
Необходимые действия оператора:
Миграции запускаются вручную один раз после первого поднятия
Healthcheck автоматически проверяет готовность сервисов (15-20 сек)
Для повторного запуска с чистыми данными: docker compose down -v
requests recovered within 10s (5.24s, 3 transient errors)
5.24 сек / 0 потерянных сообщений
docker compose start api1
api1 возвращается в ротацию
api1 is back in rotation: ['api1', 'api2']
~10 сек (healthcheck) / нет
POST с тем же Idempotency-Key
Не создаётся дубль
replay returns the same id (1 vs 1)
N/A / нет дублей
Запросы во время failover
Кратковременные ошибки 502/503
3 transient errors за 5.24 сек
N/A / допустимы
Raw summary (tests/load.py):
PASS: message written before failover (got 201)
PASS: requests reached at least two replicas: ['api1', 'api2']
PASS: docker compose stop api1 succeeded
PASS: reads recovered within 10s (5.24s, 3 transient errors)
PASS: requests still served while api1 is down
PASS: api1 left rotation, served by: ['api2']
PASS: write works while api1 is down (got 201)
PASS: docker compose start api1 succeeded
PASS: api1 is back in rotation: ['api1', 'api2']
PASS: history readable after failover (got 200)
PASS: message written before failover survived
PASS: no duplicate messages in history
Failover scenario passed
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Отчёт — лабораторная 3
Запуск из чистого clone
Prerequisites:
Команды запуска:
Необходимые действия оператора:
docker compose down -vАрхитектура и решения
Схема компонентов:
Источник истины: PostgreSQL — единственное хранилище состояния (сессии, сообщения, ключи идемпотентности).
Транзакционные границы:
BEGIN→SELECT FOR UPDATE→INSERT→COMMITОграничения:
Что перенесено из lab2:
Что изменено/добавлено:
Соответствие .env.example:
DATABASE_URL→ используется в docker-compose.yaml (postgres://app:app@postgres:5432/app)APP_INSTANCE_ID→ передаётся как env в контейнеры (api1/api2)APP_PORT→ 8080 (внутренний порт контейнера)Доказательства критериев
make testилиpython tests/client.pyAll API checks passed(12 PASS)docker compose pscurl http://localhost:8080/healthcurl -sI http://localhost:8080/health | grep X-Instance-Iddocker compose stop api1+ запросыdocker compose exec api1 ./migrate upmigrate up: donedocker compose stop api1python tests/load.pyFailover scenario passedpython tests/load.pyno duplicate messages in historyЭксперименты и отказы
Гипотеза: Система выдерживает остановку одной API-реплики без потери данных и с минимальным временем восстановления.
Hardware/лимиты:
Профиль нагрузки:
Результаты:
docker compose stop api1requests recovered within 10s (5.24s, 3 transient errors)docker compose start api1api1 is back in rotation: ['api1', 'api2']replay returns the same id (1 vs 1)3 transient errorsза 5.24 секRaw summary (tests/load.py):
Ограничения измерения:
Ограничения и следующие шаги
Какие отказы выдерживаются:
Какие отказы НЕ выдерживаются:
docker compose down -vЧто не реализовано:
Учебное упрощение:
Следующие шаги (если нужно улучшить):
Принято. Закрываю МР.
Pull request closed