Установка GitLab Runner

GitLab Runner — приложение с открытым исходным кодом, которое выполняет задания конвеерной обработки GitLab CI/CD по инструкциям из специального файла .gitlab-ci.yml. Оно позволяет запускать автоматизированные сборки внутри кластера Managed Service for Kubernetes.

Перед началом работы

Получите регистрационный токен (registration token):

• Для настройки GitLab Runner на весь инстанс GitLab (требуются права администратора GitLab):
  1. Откройте в браузере административную панель GitLab, используя FQDN инстанса.
  2. Нажмите кнопку Menu и выберите пункт Admin.
  3. Перейдите в раздел Runners.
  4. Нажмите кнопку Register an instance runner и сохраните значения параметра registration token.
• Для настройки GitLab Runner для группы или проекта:
  1. Откройте в браузере административную панель GitLab, используя FQDN инстанса.
  2. Выберите необходимую группу или проект.
  3. В открывшемся окне слева нажмите кнопку Settings и выберите пункт CI/CD.
  4. В блоке Runners нажмите кнопку Expand.
  5. Сохраните значения параметра registration token.

Установка с помощью Yandex Cloud Marketplace

1. Перейдите на страницу каталога и выберите сервис Managed Service for Kubernetes.
2. Нажмите на имя нужного кластера Kubernetes и выберите вкладку Marketplace.
3. В разделе Доступные для установки приложения выберите GitLab Runner и нажмите кнопку Использовать.
4. Задайте настройки приложения:
   • Пространство имен — выберите пространство имен для GitLab Runner или создайте новое.
   • Название приложения — укажите название приложения.
   • Имя домена GitLab — укажите домен вашего инстанса GitLab.
   • Регистрационный токен — укажите регистрационный токен, полученный ранее.
5. Нажмите кнопку Установить.
6. Дождитесь перехода приложения в статус Deployed.

Установка с помощью Helm-чарта

1. Установите менеджер пакетов Helm версии не ниже 3.7.0.

2. Установите kubectl и настройте его на работу с созданным кластером.

3. Для установки Helm-чарта с GitLab Runner выполните команду:

   export HELM_EXPERIMENTAL_OCI=1 && \
   helm pull oci://cr.yandex/yc-marketplace/yandex-cloud/gitlab-org/gitlab-runner/chart/gitlab-runner \
     --version <версия Helm-чарта> \
     --untar && \
   helm install \
     --namespace <пространство имен> \
     --create-namespace \
     --set gitlabUrl=<публичный IP-адрес ВМ или FQDN инстанса Managed Service for GitLab> \
     --set runnerRegistrationToken=<регистрационный токен, полученный ранее> \
     gitlab-runner ./gitlab-runner
   

   Актуальную версию Helm-чарта можно посмотреть на странице приложения.

См. также

• Документация Yandex Managed Service for GitLab.
• Документация GitLab.
• Документация GitLab CI/CD.
• Справочник по .gitlab-ci.yml.