Jenkins Build Server

Wiki > Project tools > Jenkins build server

There is a Jenkins Build Server located at http://epics-jenkins.isis.rl.ac.uk/.

For information on configuring Jenkins see Adding a new Windows machine to Jenkins.

What is built

EPICS

• Builds EPICS itself and the IOCs
• Runs the unit tests for the BlockServer and the DatabaseServer
• Runs a Python script as a series of unit tests to check the units in all the EPICS db files
• If the above was successful the compiled binaries are made available at \\isis\inst$\Kits$\CompGroup\ICP\EPICS

Client

• The ibex_gui build uses the master branch for the IBEX GUI
• The ibex_gui_build_PRs builds all the PRs for the ibex_gui branch
• The Tycho build is run, which is slightly different to building within Eclipse. This can be run locally by running the build/build.bat dev_python.bat file that is checked out with the client.
  • build/build.bat copy_python.bat is called in the build server but this copies python into the gui, but we want to use the new genie python as developers
• The Tycho build also runs the unit tests
• Jenkins additionally runs CheckStyle and shows a fail build if there is an increase
• Jenkins builds will bundle the JRE with the client. The version of the JRE bundled is located at \\isis\inst$\Kits$\CompGroup\ICP\ibex_client_jre. This should be updated occasionally.
• If successful The builds are output to \\isis\inst$\Kits$\CompGroup\ICP\Client, including an installer.

genie_python

genie_python gets built and put at \\isis\inst$\Kits$\CompGroup\ICP\Client\genie_python. There is a batch file to do the installation.

Setting up a Pipeline Build

Pipeline builds are created by adding a Jenkinsfile to you root directory and then pointing Jenkins at your repository.

Jenkins File

Defines all the steps there is much documentation on line. Start from a previous file which does something similar and edit. Here is an example in the ibex gui. In it the label is the label of the node on which it is to run. The labels are set by editing the node configuration in jenkins. Everything else should be googleable.

Once this is set up create a new pipeline build in Jenkins.

1. In jenkins click "New Item"
2. Name the project and select Pipeline
3. Under pipeline from SCM select Git
   1. Then add the repository url in and the credentials as ISISBuildServer
   2. Set the branch if needed

This should now build.

Other

• Jenkins trouble shooting