sjat/boma
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
boma/roles/integration_test/README.md

1.6 KiB
Raw Blame History

integration_test

Installs the KVM/libvirt substrate on the control node (ubongo) so the agent can boot throwaway Debian VMs for local integration testing (ADR-025).

This is a non-service role — no SECURITY/VERIFY/ACCESS/BACKUP files are required. It does not make ubongo a production hypervisor; it only provides the tooling needed to spin up short-lived test VMs (see ADR-015).

Target group

control (i.e. ubongo)

What it does

  1. Installs QEMU/KVM, libvirt daemon + clients, virt-install, and cloud-image tools (cloud-image-utils, genisoimage).
  2. Enables and starts libvirtd.
  3. Adds the configured users (sjat, claude) to the libvirt and kvm groups so VMs can be managed without sudo.
  4. Creates /var/lib/boma-integration (owned root:libvirt, mode 2775) as the cache directory for golden images and overlays.

Defaults

Variable Default Purpose
integration_test__packages see defaults/main.yml APT packages to install
integration_test__users [sjat, claude] Users granted libvirt/kvm access
integration_test__cache_dir /var/lib/boma-integration Image/overlay cache directory

Related decisions

  • ADR-025 — local VM integration testing
  • ADR-015 — control host scope (ubongo is not a hypervisor)