Диагностика проблем GitFlic Runner

Данный раздел может помочь при диагностике и устранении неполадок GitFlic Runner.

Общие советы

Просмотр логов приложения

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

Путь до файла с логами указывается в конфигурационном файле агента (application.properties). Путь до файла по умолчанию: $HOME/gitflic-runner/data/log/server.log.

logging.file.name=$HOME/gitflic-runner/data/log/server.log

Настройка кодировки для PowerShell агента

Если вы столкнулись с некорректной кодировкой при использовании PowerShell агента, выполните следующие рекомендации:

1. Переопределите параметры для кодировки агента в конфигурационном файле application.properties

logging.charset.console=windows-1251

2. Измените локаль PowerShell на Windows-1251

2.1. Создайте каталог для файла профиля PowerShell:

New-Item -ItemType Directory -Path (Split-Path -Path $PROFILE) -Force

2.2. Создайте файл профиля:

New-Item -ItemType File -Path $PROFILE -Force

2.3. Откройте файл профиля (пункты 1 и 2 можно пропустить, если файл профиля уже есть):

notepad $PROFILE

2.4. В открывшемся файле добавьте настройки для изменения кодировки и сохраните его:

[Console]::OutputEncoding = [System.Text.Encoding]::GetEncoding("windows-1251")
[Console]::InputEncoding = [System.Text.Encoding]::GetEncoding("windows-1251")

После перезапуска PowerShell и агента, кодировка будет отображаться корректно.

Далее приведены ошибки, которые чаще всего возникали у пользователей:

1) Следующая ошибка при запуcке агента:

Parameter 0 of constructor in com.gitflic.cicd.runner.agent.job.command.StartJobAgentCommand required a bean of type 'com.gitflic.cicd.runner.service.JobService' that could not be found.

Решение: В конфигурационном файле для агента не объявлен или некорректно объявлен параметр runner.executor. Необходимо добавить строку runner.executor=$executor, где $executor - тип агента (shell, powershell, docker).

2) Следующая ошибка при работе агента:

org.springframework.beans.factory.UnsatisfiedDependencyException: Error creating bean with name 'startJobAgentCommand' defined in URL [jar:file:/PATH/runner.jar!/BOOT-INF/classes!/com/gitflic/cicd/runner/agent/job/command/StartJobAgentCommand.class]: Unsatisfied dependency expressed through constructor parameter 0; nested exception is org.springframework.beans.factory.UnsatisfiedDependencyException: Error creating bean with name 'dockerJobService' defined in URL [jar:file:/PATH/runner.jar!/BOOT-INF/classes!/com/gitflic/cicd/runner/service/docker/DockerJobService.class]: Unsatisfied dependency expressed through constructor parameter 1; nested exception is org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'defaultDockerService': Invocation of init method failed; nested exception is java.lang.RuntimeException: java.io.IOException: com.sun.jna.LastErrorException: [61] Connection refused

Решение: Убедитесь, что Docker (Kuber) запущен.