You are not logged in.

#1 2019-11-22 10:29:55

From: Zurich
Registered: 2019-11-14
Posts: 859

How to create a build slave?

  1. Add the Archlinux32 x86_64/releng repo to pacman.conf:

        Server = https://${ANY_ARCHLINUX32_MIRROR}/$arch/$repo

        Update the repo-db/update packages (pacman -Syu)

        Install archlinux32-keyring-transition

        Install archlinux32-keyring (replaces archlinux32-keyring-transition)

        Install dependencies (base-devel git wget rsync moreutils devtools32 inetutils)

        Note: devtools32 might not be up-to-date, use the git repo from directly and install manually with:

    make install
  2. Create a signing key for signing your packages. Communicate this key to the group.

  3. Create a user to run the slave (for instance 'builder')
        visudo and add the build commands to user 'builder':

        Cmnd_Alias BUILD_CMDS = /usr/bin/staging-with-build-support-i686-build, /usr/bin/staging-i686-build, /usr/bin/multilib-build, /usr/bin/extra-x86_64-build

        builder ALL=(ALL) NOPASSWD: BUILD_CMDS
        (Note: there might be many more, pentium4)
        su to builder
        create .gnupg directory, and add to ~/.gnupg/gpg.conf:

        keyserver-options auto-key-retrieve
  4. Check out the code from into 'builder'. Copy 'conf/slave.conf.example' to 'conf/slave.conf'. Customize the slave by setting at least the 'package_key' to your signing package key. Most importantly set the signing key ID for signing packages:

  5. If you want to run multiple build slaves on the same machine, create Linux users for them like 'slave1', 'slave2' and give them each a separate workspace of the builder. Also, configure separate archbuild chroots for each of them:

  6. Get the Archlinux32 mirrorlist package 'mirrorlist32' from or create one by hand and store it as '/etc/pacman.d/mirrorlist32', pick a mirror close to you (preferably one you have set up for the build slave locally), e.g.:

    Server = https://localmirror/$arch/$repo

    Note: update pacman*.conf files in /usr/share/devtools when building on x86_64 (set Architecture manually to i486, i686, not to auto)

  7. You should also make sure, that before building a package to call a mirror syncing script (you configure this also in 'conf/slave.conf':

    mirror_update_command='curl -v https://localmirror/php/sync_mirror.php'

    Such a syncing script could look as follows:

        header( "Content-Type: text/plain" );
        system( "sudo /data/arch32/scripts/sync_mirror" );

    For sync_mirror have a look how to set up and sync a local mirror.

  8. Run the slave for a first time with 'builder/bin/build-package' . to clone upstream's pkgbuild files and verify everything is working. First time you start it you get asked about generating a private/public key pair. Leave the password blank.

    Note: This will generate an error after cloning about not having permission to access buildmaster. Just hit Ctrl+C to quit once you hit this error.

    The git repositories in work/repos/ are packages, community and packages32, they are in bare format, so you have to clone them once, remove the bare once and rename the workspaces back to their original name. Also change the remote origin to point to the repo location at git://,git://  resp. and not to the bare file system (git://, git:// and

  9. It will also generate a slave SSH key pair in 'work/.ssh/' as 'id_rsa'/''. Communicate the '' to the group - along with your name and the name of the build slave, so it can be entered on the buildmaster with:

    manage-slaves add <slave name> <owner of the slave> <public key fingerprint of the build slave>
    manage-slaves enable <slave name>

    From then on you should see the slave appear in

  10. Import your build key 'work/.ssh/id_rsa' (private key!) to the builder's gpg keyring - strip passphrase if one exists

  11. Set PACKAGER in /etc/makepkg.conf on the host to an email address which will end up in all packages you are building.

  12. Run builder/bin/build-packages (in a screen/tmux buffer) to start building

  13. You can also create a systemd service in '/etc/systemd/system/arch32-slave@.service':

    Description=Archlinux32 Build Slave (%I)
    ExecStartPre=/usr/bin/git -C /home/%I/builder pull

    Start it with:

    systemctl start arch32-slave@builder.service

    Stop it gracefully with:

    touch /tmp/do-not-run-build-slave
  14. You can see what the build slave is doing with:

    journalctl -fl -u arch32-slave@builder

    and build details of the current package building with:

    cd /home/builder/builder/work && tail -f tmp.*/*build-log
  15. Usually build slaves should run on 64-bit hosts. Only when packages are recognizing features of the host instead of the chroot, you have to build the i486 packages on a i486 host for instance.


Board footer

Powered by FluxBB