Как зарегистрировать runner в GitLab

1️⃣ Как кратко ответить

Для регистрации runner в GitLab необходимо: 1) Установить GitLab Runner на сервере; 2) Получить токен регистрации из GitLab; 3) Выполнить команду gitlab-runner register, указав URL GitLab и токен; 4) Настроить параметры runner, такие как executor и теги.

2️⃣ Подробное объяснение темы

GitLab Runner — это приложение, которое используется для выполнения задач CI/CD, определенных в .gitlab-ci.yml. Он может быть установлен на любой сервер, который имеет доступ к вашему GitLab серверу. Регистрация runner позволяет GitLab взаимодействовать с ним и отправлять задачи на выполнение.

Установка GitLab Runner

1. Установка на Linux:
   • Добавьте репозиторий GitLab Runner:

     curl -L --output /usr/local/bin/gitlab-runner https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-linux-amd64
     

   • Сделайте файл исполняемым:

     chmod +x /usr/local/bin/gitlab-runner
     

   • Создайте пользователя для GitLab Runner:

     useradd --comment 'GitLab Runner' --create-home gitlab-runner --shell /bin/bash
     

   • Установите и запустите сервис:

     gitlab-runner install --user=gitlab-runner --working-directory=/home/gitlab-runner
     gitlab-runner start
     

Получение токена регистрации

1. Перейдите в ваш проект на GitLab.
2. Перейдите в Settings -> CI/CD.
3. Разверните секцию Runners.
4. Скопируйте URL и токен регистрации.

Регистрация GitLab Runner

1. Выполните команду регистрации:

   gitlab-runner register
   

2. Введите URL вашего GitLab:

   Please enter the gitlab-ci coordinator URL (e.g. https://gitlab.com/):
   

3. Введите токен регистрации:

   Please enter the gitlab-ci token for this runner:
   

4. Введите описание runner (например, My Runner):

   Please enter the gitlab-ci description for this runner:
   

5. Укажите теги, которые будут использоваться для этого runner:

   Please enter the gitlab-ci tags for this runner (comma separated):
   

6. Выберите executor (например, shell, docker, docker+machine и т.д.):

   Please enter the executor: shell
   

Настройка и запуск

После регистрации runner будет готов принимать задачи. В зависимости от выбранного executor, может потребоваться дополнительная настройка. Например, для docker executor необходимо убедиться, что Docker установлен и настроен на сервере.

Пример использования

Если вы выбрали shell executor, runner будет выполнять команды непосредственно в оболочке сервера. Это полезно для простых задач, но для изолированных сред лучше использовать docker executor.

Зачем это нужно

Регистрация runner позволяет автоматизировать процесс сборки, тестирования и развертывания приложений. Это ключевая часть CI/CD, которая помогает командам быстро и надежно доставлять программное обеспечение.