|
Some checks are pending
ci / test (push) Waiting to run
- Mango + DankMaterialShell desktop option (desktop.profile = "mango") through the GURU overlay with scoped ~amd64 keywords, a sealed session entry point and a dwl fallback session (ADR 0009). - Coherent rollback/recovery: coordinated @ + @var snapshots, fstab and BLS root-subvolume rewriting, matching-kernel selection, snapshot recovery entry, retention/space gates and sys undo (ADR 0007). - Installed assistant (sys ask) with an OS-level systemd sandbox boundary and fail-closed typed plans; resolved package effects bound to approval. - Nix build isolation enforced (sandbox, no fallback) plus lifecycle/cleanup. - Desktop helpers (menu/lock/idle), transaction log, release gates with atomic publish and signing helpers, and a Debian-Live appliance VM harness. |
||
|---|---|---|
| .. | ||
| appliance-driver.py | ||
| appliance-guest.sh | ||
| appliance-test.conf.example | ||
| install.sh | ||
| README.md | ||
| run-vm.sh | ||
| serial-driver.py | ||
| test.conf.example | ||
Disposable UEFI VM harness
Proves that the installer produces a bootable encrypted system without ever touching a physical disk. The target is always a qcow2 file.
Files
run-vm.shinteractive QEMU launcher (manual testing).install.shguest-side, non-interactive installation (run in the VM).serial-driver.pyhost-side pexpect driver (installandbootmodes).test.conf.exampleinstaller configuration used by the driver.
Host prerequisites
qemu-system-x86_64,qemu-img, OVMF firmware, Pythonpexpect.- The reference Gentoo ISO.
- The static Rust installer (the guest never runs the Bash tree):
cd installer-rs
RUSTFLAGS="-C target-feature=+crt-static" \
cargo build --release -p phoebus-installer --target x86_64-unknown-linux-gnu
Procedure
Serve the static installer, the stage3 and the config to the guest:
cd /path/to/serve
cp /path/to/phoebus_os/installer-rs/target/x86_64-unknown-linux-gnu/release/phoebus-installer .
cp /path/to/phoebus_os/installer/tests/vm/install.sh .
cp /path/to/phoebus_os/installer/tests/vm/test.conf.example test.conf # edit TARGET_DISK etc.
sha256sum stage3.tar.xz # set STAGE3_SHA256
python3 -m http.server 8000 --bind 127.0.0.1
Run the installation (driver boots the ISO kernel/initrd directly and drives the serial console):
QEMU_BIN=/path/to/qemu-system-x86_64 \
QEMU_LIBDIR=/path/to/qemu/libs \
QEMU_DATADIR=/path/to/qemu/share \
OVMF_CODE=/path/to/OVMF_CODE_4M.fd \
OVMF_VARS=/path/to/OVMF_VARS.fd \
DISK=/tmp/phoebus/target.qcow2 \
ISO=/path/to/livegui-amd64.iso \
KERNEL=/tmp/live/boot/gentoo INITRD=/tmp/live/boot/gentoo.igz \
INSTALL_URL=http://10.0.2.2:8000/install.sh \
python3 installer/tests/vm/serial-driver.py install
Then boot the disk alone (ISO detached) and verify:
DISK=/tmp/phoebus/target.qcow2 OVMF_CODE=... OVMF_VARS=... \
python3 installer/tests/vm/serial-driver.py boot
To patch a console into an existing entry for observation, the BLS entry in
/efi/loader/entries/*.conf takes an options line; the installer can also
embed a console via KERNEL_CONSOLE (GENTOO_KERNEL_CONSOLE equivalent).
Safety
DISKmust be a qcow2 image; never point it at/dev/*.- The installer itself classifies the ISO's device as protected.
- Secrets are passed through 0600 files and are checked for leakage in the
installer log by
install.sh.