add agent-lab sandbox VM on muede-pc2

This commit is contained in:
müde 2026-11-18 18:40:12 +01:00
commit 873622dc8a

View file

@ -44,3 +44,21 @@ Machines are configured to act as build servers / binary caches for each other i
```
4. Rebuild all machines so they trust the new signing key.
## agent-lab sandbox VM
`agent-lab` is a throwaway NixOS VM on muede-pc2 for hyperhive agents to ssh
into and apply risky configs to. The host (`nixosConfigurations/muede-pc2/agent-lab-vm.nix`)
only seeds its disk and runs qemu — it never declares the guest's system, so
the guest can `nixos-rebuild switch` itself freely.
- Reachable at `muede-pc2:2222` (qemu user-mode NAT forward), root ssh only,
authorized for the lpt2 and pc2 keys plus muede-pc2's build key.
- `sudo agent-lab-reset [flake-ref]` rebuilds the seed image, replaces the
disk, and restarts the VM. Takes seconds once the image is in the store.
Defaults to the upstream flake; pass a local path to test uncommitted work.
- `/etc/nix/netrc` is copied in over ssh on every VM start by
`agent-lab-vm-netrc.service`, so the private cache credential stays out of
the nix store. The host needs `/etc/nix/distributed-build-key` for this.
- The guest's own config is `nixosConfigurations/agent-lab/`; it is the seed
only. Whatever the agents switch to afterwards is not tracked here.