feat: show why units failed, with their last journal lines
Failed jobs keep their kind: units that broke or timed out get a failure panel entry with the reason systemd reports (exit status, signal, timeout, start limit, status text) and their last journal lines read through libsystemd. Units that failed only through a dependency are dimmed and left out of the panel, and units that crash after starting count as failed. Restructure the repository around this: - move the library and binary into bootvine/ and the scripted demos into their own unpublished scripted-demos crate, with their VHS tapes - move the crane builds and NixOS module into nix/ - group each sample VM with its check under vm-tests/, adding text-console, scripted-initrd, encrypted-volume and failures machines and a vm-failures check - add docs/guide.md walking through the screen with every recording, keep one recording in the README, and re-render all recordings
This commit is contained in:
1 parent
f2544a964a
commit
7e95cbd8e9
96 files changed
+2027
-462
No files matched your search
@@ -11,21 +11,16 @@ gave me any idea of what was going on.
|
||||
|
||||
<img src="https://codeberg.org/wvhulle/bootvine/raw/branch/main/recordings/boot.gif" width="691" alt="A boot through the initrd into stage 2, with one failed unit">
|
||||
|
||||
It follows shutdowns and reboots too: the units being stopped, nested under the
|
||||
units that have to stop first.
|
||||
|
||||
<img src="https://codeberg.org/wvhulle/bootvine/raw/branch/main/recordings/shutdown.gif" width="691" alt="A poweroff: units stopping under the targets waiting on them">
|
||||
|
||||
Passphrase prompts, such as a
|
||||
[LUKS](https://gitlab.com/cryptsetup/cryptsetup) unlock in the initrd, are
|
||||
answered in place over the tree.
|
||||
|
||||
<img src="https://codeberg.org/wvhulle/bootvine/raw/branch/main/recordings/passphrase.png" width="640" alt="A LUKS passphrase prompt floating over the initrd tree">
|
||||
It also follows shutdowns, answers passphrase prompts such as a
|
||||
[LUKS](https://gitlab.com/cryptsetup/cryptsetup) unlock in place, and shows why
|
||||
a unit failed with its last journal lines. The
|
||||
[guide](https://codeberg.org/wvhulle/bootvine/src/branch/main/docs/guide.md)
|
||||
walks through each part of the screen.
|
||||
|
||||
## Requirements
|
||||
|
||||
- systemd ≥ 246 as PID 1
|
||||
- [libdbus](https://www.freedesktop.org/wiki/Software/dbus/)
|
||||
- [libdbus](https://www.freedesktop.org/wiki/Software/dbus/) and libsystemd
|
||||
- a virtual terminal
|
||||
- a systemd initrd, to show the boot from the initrd as well as stage 2
|
||||
|
||||
@@ -34,33 +29,23 @@ for each distribution.
|
||||
|
||||
## Try it without installing
|
||||
|
||||
Neither of these touches your system's boot.
|
||||
|
||||
Play a scripted boot, poweroff and encrypted-root boot in your terminal, with
|
||||
[Rust](https://www.rust-lang.org/tools/install) installed:
|
||||
With [Nix](https://nixos.org/download/), boot a sample [NixOS](https://nixos.org) machine with slow and
|
||||
failing units in a [QEMU](https://www.qemu.org) window, without touching your
|
||||
system's boot:
|
||||
|
||||
```sh
|
||||
git clone https://codeberg.org/wvhulle/bootvine.git
|
||||
cd bootvine
|
||||
cargo run --example boot
|
||||
cargo run --example shutdown
|
||||
cargo run --example luks
|
||||
nix run git+https://codeberg.org/wvhulle/bootvine#sample-vm-slow-services
|
||||
```
|
||||
|
||||
`q` quits. The encrypted root unlocks with the passphrase `demo`; `Esc` quits
|
||||
while it asks.
|
||||
|
||||
Or, with [Nix](https://nixos.org/download/), boot a sample [NixOS](https://nixos.org) machine with slow and
|
||||
failing units in a [QEMU](https://www.qemu.org) window:
|
||||
|
||||
```sh
|
||||
nix run git+https://codeberg.org/wvhulle/bootvine#sample-machine-vm
|
||||
```
|
||||
|
||||
It logs in as root; `poweroff` shows the shutdown.
|
||||
It logs in as root; `poweroff` shows the shutdown. The
|
||||
[guide](https://codeberg.org/wvhulle/bootvine/src/branch/main/docs/guide.md#trying-it)
|
||||
lists the other sample machines and the scripted demos that play in a terminal.
|
||||
|
||||
## Documentation
|
||||
|
||||
- [Guide](https://codeberg.org/wvhulle/bootvine/src/branch/main/docs/guide.md)
|
||||
to the screen: the tree, the timeline, failures, shutdown and passphrase
|
||||
prompts.
|
||||
- [Install](https://codeberg.org/wvhulle/bootvine/src/branch/main/docs/install.md)
|
||||
on NixOS, Ubuntu and other distributions.
|
||||
- [Configuration](https://codeberg.org/wvhulle/bootvine/src/branch/main/docs/configuration.md)
|
||||
|
||||
Reference in new issue
Block a user