sergio/takana

1#!/bin/sh
2# iso-image.sh — Etapa E5 (SDD 13): produce un MEDIO LIVE booteable como ISO 9660 / El Torito.
3#
4# A diferencia de install-image.sh (E1, disco GPT con / persistente en vda2), un medio live arranca
5# ENTERO desde RAM: GRUB (El Torito) carga kernel + initramfs desde el ISO 9660, el kernel desempaqueta
6# el initramfs (el rootfs del producto) a un tmpfs y corre /init — sin tocar disco. Es el medio para
7# correr el instalador (`hammer install /dev/sdX`) en hardware nuevo, o para probar el sistema sin
8# instalarlo.
9#
10# El ISO lo ARMA `xorriso` construido por hammer desde fuente (recipes/xorriso.toml) — el host no lo
11# trae. La cadena de boot BIOS reusa los módulos GRUB i386-pc de E1, pero con el core El Torito
12# (formato i386-pc-eltorito + iso9660) en vez del core de disco (ext2 + biosdisk).
13#
14# Cadena: SeaBIOS → El Torito boot catalog → eltorito.img (cdboot+core GRUB) → lee (cd0)/boot/grub/
15# grub.cfg → `linux /boot/bzImage rdinit=/init` + `initrd /boot/initramfs.cpio.gz` → kernel desempaqueta
16# → /init (marcador + exec del init real del rootfs).
17#
18# Uso:
19#   ./scripts/iso-image.sh                       # crea work/hammer-live.iso
20#   BOOT=1 KVM=1 ./scripts/iso-image.sh          # además lo arranca desde el CD (auto-boot)
21#
22# Variables:
23#   ROOTFS   dir rootfs a empaquetar como initramfs   (default work/builder-rootfs)
24#   KERNEL   bzImage a embeber                          (default store/*-linux/boot/bzImage)
25#   ISO      ISO de salida                              (default work/hammer-live.iso)
26#   XORRISO  binario xorriso                            (default el del store; si no, host)
27#   GRUB_LIB módulos GRUB i386-pc                       (default /usr/lib/grub/i386-pc)
28#   CMDLINE  cmdline del kernel             (default "console=ttyS0 rdinit=/init")
29#   BOOT/KVM/MEM  passthrough al arranque de prueba
30set -eu
31ROOT="$(cd "$(dirname "$0")/.." && pwd)"
32cd "$ROOT"
33
34ROOTFS="${ROOTFS:-work/builder-rootfs}"
35ISO="${ISO:-work/hammer-live.iso}"
36KERNEL="${KERNEL:-$(ls store/*-linux/boot/bzImage 2>/dev/null | head -1)}"
37GRUB_LIB="${GRUB_LIB:-/usr/lib/grub/i386-pc}"
38GRUB_EFI_LIB="${GRUB_EFI_LIB:-/usr/lib/grub/x86_64-efi}"
39CMDLINE="${CMDLINE:-console=ttyS0 rdinit=/init}"
40# xorriso: preferimos el construido por hammer (dogfooding de recipes/xorriso.toml); fallback al host.
41XORRISO="${XORRISO:-$(ls store/*-xorriso/usr/bin/xorriso 2>/dev/null | head -1)}"
42[ -n "$XORRISO" ] && [ -x "$XORRISO" ] || XORRISO="$(command -v xorriso 2>/dev/null || true)"
43# mtools (mformat/mcopy): para poblar la ESP FAT del arranque EFI. Preferimos el de hammer (dogfooding).
44MTOOLS_DIR="${MTOOLS_DIR:-$(ls -d store/*-mtools/usr/bin 2>/dev/null | head -1)}"
45
46[ -d "$ROOTFS" ] || { echo "no existe ROOTFS: $ROOTFS" >&2; exit 1; }
47[ -e "$ROOTFS/sbin/init" ] || { echo "ROOTFS sin /sbin/init" >&2; exit 1; }
48[ -n "$KERNEL" ] && [ -r "$KERNEL" ] || { echo "no encuentro el kernel (set KERNEL=<bzImage>)" >&2; exit 1; }
49[ -n "$XORRISO" ] || { echo "no encuentro xorriso (build recipes/xorriso.toml)" >&2; exit 1; }
50[ -d "$GRUB_LIB" ] && [ -r "$GRUB_LIB/cdboot.img" ] || { echo "faltan módulos GRUB i386-pc en $GRUB_LIB" >&2; exit 1; }
51command -v grub-mkimage >/dev/null 2>&1 || { echo "falta grub-mkimage" >&2; exit 1; }
52command -v cpio >/dev/null 2>&1 || { echo "falta cpio" >&2; exit 1; }
53
54echo "==> xorriso: $XORRISO ($("$XORRISO" -version 2>&1 | grep -m1 'xorriso version' || echo '?'))"
55
56STAGE="work/.iso-stage"
57rm -rf "$STAGE"
58ISO_ROOT="$STAGE/iso"
59RFS="$STAGE/rfs"
60mkdir -p "$ISO_ROOT/boot/grub/i386-pc" "$RFS"
61
62# --- initramfs: rootfs (hardlinks) + /init marcador que arranca el init real ---
63echo "==> staging initramfs desde $ROOTFS (hardlinks) + /init marcador"
64cp -al "$ROOTFS" "$RFS/root"
65# El cpio se arma desde $RFS/root; inyectamos /init ahí (rdinit=/init lo busca en la raíz del initramfs).
66# /init del medio live: monta lo básico + marcador. Con AUTO_INSTALL=<dev>, instala desatendido a ese
67# disco y apaga (instalación unattended + scaffolding del test); si no, arranca el init real (live).
68{
69  echo '#!/bin/sh'
70  echo '# /init del medio live (Etapa E5).'
71  echo '/bin/busybox mount -t proc     proc /proc 2>/dev/null || true'
72  echo '/bin/busybox mount -t sysfs    sys  /sys  2>/dev/null || true'
73  echo '/bin/busybox mount -t devtmpfs dev  /dev  2>/dev/null || true'
74  echo 'echo "HAMMER-ISO-LIVE-OK: medio live arrancado desde El Torito"'
75  if [ -n "${AUTO_INSTALL:-}" ]; then
76    echo "echo 'HAMMER-AUTO-INSTALL: instalando a ${AUTO_INSTALL}'"
77    echo "if /usr/bin/hammer-install '${AUTO_INSTALL}'; then echo 'HAMMER-INSTALL-OK'; else echo 'HAMMER-INSTALL-FAIL'; fi"
78    echo '/bin/busybox sync'
79    echo '/bin/busybox poweroff -f'
80  elif [ "${INSTALLER:-0}" = 1 ] && [ "${INSTALLER_INTERACTIVE:-1}" = 1 ]; then
81    # ISO instalador SIN AUTO_INSTALL ⇒ recibir al usuario con la TUI del instalador en la consola.
82    # Tras instalar (o cancelar) ofrece reiniciar o caer al live. HAMMER_INSTALL_INTERACTIVE fuerza el
83    # modo aunque /dev/console no pase el test -t (a esta altura stdin puede no ser un tty).
84    echo '[ -e /dev/console ] && exec 0</dev/console 1>/dev/console 2>/dev/console'
85    echo 'HAMMER_INSTALL_INTERACTIVE=1 /usr/bin/hammer-install || true'
86    echo 'echo; echo "Instalación finalizada.  [r] reiniciar  ·  [Enter] shell en vivo"'
87    echo 'read -r _a || _a=""'
88    echo 'case "$_a" in r|R) /bin/busybox reboot -f ;; *) exec /sbin/init ;; esac'
89  else
90    echo 'exec /sbin/init'
91  fi
92} > "$RFS/root/init"
93chmod +x "$RFS/root/init"
94
95# --- INSTALLER=1: payload de instalación a disco DESDE el live (refinamiento #1) ---
96# Bundle kernel + GRUB (boot.img + core.img MBR-prefix + módulos) bajo /usr/lib/hammer/install/ y el
97# instalador en /usr/bin/hammer-install. El core.img se arma acá (build-time, el host tiene
98# grub-mkimage); el live NO lo necesita — sólo dd's. core prefix (hd0,msdos1)/boot/grub para boot MBR.
99if [ "${INSTALLER:-0}" = 1 ]; then
100    echo "==> INSTALLER=1: bundling payload de instalación a disco (kernel + GRUB MBR + hammer-install)"
101    IPL="$RFS/root/usr/lib/hammer/install"
102    mkdir -p "$IPL/grub/i386-pc" "$IPL/kernel"
103    cp "$KERNEL" "$IPL/kernel/bzImage"; chmod 0644 "$IPL/kernel/bzImage"
104    # Rama EFI del instalador (ADR 0010 paso 5): el kernel `linux-metal` hornea CONFIG_CMDLINE con
105    # initrd=/initramfs.cpio.gz rdinit=/init ⇒ arranca por EFI-stub como \EFI\BOOT\BOOTX64.EFI sin
106    # bootloader. Lo bundleamos junto al genérico; hammer-install lo usa si el live corre en UEFI.
107    EFI_KERNEL="${EFI_KERNEL:-$(ls -dt store/*-linux-metal/boot/bzImage 2>/dev/null | head -1)}"
108    if [ -n "${EFI_KERNEL:-}" ] && [ -r "$EFI_KERNEL" ]; then
109        cp "$EFI_KERNEL" "$IPL/kernel/bzImage-efi"; chmod 0644 "$IPL/kernel/bzImage-efi"
110        echo "    + kernel EFI-stub (metal) para la rama UEFI del instalador"
111    else
112        echo "    ! sin kernel linux-metal en el store ⇒ el instalador sólo tendrá rama BIOS/MBR" >&2
113    fi
114    cp "$GRUB_LIB/boot.img" "$IPL/grub/boot.img"
115    cp "$GRUB_LIB"/*.mod "$GRUB_LIB"/*.lst "$IPL/grub/i386-pc/" 2>/dev/null || true
116    # core.img para disco MBR: prefix a la 1ª partición msdos, módulos de disco (biosdisk/part_msdos/ext2).
117    grub-mkimage -O i386-pc -p '(hd0,msdos1)/boot/grub' -o "$IPL/grub/core.img" \
118        biosdisk part_msdos ext2 normal configfile linux echo ls boot search
119    install -m 0755 "$ROOT/scripts/hammer-live-install.sh" "$RFS/root/usr/bin/hammer-install"
120    # hammer-recover (static musl): auto-sana un upgrade interrumpido al arranque del sistema instalado.
121    RECOVER_BIN="$ROOT/target/x86_64-unknown-linux-musl/release/hammer-recover"
122    if [ ! -x "$RECOVER_BIN" ]; then
123        echo "==> compilando hammer-recover (static musl) para el payload"
124        cargo build --release --target x86_64-unknown-linux-musl -p hammer-recover --manifest-path "$ROOT/Cargo.toml" >/dev/null 2>&1
125    fi
126    [ -x "$RECOVER_BIN" ] || { echo "no pude construir hammer-recover (target musl?)" >&2; exit 1; }
127    install -m 0755 "$RECOVER_BIN" "$IPL/hammer-recover"
128    # CLI `hammer` (static musl) para el menú de arranque por grafo (ADR 0010): el hook de init del
129    # sistema instalado lo invoca como `hammer boot menu`. El producto trae arje-zero/hammerd pero NO el
130    # CLI ⇒ lo bundleamos al payload; hammer-install lo copia a /usr/bin/hammer del disco.
131    HAMMER_BIN="$ROOT/target/x86_64-unknown-linux-musl/release/hammer"
132    if [ ! -x "$HAMMER_BIN" ]; then
133        echo "==> compilando hammer CLI (static musl) para el payload"
134        cargo build --release --target x86_64-unknown-linux-musl -p hammer-cli --manifest-path "$ROOT/Cargo.toml" >/dev/null 2>&1
135    fi
136    [ -x "$HAMMER_BIN" ] || { echo "no pude construir el CLI hammer (target musl?)" >&2; exit 1; }
137    install -m 0755 "$HAMMER_BIN" "$IPL/hammer"
138fi
139
140echo "==> empaquetando initramfs.cpio.gz"
141( cd "$RFS/root" && find . -print0 | cpio --null -o -H newc -R 0:0 2>/dev/null | gzip -1 ) > "$ISO_ROOT/boot/initramfs.cpio.gz"
142
143# --- kernel + módulos GRUB + grub.cfg en el árbol del ISO ---
144cp "$KERNEL" "$ISO_ROOT/boot/bzImage"; chmod 0644 "$ISO_ROOT/boot/bzImage"
145cp "$GRUB_LIB"/*.mod "$GRUB_LIB"/*.lst "$ISO_ROOT/boot/grub/i386-pc/" 2>/dev/null || true
146cat > "$ISO_ROOT/boot/grub/grub.cfg" <<CFG
147set timeout=2
148set default=0
149serial --unit=0 --speed=115200
150terminal_input serial console
151terminal_output serial console
152insmod iso9660
153insmod normal
154menuentry "hammer (live)" {
155    linux /boot/bzImage $CMDLINE
156    initrd /boot/initramfs.cpio.gz
157}
158CFG
159
160# --- core GRUB El Torito: igual que el de disco pero con iso9660+biosdisk en vez de ext2 ---
161echo "==> grub-mkimage El Torito (formato i386-pc-eltorito, módulos iso9660)"
162grub-mkimage -O i386-pc-eltorito -p '/boot/grub' -o "$ISO_ROOT/boot/grub/i386-pc/eltorito.img" \
163    biosdisk iso9660 part_gpt part_msdos normal configfile linux echo ls boot search
164
165# --- EFI=1: rama UEFI (refinamiento #3). Construye grubx64.efi (mismo grub.cfg, lee kernel+initrd del
166#     iso9660) y una ESP FAT con EFI/BOOT/BOOTX64.EFI, poblada con mtools (sin root). El kernel ya trae
167#     EFI_STUB; aquí GRUB EFI es el cargador (espeja la rama BIOS). xorriso añade un 2º El Torito (EFI). ---
168EFI_ARGS=""
169if [ "${EFI:-0}" = 1 ]; then
170    MFORMAT="$MTOOLS_DIR/mformat"; MCOPY="$MTOOLS_DIR/mcopy"; MMD="$MTOOLS_DIR/mmd"
171    [ -x "$MFORMAT" ] && [ -x "$MCOPY" ] || MFORMAT="$(command -v mformat 2>/dev/null || true)"
172    [ -n "$MFORMAT" ] && [ -x "$MFORMAT" ] || { echo "no encuentro mtools (build recipes/mtools.toml)" >&2; exit 1; }
173    [ -x "$MCOPY" ] || { MCOPY="$(command -v mcopy)"; MMD="$(command -v mmd)"; }
174    ESP="$ISO_ROOT/boot/grub/efi.img"
175    if [ "${EFI_STUB:-0}" = 1 ]; then
176        # --- EFI_STUB=1: arranque por EFI-STUB DIRECTO (sin GRUB-EFI). El bzImage ES el BOOTX64.EFI; la
177        #     firmware lo lanza por el path de medio removible \EFI\BOOT\BOOTX64.EFI. El cmdline va
178        #     HORNEADO en el kernel (CONFIG_CMDLINE, recipes/linux-metal.toml) con initrd=/initramfs.cpio.gz
179        #     ⇒ el EFI-stub carga el initrd de la PROPIA ESP (file.c convierte '/'→'\'). Esquiva el bug de
180        #     GRUB 2.14 que cuelga la rama UEFI con cualquier kernel. ---
181        INITRAMFS="$ISO_ROOT/boot/initramfs.cpio.gz"
182        [ -r "$INITRAMFS" ] || { echo "no encuentro $INITRAMFS para la ESP EFI-stub" >&2; exit 1; }
183        echo "==> EFI=1 EFI_STUB=1: kernel→BOOTX64.EFI + initramfs en la ESP (FAT32, sin GRUB-EFI)"
184        # ESP grande (kernel + initramfs + holgura) ⇒ FAT32 (-F), válido y recomendado para ESP en metal.
185        espkb=$(( ( $(stat -c%s "$KERNEL") + $(stat -c%s "$INITRAMFS") ) / 1024 + 8192 ))
186        rm -f "$ESP"; truncate -s "$(( espkb * 1024 ))" "$ESP"
187        "$MFORMAT" -F -i "$ESP" ::
188        "$MMD"   -i "$ESP" ::/EFI ::/EFI/BOOT
189        "$MCOPY" -i "$ESP" "$KERNEL"    ::/EFI/BOOT/BOOTX64.EFI
190        "$MCOPY" -i "$ESP" "$INITRAMFS" ::/initramfs.cpio.gz
191    else
192        # --- EFI=1 (default): GRUB EFI como cargador (espeja la rama BIOS, lee kernel+initrd del iso9660). ---
193        [ -d "$GRUB_EFI_LIB" ] || { echo "faltan módulos GRUB x86_64-efi en $GRUB_EFI_LIB" >&2; exit 1; }
194        echo "==> EFI=1: grub-mkimage x86_64-efi + ESP FAT (mtools: $MFORMAT)"
195        mkdir -p "$STAGE/efi"
196        grub-mkimage -O x86_64-efi -p '/boot/grub' -o "$STAGE/efi/bootx64.efi" \
197            part_gpt part_msdos fat iso9660 normal configfile linux echo ls boot search search_fs_uuid efi_gop efi_uga
198        # Tamaño ≥ 1.44 MiB; mformat SIN -F auto-elige FAT12/16 por nº de clusters (FAT32 exige ~33 MiB).
199        espkb=$(( ( $(stat -c%s "$STAGE/efi/bootx64.efi") / 1024 ) + 512 ))
200        [ "$espkb" -lt 1440 ] && espkb=1440
201        rm -f "$ESP"; truncate -s "$(( espkb * 1024 ))" "$ESP"
202        "$MFORMAT" -i "$ESP" ::
203        "$MMD"   -i "$ESP" ::/EFI ::/EFI/BOOT
204        "$MCOPY" -i "$ESP" "$STAGE/efi/bootx64.efi" ::/EFI/BOOT/BOOTX64.EFI
205    fi
206    EFI_ARGS="-eltorito-alt-boot -e boot/grub/efi.img -no-emul-boot -isohybrid-gpt-basdat"
207fi
208
209# --- armar el ISO con xorriso (personalidad mkisofs), El Torito BIOS (+EFI si EFI=1) + isohybrid MBR ---
210echo "==> xorriso: armando $ISO (El Torito BIOS${EFI_ARGS:+ + EFI} + isohybrid MBR)"
211rm -f "$ISO"
212MBR_ARGS=""
213[ -r "$GRUB_LIB/boot_hybrid.img" ] && MBR_ARGS="--grub2-mbr $GRUB_LIB/boot_hybrid.img"
214# shellcheck disable=SC2086
215"$XORRISO" -as mkisofs \
216    -volid HAMMER_LIVE \
217    -graft-points \
218    $MBR_ARGS \
219    -b boot/grub/i386-pc/eltorito.img \
220    -no-emul-boot -boot-load-size 4 -boot-info-table \
221    --grub2-boot-info \
222    $EFI_ARGS \
223    -o "$ISO" \
224    "$ISO_ROOT" 2>&1 | grep -viE "^xorriso : NOTE|Drive current|Media current|Media status|Media summary|libisofs:|^xorriso : UPDATE" || true
225
226[ -s "$ISO" ] || { echo "FALLO: xorriso no produjo el ISO" >&2; exit 1; }
227rm -rf "$STAGE"
228echo "==> ISO live creado: $(du -h "$ISO" | cut -f1) — $ISO"
229echo "    auto-boot: qemu-system-x86_64 -cdrom $ISO -boot d -nographic"
230
231if [ "${BOOT:-0}" = 1 ]; then
232    echo "==> arranque de prueba (desde el CD El Torito)"
233    accel=""
234    [ "${KVM:-0}" = 1 ] && [ -w /dev/kvm ] && accel="-enable-kvm -cpu host"
235    # shellcheck disable=SC2086
236    exec qemu-system-x86_64 -m "${MEM:-4096}" -no-reboot -nographic $accel \
237        -cdrom "$ISO" -boot d
238fi