inecs
cbd0adca91
Stateful FastAPI lab with contract packs, Compose/Helm, Docker Hub release targets, and Pulumi coverage across all Engine series (GET/POST/PUT/DELETE/HEAD).
155 lines
6.1 KiB
Makefile
155 lines
6.1 KiB
Makefile
COMPOSE ?= docker compose
|
||
SERVICE_DEV := dev
|
||
SERVICE_SIM := simulator
|
||
PYTEST_OFFLINE := -m "not integration and not compatibility"
|
||
|
||
# Docker Hub release image (runtime target only — not the local bind-mount "dev" image).
|
||
DOCKERHUB_USER ?= inecs
|
||
IMAGE_NAME ?= ovirt-api-simulator
|
||
VERSION ?= $(shell sed -n 's/^version = "\(.*\)"/\1/p' pyproject.toml)
|
||
DOCKER_IMAGE ?= $(DOCKERHUB_USER)/$(IMAGE_NAME)
|
||
PUSH_LATEST ?= 1
|
||
|
||
COMPOSE_RELEASE ?= $(COMPOSE) -f docker-compose.release.yml
|
||
HELM_CHART ?= ./helm/ovirt-api-simulator
|
||
LAB ?= ./pulumi-tests
|
||
|
||
.PHONY: help install format lint typecheck test test-unit test-integration test-contract \
|
||
test-surface test-versions coverage up down restart logs seed seed-demo smoke clean ci shell \
|
||
helm-template generate-packs \
|
||
release release-build release-up release-down release-seed \
|
||
test-pulumi-smoke test-pulumi pulumi-tests \
|
||
test-smoke-all test-all clean-test-resources
|
||
|
||
help: ## Show available commands
|
||
@awk 'BEGIN {FS = ":.*## "}; /^[a-zA-Z0-9_-]+:.*## / {printf "%-22s %s\n", $$1, $$2}' $(MAKEFILE_LIST)
|
||
|
||
install: ## Build runtime and development images
|
||
@test -f .env || cp .env.example .env
|
||
$(COMPOSE) build simulator $(SERVICE_DEV)
|
||
|
||
generate-packs: ## Regenerate contracts/ovirt series packs
|
||
$(COMPOSE) run --rm --no-deps $(SERVICE_DEV) python tools/ovirt_api_inventory/generate_packs.py
|
||
|
||
format: ## Format Python sources
|
||
$(COMPOSE) run --rm --no-deps $(SERVICE_DEV) ruff format .
|
||
|
||
lint: ## Run Ruff lint checks
|
||
$(COMPOSE) run --rm --no-deps $(SERVICE_DEV) ruff check app tests
|
||
|
||
typecheck: ## Run strict mypy checks
|
||
$(COMPOSE) run --rm --no-deps $(SERVICE_DEV) mypy app/ovirt app/web/routes.py app/main.py app/config.py app/lifespan.py
|
||
|
||
test: ## Run offline unit and contract tests
|
||
$(COMPOSE) run --rm --no-deps $(SERVICE_DEV) pytest $(PYTEST_OFFLINE)
|
||
|
||
test-unit: ## Run unit tests
|
||
$(COMPOSE) run --rm --no-deps $(SERVICE_DEV) pytest tests/unit tests/ovirt -q
|
||
|
||
test-integration: ## Run tests that require PostgreSQL
|
||
@test -f .env || cp .env.example .env
|
||
$(COMPOSE) up -d postgres migrate
|
||
$(COMPOSE) run --rm $(SERVICE_DEV) pytest -m integration tests/ovirt -q
|
||
|
||
test-contract: ## Validate oVirt contract packs
|
||
$(COMPOSE) run --rm --no-deps $(SERVICE_DEV) pytest -m contract tests/ovirt -q
|
||
|
||
test-surface: ## Probe Engine API surface across series
|
||
@test -f .env || cp .env.example .env
|
||
$(COMPOSE) up -d --wait
|
||
$(COMPOSE) run --rm --no-deps --entrypoint python $(SERVICE_SIM) -m pytest tests/ovirt -q --tb=line
|
||
|
||
test-versions: ## All Engine series packs with seeded inventory assertions
|
||
@test -f .env || cp .env.example .env
|
||
$(COMPOSE) up -d --wait
|
||
$(COMPOSE) run --rm --entrypoint python $(SERVICE_SIM) -m app.ovirt.seed_cli --profile minimal
|
||
$(COMPOSE) run --rm --no-deps $(SERVICE_DEV) pytest -m integration tests/ovirt/test_api_versions.py -q --tb=short
|
||
|
||
coverage: ## Offline coverage
|
||
$(COMPOSE) run --rm --no-deps $(SERVICE_DEV) pytest $(PYTEST_OFFLINE) --cov=app/ovirt --cov-report=term-missing
|
||
|
||
up: ## Start PostgreSQL, simulator, and Engine gateway
|
||
@test -f .env || cp .env.example .env
|
||
$(COMPOSE) up -d --build --wait
|
||
|
||
down: ## Stop local services
|
||
$(COMPOSE) down
|
||
|
||
restart: ## Rebuild and restart the stack
|
||
@test -f .env || cp .env.example .env
|
||
$(COMPOSE) up -d --build --force-recreate --wait
|
||
|
||
logs: ## Follow logs
|
||
$(COMPOSE) logs -f
|
||
|
||
seed: ## Seed minimal lab
|
||
$(COMPOSE) run --rm --entrypoint python $(SERVICE_SIM) -m app.ovirt.seed_cli --profile minimal
|
||
|
||
seed-demo: ## Seed demo datacenter (~1000 VMs)
|
||
$(COMPOSE) run --rm --entrypoint python $(SERVICE_SIM) -m app.ovirt.seed_cli --profile demo
|
||
|
||
smoke: ## Quick Engine auth + list VMs smoke
|
||
@curl -skf -u 'admin@internal:secret' -H 'Accept: application/json' -H 'Version: 4' \
|
||
https://127.0.0.1:$${OVIRT_ENGINE_PORT:-443}/ovirt-engine/api/vms >/dev/null
|
||
@echo "smoke ok"
|
||
|
||
helm-template: ## Render Helm chart
|
||
helm template ovirt-sim $(HELM_CHART)
|
||
|
||
clean: ## Remove caches
|
||
rm -rf .pytest_cache .mypy_cache .ruff_cache .coverage coverage.xml
|
||
find . -type d -name __pycache__ -prune -exec rm -rf {} +
|
||
|
||
ci: format lint test-unit ## Local CI gate
|
||
|
||
shell: ## Dev shell in container
|
||
$(COMPOSE) run --rm $(SERVICE_DEV) bash
|
||
|
||
release-build: ## Build the runtime image tagged for Docker Hub (no push)
|
||
@test -n "$(VERSION)" || (echo "VERSION is empty; set VERSION=... or version in pyproject.toml" >&2; exit 1)
|
||
@echo "Building $(DOCKER_IMAGE):$(VERSION) (target=runtime)"
|
||
docker build \
|
||
--target runtime \
|
||
--build-arg APP_VERSION=$(VERSION) \
|
||
-t $(DOCKER_IMAGE):$(VERSION) \
|
||
$(if $(filter 1 true yes,$(PUSH_LATEST)),-t $(DOCKER_IMAGE):latest,) \
|
||
.
|
||
|
||
release: release-build ## Build and push the runtime image to Docker Hub
|
||
@echo "Pushing $(DOCKER_IMAGE):$(VERSION)"
|
||
@docker push $(DOCKER_IMAGE):$(VERSION)
|
||
@if [ "$(PUSH_LATEST)" = "1" ] || [ "$(PUSH_LATEST)" = "true" ] || [ "$(PUSH_LATEST)" = "yes" ]; then \
|
||
echo "Pushing $(DOCKER_IMAGE):latest"; \
|
||
docker push $(DOCKER_IMAGE):latest; \
|
||
fi
|
||
@echo "Released $(DOCKER_IMAGE):$(VERSION)$(if $(filter 1 true yes,$(PUSH_LATEST)), and $(DOCKER_IMAGE):latest,)"
|
||
|
||
release-up: ## Pull and start the published Hub stack (docker-compose.release.yml)
|
||
IMAGE_TAG="$${IMAGE_TAG:-$(VERSION)}" DOCKER_IMAGE="$(DOCKER_IMAGE)" $(COMPOSE_RELEASE) pull
|
||
IMAGE_TAG="$${IMAGE_TAG:-$(VERSION)}" DOCKER_IMAGE="$(DOCKER_IMAGE)" $(COMPOSE_RELEASE) up -d --wait
|
||
|
||
release-down: ## Stop the published Hub stack
|
||
$(COMPOSE_RELEASE) down
|
||
|
||
release-seed: ## Seed the published Hub stack (PROFILE=minimal by default)
|
||
SEED_PROFILE="$${PROFILE:-minimal}" IMAGE_TAG="$${IMAGE_TAG:-$(VERSION)}" DOCKER_IMAGE="$(DOCKER_IMAGE)" \
|
||
$(COMPOSE_RELEASE) run --rm --entrypoint python simulator -m app.ovirt.seed_cli --profile "$${PROFILE:-minimal}"
|
||
|
||
# --- Pulumi contract-coverage lab (pulumi-tests) ---
|
||
test-pulumi-smoke: ## Pulumi contract-coverage smoke
|
||
$(MAKE) -C $(LAB) test-pulumi-smoke
|
||
|
||
test-pulumi: ## Pulumi full contract coverage (all series × all ops)
|
||
$(MAKE) -C $(LAB) test-pulumi
|
||
|
||
pulumi-tests: test-pulumi ## Alias: full Pulumi contract coverage suite
|
||
|
||
test-smoke-all: ## Client lab smoke
|
||
$(MAKE) -C $(LAB) test-smoke-all
|
||
|
||
test-all: ## Client lab full suite (Pulumi contract coverage)
|
||
$(MAKE) -C $(LAB) test-all
|
||
|
||
clean-test-resources: ## Cleanup lab-created resources
|
||
$(MAKE) -C $(LAB) clean-test-resources
|