schmunk42/gitlab-runner repository overview

⁠docker-gitlab-runner

This is a GitLab CI runner with docker-compose and git-lfs support.

⁠Resources

• Docker-Compose Runner (Image⁠, Source⁠)
• Base GitLab Runner (Image⁠, Source⁠)

⁠:warning: Important information

It is strongly recommended to run this runner on a separate Docker host VM. For some more details why and why this is not using Docker-in-Docker, please read this blog posting⁠.

We recommend running this runner only in non-public environments, see https://github.com/schmunk42/docker-gitlab-runner/issues/4⁠ for details.

⁠Requirements

• host-mounted Docker socket

⁠>= 4.1.0

• docker >= 1.10.0

⁠4.0.x

• docker >= 1.9.0

⁠1.0.0 - 3.0.0

• docker >= 1.9.0

See also CHANGELOG⁠ for versions of docker and docker-compose on this image.

⁠Setup

Connect to your runner host

docker-machine ssh ${RUNNER_HOST}

Get token from CI runners page (/admin/runners).

Set variables

export CI_RUNNER_TOKEN=<ENTER-YOUR-TOKEN-HERE>

Start runner (only one)

docker run -d \
    --name runner \
    --restart always \
    -v /var/run/docker.sock:/var/run/docker.sock \
    -v /home/gitlab-runner/config:/etc/gitlab-runner \
    -v /home/gitlab-runner/builds:/home/gitlab-runner/builds \
    schmunk42/gitlab-runner:4.2.0-rc1

First time setup

edit /home/gitlab-runner/config

Change concurrent setting.

⁠Usage

Obtain token from GitLab CI runners page, and export it.

Debug commands

docker exec -it runner gitlab-runner verify

Start runner instances (TODO: check, if they run in parallel)

docker exec -it runner gitlab-runner \
    register \
        --executor shell \
        -u https://my.gitlab.server:443/ci \
        -r ${RUNNER_TOKEN} \
        -n

⁠Building the image

docker build --pull -t local/runner .

Check version of runner

docker run local/runner -v 

Built by dmstr⁠