Конфигурирование и запуск агента GitFlic Runner
Регистрация агента
Перед запуском агента, его необходимо зарегистрировать. *Все команды описанные ниже, выполняются из рабочей директории агента!
1. Перейдите в веб интерфейс приложения GitFlic -> Панель администратора -> СI/CD
http(s)://<Адрес веб интерфейса>/admin/runners
* Для регистрации агента в сервисе GitFlic.ru перейдите в Настройки компании -> Агенты CI/CD*
https://gitflic.ru/company/<company_name>/setting/cicd/runners
2. Скопируйте и сохраните URL и Token
3. Выполните команду регистрации
java -jar runner.jar register --url <url> --registration-token <token>
| Ключ | Обязательный | Описание |
|---|---|---|
| --url \<url> | да | Url скопированный в п.2 |
| --registration-token \<token> или --token \<token> | да | Token скопированный в п.2 |
| --name \<name> | нет | Название агента |
| --tags \<tags> | нет | Теги агента (через запятую) |
| --default-config \<defaultConfig> | нет | Путь до конфигурационных файлов Docker Engine |
| --docker-image \<defaultDockerImage> | нет | Образ, который будет использован для создания контейнеров |
| --docker-volumes \<dockerVolumes>[;\ |
нет | Дополнительные тома, которые должны быть подключены к контейнеру |
| --registry-url\<registry-url> | нет | URL для Docker Registry |
| --registry-user \<registry-user> | нет | Пароль для Docker Registry |
| --registry-password \<registry-password> | нет | Пароль для Docker Registry |
* При успешном завершении регистрации в веб интерфейсе приложения на вкладке из п.1 появится соответствующая запись о том что агент подключен к приложению. * В рабочей директории будет создана директория config содержащая файл application.properties.
4. Добавьте параметры runner.executor, с указанием типа запускаемого агента, и logging.file.name, с указанием файла с логами, в файл application.properties из п.3.
shell
sed -i '1 i\runner.executor=shell\nlogging.file.name=data/log/server.log' config/application.properties
powershell
Add-Content $env:USERPROFILE/gitflic-runner/config/application.properties "runner.executor=powershell" ; Add-Content сonfig/application.properties "logging.file.name=data/log/server.log"
*С описанием параметров можно ознакомиться на данной странице.
Запуск агента
Выполните команду запуска
java -jar runner.jar start --config=config/application.properties
*--config= - Параметр указывающий на расположение файла с настройками.