ZabeMath / integration-config

⚙️ This is a mirror from https://gerrit.wikimedia.org. See https://www.mediawiki.org/wiki/Developer_access for contributing.

Wikimedia configuration for Jenkins

This repository holds the configuration of the Wikimedia Foundation Inc. Jenkins jobs. It is meant to be used with a python script written by the OpenStack Foundation: Jenkins Job Builder.

When you tweak or add jobs, follow the documentation maintained on mediawiki.org:

https://www.mediawiki.org/wiki/CI/JJB

For more about the Jenkins Job Builder software and how to use it, refer to the upstream documentation:

https://docs.openstack.org/infra/jenkins-job-builder/

Example Usage

You should run Jenkins job builder using:

$ tox -e jenkin-jobs -- <arguments>

Generate XML files for Jenkins jobs from YAML files:

$ tox -e jenkins-jobs -- test ./jjb/ --config-xml -o output/

Update Jenkins jobs which name starts with "selenium":

$ tox -e jenkins-jobs -- --conf jenkins_jobs.ini update ./jjb/ selenium*

Running tests

To test the configuration, we use tox and you need at least version 1.9+ (bug T125705) to run the test suite. Running tox in the main dir of your local clone runs the tests.

Add volunteer users to the allow list

See https://www.mediawiki.org/wiki/Continuous_integration/Allow_list

Deployments

Use the ./fab helper for deployment actions:

$ ./fab deploy_zuul
$ ./fab deploy_docker
$ ./fab docker_pull_image <imagename>