Локальные раннеры (Self-hosted)

Рекомендации

Self-hosted раннеры подходят, если вам нужно:

• запускать сборки и тесты в специфической инфраструктуре (например, со своими зависимостями, библиотеками, GPU и т. д.);
• работать с внутренними сетями кодовой базой физически или по соображениям безопасности недоступной из облака;
• выполнять долговременные задачи без ограничений по времени выполнения.

Режимы работы

Раннеры поддерживают два режима работы: в Docker-контейнере и на хосте. Для режима Docker требуется установленный и запущенный Docker daemon; если вы планируете выполнять job’ы напрямую на хосте, Docker не обязателен.

Рекомендуется запускать job’ы в контейнерах — это повышает изоляцию и воспроизводимость окружения.

Уровни привязки

Раннеры регистрируются на одном из уровней:

• уровень репозитория — раннер привязан к конкретному репозиторию, локальный раннер;
• уровень организации — раннер доступен внутри организации, организационный раннер, см. Организационные раннеры.

Настройка

Раннеры GitVerse доступны как нативные приложений под различные ОС и архитектуры, а также в виде Docker-образов.

Вы можете добавлять раннеры к репозиториям. Чтобы добавить локальный раннер к репозиторию, нужно быть владельцем репозитория.

1. В репозитории перейдите в Настройки -> Раннеры.

2. В разделе Локальные раннеры нажмите Добавить раннер.

3. Выберите платформу и архитектуру машины, на которой будет произведен запуск раннера.

4. Скачайте последнюю версию раннера по кнопке Начать загрузку или из командной строки, применив показанные команды в терминале машины запуска. Все версии доступны в пакетах организации GitVerse

5. Сконфигурируйте раннер, применив показанные команды в терминале машины запуска.

6. Проверьте, что в Настройки -> Раннеры -> Локальные раннеры появился раннер.

Метки и среды выполнения

При регистрации self-hosted раннера ему автоматически присваиваются стандартные метки (labels).

Эти метки отражают операционную систему, аппаратную архитектуру раннера, а также влияют на режим, в котором выполняются задачи:

Создание своих меток

Метки, в том числе и по умолчанию, задаются списком значений, разделенных запятой. Стандартный набор меток для раннера под Linux выглядит так:

linux:host, x64:host, self-hosted:host,
img-ubuntu-latest:gitverse:gitverse/runner-image:ubuntu-latest, img-ubuntu-22.04:gitverse:gitverse/runner-image:ubuntu-22.04, img-ubuntu-20.04:gitverse:gitverse/runner-image:ubuntu-20.04

Метка img-ubuntu-20.04:gitverse:gitverse/runner-image:ubuntu-20.04, где:

• img-ubuntu-20.04 — сама метка и указывается в runs-on: img-ubuntu-20.04;
• gitverse:gitverse/runner-image:ubuntu-20.04 указывает окружение для выполнения задач в Docker-контейнере, созданном из образа gitverse/runner-image:ubuntu-20.04.

Метка self-hosted:host

• self-hosted — сама метка и указывается в runs-on: self-hosted;
• host указывает, что каждая задача будет выполняться на самом хосте, где установлен раннер.

Суффикс :host не является обязательным, но рекомендуется использовать уникальные метки, например, linux_amd64:host или windows:host, чтобы избежать неоднозначностей и ошибок при маршрутизации задач.

Отслеживание занятости раннеров

Вы можете отслеживать занятость раннеров прямо в интерфейсе GitVerse. В репозитории перейдите в Настройки -> Раннеры. Вы увидите список всех раннеров.

Рядом с каждым раннером указан его текущий статус:

• идет сборка — раннер выполняет задачу;
• свободен — раннер свободен для новой задачи;
• недоступен — раннер зарегистрирован, но оффлайн.

Чтобы узнать больше о конкретном раннере, нажмите на его имя. Откроется страница с информацией о раннере и историей сборок. В истории сборок вы увидите основную информацию по задачам, а также время взятия в работу и продолжительность выполнения. При нажатии на название задачи вы перейдете в workflow, в котором выполнялась данная задача.