Раннеры

Раннер - это программа, которая позволяет запускать GitVerse Actions.

Она регистрируется на сервере GitVerse, загружает и выполняет задачи GitVerse CI CD и отправляет обратно результаты выполнения задач.

Вы можете скачать бинарный файл для Linux x64 или Docker образ.

Детальные примеры смотрите в разделе Регистрация и запуск раннеров.

На данный момент вы можете зарегистрировать раннер только на уровне репозитория: раннер работает с заданиями из репозитория, к которому он привязан.

Загрузка

Ссылки для скачивания

Операционная система	Бинарный файл	Адрес образа Docker
Linux x64	3.0.1 (opens in a new tab)	gitverse.ru/gitverse/act-runner:3.0.1

Загрузка бинарного файла

Скачайте бинарный файл раннера для Linux x64.
После загрузки сделайте файл исполняемым:
```
chmod +x act_runner 
./act_runner --version
```

Загрузка образа Docker

Пример команды для скачивания образа Docker:

docker pull gitverse.ru/gitverse/act-runner:3.0.1

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

Токен доступен на странице настроек репозитория (пример: https://gitverse.ru/<владелец>/<имя-репозитория>/settings/runners).

Нажмите Добавить раннер и скопируйте регистрационный токен:

Формат токена регистрации – случайная строка, пример: D0gvfu2iHfUjNqCYVljVyRV14fISpJxxxxxxxxxx.

Регистрация раннера

Регистрация обязательна перед запуском раннера, чтобы раннер знал, откуда брать задания для выполнения. Также регистрация позволяет платформе GitVerse идентифицировать раннер.

Вы можете зарегистрировать раннер на уровне репозитория: раннер работает только с заданиями из репозитория, к которому он привязан.

Интерактивная регистрация раннера

Раннер регистрируется следующей командой:

./act_runner register

Далее вас пошагово попросят ввести данные для регистрации:

токен регистрации;
имя раннера (опционально, если оставить пустым, будет использовано имя хоста);
метки раннера (опционально).

Пример диалога интерактивной регистрации раннера:

Неинтерактивная регистрация раннера

Для неинтерактивной регистрации используйте аргументы:

./act_runner register --no-interactive --token <registration_token> --name <runner_name>

💡

После регистрации в текущей директории появится файл .runner. Он хранит данные регистрации – не редактируйте его вручную! Если файл потеряется или повредится, просто удалите его и проведите регистрацию снова. При необходимости можно указать иное местоположение файла через конфигурацию.

Запуск

Запуск раннера

После регистрации раннера, запустите его:

./act_runner daemon 
# или
./act_runner daemon --config config.yaml

Раннер будет забирать задания с платформы GitVerse и выполнять их. Раннер активно развивается, поэтому рекомендуется регулярно обновлять его.

Запуск раннера в Docker контейнере

При использовании образа Docker процесс отличается. Регистрация и запуск объединены в один шаг, данные для регистрации передаются при запуске:

docker run \
      -v /var/run/docker.sock:/var/run/docker.sock \
      -e RUNNER_REGISTRATION_TOKEN=6lKl2VxzpRn6ijy9dzG5P749EXHCpCDk1gQfL16Q \
      gitverse.ru/gitverse/act-runner:3.0.1

Обратите внимание на монтирование /var/run/docker.sock. Это нужно, так как раннер запускает задания в контейнерах Docker и должен общаться с демоном Docker.

Отображения работы раннера

Активность раннера на странице CI/CD:

CI/CD Секреты