feat: boot a test VM with mkosi -f vm

The [Runtime] section of mkosi.conf sets up mkosi vm for testing: it
passes the setup credentials (mkosi.credentials/agent.ssh-key prints your
own ssh keys), forwards ssh to port 2222 and adds the serial console,
since systemd-stub ignores the console= mkosi passes under Secure Boot.

Untested: in a container without systemd, mkosi vm hangs before qemu
starts, because it can't create a systemd scope.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Job79andClaude Opus 5.5 committed 2026-11-16 21:02:43 +01:00
1 parent ce1faca070
commit eb8e4b440a
5 files changed
+25 -13

No files matched your search

-2
View File
@@ -1,4 +1,2 @@
mkosi.output/
mkosi.key
test.qcow2
vars.fd
+3 -9
View File
@@ -27,16 +27,10 @@ mkosi genkey # local test only, CI uses the SECUREBOOT_KEY secret
mkosi build
```
`mkosi.output/` then holds the disk image (`agent_<version>.raw`) and the UKI and root partitions that make up an update. To boot it with Secure Boot (needs `qemu-kvm-core edk2-ovmf`):
`mkosi.output/` then holds the disk image (`agent_<version>.raw`) and the UKI and root partitions that make up an update. To build and boot a test VM with Secure Boot (needs `qemu-kvm-core edk2-ovmf`):
```sh
qemu-img create -f qcow2 -F raw -b $PWD/mkosi.output/agent_<version>.raw test.qcow2 40G
cp /usr/share/edk2/ovmf/OVMF_VARS.fd vars.fd
qemu-kvm -m 8G -cpu host -nographic -nic user,model=virtio-net-pci,hostfwd=tcp::2222-:22 -drive file=test.qcow2,if=virtio \
-machine q35,smm=on -global driver=cfi.pflash01,property=secure,value=on \
-drive if=pflash,format=raw,readonly=on,file=/usr/share/edk2/ovmf/OVMF_CODE.secboot.fd -drive if=pflash,format=raw,file=vars.fd \
-smbios type=11,value=io.systemd.credential:agent.password=test \
-smbios type=11,value=io.systemd.credential.binary:agent.ssh-key=$(base64 -w0 ~/.ssh/id_ed25519.pub)
mkosi -f vm
```
The credentials answer the setup, so it boots straight to a login (root, password `test`) on the serial console. Ctrl-a x quits. Then `ssh -p 2222 claude@localhost`.
The `[Runtime]` section of `mkosi.conf` answers the setup, so it boots straight to a login (root, password `test`). Then `ssh -p 2222 claude@localhost` with your own key (`mkosi.credentials/agent.ssh-key`).
+14
View File
@@ -138,3 +138,17 @@ RemoveFiles=
SecureBoot=yes
SecureBootKey=mkosi.key
SecureBootCertificate=mkosi.crt
[Runtime]
# For testing with mkosi vm. It does the setup itself (the agent.* credentials,
# mkosi.extra/usr/libexec/agent-setup). Its console is hvc0, which the UKI
# doesn't use: with Secure Boot, systemd-stub ignores the console= mkosi
# passes. So the serial port joins that console, and replaces mkosi's network
# to forward ssh to port 2222. Ephemeral boots a copy, so test runs don't
# change the built image.
Ephemeral=yes
RAM=8G
RuntimeSize=40G
RuntimeNetwork=none
QemuArgs=-serial chardev:console -nic user,model=virtio-net-pci,hostfwd=tcp::2222-:22
Credentials=agent.password=test agent.hostname=agent-test mkosi.credentials/
+6
View File
@@ -0,0 +1,6 @@
#!/bin/sh
# SSH key for mkosi vm
#
# mkosi vm runs this and passes what it prints as the credential agent.ssh-key
# (mkosi.conf), so you can ssh into the test VM with your own keys.
cat ~/.ssh/*.pub 2>/dev/null || true
+2 -2
View File
@@ -8,8 +8,8 @@
# boot.
#
# With the credential agent.password, it asks nothing and takes the answers
# from the credentials agent.password, agent.hostname and agent.ssh-key, such
# as for a test VM (README.md).
# from the credentials agent.password, agent.hostname and agent.ssh-key. mkosi
# vm passes them (mkosi.conf).
set -euo pipefail
cred() { cat "${CREDENTIALS_DIRECTORY:-/nonexistent}/agent.$1" 2>/dev/null; }