Диагностика проблем 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) запущен.