Skip to content

GitFlic Runner Troubleshooting

This section may help you with SSH diagnostics and troubleshooting for GitFlic Runner.

General Tips

Viewing Application Logs

For independent troubleshooting, you can open the application log file and find the necessary error information, or you can attach this file when contacting technical support.

The path to the log file is specified in the agent's configuration file (application.properties). The default path to the file is: $HOME/gitflic-runner/data/log/server.log.

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

Configuring Encoding for PowerShell Agent

If you encounter incorrect encoding when using the PowerShell agent, follow these recommendations:

1. Override the agent encoding parameters in the application.properties configuration file:

logging.charset.console=windows-1251

2. Allow PowerShell script execution on your system

2.1. Run PowerShell as administrator

2.2. Execute the command:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned

3. Change the PowerShell locale to Windows-1251

3.1. Create a directory for the PowerShell profile file:

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

3.2. Create the profile file:

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

3.3. Open the profile file (you can skip steps 1 and 2 if the profile file already exists):

notepad $PROFILE

3.4. In the opened file, add the settings to change the encoding and save it:

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

Restart PowerShell and the agent. The encoding should display correctly.

Most Common Issues

  1. Error when starting the agent:
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.

Solution: The runner.executor parameter is not declared or is incorrectly declared in the agent configuration file. You need to add the line runner.executor=$executor, where \$executor is the type of agent (shell, powershell, docker).

  1. Error during agent operation:
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

Solution: Make sure that Docker (Kuber) is running.

  1. Error during agent registration
javax.net.ssl.SSLHandshakeException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target

Solution: To set up the agent with a self-signed certificate, refer to this article.

Automated translation!

This page was translated using automatic translation tools. The text may contain inaccuracies.