Setup a GitLab Runner¶
First, get the "Registration Token" from your instance: https://${GITLAB_URL}/admin/runners
.
Then run the registration:
docker run --rm -it -v "${CONFIG_DIR}:/etc/gitlab-runner" gitlab/gitlab-runner register
Then run the container:
docker run --rm -d --name gitlab-runner -v "${CONFIG_DIR}:/etc/gitlab-runner" -v "/var/run/docker.sock:/var/run/docker.sock" gitlab/gitlab-runner
You will likely need to alter the runner's configuration within the GitLab interface.
To get started, do the following:
- Check "Run untagged jobs"
- Uncheck "Lock to current projects"
Config¶
The config will look something like this. Multiple [[runners]]
sections are allowed.
concurrent = 1 check_interval = 0 [session_server] session_timeout = 1800 [[runners]] name = "${RUNNER_NAME}" url = "https://${GITLAB_URL}" token = "${REGISTRATION_TOKEN}" executor = "docker" [runners.custom_build_dir] [runners.docker] tls_verify = false image = "alpine:latest" privileged = false disable_entrypoint_overwrite = false oom_kill_disable = false disable_cache = false volumes = ["/cache"] shm_size = 0 [runners.cache] [runners.cache.s3] [runners.cache.gcs]