Files
takana/scripts/selfhost-verify.sh
T
sergioandClaude Opus 4.8 e9f535a1bb selfhost-verify: pieza 4 (bwrap swap) + materialización de build-deps en el lab
Cuarta pieza del toolchain hammer-from-source (variante b, SDD 11 §7.2b): bubblewrap, el
sandbox del propio lab. Binario estático ⇒ swap de archivo sobre /toolchain/usr/bin/bwrap.
Como herramienta del toolchain (no input del 4/4) no necesita casar byte-a-byte con Alpine,
sólo aislar igual.

Tres piezas:
- recipes/libcap.toml (2.78): dep obligatoria de bwrap; el toolchain Alpine no trae el -dev
  (libcap.a / sys/capability.h). Build estático musl con zig cc, sin patches (es tool, no input).
- materialización de build-deps (hammer-build): deps.build ahora se CONSTRUYE recursivamente
  (build() llama build() por cada dep) y cada artefacto sellado se apila como capa --overlay-src
  bajo el rootfs del sandbox, dejando usr/{include,lib,lib/pkgconfig} en /usr. pkgconf y zig cc
  las hallan sin plumbing de flags. Recetas sin deps: sandbox byte-igual (baseline intacto).
  Tests nuevos: no_deps_emits_single_overlay_src, deps_stack_as_overlay_layers_under_rootfs.
- recipes/bwrap.toml (0.11.0): el toolchain no trae meson/ninja/python, así que bypaseamos meson
  compilando los 4 .c de bubblewrap directo con zig cc (+config.h trivial). deps.build=["libcap"].

Validación host fuerte: hammer-bwrap es estático, corre --version y sandboxea, y musl rebuildeó
BYTE-IDÉNTICO usándolo de sandbox (bisección). Expuesto con SWAP_BWRAP=1. Tests verdes.
Pendiente: corrida in-VM acumulando swaps para el sello ✓ REPRODUCIBLE.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-13 20:05:55 -04:00

202 lines
12 KiB
Bash
Executable File

#!/usr/bin/env bash
# selfhost-verify.sh — Verifica el auto-alojamiento bit a bit de Stage 1 de punta a punta
# (SDD 11 §7; runbook docs/runbooks/stage1-vm-boot.md §8c).
#
# Hace TODO el pipeline en una corrida, pensado para un host con KVM + RAM holgada (p. ej. una
# laptop): construye el store baseline, ensambla el builder, lo empaqueta como initramfs y lo bootea
# en QEMU, donde `rebuild-stage1` reconstruye stage1' con el toolchain de adentro y compara su
# content-hash (`of_tree`) con la referencia anclada afuera → ✓ REPRODUCIBLE / ✗ DIVERGENTE.
#
# Prerequisitos:
# - Lab de dev: ./scripts/bootstrap-devfs.sh (deja .dev-fs/alpine + .dev-fs/tools/zig)
# - qemu-system-x86_64, cpio, gzip; un kernel x86_64 en $KERNEL.
# - Red (el fetch de Rust hace `cargo vendor` desde crates.io).
#
# Variables (override por entorno):
# STORE store content-addressed (default ./store)
# KERNEL kernel a bootear en la VM (default /boot/vmlinuz-linux)
# MEM RAM de la VM en MiB (default 6144; con KVM subí a 8192+)
# KVM 1 ⇒ -enable-kvm -cpu host (default auto: 1 si hay /dev/kvm)
# PRESEED "all" rebuild 4/4 in-VM | "hammerd" preseed C+arje, sólo hammerd in-VM
# (default all; "hammerd" es el camino barato/rápido si la RAM va justa)
# EXPECT_REF content-hash esperado (cross-check de reproducibilidad entre máquinas; opcional)
# STAGE0_URL / STAGE0_SHA256 / SEED_VERSION semilla zig (defaults: zig 0.16.0)
#
# Uso típico en la laptop (con KVM):
# KVM=1 MEM=10240 ./scripts/selfhost-verify.sh
set -euo pipefail
REPO_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
cd "$REPO_ROOT"
STORE="${STORE:-store}"
KERNEL="${KERNEL:-/boot/vmlinuz-linux}"
MEM="${MEM:-6144}"
PRESEED="${PRESEED:-all}"
SEED_VERSION="${SEED_VERSION:-0.16.0}"
STAGE0_URL="${STAGE0_URL:-https://ziglang.org/download/0.16.0/zig-x86_64-linux-0.16.0.tar.xz}"
STAGE0_SHA256="${STAGE0_SHA256:-70e49664a74374b48b51e6f3fdfbf437f6395d42509050588bd49abe52ba3d00}"
TOOLCHAIN="${TOOLCHAIN:-.dev-fs/alpine}"
TOOLCHAIN_TAG="${TOOLCHAIN_TAG:-alpine-3.23.4-builder}"
# Referencia conocida-buena (store baseline en el host de dev, runbook §8c). Si tu corrida produce
# otra, o bien cambió algo del pin (toolchain/recipes/seed) o hay un no-determinismo nuevo.
# Baseline DETERMINISTA con codegen-units=1 + CARGO_BUILD_JOBS=1 en el sandbox: el segundo serializa
# el backend paralelo de rustc/LLVM (ThinLTO), sin el cual arje-zero divergía ~62 KB a >1 CPU (el
# viejo 0039b2b9… era un build paralelo no-reproducible). Ver §8c y SDD 09 §2.
EXPECT_REF="${EXPECT_REF:-b3:9adefb82b8457c8616cc89e6bb725a787ea52641f65d60d989d819e4872735ac}"
: "${KVM:=$([[ -w /dev/kvm ]] && echo 1 || echo 0)}"
say() { printf '\n\033[1;36m==> %s\033[0m\n' "$*"; }
die() { printf '\033[1;31mERROR: %s\033[0m\n' "$*" >&2; exit 1; }
[[ -x "$TOOLCHAIN/usr/bin/rustc" ]] || die "falta el lab: corré ./scripts/bootstrap-devfs.sh (no veo $TOOLCHAIN)"
[[ -r "$KERNEL" ]] || die "no puedo leer el kernel $KERNEL (set KERNEL=…)"
command -v qemu-system-x86_64 >/dev/null || die "falta qemu-system-x86_64"
# 0) Binario hammer estático (musl, crt-static) — el builder lo bootea adentro.
HAMMER_BIN="target/x86_64-unknown-linux-musl/release/hammer"
say "build hammer estático ($HAMMER_BIN)"
cargo build --release --target x86_64-unknown-linux-musl -p hammer-cli
HAMMER="./$HAMMER_BIN"
say "stage0 — ingerir la semilla zig (idempotente)"
"$HAMMER" --store "$STORE" bootstrap stage0 \
--url "$STAGE0_URL" --sha256 "$STAGE0_SHA256" --version "$SEED_VERSION"
# El seed_hash sale del nombre del artefacto sellado (robusto: no parsea stdout, donde el sha256 del
# tarball también es 64-hex y podría confundirse).
SEED_HASH="$(ls -d "$STORE"/*-seed-zig 2>/dev/null | head -1 | sed -E 's#.*/([0-9a-f]{64})-seed-zig#b3:\1#')"
[[ "$SEED_HASH" == b3:* && ${#SEED_HASH} -eq 67 ]] || die "no encuentro la semilla sellada en $STORE"
say "semilla: $SEED_HASH"
# 1) Store baseline: stage1 (idempotente; rebuildea lo que falte con -mcpu=baseline ya en fuente).
say "stage1 — construir y sellar el rootfs baseline"
"$HAMMER" --store "$STORE" bootstrap stage1 --seed-hash "$SEED_HASH" --recipes recipes
ROOTFS_HASH="$(ls -d "$STORE"/*-stage1-rootfs | head -1 | sed -E 's#.*/([0-9a-f]{64})-stage1-rootfs#b3:\1#')"
[[ "$ROOTFS_HASH" == b3:* ]] || die "no encuentro el stage1-rootfs en $STORE"
say "stage1 rootfs: $ROOTFS_HASH"
# 2) Referencia of_tree(stage1) que la VM debe reproducir.
REF="$("$HAMMER" --store "$STORE" bootstrap stage2 --rootfs "$ROOTFS_HASH" 2>&1 \
| grep -oE 'content-hash: b3:[0-9a-f]{64}|content=b3:[0-9a-f]{64}' | grep -oE 'b3:[0-9a-f]{64}' | tail -1)"
[[ "$REF" == b3:* ]] || die "no obtuve la referencia de stage2"
say "referencia of_tree(stage1) = $REF"
if [[ -n "$EXPECT_REF" && "$REF" != "$EXPECT_REF" ]]; then
printf '\033[1;33mAVISO: la referencia difiere de la conocida-buena del host de dev:\n esta %s\n espera %s\nReproducibilidad entre máquinas rota O cambió un pin (toolchain/recipes/seed). Seguimos igual.\033[0m\n' "$REF" "$EXPECT_REF"
fi
# 3) Inyectar los módulos del kernel DE ESTA máquina al toolchain (el builder los carga: overlay para
# el sandbox bwrap, e1000 para la red del vendoring). Deben matchear el kernel que bootea la VM.
# La versión de los módulos DEBE matchear el kernel que bootea la VM ($KERNEL), no el del host
# corriendo el script ($(uname -r)) — en máquinas con varios kernels instalados difieren y el
# insmod falla con "version magic mismatch" → sin overlayfs, bwrap revienta. Sacamos la versión
# del propio bzImage; si no se puede, caemos a uname -r.
KVER="$(file -bL "$KERNEL" 2>/dev/null | grep -oE 'version [0-9][^ ]*' | awk '{print $2}')"
[[ -n "$KVER" && -d "/lib/modules/$KVER" ]] || KVER="$(uname -r)"
say "inyectar overlay.ko + e1000.ko (kernel $KVER) al toolchain"
moddir="/lib/modules/$KVER"
for m in overlay e1000; do
src="$(find "$moddir" -name "$m.ko*" 2>/dev/null | head -1)"
if [[ -n "$src" ]]; then
# Descomprimir si viene .ko.zst/.ko.gz/.ko.xz; el builder hace insmod del .ko crudo.
case "$src" in
*.zst) zstd -dqf "$src" -o "$TOOLCHAIN/lib/$m.ko" 2>/dev/null || cp "$src" "$TOOLCHAIN/lib/$(basename "$src")" ;;
*.gz) gzip -dc "$src" > "$TOOLCHAIN/lib/$m.ko" ;;
*.xz) xz -dc "$src" > "$TOOLCHAIN/lib/$m.ko" ;;
*) cp "$src" "$TOOLCHAIN/lib/$m.ko" ;;
esac
echo " $m: $src"
else
echo " $m: NO encontrado en $moddir (si la VM lo necesita, fallará: bwrap overlay / red)"
fi
done
# 3b) Auto-alojamiento *puro* (variante b, SDD 11 §7.2b): reemplazar piezas del toolchain Alpine por
# recetas hammer construidas desde fuente, con Stage 2 reverificando que `of_tree(stage1')` NO
# cambia (el make hammer compila los 4/4 igual de bit-a-bit que el de Alpine). Opt-in:
# SWAP_MAKE=1 → construye recipes/make.toml y lo monta sobre /toolchain/usr/bin/make.
# SWAP_BUSYBOX=1 → monta el busybox de hammer sobre /toolchain/bin/busybox (los symlinks de
# applets de Alpine — sh/sed/grep/awk/tar/find — pasan a usarlo; cp/mkdir/
# install siguen siendo GNU coreutils, intactos).
# SWAP_LINUX_HEADERS=1 → construye recipes/linux-headers.toml y swap-directorio de los 13 subdirs
# kernel-owned de /toolchain/usr/include (linux/asm/…); musl bits/sys intactos.
# SWAP_BWRAP=1 → construye recipes/bwrap.toml (+libcap, su dep, vía deps.build) y lo monta
# sobre /toolchain/usr/bin/bwrap (el sandbox del propio lab).
# SWAPS="name=hash[:rel] …" → swaps explícitos extra (formato del flag --swap).
# Por defecto, off ⇒ corrida pura-Alpine (variante a), idéntica a la baseline conocida-buena.
# Piezas validadas en host: make+busybox reproducen of_tree=9adefb82 in-VM; linux-headers da un
# header-tree byte-idéntico a Alpine (diff -r vacío); bwrap rebuildea musl byte-idéntico de sandbox.
SWAP_ARGS=()
if [[ "${SWAP_MAKE:-0}" == 1 ]]; then
say "variante b — construir make desde fuente (recipes/make.toml) y swapearlo en /toolchain"
MAKE_HASH="$("$HAMMER" --store "$STORE" build recipes/make.toml | grep -oE 'b3:[0-9a-f]{64}' | tail -1)"
[[ "$MAKE_HASH" == b3:* ]] || die "no obtuve el hash sellado de make"
say "make hammer: $MAKE_HASH"
SWAP_ARGS+=(--swap "make=$MAKE_HASH")
fi
if [[ "${SWAP_BUSYBOX:-0}" == 1 ]]; then
say "variante b — construir busybox desde fuente y swapearlo en /toolchain/bin/busybox"
BB_HASH="$("$HAMMER" --store "$STORE" build recipes/busybox.toml | grep -oE 'b3:[0-9a-f]{64}' | tail -1)"
[[ "$BB_HASH" == b3:* ]] || die "no obtuve el hash sellado de busybox"
say "busybox hammer: $BB_HASH"
SWAP_ARGS+=(--swap "busybox=$BB_HASH:bin/busybox")
fi
if [[ "${SWAP_LINUX_HEADERS:-0}" == 1 ]]; then
# Pieza 3: los headers UAPI del kernel. NO es un binario sino un árbol — el swap-directorio
# (assemble_builder) reemplaza cada subdir entero. Swapeamos exactamente los subdirs que el
# artefacto sellado produce (linux/asm/asm-generic/cxl/fwctl/misc/mtd/rdma/regulator/scsi/sound/
# video/xen), que son justo los que el paquete linux-headers de Alpine posee; los de musl
# (bits/sys/net/…) quedan intactos.
say "variante b — construir linux-headers desde fuente y swapear /toolchain/usr/include/{linux,asm,…}"
LH_HASH="$("$HAMMER" --store "$STORE" build recipes/linux-headers.toml | grep -oE 'b3:[0-9a-f]{64}' | tail -1)"
[[ "$LH_HASH" == b3:* ]] || die "no obtuve el hash sellado de linux-headers"
say "linux-headers hammer: $LH_HASH"
LH_INC="$(ls -d "$STORE"/*-linux-headers/usr/include 2>/dev/null | head -1)"
[[ -d "$LH_INC" ]] || die "no encuentro usr/include en el linux-headers sellado"
for d in "$LH_INC"/*/; do
sub="$(basename "$d")"
SWAP_ARGS+=(--swap "linux-headers=${LH_HASH}:usr/include/$sub")
done
fi
if [[ "${SWAP_BWRAP:-0}" == 1 ]]; then
# Pieza 4: bwrap (bubblewrap), EL sandbox del lab. Binario estático ⇒ swap de archivo sobre
# /toolchain/usr/bin/bwrap. Su dep libcap la construye y materializa el lab solo (deps.build).
# bwrap es herramienta, no input del 4/4: no necesita casar byte-a-byte con Alpine, sólo aislar
# igual (validado en host — musl rebuildeó byte-idéntico bajo hammer-bwrap).
say "variante b — construir bwrap (+libcap) desde fuente y swapearlo en /toolchain/usr/bin/bwrap"
BW_HASH="$("$HAMMER" --store "$STORE" build recipes/bwrap.toml | grep -oE 'b3:[0-9a-f]{64}' | tail -1)"
[[ "$BW_HASH" == b3:* ]] || die "no obtuve el hash sellado de bwrap"
say "bwrap hammer: $BW_HASH"
SWAP_ARGS+=(--swap "bwrap=${BW_HASH}:usr/bin/bwrap")
fi
for s in ${SWAPS:-}; do SWAP_ARGS+=(--swap "$s"); done
# 4) Ensamblar el builder con la referencia embebida.
say "ensamblar builder (toolchain in-rootfs + hammer baseline + ref${SWAP_ARGS:+ + swaps})"
"$HAMMER" --store "$STORE" bootstrap builder \
--stage1 "$ROOTFS_HASH" --seed-hash "$SEED_HASH" \
--hammer-bin "$HAMMER_BIN" \
--toolchain "$TOOLCHAIN" --toolchain-tag "$TOOLCHAIN_TAG" \
--ref-content "$REF" \
"${SWAP_ARGS[@]}" \
--work-cache work --out work/builder-rootfs
# 4b) Preseed opcional para abaratar el rebuild in-VM (sólo hammerd se reconstruye).
if [[ "$PRESEED" == "hammerd" ]]; then
say "preseed musl+busybox+arje-zero (sólo hammerd se reconstruye in-VM)"
for n in musl busybox arje-zero; do
d="$(ls -d "$STORE"/*-"$n" 2>/dev/null | head -1)"
[[ -n "$d" ]] && cp -a "$d" work/builder-rootfs/store/ && echo " preseed: $(basename "$d")"
done
fi
# 5) Empaquetar como initramfs. --owner=root:root OBLIGATORIO: si los ficheros viajan con el uid del
# host, el userns de bwrap (mapea 0→0) no lo mapea y el copy-up de overlay falla con EACCES.
say "empaquetar initramfs (cpio newc, --owner=root:root)"
( cd work/builder-rootfs && find . -print0 | cpio --null -o -H newc --owner=root:root 2>/dev/null | gzip -1 ) > work/builder.cpio.gz
echo " work/builder.cpio.gz: $(du -h work/builder.cpio.gz | cut -f1)"
# 6) Bootear + driver no-interactivo → veredicto.
say "bootear la VM y correr rebuild-stage1 (KVM=$KVM MEM=$MEM)"
KVM="$KVM" MEM="$MEM" KERNEL="$KERNEL" BUILDER_CPIO="work/builder.cpio.gz" \
python3 scripts/drive-rebuild.py