// docs

ISOa eraiki

ISO osoa script bakar batetik ateratzen da, build.sh, eta irudi hibrido bat sortzen du (BIOS + UEFI), USB batean grabatzeko prest.

Betekizunak

Root baimena duen Linux bat: Ubuntu 24.04 edo Debian 12. Windowsen, erabili WSL2 edo makina birtual bat.
Interneteko konexioa paketeak deskargatzeko.
Hainbat GB libre laneko sistemarentzat (work/).

sudo apt install debootstrap squashfs-tools xorriso grub-pc-bin grub-efi-amd64-bin mtools

Eraiki

SEaren karpetatik:

sudo ./build.sh                 # base Debian bookworm (por defecto)
sudo BASE=ubuntu ./build.sh     # base Ubuntu noble (la que se ha probado)

Emaitza out/ karpetan:

redderos-<base>-amd64.iso: irudia.
redderos-<base>-amd64.iso.sha256: haren SHA-256 laburpena.

Zer egiten duen scriptak

Oinarrizko sistema. debootstrap-ek gutxieneko sistema bat (--variant=minbase) sortzen du work/rootfs karpetan. Lehendik badago, berrerabili egiten da.
Overlay-a. overlay/ erroaren gainean kopiatzen du: suhesia, Tor, sysctl, systemd eta script propioak.
Chroot-a. hooks/chroot.sh scriptak kernela, live sistema eta config/packages.list fitxategiko paketeak instalatzen ditu; hizkuntza eta teklatua (gaztelania), mahaigaina, erabiltzaileak eta zerbitzuak konfiguratzen ditu, eta initramfs-a birsortzen du.
squashfs. Erroa xz bidez konprimatzen du.
GRUB. config/grub.cfg gotortze-parametroekin betetzen du eta fitxategi bakoitzaren md5sum.txt eta sha256sum.txt baturak sortzen ditu.
ISOa. grub-mkrescue-k irudia (REDDEROS etiketarekin) eta haren SHA-256 laburpena sortzen ditu.

Aldagaiak

Aldagaia	Lehenetsia	Zertarako
`BASE`	`debian`	`debian` edo `ubuntu`.
`SUITE`	`bookworm` / `noble`	Oinarrizko banaketaren bertsioa.
`MIRROR`	`deb.debian.org` / `archive.ubuntu.com`	Paketeen ispilua.
`KERNEL_PKG`	`linux-image-amd64` / `linux-image-virtual`	Kernelaren paketea. Ubunturekin, `linux-image-generic` benetako hardwarerako.
`WORK`	`./work`	Laneko karpeta.
`ISO_NAME`	`redderos-<base>-amd64`	ISOaren izena, luzapenik gabe.
`GRUB_DEFAULT`	`0`	GRUBeko sarrera lehenetsia (`3` = autotesta).
`ISO_ONLY`	—	`1` balioarekin, konfiguratutako erroa berrerabiltzen du eta irudia bakarrik birsortzen du.

Adibideak:

# Ubuntu con drivers de hardware real
sudo BASE=ubuntu KERNEL_PKG=linux-image-generic ./build.sh

# Regenerar solo la imagen tras cambiar grub.cfg
sudo BASE=ubuntu ISO_ONLY=1 ./build.sh

Pertsonalizatu

Paketeak: gehitu edo kendu lerroak config/packages.list fitxategian (# ikurrarekin hasten direnak ez dira kontuan hartzen).
Sistemaren fitxategiak: overlay/ karpetan jartzen duzun guztia bere horretan kopiatzen da / gainean.
Abio-menua: config/grub.cfg. @LIVE@, @BOOT@ eta @HARDEN@ scriptak ordezten ditu.
Profilak: zirrikitu kopurua eta Argon2id-ren kostua overlay/etc/redderos/profiles.conf fitxategian daude.

Grabatu eta probatu

sudo dd if=out/redderos-ubuntu-amd64.iso of=/dev/sdX bs=4M status=progress conv=fsync
qemu-system-x86_64 -m 3G -enable-kvm -cdrom out/redderos-ubuntu-amd64.iso

ISO bat argitaratu aurretik, pasatu autotesta: ikusi Autotesta.