Запуск агента компании


Данная инструкция предназначена только для облачной версии GitFlic.

Последняя версия runner доступна по ссылке.

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

Перед запуском агента, его необходимо зарегистрировать.

Все комманды описанные ниже, выполняются из рабочей директории агента.

1 Перейдите в веб интерфейс приложения Gitflic -> Выберите желаемую компанию -> Настройки –> Агенты СI/CD

https://gitflic.ru/company/<Алиас компании>/setting/cicd/runners

2 Скопируйте и сохраните URL и Token

<img src=https://gitflic.ru/project/gitflic/docs/blob/raw?file=img%2Fsetup%2Fsetup_saas_1.png>

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

java -jar runner.jar register --url <url> --registration-token <token>

<url> - Url скопировнный в п.2

<token>- Token скопированный в п.2

При успешном завершении регистрации в веб интерфейсе приложения на вкладке из п.1 появиться соответствующая запись о том что ранер подключен к приложению.

В рабочей директории будет создана директория config содержащая файл https://docs1.gitflic.space/company/saas_runner_setupapplication.properties.

4 Добавьте параметр runner.executor= ,с указанием типа запускаемого агента, в файл application.properties из п.3.

sed -i '1 i\runner.executor=docker' config/application.properties

5 Отредактируйте файл application.properties из п.3, добавив необходимые параметры, в соотвествии с типом агента.

С описанием параметров можно ознакомиться на данной странице.

Запуск через systemd

Подробнее со службой systemd можно ознакомиться на странице wiki

  • Если приложение было установлено через deb пакет , то файл юнита systemd gfagent.service , будет добавлен по умолчанию в директорию /etc/systemd/system/. Отредактируйте данный файл если небходимо.
  • Во всех остальных случаях необходимо самостоятельно создать юнит
  • Разрешите запуск юнита и запустите приложение
sudo systemctl enable gfagent.service --now

Запуск агента

Перейдите в рабочую директорию агента и выполните команду запуска

java -jar runner.jar start --config=config/application.properties

--config= - Параметр указывающий на расположение файла с настройками.