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

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

Related terms

• TeamCity agents
• gitlab-runner --help

See also

• Gitlab runner, runners: gitlab-runner, gitlab-ci.yml, config.toml, GitLab Runner Changelog
• GitLab: Install GitLab, Upgrade GitLab Gitlab runner (changelog), gitlab.rb, .gitlab/, gitlab-ci.yml, gitlab-ctl, gitlab-rake, gitlab-backup, gitlab-rails, GitLab editions, GitLab Security Dashboards, GitLab environments, GitLab environment variables, Auto DevOps, permissions, GitLab Pages, gitlab-rails, GitLab scheduled pipelines, GitLab logs, GitLab changelog , GitLab Release CLI, GitLab Omnibus, GitLab Advanced Search, GitLab container registry, GitLab infrastructure registry
• git: [config | init | status ], git add, git rm, git commit, git push, git pull, .gitconfig, .gitignore, git (clone, fetch, pull), git tag, git log, git blame, Merge Request, LFS, git branch, git apply, git rebase, git diff, git diff-tree, git config --global, remote | submodule | request-pull, GIT_TRACE, GIT_CURL_VERBOSE, clean, main, git show-ref, git reset, git prune, git ls-remote origin, git checkout, git switch, pathspec, git credential-osxkeychain, git version, pre-commit, git --help, GitBook, refs/

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