Jenkins is a Java tool used to handle recurring tasks such as running tests or building packages. Our primary install is at https://integration.mediawiki.org/ci/.
The tool is permanently connected to our review tool (Gerrit) and can be made to react on changes submitted to Gerrit. A typical example, is running MediaWiki unit tests whenever a change is submitted to the
Services[edit | edit source]
These services run alongside on the Jenkins server as a result of certain jobs that publish results outside the Jenkins realm for other use:
Nightly snapshots[edit | edit source]
They are being generated at 3am UTC via the Jenkins job "Nightly - MediaWiki core". The ant target is nightly-mediawiki-core and is really straightforward : it get the latest version of master and uses git-archive to generate a zip file. It is then copied under /org/mediawiki/integration/nightly hierarchy which is publicly available via https://integration.mediawiki.org/nightly/.
The latest snapshot is always available at https://integration.mediawiki.org/nightly/mediawiki/core/mediawiki-latest.zip (it is a symbolic link to the latest snapshot).
Android applications[edit | edit source]
The WMF produces three Android application (WikipediaMobile, WLMMobile and WiktionaryMobile), hosted on GitHub. A pre commit hook notifies Jenkins whenever a change is submitted in GitHub. The ping back URL is https://integration.mediawiki.org/ci/github-webhook/. Jenkins will then fetch the branch the commit was made in and build the application.
Jenkins expects an ant script named build.xml in the root directory and will then execute ant debug. Once it completes a build, it copies the generated apk under /srv/org/mediawiki/integration/*Mobile to make it available publicly. For example, the WLMMobile application at https://integration.mediawiki.org/WLMMobile/nightly/ .
The mobile team is informed of build completion via an IRC bot idling in their irc channel irc://irc.freenode.net/#wikimedia-mobile
Installation[edit | edit source]
||IMPORTANT: The content of this page is outdated. If you have checked or updated this page and found the content to be suitable, please remove this notice.|
Automatic installation[edit | edit source]
To make the install go faster, it helps to have a mediawiki-core checkout in ~/src/mediawiki-core - if this repository exists, it will make a local clone. If it doesn't, it will download from gerrit instead (slow!).
Manual installation[edit | edit source]
- git clone https://gerrit.wikimedia.org/r/p/integration/jenkins.git ~/.jenkins
- ~/.jenkins is the default jenkins configuration directory
- WM-specific configuration patch I - ln -s $HOME/.jenkins /var/lib/jenkins
- because some jobs assume jenkins is installed in /var/lib/jenkins
- Download jenkins and place it in ~/.jenkins
- install the following plugins (download into ~/.jenkins/plugins):
- Download jenkins-job-builder and its configuration ‒ see Continuous_integration/Jenkins job builder for more information. You don't need a password when you install Jenkins locally.
- WM-specific configuration patch II - Patch the JBB configuration that depends on Zuul (see the mkjenkins script for a diff)
- If you already have a checkout of mediawiki-core: git clone --mirror -l -- your_existing_checkout /var/lib/jenkins/git/mw-core-bare. Otherwise, git clone --mirror -- https://gerrit.wikimedia.org/r/p/mediawiki/core.git /var/lib/jenkins/git/mw-core-bare
- Start Jenkins: cd ~/.jenkins && java -jar jenkins.war&
- When Jenkins is running, install the JBB jobs: rm -f $HOME/.cache/jenkins_jobs/jenkins_jobs_cache.yml && jenkins-jobs --conf jenkins_jobs.ini update config/.
Debugging[edit | edit source]
Start Jenkins with Java option: