GitLab Runner

This is GitLab Runner repository, this application run tests and sends the results to GitLab CI.
GitLab CI is the open-source continuous integration server that coordinates the testing.

Requirements

Omnibus packages and other platforms

The recommended way to install this runner are the Omnibus packages.
GitLab runners are also available for all kinds of other platforms such as Windows and OSX.
For more information about both please see the runner section of the GitLab CI page on the website.

Supported platforms

This projects officially support these Linux distributions:

Ubuntu

Debian

CentOS

Red Hat Enterprise Linux

Scientific Linux

Oracle Linux

Mac OSX and other POSIX operating systems are not supported but will work with adaptations.
Under Windows the runner will only work under POSIX compliant environments like Cygwin.
Also see the alternative Runners for Windows, Scala/Java and Node please see the runner section of the GitLab CI page on the website.

By default the configuration file for your new runner gets written in the directory where the gitlab-ci-runner source code was installed, e.g. in /home/gitlab_ci_runner/gitlab-ci-runner/config.yml.
You can tell bin/setup to use a different directory with the -C switch.

bin/setup -C /my/runner/working/directory

You can also specify RUNNER_DESCRIPTION and RUNNER_TAG_LIST during setup.

Run

If you are using a custom working directory you can tell the runner about it with the -C switch.
The default working directory is the directory where the gitlab-ci-runner source code was installed, e.g. /home/gitlab_ci_runner/gitlab-ci-runner.

bundle exec bin/runner -C /my/runner/working/directory

Update

In order to update the runner to a new version just go to runner directory and do next:

Easily add Runners to existing GitLab CI

GitLab.com uses GitLab CI to test our own builds. To quickly spin up some extra runners in time of need, we have setup a runner as described above, with all the relevant dependencies for our builds and have taken a snapshot of this runner.

To quickly add a runner, have the registration token at hand and:

instantiate a new VPS with the snapshot gitlab-ci-runner-2gb-2gbswap

bundle exec ./bin/setup

sudo service gitlab-ci-runner start

Now the runner will start to pick up builds automatically. When you are done with it, you can destroy the VPS without worrying about anything. For testing GitLab itself, use of a runner with >= 2GB RAM is recommended.