2.0 KiB
Aimee OS Build Container Images
This repository contains the build scripts for the container images that provide the build environment for Aimee OS projects. Most projects will use the build/build-{target} image, which contains a cross-compiler toolchain for the {target} system (e.g. aarch64-unknown-linux-gnu) with Rust support, as well as several other tools for compiling software and creating bootable OS images.
Container Images
There are several images in the collection:
gentoo/stage3 †
build/base
└── build/cross-aarch64-unknown-linux-gnu
└── build/build-aarch64-unknown-linux-gnu ‡
† The gentoo/stage3 image contains an unmodified Gentoo stage3 system. It is used to bootstrap the build/base image.
‡ Although the build/build-{target} image is initially populated from the corresponding build/cross-{target} image, the final image is "squashed" into a single layer to minimize download size.
Git Branches
To enable building images in Jenkins without building all of the preceding
images, each image has its own Jenkins job. Since Jenkins does not support
(auto discovering) multiple jobs in a single Git repository branch, the build
scripts for the images are tracked in separate branches. Each branch is named
like {image}/{sub-branch}, where {image} is the short name of the image
(e.g. base, cross, etc) and {sub-branch} is an arbitrary name (e.g.
main).
- base/main: This branch is responsible for building gentoo/stage3 and build/base.
- cross/main: This branch contains the build script for build/cross-{target}.
- build/main: This branch builds build/build-{target}.
In addition to the per-image branches, there is also lib/{sub-branch}.
Code shared by multiple image build scripts is tracked here. Build scripts
expect the shared code to be available in the lib directory, which is
generally populated using a Git worktree, e.g.:
git worktree add lib lib/main
The main branch itself is empty except for this README.