Continuous integration/Tutorials/Adding a MediaWiki extension
This tutorial is aimed at adding automatic tests for a new MediaWiki extension. You will learn how to verify the tests are going to work properly and how to edit the Wikimedia platform configuration to enable continuous testing.
- A Wikimedia Gerrit account to be able to submit changes for review
- A MediaWiki extension hosted in Wikimedia Gerrit in a repository named
- The extension must install properly using a MySQL database backend
- Your extension must be using extension.json, or if using the legacy PHP entry point, that file must be named the same as the extension, e.g.
- The composer/npm entry points should be set up, if not check the BoilerPlate extension for predefined ones.
- Verify that the unit tests pass (
php tests/phpunit/phpunit.php --testsuite extensions).
Editing Zuul configuration
- Terminology note: Zuul is the system that schedules jobs to be run after a patch is uploaded or approved in Gerrit. Jenkins is the job runner, that communicates with Zuul.
The file is made of four sections:
- pipelines : define event filtering and result handling behavior
- jobs: finely adjust the behavior on a per job basis
- project-templates : define common jobs triggering
- projects: define, for a Gerrit repository, the pipelines to uses and the hierarchy of jobs being triggered.
To add the triggers for the DonationInterface extension, we should add a new entry in the
project section and invoke
project: - name: mediawiki/extensions/DonationInterface # Gerrit project name template: - name: extension-unittests-composer # invoke the template above for unit tests and linting through composer - name: mwgate-npm # run npm test too
Save the file and send it for review. Your changes will be diffed with the previous configuration, and if you are listed in the CI Whitelist, your configuration will be automatically validated.
To have it deployed, see the Zuul page, that requires shell access on the server running it.
If your checks do not run after your configuration has been merged, check to see whether you are listed in the CI Whitelist. Only those on the whitelist can trigger jobs. To request you be added to the whitelist, edit zuul/layout.yaml and find the appropriate whitelist section. Add the email you use for commits, being sure to escape periods and use only greedy selectors. Save the file and send the code for review.
The Jenkins job injects specific configuration at the end of MediaWiki LocalSettings.php. You can find them under integration/jenkins.git repository in directory /mediawiki/conf.d/. It sets for example the global
$wgWikimediaJenkinsCI which let you finely tweak your extension setting when running tests, for example to enable a feature which you want disabled by default but for which you have tests.
If your extension has dependencies on other extensions, they can be added to the mapping in zuul/parameter_functions.py.