Compatibility¶
What this tree supports now. Do not infer unstated EVE-NG editions, scale numbers, or a frozen API.
Current packages: product 0.4.7, Debian / health 0.4.7-1. Downloads: GitLab Release. How those two identifiers differ: versioning.
Pairing¶
| Piece | Compatible with |
|---|---|
eve-iac-agent (eve-iac-agent_0.4.7-1_amd64.deb) |
The EVE host where you install the .deb. Listens on HTTPS :8787. |
VSIX eve-iac-client-0.4.7.vsix |
Same product 0.4.7 as the agent you talk to |
CLI / Python eve-iac (eve_iac-0.4.7-py3-none-any.whl) |
Same product 0.4.7 |
npm @eve-iac/sdk, Go tarball |
Same product 0.4.7 |
Run matching agent and client product versions. Mixing an older agent with a newer client (or the reverse) is not a supported matrix.
eve-iac/v1 (/api/v1, OpenAPI + semantics) is a candidate contract. It is not frozen. Valid v1 calls may still change until a public cut. Do not build a long-lived external product on “v1 is stable” until versioning says otherwise.
Platforms¶
| Surface | Requirement |
|---|---|
| Backend | EVE-NG is the currently supported execution platform. eve-iac does not modify EVE PHP, Vue, or dataplane. |
| Agent package | amd64 Debian (.deb on the EVE host) |
| Operator IDE | VS Code or Cursor ^1.85.0 (engines.vscode) |
| Operator OS | Windows 10/11 x64; macOS Intel or Apple silicon; Linux x64 or arm64 |
| CLI / Python SDK | Python 3 |
| Node SDK | Node-capable workstation; package is @eve-iac/sdk from GitLab npm |
| Go SDK | Release tarball + replace (no public module proxy) |
Image and template availability (IOL, QEMU, docker, VPCS, …) is per EVE host. Validate against live templates. Do not assume a lab that imported on one server will deploy on another missing those images.
Feature floors (older than current)¶
These are historical minimums, not current download names. Current files are eve-iac-agent_0.4.7-1_amd64.deb and eve-iac-client-0.4.7.vsix.
| Floor | Why it exists |
|---|---|
| Agent 0.4.2-2 | Import of HTML workbook tasks where native id is a JSON string |
| Agent 0.4.3-1 | Deploy no longer REST-replays every node after ZIP import |
| CLI 0.4.3 | --insecure exists (lab/dev only) |
Limits that are documented, not guessed¶
| Topic | Status |
|---|---|
| Official node / lab scale numbers | Not published. Do not treat any lab size as a certified limit. |
| Continuous reconciliation | Not implemented (by design). Git-driven push from CI/humans only. |
| Durable console audit log | Not in V1. Hub history is a 64 KiB ring; it dies with the Hub. |
| Public PyPI / npm / Go proxy / Marketplace / Debian archive | Not used. GitLab Package Registry + Release only. |
| Serial NETEM | 400 serial_impairment_unsupported |
| Concurrent console Hubs | Max 64 |
| LOAD vs CREATE/IMPORT | LOAD has no topology ownership; no deploy/reconcile/destroy |
Distribution¶
| Artifact | Where |
|---|---|
Agent .deb, VSIX, wheel, npm tarball, Go tarball |
GitLab Release v0.4.7-1 and this project’s Package Registry |
| Documentation | eve-iac.io (this site) |
Install steps: VS Code / Cursor, CLI, packages.