Docker GitlabCI Runner images

Gitlab CI runner docker base images with ssh-key sharing.

Take care, this project is not maintained anymore and deprecated in favor of official Gitlab Multi-Runner

Table of contents

• Base Image
  • Build
  • Usage
• PHP Images
  • Usage
  • Custom PHP configuration
  • Development
• NodeJS Image
  • Usage
  • Development
• Gitlab CI setup
• Contributors

Base Image

This docker image is based on gitlabhq/gitlab-ci-runner image and provide a way to pass it an ssh-key or automatically generate a new one. This is a base image you can extend with your own stack.

Build

In order to build it, you need to execute the following commands:

docker build -t gitlabhq/gitlab-ci-runner github.com/gitlabhq/gitlab-ci-runner
docker build -t bobey/docker-gitlab-ci-runner github.com/bobey/docker-gitlab-ci-runner

Usage

docker pull bobey/docker-gitlab-ci-runner

Then, you can run as many runners as you want by executing:

docker run \
  -e CI_SERVER_URL=https://ci.example.com \
  -e REGISTRATION_TOKEN=replaceme \
  -e HOME=/root \
  -e GITLAB_SERVER_FQDN=gitlab.example.com \
  bobey/docker-gitlab-ci-runner

If you need to pass an ssh key to the runner (a deploy key for example), use the following command:

docker run \
  -e CI_SERVER_URL=https://ci.example.com \
  -e REGISTRATION_TOKEN=replaceme \
  -e HOME=/root \
  -e GITLAB_SERVER_FQDN=gitlab.example.com \
  -v /absolute/path/to/your/home/.ssh/id_rsa:/root/.ssh/id_rsa:ro \
  bobey/docker-gitlab-ci-runner

If you don't mount this optional volume, an ssh-key will be automatically generated and the public key will be displayed on standard output.

If you need to start a bash inside your container, use the following command:

docker run \
  -e CI_SERVER_URL=https://ci.example.com \
  -e REGISTRATION_TOKEN=replaceme \
  -e HOME=/root --rm -it \
  bobey/docker-gitlab-ci-runner:latest /bin/bash

PHP Images

We provide docker gitlab-ci runner images for php 5.4, 5.5 and 5.6 containing the following stack:

• PHP 5.x
• Git
• Composer

Usage

You can run as many runners as you want by executing:

docker run \
  -e CI_SERVER_URL=https://ci.example.com \
  -e REGISTRATION_TOKEN=replaceme \
  -e HOME=/root \
  -e GITLAB_SERVER_FQDN=gitlab.example.com \
  -v /absolute/path/to/your/home/.ssh/id_rsa:/root/.ssh/id_rsa:ro \
  bobey/docker-gitlab-ci-runner-php5.6

In your GitlabCI, a basic phpunit job could looks like this:

composer install
php vendor/phpunit/phpunit/phpunit --coverage-text

By displaying code coverage as text, you can easily extract code coverage metrics. In your project settings, under "Test coverage parsing", just input the following regex: Lines:\s+(\d+.\d+\%).

Custom PHP configuration

All PHP images comes with the following extensions pre-installed but not enabled by default with the exception of xdebug:

• memcache.so
• mongo.so
• redis.so
• ssh2.so
• xdebug.so

If you need to customize the php configuration, you can add your own settings to the ci-runner.ini file. For example, the following command in one of your gitlab-ci jobs will enable mongo.so extension:

echo 'extension="mongo.so"' >> ~/.phpenv/versions/$(phpenv version-name)/etc/conf.d/ci-runner.ini

You can of course customize any other parameter of the php.ini configuration file. Below command will set Europe/Paris as the default timezone:

echo 'date.timezone="Europe/Paris"' >> ~/.phpenv/versions/$(phpenv version-name)/etc/conf.d/ci-runner.ini

Composer and Github API rate limit

All PHP images comes with Composer pre-installed and ready to be used. But, as you might already know, Github API rate limit is quite often reached when building projects in CI. See what Composer doc say about it.

One way to handle this problem is to create an auth.json file and share it with your gitlab-ci-runners via a volume:

{
    "http-basic": {},
    "github-oauth": {
        "github.com": "GITHUB_GENERATED_TOKEN"
    }
}

Then, start your runner with an extra -v option:

docker run \
  -e ...
  -v /absolute/path/to/composer-auth.json:/root/.composer/auth.json:ro \
  bobey/docker-gitlab-ci-runner-php5.6

Development

This docker image is based on bobey/docker-gitlab-ci-runner image. In order to build it, you need to execute the following command:

docker build -t bobey/docker-gitlab-ci-runner-php5.6 github.com/bobey/docker-gitlab-ci-runner/php/5.6

NodeJS Image

A docker gitlab-ci runner containing the following stack:

• NodeJS
• NPM

Usage

You can run as many runners as you want by executing:

docker run \
  -e CI_SERVER_URL=https://ci.example.com \
  -e REGISTRATION_TOKEN=replaceme \
  -e HOME=/root \
  -e GITLAB_SERVER_FQDN=gitlab.example.com \
  -v /absolute/path/to/your/home/.ssh/id_rsa:/root/.ssh/id_rsa:ro \
  bobey/docker-gitlab-ci-runner-nodejs

Development

This docker image is based on bobey/docker-gitlab-ci-runner image. In order to build it, you need to execute the following commands:

docker build -t bobey/docker-gitlab-ci-runner-php github.com/bobey/docker-gitlab-ci-runner/nodejs

Gitlab CI setup

By starting Gitlab CI runners through Docker, assuming you passed a valid registration token, they will automatically add themselves to your CI instance. You should see them in the "Runners" tab.

Contributors

Many thanks to the awesome @jubianchi for its help with the base php image.