Jenkins » History » Version 9

laforge, 03/05/2018 07:23 PM

1 6 laforge
2 1
3 4 laforge
h1. Continuous Integration with Jenkins
4 1
5 4 laforge
h2. What
6 1
7 6 laforge
The Osmocom Cellular Infrastructure software stack has grown to a size where it make sense to somehow track the state after each commit. The "Jenkins Software": allows us to do this. The installation can be found at and all of Osmocom is tracked there. The goal is to have all projects/repositories of the osmocom umbrella tracked there. 
8 1
9 8 laforge
We are happy if people donate CPU time to be used as additional nodes (Build Slaves) to execute the compile jobs. Please contact if you want to donate some.
10 5 laforge
11 4 laforge
h2. How
12 3
13 8 laforge
We are using Jenkins as it comes from the FreeBSD port system. It runs using the standalone servlet container (Winstone Servlet Engine) and is behind one (IPv6) or two (IPv4) cherokee reverse proxies. Currently there are several build slaves, primarily Debian GNU/Linux 8 and 9 on amd64..
14 1
See also [[osmocom-servers:Jenkins_Node_Setup]]
17 8 laforge
h3. Jenkins Job Builder
19 9 laforge
Initially we used manually-configured jenkins jobs using the Jenkins Web UI.  With a lot of projects, it's easy to introduce inconsistency and becomes difficult to maintain.  Instead, we step by step migrated to using "Jenkins Job Builder": which allows us to describe build jobs in YAML syntax.  You can find our job descriptions at - and as always, contributions are welcome.
20 8 laforge
21 6 laforge
h3. Custom Build Helper Scripts
22 1
23 6 laforge
If you look into the jenkins job configuration of the individual jobs, you will notice that they use a custom helper script that is part of each Osmocom projects' git repository: @contrib/ (for an example, see
24 5 laforge
25 6 laforge
This @contrib/ expects that some common helper scripts from are in your PATH at the time of execution.  The common helper scripts (such as or  Those helpers perform tasks similar to all osmocom projects, i.e. clone/update a dependency in the workspace of a build node.  The script will try to @git-clone@, @git-fetch@, @git-reset --hard@ the dependency.
26 3
27 6 laforge
h4. Building code like jenkins build slave would do it
During development, it sometimes is useful to build the code just like it is built on the jenkins build slave.
31 5 laforge
If you would like to do that, you should
32 3
# @git clone git://
33 1
# set your shell @PATH@ to include the @osmo-ci/scripts@ directory
# set the @MAKE@ environment variable to your make command (@make@ or @gmake@)
# go to the root directory of the respective project git repo (e.g. libosmo-netif)
36 5 laforge
# execute @./contrib/
Add picture from clipboard (Maximum size: 48.8 MB)