Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Raptor Builders

After carefully building a set of layers with Raptor, they are ready to process into more useful build artifacts.

The way this is done in Raptor, is through build containers. These are, themselves, Raptor containers, made specifically for producing a certain kind of output.

Raptor itself does not come with any build containers, but the companion project, raptor-builders does. It’s called the “companion” project to highlight the fact that it is not above other Raptor projects. Anyone can make build containers, and if you need to build something that is uncommon, or specialized to a niche situtation, you might have to.

Most people, however, should be able to get started quickly, and save a lot of time, by using the build containers from raptor-builders.

Meet the builders

BuilderOutputSupported output formats
debliveDebian Liveboot isoiso
live-disk-imageDebian Liveboot disk imageraw, qcow2, vmdk, …
disk-imageDisk imageraw, qcow2, vmdk, …
part-imagePartition (filesystem) imageraw, qcow2, vmdk, …
docker-imageDocker imagetar

Compatibility

The various builders can construct a wide variety of outputs, suitable for use with both containers (systemd-nspawn), virtual machines (e.g. qemu), and physical hardware.

However, not all combinations are possible. For example, a physical machine will not boot a qcow2 image for virtual machines, but qemu will be able to boot either qcow2 or raw images.

The tables below provides an overview of the possible options.

Machines:

BuilderFormatVirtual MachinePhysical Machine
debliveisoUEFI:✅ – BIOS:✅UEFI:✅ – BIOS:✅
live-disk-imageqcow2UEFI:✅ – BIOS:❌UEFI:❌ – BIOS:❌
disk-imageqcow2UEFI:✅ – BIOS:❌UEFI:❌ – BIOS:❌
live-disk-imagerawUEFI:✅ – BIOS:❌UEFI:✅ – BIOS:❌
disk-imagerawUEFI:✅ – BIOS:❌UEFI:✅ – BIOS:❌
part-imagerawUEFI:❌ – BIOS:❌UEFI:❌ – BIOS:❌
docker-imagetarUEFI:❌ – BIOS:❌UEFI:❌ – BIOS:❌

Note

Currently, booting in BIOS mode is only supported by the deblive builder, but the live-disk-image and disk-image builders could possibly be extended to support this, in the future.

Containers:

BuilderFormatsystemd-nspawndockerpodman
debliveiso
live-disk-imageqcow2
disk-imageqcow2
live-disk-imageraw
disk-imageraw
part-imageraw
docker-imagetar