- 2 API-реплики (api-1, api-2) с уникальным INSTANCE_ID - Nginx load balancer с health-check и failover - PostgreSQL источник истины, Valkey кэш сессий - Idempotency-Key в заголовке, replay возвращает исходное сообщение - X-Instance-Id в каждом ответе для идентификации реплики - /version и /info эндпоинты - Housekeeping-loop для очистки истёкших сессий и ключей - stop-one.sh/cmd для failover-теста, restart.sh/cmd для persistence - Исправлены импорты config/models/api/store/sessions - Добавлены миграции 004 (idempotency), 005 (indexes), 006 (message_id) - Отчёт с доказательствами критериев уровня 3 и 4 - Все тесты проходят: smoke, 26 student tests, failover, persistence, degradation
57 lines
2.0 KiB
Makefile
57 lines
2.0 KiB
Makefile
PYTHON ?= python3
|
|
# 127.0.0.1, not localhost: compose publishes the API on IPv4 only, and a
|
|
# dual-stack localhost would add a ~2 s IPv6 retry to every request.
|
|
BASE_URL ?= http://127.0.0.1:8080
|
|
CA_FILE ?=
|
|
ACTION_SCRIPT ?=
|
|
TARGET_INSTANCE_ID ?= api-1
|
|
STUDENT_DIR = student-tests
|
|
|
|
.PHONY: help check validate test load test-persistence test-failover run bootstrap up down test-student explain
|
|
|
|
help:
|
|
@echo "check: offline structure; validate: full OpenAPI (requirements-dev.txt); test: running API; load: synthetic writes"
|
|
@echo "bootstrap/up/down: local Compose stand; run: API without Docker (needs DATABASE_URL/CACHE_URL)"
|
|
@echo "test-student: own functional+race tests; test-persistence: restart stack; test-failover: stop one API replica"
|
|
@echo "explain: seed 12k messages and capture EXPLAIN (ANALYZE, BUFFERS) into evidence/"
|
|
|
|
check:
|
|
$(PYTHON) scripts/check_contract.py
|
|
|
|
validate:
|
|
$(PYTHON) scripts/validate_openapi.py
|
|
|
|
test:
|
|
$(PYTHON) tests/smoke.py --base-url "$(BASE_URL)" $(TLS_ARGS)
|
|
|
|
load:
|
|
$(PYTHON) tests/load.py --base-url "$(BASE_URL)" $(TLS_ARGS)
|
|
|
|
test-persistence:
|
|
@test -n "$(ACTION_SCRIPT)" || (echo "Set ACTION_SCRIPT to your implemented executable restart hook"; exit 2)
|
|
$(PYTHON) tests/resilience.py --mode persistence --action-script "$(ACTION_SCRIPT)" --base-url "$(BASE_URL)" $(TLS_ARGS)
|
|
|
|
test-failover:
|
|
@test -n "$(ACTION_SCRIPT)" || (echo "Set ACTION_SCRIPT to your implemented executable stop-one hook"; exit 2)
|
|
TARGET_INSTANCE_ID="$(TARGET_INSTANCE_ID)" $(PYTHON) tests/resilience.py --mode failover --action-script "$(ACTION_SCRIPT)" --base-url "$(BASE_URL)" $(TLS_ARGS)
|
|
|
|
# --- lab 3 ----------------------------------------------------------------
|
|
run:
|
|
$(PYTHON) -B src/app.py
|
|
|
|
bootstrap:
|
|
sh scripts/bootstrap-secrets.sh
|
|
|
|
up: bootstrap
|
|
docker compose --env-file .env up -d --build --wait --wait-timeout 180
|
|
docker compose --env-file .env ps
|
|
|
|
down:
|
|
docker compose --env-file .env down
|
|
|
|
test-student:
|
|
cd $(STUDENT_DIR) && BASE_URL="$(BASE_URL)" $(PYTHON) -B -m unittest -v test_api test_race
|
|
|
|
explain:
|
|
sh scripts/explain-history.sh
|