This document describes how to use the various components of this repository to do work, mostly without interacting with the GitHub Actions stuff at all, so that you can quickly execute part of the pipeline locally.
We use debos to build an image. For how to install debos, please see their instructions.
For running it, your host needs to be some Debian-like environment with its
tools, and ideally you have access to kvm (check ls -l /dev/kvm
for which
group you need to be in).
We need a few files:
debos-recipes/u-boot/idbloader.img
: SPL u-boot image, feel free to grab it from a previous actions run, or build it yourself from the u-boot sources.debos-recipes/u-boot/u-boot.itb
: Main u-boot image, ditto on that.
If you want to build e.g. a Quartz64 Model A image, you can use
debos debian-quartz64a.yaml
. For the other images, use their respective files.
The main debian-quartz64.yaml
is not to be run directly, that gets included by
the other files.
Everyone has their own favourite method, but I run (as root):
xzcat imagename.img.xz | dd of=/dev/sdX bs=4M oflag=dsync status=progress