Runbook — Test the Koder Linux ISO

Trigger

The user says "teste a iso", "testar a iso", "test the iso", or an equivalent phrase.

Working Directory

~/dev/koder/linux/distro

Procedure

1. Update Package Versions

For each package listed in config/package-lists/koder.list.chroot, check the latest available version in the Debian repositories via apt-cache policy and update the comment or version record if needed. Ensure the list reflects the most current packages.

2. Commit

Execute the commit flow (clean temp files, staging, descriptive commit, push with tags).

3. Release with ISO

Create a new release (bump the minor version) and upload the ISO (koder-linux-amd64.hybrid.iso) as a release asset via the Koder Flow API. If the ISO is larger than 2 GB, split it into 1.9 GB parts with split before uploading.

4. Sync

Ensure the local repository is synchronized with the remote (push code + tags).

5. Clean Previous Raw Images

Remove ~/dev/koder/linux/distro/koder-linux-disk*.raw files from previous tests.

6. Create New Raw Images

Generate two new 50 GB raw images:

qemu-img create -f raw koder-linux-disk1.raw 50G
qemu-img create -f raw koder-linux-disk2.raw 50G

7. Start QEMU VM

Boot the VM from the ISO with both disks attached:

qemu-system-x86_64 \
  -enable-kvm \
  -m 4G \
  -smp 2 \
  -boot d \
  -cdrom koder-linux-amd64.hybrid.iso \
  -drive file=koder-linux-disk1.raw,format=raw,if=virtio \
  -drive file=koder-linux-disk2.raw,format=raw,if=virtio \
  -vga virtio \
  -display gtk

Expected Outcome

A freshly built Koder Linux ISO running in a QEMU VM with two virtual disks available, ready for interactive testing.