From 8c79515c867ece9da658728e0da51df9786c3220 Mon Sep 17 00:00:00 2001 From: Jorge Castro Date: Mon, 28 Sep 2026 22:11:49 -0400 Subject: [PATCH 1/4] fix(installer): boot offline, allow credential overrides, quiet repart warnings Found by booting the CI-built installer in QEMU: - With no network the initrd waited forever on network-online (systemd-networkd-wait-online, no limit). Mask it in the installer UKI's initrd, as the disk UKI already does. - Rename the sysinstall drop-in to 10-bluefin-installer.conf so systemd.unit-dropin.* credential drop-ins (50-*) can override ExecStart for unattended installs. - Mount the installer ESP with fmask=0133,dmask=0022; vfat otherwise reports every file executable and systemd-repart warns per definition. Assisted-by: claude-opus-5.5 via GitHub Copilot Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- elements/oci/bluefin-server-boot.bst | 7 +++++-- files/os/systemd/system/run-bluefin-installer.mount | 4 +++- .../{bluefin-installer.conf => 10-bluefin-installer.conf} | 0 3 files changed, 8 insertions(+), 3 deletions(-) rename files/os/systemd/system/systemd-sysinstall.service.d/{bluefin-installer.conf => 10-bluefin-installer.conf} (100%) diff --git a/elements/oci/bluefin-server-boot.bst b/elements/oci/bluefin-server-boot.bst index 9437a2c3..b9d9ce62 100644 --- a/elements/oci/bluefin-server-boot.bst +++ b/elements/oci/bluefin-server-boot.bst @@ -85,13 +85,16 @@ variables: # The installer medium opens its own usr/verity by partition label, not by # the usrhash-derived UUIDs: those belong to installed usr slots, so an # existing install (or the disk being installed) is never picked up as the - # installer's /usr. tty0 comes last so /dev/console, where - # systemd-sysinstall.service draws its interface, is the monitor. + # installer's /usr. The installer is offline: the initrd must not wait for + # network-online (no limit; netboot needs it, the installer never does). + # tty0 comes last so /dev/console, where systemd-sysinstall.service draws + # its interface, is the monitor. installer-cmdline: >- root=tmpfs systemd.verity_usr_data=/dev/disk/by-partlabel/bluefin-installer-usr systemd.verity_usr_hash=/dev/disk/by-partlabel/bluefin-installer-usr-verity rd.systemd.mask=systemd-repart.service systemd.mask=systemd-repart.service + rd.systemd.mask=systemd-networkd-wait-online.service systemd.mask=boot.automount systemd.mask=boot.mount systemd.unit=system-install.target systemd.setenv=BLUEFIN_INSTALL_KERNEL=/run/bluefin/installer/bluefin/bluefin-server-%{image-version}.efi diff --git a/files/os/systemd/system/run-bluefin-installer.mount b/files/os/systemd/system/run-bluefin-installer.mount index 0cea14b2..f6f1f261 100644 --- a/files/os/systemd/system/run-bluefin-installer.mount +++ b/files/os/systemd/system/run-bluefin-installer.mount @@ -6,4 +6,6 @@ Documentation=man:systemd-sysinstall(8) What=/dev/disk/by-partlabel/bluefin-installer Where=/run/bluefin/installer Type=vfat -Options=ro,nosuid,nodev,noexec +# fmask: vfat has no permission bits; without it every file reads as +# executable and systemd-repart warns about each repart.d definition. +Options=ro,nosuid,nodev,noexec,fmask=0133,dmask=0022 diff --git a/files/os/systemd/system/systemd-sysinstall.service.d/bluefin-installer.conf b/files/os/systemd/system/systemd-sysinstall.service.d/10-bluefin-installer.conf similarity index 100% rename from files/os/systemd/system/systemd-sysinstall.service.d/bluefin-installer.conf rename to files/os/systemd/system/systemd-sysinstall.service.d/10-bluefin-installer.conf From 14dcd306cead05219bcc9bfe4dc2d4c24e589213 Mon Sep 17 00:00:00 2001 From: Jeffrey Sica Date: Tue, 29 Sep 2026 00:31:39 -0500 Subject: [PATCH 2/4] test: add an end-to-end QEMU check of the offline USB installer scripts/dogfood-installer.sh boots bluefin-server-installer_.raw with Secure Boot and no network next to a blank disk, makes the shipped systemd-sysinstall.service unattended with a systemd.unit-dropin.systemd-sysinstall.service SMBIOS credential (the image drop-in's ExecStart= plus the target and --erase=yes --confirm=no --variables=yes, StandardInput=null so no prompt can hang), answers systemd-firstboot with firstboot.* credentials, and waits for the reboot. It then boots the target alone and again with the installer attached and checks that /usr is backed by the target's bluefin_usr_ slot (never bluefin-installer-usr), that slot B and the xfs root appear on first boot, and that no unit failed. Refs #265 Assisted-by: Claude Opus 5.5 via GitHub Copilot Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- scripts/dogfood-installer.sh | 235 +++++++++++++++++++++++++++++++++++ 1 file changed, 235 insertions(+) create mode 100644 scripts/dogfood-installer.sh diff --git a/scripts/dogfood-installer.sh b/scripts/dogfood-installer.sh new file mode 100644 index 00000000..88559639 --- /dev/null +++ b/scripts/dogfood-installer.sh @@ -0,0 +1,235 @@ +#!/usr/bin/env bash +# End-to-end check of the offline USB installer in QEMU with Secure Boot: +# 1. boot bluefin-server-installer_.raw once so systemd-boot enrolls +# the dev keys (secure-boot-enroll if-safe) +# 2. boot it with a blank target disk and no network; the shipped +# systemd-sysinstall.service runs unattended and reboots +# 3. boot the target disk on its own: /usr must come from its +# bluefin_usr_ slot, the first boot creates slot B and the xfs root, +# and no unit may fail +# 4. boot the target again with the installer still attached: /usr must +# still come from the target, never from the installer's +# bluefin-installer-usr partition +# +# systemd-sysinstall is interactive on /dev/console. The test makes it +# unattended with a systemd.unit-dropin.systemd-sysinstall.service SMBIOS +# credential (installed as 50-credential.conf, after the image's +# 10-bluefin-installer.conf) that re-runs the image drop-in's ExecStart= with +# the target disk and --erase=yes --confirm=no --variables=yes appended, and +# with StandardInput=null: the only prompt left is "Press any key" before the +# reboot, which EOF answers, and any prompt a regression adds fails at once +# instead of hanging. +# +# Usage: dogfood-installer.sh .raw> +# Environment: +# DOGFOOD_STATE= logs, target disk and UEFI vars (default dist/dogfood-installer) +# DOGFOOD_TARGET_DISK= target disk image, recreated blank (default /target.raw) +# DOGFOOD_TARGET_DEV= target device the installer is told to use +# (default /dev/disk/by-id/virtio-bluefin-target) +# DOGFOOD_SYSINSTALL_ARGS=.. extra systemd-sysinstall arguments +# (default --erase=yes --confirm=no --variables=yes) +# DOGFOOD_SYSINSTALL_CRED=0 do not pass the unattended drop-in credential +# DOGFOOD_MEM= guest memory (default 4096) +# DOGFOOD_TIMEOUT= per-boot timeout (default 600) +set -euo pipefail + +here="$(cd "$(dirname "$0")" && pwd)" +dir="$(realpath "${1:?usage: $0 }")" +state="$(realpath -m "${DOGFOOD_STATE:-dist/dogfood-installer}")" +mem="${DOGFOOD_MEM:-4096}" +timeout_s="${DOGFOOD_TIMEOUT:-600}" +target_serial=bluefin-target +target_dev="${DOGFOOD_TARGET_DEV:-/dev/disk/by-id/virtio-${target_serial}}" +install_args="${DOGFOOD_SYSINSTALL_ARGS:---erase=yes --confirm=no --variables=yes}" +dropin_src="${here}/../files/os/systemd/system/systemd-sysinstall.service.d/10-bluefin-installer.conf" + +installer="$(ls "${dir}"/bluefin-server-installer_*.raw 2>/dev/null | tail -n1)" \ + || { echo "ERROR: no bluefin-server-installer_.raw in ${dir}" >&2; exit 1; } +ver="${installer##*/bluefin-server-installer_}"; ver="${ver%.raw}" + +first_existing() { for f in "$@"; do [ -f "$f" ] && { echo "$f"; return 0; }; done; return 1; } +code="${OVMF_CODE:-$(first_existing \ + /usr/share/edk2/ovmf/OVMF_CODE.secboot.fd \ + /usr/share/OVMF/OVMF_CODE_4M.secboot.fd \ + /usr/share/OVMF/OVMF_CODE.secboot.fd \ + /usr/share/edk2/x64/OVMF_CODE.secboot.4m.fd)}" || { echo "ERROR: no Secure Boot OVMF_CODE found (set OVMF_CODE)" >&2; exit 1; } +vars_tmpl="${OVMF_VARS:-$(first_existing \ + /usr/share/edk2/ovmf/OVMF_VARS.fd \ + /usr/share/OVMF/OVMF_VARS_4M.fd \ + /usr/share/OVMF/OVMF_VARS.fd \ + /usr/share/edk2/x64/OVMF_VARS.4m.fd)}" || { echo "ERROR: no blank OVMF_VARS found (set OVMF_VARS)" >&2; exit 1; } + +rm -rf "${state}" +mkdir -p "${state}" +target="${DOGFOOD_TARGET_DISK:-${state}/target.raw}" +[ -b "${target}" ] && { echo "ERROR: ${target} is a block device; use a disk image file" >&2; exit 1; } +rm -f "${target}" +truncate -s 16G "${target}" +vars="${state}/vars.fd" +cp "${vars_tmpl}" "${vars}" + +fail() { + echo "FAIL: $* (logs: ${state})" >&2 + exit 1 +} + +cred() { printf 'type=11,value=io.systemd.credential.binary:%s=%s' "$1" "$(base64 -w0 < "$2")"; } + +qemu=(qemu-system-x86_64 + -machine q35,smm=on,accel=kvm -cpu host -m "${mem}" -smp 2 + -global driver=cfi.pflash01,property=secure,value=on + -drive if=pflash,format=raw,unit=0,readonly=on,file="${code}" + -drive if=pflash,format=raw,unit=1,file="${vars}" + -display none -monitor none -no-reboot + ) +# snapshot=on keeps the release artifact untouched. +stick=(-drive "if=none,id=stick,format=raw,snapshot=on,file=${installer}" + -device virtio-blk-pci,drive=stick,serial=bluefin-installer) +disk=(-drive "if=none,id=target,format=raw,file=${target}" + -device "virtio-blk-pci,drive=target,serial=${target_serial}") + +# boot : run QEMU until it exits (-no-reboot +# turns every reboot into an exit), shows up in the ttyS1 log, +# or the timeout hits. Serial logs land in ${state}/.*.log. +boot() { + local name="$1" done_re="$2"; shift 2 + local log="${state}/${name}" + "${qemu[@]}" "$@" \ + -serial "file:${log}.ttyS0" -serial "file:${log}.ttyS1" -serial "file:${log}.ttyS2" \ + "${log}.qemu.log" 2>&1 & + local pid=$! deadline=$(( $(date +%s) + timeout_s )) + while kill -0 "${pid}" 2>/dev/null && [ "$(date +%s)" -lt "${deadline}" ]; do + # A few seconds of grace so the journal mirror catches up. + [ -n "${done_re}" ] && grep -aqE "${done_re}" "${log}.ttyS1" 2>/dev/null && { sleep 3; break; } + sleep 2 + done + local timed_out=0 + if kill -0 "${pid}" 2>/dev/null; then + [ "$(date +%s)" -ge "${deadline}" ] && timed_out=1 + kill "${pid}" 2>/dev/null || true + fi + wait "${pid}" 2>/dev/null || true + for s in ttyS0 ttyS1 ttyS2; do + sed 's/\x1b\[[0-9;?]*[a-zA-Z]//g; s/\x1bP[^\x1b]*\x1b\\//g' "${log}.${s}" 2>/dev/null \ + | tr -d '\r' > "${log}.${s}.log" || true + rm -f "${log}.${s}" + done + grep -aoE 'PROBE[ -].*' "${log}.ttyS1.log" || true + [ "${timed_out}" = 0 ] || { tail -n 40 "${log}.ttyS0.log" >&2; fail "${name}: no result within ${timeout_s}s"; } +} + +echo "==> 1/4 enroll Secure Boot keys from the installer (${ver})" +boot 1-enroll '' "${stick[@]}" -nic none +grep -aq 'successfully enrolled' "${state}/1-enroll.ttyS0.log" || fail "key enrollment" + +exec_start="$(sed -n 's/^ExecStart=\(..*\)$/\1/p' "${dropin_src}" | tail -n1)" +[ -n "${exec_start}" ] || fail "no ExecStart= in ${dropin_src}" +cat > "${state}/sysinstall.conf" </dev/ttyS1 2>&1; echo "PROBE sysinstall=\$\${SERVICE_RESULT} \$\${EXIT_STATUS}"; udevadm settle -t 10 || true; echo "PROBE installed-slot-b=\$\$(lsblk -rno PARTLABEL ${target_dev} | grep -cx _empty)"; lsblk -o NAME,PARTLABEL,FSTYPE,SIZE ${target_dev} | sed "s/^/PROBE-LOG installed /"' +EOF +cat > "${state}/journal.service" <<'EOF' +[Unit] +Description=Dogfood journal mirror on ttyS2 +DefaultDependencies=no +[Service] +ExecStart=journalctl -b -f --no-pager -o short-monotonic +StandardOutput=tty +TTYPath=/dev/ttyS2 +EOF +install_creds=(-smbios "$(cred systemd.extra-unit.dogfood-journal.service "${state}/journal.service")") +# systemd-firstboot prompts on the installer console first; answer it the +# unattended way. sysinstall copies locale, keymap and timezone to the target. +for kv in firstboot.locale=C.UTF-8 firstboot.keymap=us firstboot.timezone=UTC 'passwd.hashed-password.root=!*'; do + printf '%s' "${kv#*=}" > "${state}/${kv%%=*}" + install_creds+=(-smbios "$(cred "${kv%%=*}" "${state}/${kv%%=*}")") +done +if [ "${DOGFOOD_SYSINSTALL_CRED:-1}" != 0 ]; then + install_creds+=(-smbios "$(cred systemd.unit-dropin.systemd-sysinstall.service "${state}/sysinstall.conf")") +fi + +echo "==> 2/4 offline install: ExecStart=${exec_start} ${install_args} ${target_dev}" +# Offline (-nic none): the installer must not need a network. +boot 2-install 'PROBE sysinstall=([^s]|s[^u])' \ + "${stick[@]}" "${disk[@]}" -nic none "${install_creds[@]}" +grep -aq 'PROBE sysinstall=success' "${state}/2-install.ttyS1.log" \ + || { grep -a 'sysinstall' "${state}/2-install.ttyS2.log" | grep -v audit | tail -n 20 >&2 || true; fail "systemd-sysinstall did not succeed"; } +grep -aq 'PROBE installed-slot-b=0' "${state}/2-install.ttyS1.log" \ + || fail "slot B exists before the first boot of the target" + +{ + printf 'ver=%q\ntarget=/dev/disk/by-id/virtio-%s\n' "${ver}" "${target_serial}" + cat <<'PROBE' +serial() { cat "/sys/block/$(lsblk -dno PKNAME "$1")/serial" 2>/dev/null; } +echo "PROBE secureboot=$(bootctl status 2>/dev/null | sed -n 's/.*Secure Boot: *//p' | head -n1)" +echo "PROBE os=$(. /usr/lib/os-release; echo "${IMAGE_ID} ${IMAGE_VERSION}")" +dm="$(basename "$(readlink -f /dev/mapper/usr)")" +for s in /sys/block/"${dm}"/slaves/*; do + p="/dev/${s##*/}" + echo "PROBE usr-backing=$(lsblk -dno PARTLABEL "${p}")@$(serial "${p}")" +done +echo "PROBE root=$(findmnt -no FSTYPE /)@$(serial "$(findmnt -no SOURCE /)")" +echo "PROBE slot-b=$(lsblk -rno PARTLABEL "${target}" | grep -cx _empty)" +lsblk -o NAME,PARTLABEL,FSTYPE,SIZE,MOUNTPOINTS | sed 's/^/PROBE-LOG /' +for s in /sys/block/*/serial; do echo "PROBE-LOG $(basename "$(dirname "${s}")") serial=$(cat "${s}")"; done +boots=$(( $(cat /var/lib/dogfood-boots 2>/dev/null || echo 0) + 1 )) +echo "${boots}" > /var/lib/dogfood-boots +echo "PROBE boots=${boots}" +sync +echo "PROBE failed=$(systemctl --failed --no-legend | wc -l) $(systemctl --failed --no-legend --plain | cut -d' ' -f1 | tr '\n' ' ')" +PROBE +} > "${state}/probe.sh" +cat > "${state}/probe.service" <<'UNIT' +[Unit] +Description=Dogfood boot probe +After=multi-user.target +[Service] +Type=oneshot +ImportCredential=dogfood.probe +TimeoutStartSec=infinity +StandardOutput=tty +StandardError=tty +TTYPath=/dev/ttyS1 +ExecStart=/bin/bash ${CREDENTIALS_DIRECTORY}/dogfood.probe +[Install] +WantedBy=multi-user.target +UNIT +printf '[Unit]\nWants=dogfood-probe.service\n' > "${state}/probe-wants.conf" +probe_creds=( + -smbios "$(cred dogfood.probe "${state}/probe.sh")" + -smbios "$(cred systemd.extra-unit.dogfood-probe.service "${state}/probe.service")" + -smbios "$(cred systemd.unit-dropin.multi-user.target~dogfood-probe "${state}/probe-wants.conf")" +) + +check_disk_boot() { + local log="${state}/$1.ttyS1.log" serial0="${state}/$1.ttyS0.log" b + grep -aq 'PROBE failed=' "${log}" || fail "$1: probe did not run" + grep -aq "PROBE os=bluefin-server ${ver}" "${log}" || fail "$1: not running ${ver}" + grep -aq "PROBE boots=$2" "${log}" || fail "$1: expected boot $2 of the persistent root" + grep -aq "PROBE root=xfs@${target_serial}" "${log}" || fail "$1: / is not the target's xfs root" + grep -aq 'PROBE slot-b=2' "${log}" || fail "$1: slot B (usr + usr-verity) missing" + [ "$(grep -ac 'PROBE usr-backing=' "${log}")" -ge 2 ] || fail "$1: no dm-verity backing for /usr" + while read -r b; do + [[ "${b}" =~ ^PROBE\ usr-backing=bluefin_usr_(verity_)?${ver//./\\.}@${target_serial}$ ]] \ + || fail "$1: /usr backed by ${b#PROBE usr-backing=}, not the target's bluefin_usr_${ver} slot" + done < <(grep -aoE 'PROBE usr-backing=.*' "${log}") + grep -aq 'PROBE failed=0' "${log}" || fail "$1: failed units: $(grep -ao 'PROBE failed=.*' "${log}")" + ! grep -a '\[FAILED\]' "${serial0}" >&2 || fail "$1: units failed during boot" +} + +echo "==> 3/4 first boot of the target (creates slot B and the xfs root)" +boot 3-first-boot 'PROBE failed=' "${disk[@]}" -nic user,model=virtio-net-pci "${probe_creds[@]}" +check_disk_boot 3-first-boot 1 + +echo "==> 4/4 boot the target with the installer still attached" +boot 4-with-installer 'PROBE failed=' "${disk[@]}" "${stick[@]}" -nic user,model=virtio-net-pci "${probe_creds[@]}" +check_disk_boot 4-with-installer 2 + +echo "PASS: offline installer installed ${ver} onto a blank disk; the target booted twice (with and without the installer attached) from its own bluefin_usr_${ver} slot with slot B and the xfs root created on first boot and no failed units" From f5a8d974d0211c29a88dc2d79c26a0b0c8ae9df8 Mon Sep 17 00:00:00 2001 From: Jeffrey Sica Date: Tue, 29 Sep 2026 00:31:39 -0500 Subject: [PATCH 3/4] feat(just): add a dogfood-installer recipe Runs scripts/dogfood-installer.sh against dist/diskless, next to the other dogfood recipes. Assisted-by: Claude Opus 5.5 via GitHub Copilot Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- Justfile | 5 +++++ docs/skills/ddi-installer-build.md | 1 + 2 files changed, 6 insertions(+) diff --git a/Justfile b/Justfile index ce2c3e7d..cc92ae7e 100644 --- a/Justfile +++ b/Justfile @@ -136,6 +136,11 @@ set-version VERSION: dogfood-install NEXT="": bash scripts/dogfood-install.sh dist/diskless {{NEXT}} +# Boot the offline USB installer, install unattended to a blank disk, boot it (QEMU). +[group('diskless')] +dogfood-installer: + bash scripts/dogfood-installer.sh dist/diskless + # REF=ghcr.io//bluefin-server or :30500/bluefin-server # (PLAIN_HTTP=1); log in with podman login first. One layer per file. # Publish an image set as an ORAS OCI artifact tagged and latest. diff --git a/docs/skills/ddi-installer-build.md b/docs/skills/ddi-installer-build.md index 0d8e1067..cfb26614 100644 --- a/docs/skills/ddi-installer-build.md +++ b/docs/skills/ddi-installer-build.md @@ -77,6 +77,7 @@ just dogfood-check # headless: pass when the in-guest probe just dogfood-install # diskless boot, systemd-sysinstall to a blank # disk, then boot the installed disk just dogfood-install NEXT= # ...then sysupdate A->B to NEXT and boot it +just dogfood-installer # offline USB installer: unattended install to a blank disk, boot it with and without the stick ``` `scripts/dogfood-diskless.sh [--check]` boots the way a PXE/HTTP-booted From ff6f540d5c49d848490226624996752be4596ca4 Mon Sep 17 00:00:00 2001 From: Jeffrey Sica Date: Tue, 29 Sep 2026 00:31:39 -0500 Subject: [PATCH 4/4] ci: boot-test the offline USB installer end to end Append one boot-test step running scripts/dogfood-installer.sh on the image artifact, which already carries bluefin-server-installer_.raw (the build job uploads dist/diskless/ whole). A regression in the installer UKI command line, the sysinstall drop-in or run-bluefin-installer.mount now fails CI. Closes #265 Assisted-by: Claude Opus 5.5 via GitHub Copilot Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- .github/workflows/build.yml | 3 +++ docs/skills/ci-tooling.md | 2 +- 2 files changed, 4 insertions(+), 1 deletion(-) diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml index 5bcf73f0..290f8a35 100644 --- a/.github/workflows/build.yml +++ b/.github/workflows/build.yml @@ -147,6 +147,9 @@ jobs: - name: Install to disk and boot it run: bash scripts/dogfood-install.sh dist/diskless + - name: Install from the offline USB installer and boot it + run: bash scripts/dogfood-installer.sh dist/diskless + # Publishes the signed image set as a new, immutable GitHub Release and as # an ORAS OCI artifact (one layer per file, tags and latest). # Only runs on pushes/dispatches to main, where the code is already diff --git a/docs/skills/ci-tooling.md b/docs/skills/ci-tooling.md index 4eb28c2e..022e30e3 100644 --- a/docs/skills/ci-tooling.md +++ b/docs/skills/ci-tooling.md @@ -117,7 +117,7 @@ sudo_cmd := if `podman info >/dev/null 2>&1 && echo 1 || echo 0` == "1" { "" } e |-----|----------|---------|---------| | `track-junctions` | `track-junctions.yml` | `schedule` (08:00 UTC), `workflow_dispatch` | Resolves the `freedesktop-sdk.bst` + `gnome-build-meta.bst` junction refs, syncs `project.conf`'s `installer-version`, and opens/updates its own PR on `auto/track-junctions`. `contents: write` + `pull-requests: write`, never on `pull_request`. | | `build` | `build.yml` | `pull_request`, `push/main`, `workflow_dispatch` | Resolves the element graph, sets `image-version`, and runs the full BuildStream compile of the image set (OS DDI, signed UKIs, netboot ESP, k0s/KubeStellar/OpenZFS sysext assets), which also writes and signs the combined `SHA256SUMS` inside `oci/bluefin-server-image.bst`. On `main` it installs the `BOOT_KEYS_TARBALL` and `SYSUPDATE_SIGNING_KEY` secrets; both are required there. Read-only token. | -| `boot-test` | `build.yml` | `pull_request`, `push/main`, `workflow_dispatch` | Downloads the build job's exported image set and runs the Secure Boot QEMU checks: `scripts/dogfood-diskless.sh --check` (diskless boot) and `scripts/dogfood-install.sh` (install to disk and boot it). Read-only token. | +| `boot-test` | `build.yml` | `pull_request`, `push/main`, `workflow_dispatch` | Downloads the build job's exported image set and runs the Secure Boot QEMU checks: `scripts/dogfood-diskless.sh --check` (diskless boot), `scripts/dogfood-install.sh` (install to disk and boot it) and `scripts/dogfood-installer.sh` (offline USB installer: unattended `systemd-sysinstall` to a blank disk, then boot it with and without the installer attached). Read-only token. | | `release` | `build.yml` | `push/main`, `workflow_dispatch` | Publishes `dist/diskless/` as-is: an immutable GitHub Release tagged `v` plus an ORAS OCI artifact at `ghcr.io//bluefin-server:,latest` (one layer per file, artifact type `application/vnd.projectbluefin.server.release.v1`) (`if: ${{ !failure() && !cancelled() && github.ref == 'refs/heads/main' }}`). `contents: write` + `packages: write`. | | `docs` | `docs-checks.yml` | `pull_request`, `push/main` | Runs markdown and skill metadata checks via `docs-checks.py`. Read-only token. | | `unit` | `unit-tests.yml` | `pull_request`, `push/main` | Runs pytest and BATS unit test suites. Read-only token. |