
GitLab Runner – это еще одно приложение из категории open-source, которое предлагает компания GitLab.com (компания). Оно было разработано для работы с функциональностью Gitlab CI/CD (Continuous Integration/Continuous Deployment (CI/CD)) для запуска заданий и отправки результатов обратно на платформу Gitlab. Runner предоставляет разработчикам функциональность автоматизированного тестирования, сборки и развертывания кода. GitLab Runner хорош тем, что мы можем установить его не только на Linux, но и на Windows и MacOS; он очень гибкий, а благодаря возможности масштабирования может удовлетворить различные потребности в развертывании и разработке.
Ключевые особенности GitLab Runner
- Поддержка нескольких платформ
- Несколько исполнителей
- Параллельное выполнение
- Кэширование
- Автомасштабирование
- Настраиваемые
- Безопасное выполнение заданий.
- Простая регистрация и управление
Необходимые условия для выполнения данного руководства:
- Ubuntu 24.04, 22.04 или 20.04
- Привилегии Sudo для установки пакетов GitLab Runner.
- Учетная запись GitLab для регистрации бегуна
Установка и регистрация GitLab Runner на Ubuntu
Узнайте, как установить GitLab Runner на Ubuntu 24.04 или 22.04, чтобы автоматизировать конвейеры CI/CD, оптимизировать сборку программного обеспечения и эффективно развертывать код.
Шаг 1: Обновление пакета
Зайдите в командный терминал на вашем Ubuntu 24.04 или 22.04 Linux; если ваш сервер работает удаленно, используйте SSH. После этого выполните команду system update, чтобы убедиться, что все пакеты обновлены и в системе установлены последние исправления безопасности.
sudo apt update && sudo apt upgrade
Шаг 2: Добавление репозитория GitLab Runner
Точно так же, как мы установили платформу GitLab DevOps на Ubuntu , используя ее официальный репозиторий, нам необходимо добавить репозиторий для GitLab Runner, поскольку его пакеты также недоступны в системном репозитории по умолчанию. Поэтому выполните приведенные команды в терминале.
curl -L "https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.deb.sh" | sudo bash

Шаг 3: Установка Gitlab Runner на Ubuntu 24.04 или 22.04
После выполнения команд предыдущего шага в нашей системе Ubuntu появится официальный репозиторий Runner. Также будет запущена команда обновления системы, чтобы обновить список пакетов репозитория. Теперь используйте менеджер пакетов APT вместе с именем пакета.
sudo apt-get install gitlab-runner

Шаг 4: Зарегистрируйте GitLab Runner
После установки GitLab Runner следующим шагом будет его регистрация в вашем экземпляре GitLab.
Получите регистрационный токен:
Чтобы получить регистрационный токен, мы должны войти в наш экземпляр GitLab и посетить проект или группу, в которую мы хотим добавить бегун.
- После этого нажмите на Настройки и выберите CI / CD вариант.

- Пройдя через несколько разделов, зайдите в раздел Runners и нажмите на кнопку Развернуть кнопку. После этого нажмите “Новый проект”. если у вас нет активного Бегуна.

- Теперь добавьте теги, чтобы указать задания, которые может выполнять бегун. Вы также можете запускать задания без тегов, установив соответствующий флажок. При необходимости настройте другие параметры и нажмите кнопку “Creел бегуна” кнопка.

- Выберите тип операционной системы, на которую вы установили Runner; например, мы выбрали Linux. Затем скопируйте код, приведенный вместе с маркером аутентификации Runner.

- Вставьте код в терминал Ubuntu 24.04 и нажмите кнопку Enter клавиша. Система задаст несколько вопросов о настройке бегуна. Ответьте на них, и ваш бегунок будет зарегистрирован.
Предоставьте необходимую информацию:
- Команда регистрации запросит у вас несколько сведений:
- URL GitLab: Укажите URL-адрес вашего экземпляра GitLab (например,
https://gitlab.com
). - Регистрационный токен: Введите токен, полученный от вашего проекта GitLab.
- Описание: Укажите имя или описание для бегуна (например,
My Ubuntu Runner
). - Теги: Опционально добавьте теги к бегуну, чтобы распределить его по категориям.
- Исполнитель: Выберите тип исполнителя. Для большинства случаев,
shell
достаточно, но вы можете выбрать и другие, напримерdocker
,virtualbox
, и т.д.
- URL GitLab: Укажите URL-адрес вашего экземпляра GitLab (например,

Шаг 5: Запуск и включение GitLab Runner
После регистрации запустите службу GitLab Runner и включите ее запуск при загрузке.
sudo systemctl start gitlab-runner
sudo systemctl enable gitlab-runner
Шаг 6: Проверка установки
Убедитесь, что служба установки работает без ошибок:
sudo systemctl status gitlab-runner --no-pager -l

Проверьте Runner в GitLab:
Вы также можете проверить статус созданного Runner на вашем экземпляре GitLab, посетив ваш Настройки проекта GitLab > CI / CD > раздел Runners. Вы должны увидеть только что зарегистрированный бегун в списке активных, откуда вы также можете приостановить или удалить его.
