This topic contains general troubleshooting information for error messages and other issues that can arise.
Troubleshooting remote builds
The Harness CI Re-run in Debug Mode feature can troubleshoot remote builds. This command is available only for the following build types:
This feature is available only for builds in remote infrastructures: Harness Cloud, Kubernetes, or VMs on remote hosts.
The build must have failed at a Run step within a CI stage. You must build a pipeline at least once before you can run the build in Debug mode.
To troubleshoot a pipeline that builds successfully but still needs remote troubleshooting, add a Run step with the CLI command
exit 1and re-run in Debug mode.
The following steps describe the workflow.
Navigate to the Builds, Execution, or Execution History page in the Harness UI.
Choose Re-run in Debug Mode in the options menu (⋮) for the build you want to troubleshoot.
When the Run step fails, the build stops and generates log output with links to web and SSH sessions on the remote host. Follow one of these links to troubleshoot the build.
When you're in the debug session, use the CLI to reproduce and troubleshoot the issue on the remote host.
To terminate the debug session, abort the build and then run a new build to determine if the issue is resolved.
Troubleshooting test suites
The following issues can occur when parsing test suites in Harness CI.
Test suites wrongly parsed
The parsed Test report in the Test tab comes strictly from the JUnit reports provided. It is important to adhere to the standard format to improve test suite parsing.
Refer to the standard JUnit format.