AOSC Wiki / Developer / Automation / .

AOINB Builder

The WIP builder component of AOINB.



The typical workflow is:

  1. Compose config files.
  2. Load BuildKit via load-baseos
  3. update-baseos
  4. Build!


aoinb-builder requires a configuration folder to run. The folder should looks like this:

├── config.toml
└── source_lists
    ├─── stable.list
    ├─── testing.list
    └─── ... and so on.

config.toml is the main configuration file. Here is an example.

# work_dir: where all the work happens.
work_dir = "/var/cache/aoinb/work" 
# arch: the architecture of the build machine. only used to determine BuildKit download url for now.
arch = "amd64"

The source_lists folder contains the sources.list file used inside the instance overlay. You can change branch and use preferred mirror by editing the corresponding file inside this folder.


aoinb-builder will automatically populate all the directory it need, so be careful when choosing the working directory in the config file as mentioned before.

Notice that since AOSC OS's building process involves mounting OverlayFS and using systemd-nspawn, root permission is required.

By default /var/cache/aoinb/conf is used to search for configs, but you can manually specify the path by offering -c $PATH.

Here are all the sub-commands:


This is the main command we will be using. To use it, simply run:


The so-called "build bundle" is the folder that contains spec file and autobuild/ folder.

The BRANCH used in the command is the destination branch to build upon. A corresponding $BRANCH.list must exists in the source_lists folder in the configuration folder, otherwise the program will give an error.


This command installs the base OS (typically BuildKit) to the working directory for future operations.

By default, this command will automatically download the latest BuildKit from But if that's too slow, or you already have a copy of BuildKit, you can just place it in $work_dir/buildkit_amd64.tar.xz and the builder will use that directly.


This command updates the base OS. Note that by now it can only use as its repository site.


This command can destroy the specific instance or base OS. This can be useful when thing does not feel right. Options are:


There are two layers of OverlayFS used.

------------- -> workspace-overlay, workspace-workdir
------------- -> instance-overlay, instance-workdir

Workspace layer is the temporary place for each build. It will be cleaned up every time the build is finished (whether successful or not).

Instance layer is the layer for different branched. An apt update && apt upgrade will be made to this layer each time a build begins.

Base OS layer is, as the name implies, the base layer. It will never be changed unless a manual update command is used (update-baseos).

Before every build, the "build bundle" and the toolbox is copied to /buildroot inside the container. is called by systemd-nspawn for the build process. The script will call (and eventually call downloader.tcl) to download source code as $VER.bin and extract it to /buildroot/build (For packages that use SRCTBL). Finally, will execute autobuild to actually build the package.

After the build finishes successfully, will copy the output deb file to /buildroot/output and hand back control to Python. Then the builder will copy the result to $work_dir/output/$branch/. Eventually, the builder will delete everything in the workspace overlay (effectively rollback to the inital state of the instance) and exit.

Proposed RESTful API§