GitLab Runner

GitLab Runner released in January 2015 and written in Go offers continuous integration in GitLab, it is used to run your CI/CD jobs and send the results back to GitLab.

Configuration allows to define

• How many jobs you can run in parallel concurrent option
• Integration with sentry
• Integration with Prometheus

• Runners cache: [runners.cache] https://docs.gitlab.com/runner/configuration/advanced-configuration.html#the-runnerscache-section

Configuration

/etc/gitlab-runner/config.toml. Read https://docs.gitlab.com/runner/configuration/advanced-configuration.html

Known problems: shell executor doesn't clean up build directories

Commands

Full command list: https://docs.gitlab.com/runner/commands/

• gitlab-runner --help
• gitlab-runner verify
• gitlab-runner status
• gitlab-runner list (Provides executor information Executor=docker|Executor=shell)
• gitlab-runner exec docker validate
• gitlab-runner exec docker --docker-privileged $JOB

New

• Credential Helpers GitLab Runner 12.0 https://docs.gitlab.com/ee/ci/docker/using_docker_images.html#use-credential-helpers

Activities

1. Install Gitlab runner
2. Read GitLab Runner Changelog, approximately monthly releases: https://gitlab.com/gitlab-org/gitlab-runner/blob/master/CHANGELOG.md
3. Read GitLab CI/CD Pipeline Configuration Reference:.gitlab-ci.yml https://docs.gitlab.com/ee/ci/yaml/
4. Read GitLab release notes
5. Learn differences between TeamCity Agents and Gitlab runners
6. Create a shared runner in Admin area -> Overview -> runners
7. Setup Autoscaling GitLab Runner on AWS EC2 (GitLab Runner Manager)

Related terms

• TeamCity agents
• gitlab-runner --help
• CI/CD Runners
• GitLab executors
• There has been a runner system failure, please try again
• GitHub runner

See also

• Gitlab Runner: gitlab-runner [ status | verify | list ] gitlab-runner --help, GIT_STRATEGY
• Gitlab runner, runners: gitlab-runner, gitlab-ci.yml, config.toml, GitLab Runner Changelog
• GitLab CI, variables, templates, executors, .gitlab-ci.yml, .gitlab/, Credential helpers, notifications, pipeline editor, Keyword reference, Changelog, ContainersNotReady, GitLab environments

https://docs.gitlab.com/runner/

https://gitlab.com/gitlab-org/gitlab-runner/commit/6f1b10ef6d72de4afc0937ca9337b41be543d64c

https://gitlab.com/gitlab-org/gitlab-runner/issues/3856#note_127887227