GitLab/Workflows/CI

Getting started with gitlab-ci
Here you will find some tips for getting started using gitlab-ci to test commits on your project hosted at gitlab.wikimedia.org.

This is a supplement to the upstream documentation and the aim of this page is to cover differences and limitations specific to Wikimedia's GitLab CI environment.

Configuring your test pipelines: .gitlab-ci.yaml
You can configure the commands to run for your CI pipeline by creating .gitlab-ci.yaml at the root of your project repository. You can also create this file by using the web interface at

When using the web interface to create your CI configuration, you should be aware that the built-in templates that GitLab provides as examples for  are not customized for the Wikimedia CI environment and will not work without some modifications. One of the things that you will have to change is the docker images used to run your jobs. The build-in templates point to images hosted on docker hub which will not be accessible by the Wikimedia CI runners. Instead you need to use images published on https://docker-registry.wikimedia.org/.

Upstream / External Documentation & Resources

 * Get started with GitLab CI/CD
 * Keyword reference for the  file