Builder CI

Builder-CI should work on any GNU/Linux based system however it was developed on Debian Buster with limited testing on other distributions. Please let us know if you run it on another distribution with issues and off course if you have problems.

The following server specification is known to be able to build all packages tested as of today, but Builder-CI itself can run on much lower specification hardware with limitations due to performance.

• 4 vCPU
• 4Gb of RAM
• 50Gb hard drive space

The rest of this guide is done on a terminal with root access (sudo su).

Installing Mongo¶

Builder-CI uses the Listener feature of Mongo replicaset. Mongo can be installed on the same server or deployed on another server/cluster. Deployment on the same server is the simplest option.

## Install Mongo Repository
curl -s https://www.mongodb.org/static/pgp/server-${VERSION}.asc | apt-key add -
echo "deb http://repo.mongodb.org/apt/debian buster/mongodb-org/4.4 main" \
    > /etc/apt/sources.list.d/mongo.list

## Install Mongo Package
apt update && apt install mongodb-server

## Enable the replicaset feature
echo -e "replication:\n   replSetName: \"rs0\"" >> /etc/mongod.conf

## Start Mongo and enable the service
systemctl enable --now mongod

## Enter into Mongo console and add this host to replicaset.
mongo
rs.initiate({
   _id: "rs0",
   members:[
      {
         _id: 0,
         host: "localhost:27017"
      }
   ]
})

Installing Docker¶

Docker is not mandatory if you only want to build Debian Package, but most build processes will require that you install Docker to provide clean build environments.

curl -s https://download.docker.com/linux/debian/gpg | apt-key add -
echo "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/debian buster stable" \
    > /etc/apt/sources.list.d/docker.list
apt update && apt install docker-ce

Builder-CI will automatically build all the required docker images during the installation phase.

Installing Builder-CI¶

The installation of Builder-CI includes the installation of the Builder-ci process and the building of various base Docker images used during the build processes. This step will take several minutes depending on your internet speed and server performance.

echo "deb [trusted=yes] https://projects.iabsis.com/repository/builder-ci/debian buster main" \
    > /etc/apt/sources.list.d/iabsis.list
apt update && apt install builder-ci

The next step is to check your server sanity before doing your first build Server-sanity-checks