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.

~~~ bash

## 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.

~~~ bash

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, ...).

~~~ bash

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.