diff --git a/doc/building.dox b/doc/building.dox index c0ee2f5e0..6fb48bbab 100644 --- a/doc/building.dox +++ b/doc/building.dox @@ -385,6 +385,30 @@ depending projects. If you have Node.js installed, you can also build and run unit tests using `ctest`. See `BUILD_TESTS` above. +@section building-ci-jenkins Jenkins Continuous Integration + +In `package/ci/` there are `jenkins.xml` and `jenkins-gltests.xml` files +containing job configuration, one for build and non-GL tests and the other for +GL tests only. Setup your Jenkins server, enable the **Git** and +**Text-finder** plugin and download the CLI application from here: + + http://your-jenkins-server/cli + +Then add new jobs or update existing ones (replace `` with `create-job` +or `update-job`). + + java -jar jenkins-cli.jar -s http://your-jenkins-server Magnum < jenkins.xml + java -jar jenkins-cli.jar -s http://your-jenkins-server Magnum-GLTests < jenkins-gltests.xml + +Build is done using **Ninja** build system and everything possible is enabled, +thus you need also **SDL2**, **GLUT** and **OpenAL** libraries. It expects that +**GCC** >=4.8.2, 4.7, 4.6 and **Clang** are installed and there are **OpenGL**, +**OpenGL ES 2.0** and **OpenGL ES 3.0** librares as it tries to compile the +library with every combination of them. You can add/remove the axes in +`axes/hudson.matrix.TextAxis` or via the web interface later. + +Magnum-GLTests depend on active X11 session, thus they should be run from +Jenkins instance running on graphical user session. */ } diff --git a/package/ci/jenkins-gltests.xml b/package/ci/jenkins-gltests.xml new file mode 100644 index 000000000..63cc38a58 --- /dev/null +++ b/package/ci/jenkins-gltests.xml @@ -0,0 +1,90 @@ + + + + + + -1 + 10 + -1 + -1 + + false + + + true + false + false + false + + false + Magnum + + + compiler + + g++ + g++-4.7 + g++-4.6 + clang++ + + + + libraries + + static + dynamic + + + + compatibility + + + deprecated + + + + gl + + desktop + es2 + es2desktop + es3 + + + + + + + + + + + + + Errors while running CTest + false + true + true + + + + + false + + + + + SUCCESS + 0 + BLUE + true + + + . + diff --git a/package/ci/jenkins.xml b/package/ci/jenkins.xml new file mode 100644 index 000000000..1c8ab5127 --- /dev/null +++ b/package/ci/jenkins.xml @@ -0,0 +1,172 @@ + + + + + + -1 + 10 + -1 + -1 + + false + + + 2 + + + git://github.com/mosra/magnum.git + + + + + */master + + + false + + + + true + + + + + true + false + false + false + + false + Magnum + + + compiler + + g++ + g++-4.7 + g++-4.6 + clang++ + + + + libraries + + static + dynamic + + + + compatibility + + + deprecated + + + + gl + + desktop + es2 + es2desktop + es3 + + + + + + + + + + + + + Magnum-GLTests + + SUCCESS + 0 + BLUE + true + + + + Errors while running CTest + false + true + true + + + + + true + + + + + SUCCESS + 0 + BLUE + true + + + . +