145 lines
6.5 KiB
Makefile
145 lines
6.5 KiB
Makefile
PYTHON ?= python3
|
||
# 127.0.0.1, а не localhost: на части Windows-машин localhost резолвится очень медленно.
|
||
# С lab3 это адрес балансировщика HAProxy — единственной точки входа API.
|
||
BASE_URL ?= http://127.0.0.1:8080
|
||
# API с SESSION_TTL_SECONDS=2 (сервис api-short-ttl, профиль ttl), тоже через балансировщик.
|
||
BASE_URL_TTL ?= http://127.0.0.1:8081
|
||
CA_FILE ?=
|
||
ACTION_SCRIPT ?=
|
||
TLS_ARGS = $(if $(CA_FILE),--ca-file "$(CA_FILE)",)
|
||
# Передаём адреса собственным тестам через окружение (работает и в cmd, и в sh).
|
||
export BASE_URL
|
||
export BASE_URL_TTL
|
||
|
||
.PHONY: help check validate test load test-persistence test-failover \
|
||
secrets up down ps logs restore student-test race expiry failure-valkey failure-postgres \
|
||
failure-valkey-pause db-test explain demo cache-stats \
|
||
balancing idempotency failover persistence failover-metrics rolling-update load-profile check-stack report-tables
|
||
|
||
help:
|
||
@echo "check: offline structure; validate: full OpenAPI (requirements-dev.txt); test: running API; load: synthetic writes"
|
||
@echo "secrets/up/down/ps/logs/restore: stand; student-test, race, expiry, failure-valkey, failure-postgres, failure-valkey-pause, db-test, explain, demo, cache-stats: own checks (lab2)"
|
||
@echo "balancing, idempotency, failover, persistence, failover-metrics, rolling-update, load-profile, check-stack, report-tables: own checks (lab3)"
|
||
|
||
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)
|
||
$(PYTHON) tests/resilience.py --mode failover --action-script "$(ACTION_SCRIPT)" --base-url "$(BASE_URL)" $(TLS_ARGS)
|
||
|
||
# ---------- стенд ----------
|
||
|
||
secrets:
|
||
sh scripts/init-secrets.sh
|
||
|
||
up:
|
||
docker compose up -d --build --wait
|
||
|
||
# Без -v: volumes с данными сохраняются. Удаление данных — только осознанно: docker compose down -v
|
||
down:
|
||
docker compose --profile ttl --profile tools down
|
||
|
||
# ID контейнера + состояние. ID реплики api = её X-Instance-Id.
|
||
ps:
|
||
docker compose ps -a --format "table {{.Service}}\t{{.ID}}\t{{.Status}}"
|
||
|
||
logs:
|
||
docker compose logs --tail 50 api lb
|
||
|
||
# Вернуть остановленные реплики (после make test-failover): запустить всё, что должно работать,
|
||
# и дождаться, пока HAProxy снова возьмёт в работу все реплики.
|
||
restore:
|
||
docker compose up -d --wait
|
||
$(PYTHON) student-tests/stand.py
|
||
|
||
# ---------- собственные проверки lab1–lab2 (теперь через балансировщик) ----------
|
||
|
||
student-test:
|
||
$(PYTHON) -m unittest discover -s student-tests -p "test_*.py" -v
|
||
|
||
race:
|
||
$(PYTHON) student-tests/race.py
|
||
|
||
# Поднимает API с TTL сессии 2 с (за балансировщиком, 127.0.0.1:8081), проверяет и убирает его.
|
||
expiry:
|
||
docker compose --profile ttl up -d --wait api-short-ttl
|
||
$(PYTHON) student-tests/expiry.py; status=$$?; docker compose --profile ttl rm -sf api-short-ttl >/dev/null 2>&1; exit $$status
|
||
|
||
failure-valkey:
|
||
$(PYTHON) student-tests/dependency_failure.py valkey
|
||
|
||
failure-postgres:
|
||
$(PYTHON) student-tests/dependency_failure.py postgres
|
||
|
||
# Valkey на паузе (данные в нём сохраняются), logout, снова в строю: токен должен остаться отозванным.
|
||
failure-valkey-pause:
|
||
$(PYTHON) student-tests/cache_revocation.py
|
||
|
||
db-test:
|
||
docker compose --profile tools run --rm db-test
|
||
|
||
explain:
|
||
docker compose exec -T postgres psql -X -q -U messenger -d messenger -v ON_ERROR_STOP=1 < infra/sql/explain_history.sql
|
||
|
||
demo:
|
||
$(PYTHON) student-tests/demo.py
|
||
|
||
# Роль Valkey: сколько ключей в кэше и сколько попаданий/промахов; права пользователя health.
|
||
VALKEY_HEALTH = docker compose exec -T valkey valkey-cli --user health --pass none --no-auth-warning
|
||
cache-stats:
|
||
$(VALKEY_HEALTH) dbsize
|
||
$(VALKEY_HEALTH) info stats | grep -E "keyspace_(hits|misses)"
|
||
-$(VALKEY_HEALTH) get sess:anything
|
||
|
||
# ---------- собственные проверки lab3 ----------
|
||
|
||
# Реплики, общие сессии и кэш, X-Instance-Id (входит и в student-test).
|
||
balancing:
|
||
$(PYTHON) -m unittest discover -s student-tests -p "test_balancing.py" -v
|
||
|
||
# Idempotency-Key: повторы, конкурентные запросы через разные реплики (входит и в student-test).
|
||
idempotency:
|
||
$(PYTHON) -m unittest discover -s student-tests -p "test_idempotency.py" -v
|
||
|
||
# Публичный failover-тест для КАЖДОЙ реплики по очереди + какой контейнер реально остановлен.
|
||
failover:
|
||
$(PYTHON) student-tests/run_failover.py
|
||
|
||
# Публичный persistence-тест + время старта каждого контейнера до и после hook.
|
||
persistence:
|
||
$(PYTHON) student-tests/run_persistence.py
|
||
|
||
# Уровень 4: остановка (SIGTERM) и авария (SIGKILL) каждой реплики под нагрузкой: RPS, ошибки, восстановление.
|
||
failover-metrics:
|
||
$(PYTHON) student-tests/failover_metrics.py
|
||
|
||
# Уровень 4: поочерёдная замена реплик новой версией под нагрузкой.
|
||
rolling-update:
|
||
$(PYTHON) student-tests/rolling_update.py
|
||
|
||
# Профиль нагрузки: публичный tests/load.py (30 с, 4 потока) + CPU/RAM контейнеров во время нагрузки.
|
||
load-profile:
|
||
$(PYTHON) student-tests/load_profile.py
|
||
|
||
# Уровень 4: лимиты CPU/RAM, нет портов API в обход LB, нет container_name, сети, версии.
|
||
check-stack:
|
||
$(PYTHON) student-tests/check_stack.py
|
||
|
||
# Таблицы замеров из evidence/*.json -> REPORT.md (между метками measurements).
|
||
report-tables:
|
||
$(PYTHON) student-tests/report_tables.py
|