Public | Automated Build

Last pushed: 2 years ago
Short Description
Simple gitlab runner
Full Description

Fully dockerized Gitlab Runner

This image registers and runs a single gitlab runner.

If you need multiple runners, simply start multiple containers.

The usage examples below focus on running this container with the necessary configuration to let you
spawn docker containers from inside it.

Note that we share the docker.sock instead of using some dind image. please read this blog post to understand our motivations to avoid Docker in Docker strategy.

Be aware that images are built in the host. This is great because it allows you to share the images cache and run your builds faster. Take care to you always include dynamic tags to your inner docker builds so that parallel builds don't conflict.

Also take note that if you use docker-compose in your tests, you would need to ensure that concurrent builds don't conflict. Actually, gitlab ci automatically puts your current build in a folder with the name of your project. Docker-compose will use this folder name to name your images and containers. If you run multiple containers of this image on the same host and you want to use docker-compose, you will need to find a way to isolate the builds. Please feel free to contribute on the subject if you have an idea.

Manual usage example

docker run -it \
-v /var/run/docker.sock:/var/run/docker.sock \
-v `which docker`:`which docker` \
-v /home/gitlab-runner:/home/gitlab-runner \
jgranstrom/simple-gitlab-runner \
-u \
-r yourregistrationtoken \
--description 'Your Runner Name' \
--tag-list 'your, tags' \
--executor shell

All the command arguments are proxied to the gitlab-runner register -n. For more information on available options check the official documentation of the gitlab runner.

Volumes explanation

Mount the docker socket so that builds can spawn docker containers through the host's docker.


Mount the docker binary so that the versions match. Adapt this if the docker resides in another directory.


Mount the work directory. The directory must be the same on the host and inside the container, so that new containers can mount volumes from the current build using pwd for example.


We actually do no recommend mounting the config directory /etc/gitlab-runner as this container is intended to be ephemeral and run a single runner.

Tutum deployment

Run command

-u -r yourregistrationtoken --name 'Your Runner Name' --tag-list 'your, tags'

Mount volumes

In tutum you have to mount the volumes via the gui

  • /var/run/docker.sock:/var/run/docker.sock
  • /usr/bin/docker:/usr/bin/docker
  • /home/gitlab-runner:/home/gitlab-runner

Note that you can not use which docker for mounting the docker binary. So you might have to adapt the location of the docker binary depending on your host's docker binary location. The easiest way to check that your docker is accessible is to open a terminal in your container (possible through the Tutum gui), and type docker info.

Docker Pull Command
Source Repository