Хостинг GitLab Runner на машине, которая принадлежит вам

Как установить GitLab Runner на новом хосте

Debian или Ubuntu, с чистого сервера, в том порядке, который документирует GitLab. Всё ниже - их последовательность, не наша.

1. 1

   Добавьте официальный репозиторий пакетов

   curl -L "https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.deb.sh" -o script.deb.sh
   less script.deb.sh
   sudo bash script.deb.sh

   GitLab поставляет репозиторий как сценарий установки и просит прочитать его перед запуском - именно поэтому их собственная инструкция сначала скачивает его, а не передаёт сразу в оболочку.

2. 2

   Установите runner

   sudo apt install gitlab-runner

   Пакет создаёт системного пользователя gitlab-runner, домашний каталог которого создаётся пустым, без файлов-шаблонов. Чтобы зафиксировать версию, установите gitlab-runner и gitlab-runner-helper-images вместе одной версии - с 17.7.1 они идут парой, и упоминание только одного завершается ошибкой зависимостей.

3. 3

   Установите Docker, если задачи выполняются в контейнерах

   sudo apt install docker.io
   sudo systemctl enable --now docker

   Executor docker общается с локальным Docker Engine через API v1.25, поэтому демон должен быть на самом хосте runner. Пакета из дистрибутива достаточно для начала; собственный репозиторий Docker содержит более новые выпуски, если какой-то сборке они нужны.

4. 4

   Зарегистрируйте runner

   sudo gitlab-runner register \
     --non-interactive \
     --url "https://gitlab.com/" \
     --token "$RUNNER_TOKEN" \
     --executor "docker" \
     --docker-image alpine:latest \
     --docker-pull-policy "if-not-present" \
     --description "docker-runner"

   Сначала создайте runner в GitLab, в Settings, затем CI/CD, затем Runners - он вернёт токен аутентификации, начинающийся с glrt-, который идёт в --token. Теги задач и параметр для задач без тегов задайте в той же форме: с токенами аутентификации они принадлежат runner, а не команде register. Более старый путь с --registration-token устарел и запланирован к удалению в GitLab 20.0.

5. 5

   Задайте параллельность и запустите

   sudo sed -i "s/^concurrent = .*/concurrent = 4/" /etc/gitlab-runner/config.toml
   sudo gitlab-runner restart
   sudo gitlab-runner status

   config.toml лежит в /etc/gitlab-runner, когда runner работает от root. concurrent - это потолок для всех runner, зарегистрированных на этом хосте, а не настройка для каждого по отдельности, и каждый runner может нести под ней собственный, меньший лимит.

6. 6

   Проверьте это одной задачей

   stages: [test]
   
   smoke:
     stage: test
     tags: [docker-runner]
     script:
       - cat /etc/os-release
       - echo "built on $CI_RUNNER_DESCRIPTION"

   Закоммитьте это как .gitlab-ci.yml, сделайте push, и задача должна попасть на ваш хост за несколько секунд. Если она остаётся в очереди, теги не совпадают с теми, что вы задали в интерфейсе, или runner привязан к другому проекту.

Сверено с официальной документацией 2026-08-15 — читать первоисточник