Builder CI

Despite Builder-CI should work on almost any GNU/Linux based system, it's recommended to deploy it on Debian Buster. The following server specification is known to be able to build any kind of package, but Builder-CI itself can run on much lower specifications.

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

We assume the rest of this guide is done on a terminal with root access.

Installing Mongo¶

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

## 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 replicaset feature into config
echo -e "replication:\n   replSetName: \"rs0\"" >> /etc/mongod.conf

## Start Mongo
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¶

Builder-CI may rely on Docker to make builds. Docker is not mandatory if you only want build Debian Package, but most of build requires that you install Docker.

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 build for you all images automatically during installation phase.

Installing Builder-CI¶

The most easy part is installing ready packages for Builder-CI. Despite this is only few command lines, the process may take several minutes depending of your internet speed and server. During this stage, few Docker base images will be fetched (Debian, Centos, ...).

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

Next step is to check your server sanity before doing your first build.