Zeus VM Tools

Zeus VM Tools

Product: Zeus VM Tools · Binary: zyvor-guest-agent · Package: zyvor-vm-tools

Kubernetes-native guest agent + drivers bootstrap for KubeVirt — the VMware Tools equivalent for Zeus OS / Zyvor.

Deep docs: zeus-vm-tools.md · guest-agent · KubeVirt · Guest Control Fabric.

What it does

Capability	Notes
Linux agent	guestkit.getStatus, heartbeat, evidence push
Snapshot quiesce	freeze / unfreeze
Soft reboot / graceful shutdown	Via API
Guest exec	QGA guest-exec through virt-launcher
Fleet coverage	Connected / pending / missing labels
Policy auto-install / upgrade	VMToolsPolicy + CronJob reconcile
Packages	DEB, RPM, tar.gz, ISO (build-artifacts.sh)
Windows MSI	Scaffold (Phase 4); virtio-win path for QGA today

Install methods

1. Cloud-init — merge agent + virtio channel (Linux)
2. QGA bootstrap — script when qemu-ga is already up
3. QGA file bootstrap — airgap: write tar via guest-file-write, then guest-exec (no guest network)
4. ISO attach — ?method=iso CDI DataVolume + /linux/install.sh
5. Offline inject — guestkit repair --inject-agent or repair-plan API

# Query params on install route
# ?restart=true|false&method=auto|cloud-init|qga|iso

Build & CRDs

./packaging/vmtools/build-artifacts.sh
kubectl apply -f deploy/crd/zeus-vmtools.yaml
# optional guest action policy
kubectl apply -f deploy/crd/zeus-guest-action-policy.yaml

Labels

metadata:
  labels:
    zeus.zyvor.dev/guest-tools: connected|pending|missing
  annotations:
    zeus.zyvor.dev/tools-version: "0.1.0"

Key API routes (abbrev.)

Path	Purpose
GET /api/v1/vmtools/coverage	Fleet coverage
GET/PUT /api/v1/vmtools/policy	Auto-install policy
POST …/vmtools/policy/reconcile	Manual / CronJob reconcile
POST …/kubevirt/vms/{ns}/{name}/vmtools/install	Install tools
`POST …/vmtools/quiesce	unquiesce
GET …/guest/doctor · …/guest/capabilities	Agent Doctor / contract

Full table: zeus-vm-tools.md § API.

Web demos

Web Dashboard Tour · Web Tutorial · Machina × GuestKit agent