Files

T

inecs cbd0adca91 Initial release of the oVirt/RHV Engine API simulator.

Stateful FastAPI lab with contract packs, Compose/Helm, Docker Hub release
targets, and Pulumi coverage across all Engine series (GET/POST/PUT/DELETE/HEAD).

2026-07-18 04:49:28 +03:00

2.6 KiB

Raw Blame History

Language / Язык: English | Русский

Kubernetes / Helm

Deploy with the chart in helm/ovirt-api-simulator.

Published image (when pushed): inecs/ovirt-api-simulator

What the chart installs today

Component	Role
simulator Deployment	FastAPI on container port `8080`
Service	ClusterIP → `8080`
PostgreSQL StatefulSet	Bundled Postgres 17 (optional)
migrate initContainer	Idempotent schema migrations
seed Job (optional)	`minimal` or `demo` lab data

The Compose stack publishes Engine HTTPS + UI via nginx api-gateway (ports.md). The Helm chart does not yet ship that gateway: gateway.* / ingress.* keys in values.yaml are reserved and unused. Access the simulator Service on :8080 (port-forward or your own Ingress).

Prerequisites

Kubernetes 1.27+ (or comparable)
Helm 3.14+

Install

helm upgrade --install ovirt-sim ./helm/ovirt-api-simulator \
  -n ovirt-sim --create-namespace \
  --set image.repository=inecs/ovirt-api-simulator \
  --set image.tag=0.1.0 \
  --set config.ovirtSeries=4.5 \
  --set seed.profile=minimal \
  --set secrets.ticketSigningKey="$(openssl rand -hex 32)"

For a locally built image, set image.repository / image.tag to match what you loaded into the cluster.

Render locally:

make helm-template

Important values

Value	Purpose
`image.repository` / `image.tag`	Container image (default `inecs/ovirt-api-simulator:0.1.0`)
`config.ovirtSeries`	Cold-start pack (`4.5`, `3.6`, …)
`seed.enabled` / `seed.profile`	Post-install seed Job
`postgresql.enabled`	Bundled database
`databaseUrl`	External DSN when `postgresql.enabled=false`
`secrets.ticketSigningKey`	Rotate on shared clusters
`service.port`	Service port (default `8080`)

See values.yaml.

Access

Port-forward the simulator Service:

kubectl -n ovirt-sim port-forward svc/<release>-ovirt-api-simulator 8080:8080

Then:

Surface	URL
Engine API	http://127.0.0.1:8080/ovirt-engine/api
SSO token	http://127.0.0.1:8080/ovirt-engine/sso/oauth/token
Web UI	http://127.0.0.1:8080/
OpenAPI	http://127.0.0.1:8080/docs

Default seeded login: admin@internal / secret.

Manual reseed

kubectl exec deploy/<release>-ovirt-api-simulator -- \
  python -m app.ovirt.seed_cli --profile demo

2.6 KiB Raw Blame History